com php-src: small corrections: compat/PECL_PORTING

From: Date: Mon, 13 Jan 2014 17:56:43 +0000
Subject: com php-src: small corrections: compat/PECL_PORTING
Groups: php.cvs 
Request: Send a blank email to php-cvs+get-75600@lists.php.net to get a copy of this message
Commit: 25dfcf4fdd3a5d08c0c818d67fa3c0e0d26b452a Author: Anatol Belski <ab@php.net> Mon, 13 Jan 2014 18:56:43 +0100 Parents: 972a6bd0f7afc2dc4850996433c1fbef73f7ba45 Branches: str_size_and_int64 Link: http://git.php.net/?p=php-src.git;a=commitdiff;h=25dfcf4fdd3a5d08c0c818d67fa3c0e0d26b452a Log: small corrections Changed paths: M compat/PECL_PORTING Diff: diff --git a/compat/PECL_PORTING b/compat/PECL_PORTING index 75e77d7..37949de 100644 --- a/compat/PECL_PORTING +++ b/compat/PECL_PORTING @@ -47,8 +47,8 @@ https://wiki.php.net/rfc/size_t_and_int64 guarantee the consistent 64 bit support. Signed integer is defined as zend_int_t, unsigned integer as zend_uint_t - inside Zend. Both are aliased as php_int_t, php_uint_t anywhere else. The - inclusion of php.h is necessary. + inside Zend. Both are aliased as php_int_t and php_uint_t anywhere else, + respectively.. The inclusion of php.h is necessary. iii. Other datatypes zend_off_t - portable off_t analogue @@ -56,7 +56,8 @@ https://wiki.php.net/rfc/size_t_and_int64 These datatypes are declared to be portable across platforms. Thus, direct usage of the functions like fseek, stat, etc. as well as direct usage of - off_t and struct stat is strongly not recommended. Instead the portable macros should be used. + off_t and struct stat is strongly not recommended. Instead the portable + macros should be used. zend_fseek - portable fseek equivalent zend_ftell - portable ftell equivalent @@ -111,7 +112,7 @@ II. Porting steps The arg specs 'l', 'L', 's' and 'p' are not available anymore. As their replacements 'i', 'I', 'S' and 'P' was invented. The integer specs expect a - variable of type php_int_t to be passed. The string/path length are expected + variable of type php_int_t to be passed. The string/path lengths are expected to be of type php_size_t. The recommended way to declare the argument specs is using the ternary operator, @@ -129,7 +130,7 @@ II. Porting steps iv. Manual code fixes - While for many extensions the mechanic replacements will be already enough to + While for many extensions the mechanic replacements will do the big job to retain the compatibility, the manual code fixes might be necessary. Here are especially to mention array API, filesystem API, unsigned string lengths. Also this is likely the case for extensions with library dependencies, see also the

« previous php.cvs (#75600) next »