diff options
author | Max Semenik <maxsem.wiki@gmail.com> | 2020-07-01 16:32:55 +0300 |
---|---|---|
committer | Máté Kocsis <kocsismate@woohoolabs.com> | 2020-07-06 21:13:34 +0200 |
commit | 2b5de6f839feea0ae1d5289d59dd7f159fcdcc8c (patch) | |
tree | f23a5c00a96f30a62ddcf626b4c6a6d53809d14f /Zend | |
parent | 47579986504022d3eab38e24fff5861d5e4eadad (diff) | |
download | php-git-2b5de6f839feea0ae1d5289d59dd7f159fcdcc8c.tar.gz |
Remove proto comments from C files
Closes GH-5758
Diffstat (limited to 'Zend')
-rw-r--r-- | Zend/zend_builtin_functions.c | 161 | ||||
-rw-r--r-- | Zend/zend_closures.c | 12 | ||||
-rw-r--r-- | Zend/zend_exceptions.c | 39 | ||||
-rw-r--r-- | Zend/zend_generators.c | 24 | ||||
-rw-r--r-- | Zend/zend_ini_parser.y | 27 | ||||
-rw-r--r-- | Zend/zend_ini_scanner.l | 21 | ||||
-rw-r--r-- | Zend/zend_signal.c | 3 |
7 files changed, 96 insertions, 191 deletions
diff --git a/Zend/zend_builtin_functions.c b/Zend/zend_builtin_functions.c index 47c44c8fd6..f766227343 100644 --- a/Zend/zend_builtin_functions.c +++ b/Zend/zend_builtin_functions.c @@ -65,8 +65,7 @@ int zend_startup_builtin_functions(void) /* {{{ */ } /* }}} */ -/* {{{ proto string zend_version(void) - Get the version of the Zend Engine */ +/* {{{ Get the version of the Zend Engine */ ZEND_FUNCTION(zend_version) { ZEND_PARSE_PARAMETERS_NONE(); @@ -75,8 +74,7 @@ ZEND_FUNCTION(zend_version) } /* }}} */ -/* {{{ proto int gc_mem_caches(void) - Reclaims memory used by MM caches. +/* {{{ Reclaims memory used by MM caches. Returns number of freed bytes */ ZEND_FUNCTION(gc_mem_caches) { @@ -86,8 +84,7 @@ ZEND_FUNCTION(gc_mem_caches) } /* }}} */ -/* {{{ proto int gc_collect_cycles(void) - Forces collection of any existing garbage cycles. +/* {{{ Forces collection of any existing garbage cycles. Returns number of freed zvals */ ZEND_FUNCTION(gc_collect_cycles) { @@ -97,8 +94,7 @@ ZEND_FUNCTION(gc_collect_cycles) } /* }}} */ -/* {{{ proto void gc_enabled(void) - Returns status of the circular reference collector */ +/* {{{ Returns status of the circular reference collector */ ZEND_FUNCTION(gc_enabled) { ZEND_PARSE_PARAMETERS_NONE(); @@ -107,8 +103,7 @@ ZEND_FUNCTION(gc_enabled) } /* }}} */ -/* {{{ proto void gc_enable(void) - Activates the circular reference collector */ +/* {{{ Activates the circular reference collector */ ZEND_FUNCTION(gc_enable) { zend_string *key; @@ -121,8 +116,7 @@ ZEND_FUNCTION(gc_enable) } /* }}} */ -/* {{{ proto void gc_disable(void) - Deactivates the circular reference collector */ +/* {{{ Deactivates the circular reference collector */ ZEND_FUNCTION(gc_disable) { zend_string *key; @@ -135,8 +129,7 @@ ZEND_FUNCTION(gc_disable) } /* }}} */ -/* {{{ proto array gc_status(void) - Returns current GC statistics */ +/* {{{ Returns current GC statistics */ ZEND_FUNCTION(gc_status) { zend_gc_status status; @@ -154,8 +147,7 @@ ZEND_FUNCTION(gc_status) } /* }}} */ -/* {{{ proto int func_num_args(void) - Get the number of arguments that were passed to the function */ +/* {{{ Get the number of arguments that were passed to the function */ ZEND_FUNCTION(func_num_args) { zend_execute_data *ex = EX(prev_execute_data); @@ -175,8 +167,7 @@ ZEND_FUNCTION(func_num_args) } /* }}} */ -/* {{{ proto mixed func_get_arg(int arg_num) - Get the $arg_num'th argument that was passed to the function */ +/* {{{ Get the $arg_num'th argument that was passed to the function */ ZEND_FUNCTION(func_get_arg) { uint32_t arg_count, first_extra_arg; @@ -222,8 +213,7 @@ ZEND_FUNCTION(func_get_arg) } /* }}} */ -/* {{{ proto array func_get_args() - Get an array of the arguments that were passed to the function */ +/* {{{ Get an array of the arguments that were passed to the function */ ZEND_FUNCTION(func_get_args) { zval *p, *q; @@ -292,8 +282,7 @@ ZEND_FUNCTION(func_get_args) } /* }}} */ -/* {{{ proto int strlen(string str) - Get string length +/* {{{ Get string length Warning: This function is special-cased by zend_compile.c and so is usually bypassed */ ZEND_FUNCTION(strlen) { @@ -307,8 +296,7 @@ ZEND_FUNCTION(strlen) } /* }}} */ -/* {{{ proto int strcmp(string str1, string str2) - Binary safe string comparison */ +/* {{{ Binary safe string comparison */ ZEND_FUNCTION(strcmp) { zend_string *s1, *s2; @@ -322,8 +310,7 @@ ZEND_FUNCTION(strcmp) } /* }}} */ -/* {{{ proto int strncmp(string str1, string str2, int len) - Binary safe string comparison */ +/* {{{ Binary safe string comparison */ ZEND_FUNCTION(strncmp) { zend_string *s1, *s2; @@ -344,8 +331,7 @@ ZEND_FUNCTION(strncmp) } /* }}} */ -/* {{{ proto int strcasecmp(string str1, string str2) - Binary safe case-insensitive string comparison */ +/* {{{ Binary safe case-insensitive string comparison */ ZEND_FUNCTION(strcasecmp) { zend_string *s1, *s2; @@ -359,8 +345,7 @@ ZEND_FUNCTION(strcasecmp) } /* }}} */ -/* {{{ proto int strncasecmp(string str1, string str2, int len) - Binary safe string comparison */ +/* {{{ Binary safe string comparison */ ZEND_FUNCTION(strncasecmp) { zend_string *s1, *s2; @@ -381,8 +366,7 @@ ZEND_FUNCTION(strncasecmp) } /* }}} */ -/* {{{ proto int error_reporting([int new_error_level]) - Return the current error_reporting level, and if an argument was passed - change to the new level */ +/* {{{ Return the current error_reporting level, and if an argument was passed - change to the new level */ ZEND_FUNCTION(error_reporting) { zval *err = NULL; @@ -496,8 +480,7 @@ static void copy_constant_array(zval *dst, zval *src) /* {{{ */ } /* }}} */ -/* {{{ proto bool define(string constant_name, mixed value[, bool case_insensitive]) - Define a new constant */ +/* {{{ Define a new constant */ ZEND_FUNCTION(define) { zend_string *name; @@ -571,8 +554,7 @@ register_constant: } /* }}} */ -/* {{{ proto bool defined(string constant_name) - Check whether a constant exists +/* {{{ Check whether a constant exists Warning: This function is special-cased by zend_compile.c and so is usually bypassed */ ZEND_FUNCTION(defined) { @@ -590,8 +572,7 @@ ZEND_FUNCTION(defined) } /* }}} */ -/* {{{ proto string get_class([object object]) - Retrieves the class name */ +/* {{{ Retrieves the class name */ ZEND_FUNCTION(get_class) { zval *obj = NULL; @@ -615,8 +596,7 @@ ZEND_FUNCTION(get_class) } /* }}} */ -/* {{{ proto string get_called_class() - Retrieves the "Late Static Binding" class name */ +/* {{{ Retrieves the "Late Static Binding" class name */ ZEND_FUNCTION(get_called_class) { zend_class_entry *called_scope; @@ -633,8 +613,7 @@ ZEND_FUNCTION(get_called_class) } /* }}} */ -/* {{{ proto mixed get_parent_class([mixed object]) - Retrieves the parent class name for object or class or current scope or false if not in a scope. */ +/* {{{ Retrieves the parent class name for object or class or current scope or false if not in a scope. */ ZEND_FUNCTION(get_parent_class) { zend_class_entry *ce = NULL; @@ -708,16 +687,14 @@ static void is_a_impl(INTERNAL_FUNCTION_PARAMETERS, zend_bool only_subclass) /* } /* }}} */ -/* {{{ proto bool is_subclass_of(mixed object_or_string, string class_name [, bool allow_string]) - Returns true if the object has this class as one of its parents */ +/* {{{ Returns true if the object has this class as one of its parents */ ZEND_FUNCTION(is_subclass_of) { is_a_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, 1); } /* }}} */ -/* {{{ proto bool is_a(mixed object_or_string, string class_name [, bool allow_string]) - Returns true if the first argument is an object and is this class or has this class as one of its parents, */ +/* {{{ Returns true if the first argument is an object and is this class or has this class as one of its parents, */ ZEND_FUNCTION(is_a) { is_a_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, 0); @@ -771,8 +748,7 @@ static void add_class_vars(zend_class_entry *scope, zend_class_entry *ce, int st } /* }}} */ -/* {{{ proto array get_class_vars(string class_name) - Returns an array of default properties of the class. */ +/* {{{ Returns an array of default properties of the class. */ ZEND_FUNCTION(get_class_vars) { zend_string *class_name; @@ -799,8 +775,7 @@ ZEND_FUNCTION(get_class_vars) } /* }}} */ -/* {{{ proto array get_object_vars(object obj) - Returns an array of object properties */ +/* {{{ Returns an array of object properties */ ZEND_FUNCTION(get_object_vars) { zval *obj; @@ -870,8 +845,7 @@ ZEND_FUNCTION(get_object_vars) } /* }}} */ -/* {{{ proto array get_mangled_object_vars(object obj) - Returns an array of mangled object properties. Does not respect property visibility. */ +/* {{{ Returns an array of mangled object properties. Does not respect property visibility. */ ZEND_FUNCTION(get_mangled_object_vars) { zval *obj; @@ -913,8 +887,7 @@ static int same_name(zend_string *key, zend_string *name) /* {{{ */ } /* }}} */ -/* {{{ proto array get_class_methods(mixed class) - Returns an array of method names for class or class instance. */ +/* {{{ Returns an array of method names for class or class instance. */ ZEND_FUNCTION(get_class_methods) { zval method_name; @@ -944,8 +917,7 @@ ZEND_FUNCTION(get_class_methods) } /* }}} */ -/* {{{ proto bool method_exists(object object, string method) - Checks if the class method exists */ +/* {{{ Checks if the class method exists */ ZEND_FUNCTION(method_exists) { zval *klass; @@ -1002,8 +974,7 @@ ZEND_FUNCTION(method_exists) } /* }}} */ -/* {{{ proto bool property_exists(mixed object_or_class, string property_name) - Checks if the object or class has a property */ +/* {{{ Checks if the object or class has a property */ ZEND_FUNCTION(property_exists) { zval *object; @@ -1078,32 +1049,28 @@ static inline void class_exists_impl(INTERNAL_FUNCTION_PARAMETERS, int flags, in } /* {{{ */ -/* {{{ proto bool class_exists(string classname [, bool autoload]) - Checks if the class exists */ +/* {{{ Checks if the class exists */ ZEND_FUNCTION(class_exists) { class_exists_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, ZEND_ACC_LINKED, ZEND_ACC_INTERFACE | ZEND_ACC_TRAIT); } /* }}} */ -/* {{{ proto bool interface_exists(string classname [, bool autoload]) - Checks if the class exists */ +/* {{{ Checks if the class exists */ ZEND_FUNCTION(interface_exists) { class_exists_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, ZEND_ACC_LINKED|ZEND_ACC_INTERFACE, 0); } /* }}} */ -/* {{{ proto bool trait_exists(string traitname [, bool autoload]) - Checks if the trait exists */ +/* {{{ Checks if the trait exists */ ZEND_FUNCTION(trait_exists) { class_exists_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, ZEND_ACC_TRAIT, 0); } /* }}} */ -/* {{{ proto bool function_exists(string function_name) - Checks if the function exists */ +/* {{{ Checks if the function exists */ ZEND_FUNCTION(function_exists) { zend_string *name; @@ -1129,8 +1096,7 @@ ZEND_FUNCTION(function_exists) } /* }}} */ -/* {{{ proto bool class_alias(string user_class_name , string alias_name [, bool autoload]) - Creates an alias for user defined class */ +/* {{{ Creates an alias for user defined class */ ZEND_FUNCTION(class_alias) { zend_string *class_name; @@ -1164,8 +1130,7 @@ ZEND_FUNCTION(class_alias) } /* }}} */ -/* {{{ proto array get_included_files(void) - Returns an array with the file names that were include_once()'d */ +/* {{{ Returns an array with the file names that were include_once()'d */ ZEND_FUNCTION(get_included_files) { zend_string *entry; @@ -1181,8 +1146,7 @@ ZEND_FUNCTION(get_included_files) } /* }}} */ -/* {{{ proto bool trigger_error(string message [, int error_type]) - Generates a user-level error/warning/notice message */ +/* {{{ Generates a user-level error/warning/notice message */ ZEND_FUNCTION(trigger_error) { zend_long error_type = E_USER_NOTICE; @@ -1212,8 +1176,7 @@ ZEND_FUNCTION(trigger_error) } /* }}} */ -/* {{{ proto string set_error_handler(callable error_handler [, int error_types]) - Sets a user-defined error handler function. Returns the previously defined error handler, or false on error */ +/* {{{ Sets a user-defined error handler function. Returns the previously defined error handler, or false on error */ ZEND_FUNCTION(set_error_handler) { zval *error_handler; @@ -1249,8 +1212,7 @@ ZEND_FUNCTION(set_error_handler) } /* }}} */ -/* {{{ proto void restore_error_handler(void) - Restores the previously defined error handler function */ +/* {{{ Restores the previously defined error handler function */ ZEND_FUNCTION(restore_error_handler) { ZEND_PARSE_PARAMETERS_NONE(); @@ -1279,8 +1241,7 @@ ZEND_FUNCTION(restore_error_handler) } /* }}} */ -/* {{{ proto mixed set_exception_handler(callable exception_handler) - Sets a user-defined exception handler function. Returns the previously defined exception handler, or false on error */ +/* {{{ Sets a user-defined exception handler function. Returns the previously defined exception handler, or false on error */ ZEND_FUNCTION(set_exception_handler) { zval *exception_handler; @@ -1313,8 +1274,7 @@ ZEND_FUNCTION(set_exception_handler) } /* }}} */ -/* {{{ proto void restore_exception_handler(void) - Restores the previously defined exception handler function */ +/* {{{ Restores the previously defined exception handler function */ ZEND_FUNCTION(restore_exception_handler) { ZEND_PARSE_PARAMETERS_NONE(); @@ -1364,32 +1324,28 @@ static inline void get_declared_class_impl(INTERNAL_FUNCTION_PARAMETERS, int fla } /* {{{ */ -/* {{{ proto array get_declared_traits() - Returns an array of all declared traits. */ +/* {{{ Returns an array of all declared traits. */ ZEND_FUNCTION(get_declared_traits) { get_declared_class_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, ZEND_ACC_TRAIT, 0); } /* }}} */ -/* {{{ proto array get_declared_classes() - Returns an array of all declared classes. */ +/* {{{ Returns an array of all declared classes. */ ZEND_FUNCTION(get_declared_classes) { get_declared_class_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, ZEND_ACC_LINKED, ZEND_ACC_INTERFACE | ZEND_ACC_TRAIT); } /* }}} */ -/* {{{ proto array get_declared_interfaces() - Returns an array of all declared interfaces. */ +/* {{{ Returns an array of all declared interfaces. */ ZEND_FUNCTION(get_declared_interfaces) { get_declared_class_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, ZEND_ACC_INTERFACE, 0); } /* }}} */ -/* {{{ proto array get_defined_functions(void) - Returns an array of all defined functions */ +/* {{{ Returns an array of all defined functions */ ZEND_FUNCTION(get_defined_functions) { zval internal, user; @@ -1425,8 +1381,7 @@ ZEND_FUNCTION(get_defined_functions) } /* }}} */ -/* {{{ proto array get_defined_vars(void) - Returns an associative array of names and values of all currently defined variable names (variables in the current scope) */ +/* {{{ Returns an associative array of names and values of all currently defined variable names (variables in the current scope) */ ZEND_FUNCTION(get_defined_vars) { zend_array *symbol_table; @@ -1455,8 +1410,7 @@ ZEND_FUNCTION(zend_thread_id) } #endif -/* {{{ proto string get_resource_type(resource res) - Get the resource type name for a given resource */ +/* {{{ Get the resource type name for a given resource */ ZEND_FUNCTION(get_resource_type) { const char *resource_type; @@ -1475,8 +1429,7 @@ ZEND_FUNCTION(get_resource_type) } /* }}} */ -/* {{{ proto int get_resource_id(resource res) - Get the resource ID for a given resource */ +/* {{{ Get the resource ID for a given resource */ ZEND_FUNCTION(get_resource_id) { zval *resource; @@ -1489,8 +1442,7 @@ ZEND_FUNCTION(get_resource_id) } /* }}} */ -/* {{{ proto array get_resources([string resource_type]) - Get an array with all active resources */ +/* {{{ Get an array with all active resources */ ZEND_FUNCTION(get_resources) { zend_string *type = NULL; @@ -1544,8 +1496,7 @@ static void add_zendext_info(zend_extension *ext, void *arg) /* {{{ */ } /* }}} */ -/* {{{ proto array get_loaded_extensions([bool zend_extensions]) - Return an array containing names of loaded extensions */ +/* {{{ Return an array containing names of loaded extensions */ ZEND_FUNCTION(get_loaded_extensions) { zend_bool zendext = 0; @@ -1568,8 +1519,7 @@ ZEND_FUNCTION(get_loaded_extensions) } /* }}} */ -/* {{{ proto array get_defined_constants([bool categorize]) - Return an array containing the names and values of all defined constants */ +/* {{{ Return an array containing the names and values of all defined constants */ ZEND_FUNCTION(get_defined_constants) { zend_bool categorize = 0; @@ -1743,7 +1693,7 @@ static inline zend_bool skip_internal_handler(zend_execute_data *skip) /* {{{ */ } /* {{{ */ -/* {{{ proto void debug_print_backtrace([int options[, int limit]]) */ +/* {{{ */ ZEND_FUNCTION(debug_print_backtrace) { zend_execute_data *call, *ptr, *skip; @@ -2129,8 +2079,7 @@ ZEND_API void zend_fetch_debug_backtrace(zval *return_value, int skip_last, int } /* }}} */ -/* {{{ proto array debug_backtrace([int options[, int limit]]) - Return backtrace as array */ +/* {{{ Return backtrace as array */ ZEND_FUNCTION(debug_backtrace) { zend_long options = DEBUG_BACKTRACE_PROVIDE_OBJECT; @@ -2144,8 +2093,7 @@ ZEND_FUNCTION(debug_backtrace) } /* }}} */ -/* {{{ proto bool extension_loaded(string extension_name) - Returns true if the named extension is loaded */ +/* {{{ Returns true if the named extension is loaded */ ZEND_FUNCTION(extension_loaded) { zend_string *extension_name; @@ -2165,8 +2113,7 @@ ZEND_FUNCTION(extension_loaded) } /* }}} */ -/* {{{ proto array get_extension_funcs(string extension_name) - Returns an array with the names of functions belonging to the named extension */ +/* {{{ Returns an array with the names of functions belonging to the named extension */ ZEND_FUNCTION(get_extension_funcs) { zend_string *extension_name; diff --git a/Zend/zend_closures.c b/Zend/zend_closures.c index 40ebaae0ab..7331188228 100644 --- a/Zend/zend_closures.c +++ b/Zend/zend_closures.c @@ -109,8 +109,7 @@ static zend_bool zend_valid_closure_binding( } /* }}} */ -/* {{{ proto mixed Closure::call(object to [, mixed parameter] [, mixed ...] ) - Call closure, binding to a given object with its class as the scope */ +/* {{{ Call closure, binding to a given object with its class as the scope */ ZEND_METHOD(Closure, call) { zval *newthis, closure_result; @@ -187,8 +186,7 @@ ZEND_METHOD(Closure, call) } /* }}} */ -/* {{{ proto Closure Closure::bind(callable old, object to [, mixed scope]) - Create a closure from another one and bind to another object and scope */ +/* {{{ Create a closure from another one and bind to another object and scope */ ZEND_METHOD(Closure, bind) { zval *newthis, *zclosure, *scope_arg = NULL; @@ -323,8 +321,7 @@ static int zend_create_closure_from_callable(zval *return_value, zval *callable, } /* }}} */ -/* {{{ proto Closure Closure::fromCallable(callable callable) - Create a closure from a callable using the current scope. */ +/* {{{ Create a closure from a callable using the current scope. */ ZEND_METHOD(Closure, fromCallable) { zval *callable; @@ -591,8 +588,7 @@ static HashTable *zend_closure_get_gc(zend_object *obj, zval **table, int *n) /* } /* }}} */ -/* {{{ proto Closure::__construct() - Private constructor preventing instantiation */ +/* {{{ Private constructor preventing instantiation */ ZEND_COLD ZEND_METHOD(Closure, __construct) { zend_throw_error(NULL, "Instantiation of 'Closure' is not allowed"); diff --git a/Zend/zend_exceptions.c b/Zend/zend_exceptions.c index c66a918993..4954a1bd5b 100644 --- a/Zend/zend_exceptions.c +++ b/Zend/zend_exceptions.c @@ -267,8 +267,7 @@ static zend_object *zend_error_exception_new(zend_class_entry *class_type) /* {{ } /* }}} */ -/* {{{ proto Exception|Error Exception|Error::__clone() - Clone the exception object */ +/* {{{ Clone the exception object */ ZEND_COLD ZEND_METHOD(Exception, __clone) { /* Should never be executable */ @@ -276,8 +275,7 @@ ZEND_COLD ZEND_METHOD(Exception, __clone) } /* }}} */ -/* {{{ proto Exception|Error::__construct(string message, int code [, Throwable previous]) - Exception constructor */ +/* {{{ Exception constructor */ ZEND_METHOD(Exception, __construct) { zend_string *message = NULL; @@ -308,8 +306,7 @@ ZEND_METHOD(Exception, __construct) } /* }}} */ -/* {{{ proto Exception::__wakeup() - Exception unserialize checks */ +/* {{{ Exception unserialize checks */ #define CHECK_EXC_TYPE(id, type) \ pvalue = zend_read_property_ex(i_get_exception_base(object), (object), ZSTR_KNOWN(id), 1, &value); \ if (Z_TYPE_P(pvalue) != IS_NULL && Z_TYPE_P(pvalue) != type) { \ @@ -329,8 +326,7 @@ ZEND_METHOD(Exception, __wakeup) } /* }}} */ -/* {{{ proto ErrorException::__construct(string message, int code, int severity [, string filename [, int lineno [, Throwable previous]]]) - ErrorException constructor */ +/* {{{ ErrorException constructor */ ZEND_METHOD(ErrorException, __construct) { zend_string *message = NULL, *filename = NULL; @@ -380,8 +376,7 @@ ZEND_METHOD(ErrorException, __construct) #define GET_PROPERTY_SILENT(object, id) \ zend_read_property_ex(i_get_exception_base(object), (object), ZSTR_KNOWN(id), 1, &rv) -/* {{{ proto string Exception|Error::getFile() - Get the file in which the exception occurred */ +/* {{{ Get the file in which the exception occurred */ ZEND_METHOD(Exception, getFile) { zval *prop, rv; @@ -393,8 +388,7 @@ ZEND_METHOD(Exception, getFile) } /* }}} */ -/* {{{ proto int Exception|Error::getLine() - Get the line in which the exception occurred */ +/* {{{ Get the line in which the exception occurred */ ZEND_METHOD(Exception, getLine) { zval *prop, rv; @@ -406,8 +400,7 @@ ZEND_METHOD(Exception, getLine) } /* }}} */ -/* {{{ proto string Exception|Error::getMessage() - Get the exception message */ +/* {{{ Get the exception message */ ZEND_METHOD(Exception, getMessage) { zval *prop, rv; @@ -419,8 +412,7 @@ ZEND_METHOD(Exception, getMessage) } /* }}} */ -/* {{{ proto int Exception|Error::getCode() - Get the exception code */ +/* {{{ Get the exception code */ ZEND_METHOD(Exception, getCode) { zval *prop, rv; @@ -433,8 +425,7 @@ ZEND_METHOD(Exception, getCode) } /* }}} */ -/* {{{ proto array Exception|Error::getTrace() - Get the stack trace for the location in which the exception occurred */ +/* {{{ Get the stack trace for the location in which the exception occurred */ ZEND_METHOD(Exception, getTrace) { zval *prop, rv; @@ -447,8 +438,7 @@ ZEND_METHOD(Exception, getTrace) } /* }}} */ -/* {{{ proto int ErrorException::getSeverity() - Get the exception severity */ +/* {{{ Get the exception severity */ ZEND_METHOD(ErrorException, getSeverity) { zval *prop, rv; @@ -590,8 +580,7 @@ static void _build_trace_string(smart_str *str, HashTable *ht, uint32_t num) /* } /* }}} */ -/* {{{ proto string Exception|Error::getTraceAsString() - Obtain the backtrace for the exception as a string (instead of an array) */ +/* {{{ Obtain the backtrace for the exception as a string (instead of an array) */ ZEND_METHOD(Exception, getTraceAsString) { zval *trace, *frame, rv; @@ -631,8 +620,7 @@ ZEND_METHOD(Exception, getTraceAsString) } /* }}} */ -/* {{{ proto Throwable Exception|Error::getPrevious() - Return previous Throwable or NULL. */ +/* {{{ Return previous Throwable or NULL. */ ZEND_METHOD(Exception, getPrevious) { zval rv; @@ -642,8 +630,7 @@ ZEND_METHOD(Exception, getPrevious) ZVAL_COPY(return_value, GET_PROPERTY_SILENT(ZEND_THIS, ZEND_STR_PREVIOUS)); } /* }}} */ -/* {{{ proto string Exception|Error::__toString() - Obtain the string representation of the Exception object */ +/* {{{ Obtain the string representation of the Exception object */ ZEND_METHOD(Exception, __toString) { zval trace, *exception; diff --git a/Zend/zend_generators.c b/Zend/zend_generators.c index fe7066c0c8..21a44b3865 100644 --- a/Zend/zend_generators.c +++ b/Zend/zend_generators.c @@ -828,8 +828,7 @@ static inline void zend_generator_rewind(zend_generator *generator) /* {{{ */ } /* }}} */ -/* {{{ proto void Generator::rewind() - * Rewind the generator */ +/* {{{ Rewind the generator */ ZEND_METHOD(Generator, rewind) { zend_generator *generator; @@ -842,8 +841,7 @@ ZEND_METHOD(Generator, rewind) } /* }}} */ -/* {{{ proto bool Generator::valid() - * Check whether the generator is valid */ +/* {{{ Check whether the generator is valid */ ZEND_METHOD(Generator, valid) { zend_generator *generator; @@ -860,8 +858,7 @@ ZEND_METHOD(Generator, valid) } /* }}} */ -/* {{{ proto mixed Generator::current() - * Get the current value */ +/* {{{ Get the current value */ ZEND_METHOD(Generator, current) { zend_generator *generator, *root; @@ -881,8 +878,7 @@ ZEND_METHOD(Generator, current) } /* }}} */ -/* {{{ proto mixed Generator::key() - * Get the current key */ +/* {{{ Get the current key */ ZEND_METHOD(Generator, key) { zend_generator *generator, *root; @@ -902,8 +898,7 @@ ZEND_METHOD(Generator, key) } /* }}} */ -/* {{{ proto void Generator::next() - * Advances the generator */ +/* {{{ Advances the generator */ ZEND_METHOD(Generator, next) { zend_generator *generator; @@ -918,8 +913,7 @@ ZEND_METHOD(Generator, next) } /* }}} */ -/* {{{ proto mixed Generator::send(mixed value) - * Sends a value to the generator */ +/* {{{ Sends a value to the generator */ ZEND_METHOD(Generator, send) { zval *value; @@ -955,8 +949,7 @@ ZEND_METHOD(Generator, send) } /* }}} */ -/* {{{ proto mixed Generator::throw(Exception exception) - * Throws an exception into the generator */ +/* {{{ Throws an exception into the generator */ ZEND_METHOD(Generator, throw) { zval *exception; @@ -993,8 +986,7 @@ ZEND_METHOD(Generator, throw) } /* }}} */ -/* {{{ proto mixed Generator::getReturn() - * Retrieves the return value of the generator */ +/* {{{ Retrieves the return value of the generator */ ZEND_METHOD(Generator, getReturn) { zend_generator *generator; diff --git a/Zend/zend_ini_parser.y b/Zend/zend_ini_parser.y index 5b82ec2f6a..373dee7aeb 100644 --- a/Zend/zend_ini_parser.y +++ b/Zend/zend_ini_parser.y @@ -60,8 +60,7 @@ static int get_int_val(zval *op) { } } -/* {{{ zend_ini_do_op() -*/ +/* {{{ zend_ini_do_op() */ static void zend_ini_do_op(char type, zval *result, zval *op1, zval *op2) { int i_result; @@ -98,8 +97,7 @@ static void zend_ini_do_op(char type, zval *result, zval *op1, zval *op2) } /* }}} */ -/* {{{ zend_ini_init_string() -*/ +/* {{{ zend_ini_init_string() */ static void zend_ini_init_string(zval *result) { if (ZEND_SYSTEM_INI) { @@ -110,8 +108,7 @@ static void zend_ini_init_string(zval *result) } /* }}} */ -/* {{{ zend_ini_add_string() -*/ +/* {{{ zend_ini_add_string() */ static void zend_ini_add_string(zval *result, zval *op1, zval *op2) { int length, op1_len; @@ -139,8 +136,7 @@ static void zend_ini_add_string(zval *result, zval *op1, zval *op2) } /* }}} */ -/* {{{ zend_ini_get_constant() -*/ +/* {{{ zend_ini_get_constant() */ static void zend_ini_get_constant(zval *result, zval *name) { zval *c, tmp; @@ -167,8 +163,7 @@ static void zend_ini_get_constant(zval *result, zval *name) } /* }}} */ -/* {{{ zend_ini_get_var() -*/ +/* {{{ zend_ini_get_var() */ static void zend_ini_get_var(zval *result, zval *name) { zval *curval; @@ -187,8 +182,7 @@ static void zend_ini_get_var(zval *result, zval *name) } /* }}} */ -/* {{{ ini_error() -*/ +/* {{{ ini_error() */ static ZEND_COLD void ini_error(const char *msg) { char *error_buf; @@ -217,8 +211,7 @@ static ZEND_COLD void ini_error(const char *msg) } /* }}} */ -/* {{{ zend_parse_ini_file() -*/ +/* {{{ zend_parse_ini_file() */ ZEND_API int zend_parse_ini_file(zend_file_handle *fh, zend_bool unbuffered_errors, int scanner_mode, zend_ini_parser_cb_t ini_parser_cb, void *arg) { int retval; @@ -246,8 +239,7 @@ ZEND_API int zend_parse_ini_file(zend_file_handle *fh, zend_bool unbuffered_erro } /* }}} */ -/* {{{ zend_parse_ini_string() -*/ +/* {{{ zend_parse_ini_string() */ ZEND_API int zend_parse_ini_string(char *str, zend_bool unbuffered_errors, int scanner_mode, zend_ini_parser_cb_t ini_parser_cb, void *arg) { int retval; @@ -274,8 +266,7 @@ ZEND_API int zend_parse_ini_string(char *str, zend_bool unbuffered_errors, int s } /* }}} */ -/* {{{ zval_ini_dtor() -*/ +/* {{{ zval_ini_dtor() */ static void zval_ini_dtor(zval *zv) { if (Z_TYPE_P(zv) == IS_STRING) { diff --git a/Zend/zend_ini_scanner.l b/Zend/zend_ini_scanner.l index 1f4bc34742..e8641faa49 100644 --- a/Zend/zend_ini_scanner.l +++ b/Zend/zend_ini_scanner.l @@ -217,8 +217,7 @@ static void yy_scan_buffer(char *str, unsigned int len) #define ini_filename SCNG(filename) -/* {{{ init_ini_scanner() -*/ +/* {{{ init_ini_scanner() */ static int init_ini_scanner(int scanner_mode, zend_file_handle *fh) { /* Sanity check */ @@ -244,8 +243,7 @@ static int init_ini_scanner(int scanner_mode, zend_file_handle *fh) } /* }}} */ -/* {{{ shutdown_ini_scanner() -*/ +/* {{{ shutdown_ini_scanner() */ void shutdown_ini_scanner(void) { zend_stack_destroy(&SCNG(state_stack)); @@ -255,24 +253,21 @@ void shutdown_ini_scanner(void) } /* }}} */ -/* {{{ zend_ini_scanner_get_lineno() -*/ +/* {{{ zend_ini_scanner_get_lineno() */ ZEND_COLD int zend_ini_scanner_get_lineno(void) { return SCNG(lineno); } /* }}} */ -/* {{{ zend_ini_scanner_get_filename() -*/ +/* {{{ zend_ini_scanner_get_filename() */ ZEND_COLD char *zend_ini_scanner_get_filename(void) { return ini_filename ? ini_filename : "Unknown"; } /* }}} */ -/* {{{ zend_ini_open_file_for_scanning() -*/ +/* {{{ zend_ini_open_file_for_scanning() */ int zend_ini_open_file_for_scanning(zend_file_handle *fh, int scanner_mode) { char *buf; @@ -293,8 +288,7 @@ int zend_ini_open_file_for_scanning(zend_file_handle *fh, int scanner_mode) } /* }}} */ -/* {{{ zend_ini_prepare_string_for_scanning() -*/ +/* {{{ zend_ini_prepare_string_for_scanning() */ int zend_ini_prepare_string_for_scanning(char *str, int scanner_mode) { int len = (int)strlen(str); @@ -309,8 +303,7 @@ int zend_ini_prepare_string_for_scanning(char *str, int scanner_mode) } /* }}} */ -/* {{{ zend_ini_escape_string() - */ +/* {{{ zend_ini_escape_string() */ static void zend_ini_escape_string(zval *lval, char *str, int len, char quote_type) { register char *s, *t; diff --git a/Zend/zend_signal.c b/Zend/zend_signal.c index e69914752a..2086f03dd8 100644 --- a/Zend/zend_signal.c +++ b/Zend/zend_signal.c @@ -330,8 +330,7 @@ void zend_signal_activate(void) SIGG(depth) = 0; } /* }}} */ -/* {{{ zend_signal_deactivate - * */ +/* {{{ zend_signal_deactivate */ void zend_signal_deactivate(void) { if (SIGG(check)) { |