[PHP-DOC] #40610 [Opn]: Array changes when missing array element is ref'd (w/ no assignment to array!)
ID: 40610
Updated by: [EMAIL PROTECTED]
Reported By: Webbed dot Pete at gmail dot com
Status: Open
Bug Type: Documentation problem
Operating System: Windows, Linux
PHP Version: 5.2.1
-Assigned To:
+Assigned To: colder
New Comment:
function foo($a) {}
foo($a); // will create $a
$b = new stdclass;
foo($b-c); // will create the public property c
$d = array();
foo($d['index']); // Will create the array index
In each case, it will be assigned to null. Calling isset will return
false because isset() returns false on variables assigned to NULL.
However, there are other functions like array_key_exist() or
property_exist() that are able to detect the NULL value.
Conclusion: there is simply no solution to effectively emulate the
isset() construct with default value using an user land function.
Previous Comments:
[2007-02-24 03:20:18] Webbed dot Pete at gmail dot com
Typo on function arrset(). Instead of
... return $val;
it should be
... return $arr[$key];
[2007-02-24 00:38:43] Webbed dot Pete at gmail dot com
When you pass a non-existent variable by reference of course it HAS
to be created, or what do you think should be referenced?
Funny thing is, passing a reference to a non-existent normal variable
works fine. Only array elements require something to be created.
If we accept this as a requirement, I believe we arrive at the
following set of conclusions:
What we're declarng here is that
a) isset() is not identical to is created.
b) A php app has no way to discover if a variable is created.
c) Array elements must be treated distinctly from other variables
whenever the number of created keys is important.
d) For array elements, key references must be carried separately from
value references.
Thus, to accomplish the equivalent of isset() with default, without
causing side effects, can still be accomplished with some pain.
It requires separate functions for variables, constants and array
elements. I believe the following patterns would be correct:
function varset($val,$default='') {
if (isset($val)) return $val;
return $default;
}
function defset($str,$default='') {
if (defined($str)) return constant($str);
return $default;
}
function arrset($arr,$key,$default='') {
if ( isset($arr) is_array($arr) array_key_exists($key,$arr)
isset($arr[$key]) ) return $val;
return $default;
}
Corrections welcome.
Thanks!
[2007-02-23 23:38:31] [EMAIL PROTECTED]
Reclassified a docu problem.
When you pass a non-existent variable by reference of course it HAS to
be created, or what do you think should be referenced?
[2007-02-23 22:47:54] Webbed dot Pete at gmail dot com
I have double and triple checked the documentation...
http://us3.php.net/manual/en/language.references.whatdo.php
...tells us that
PHP references allow you to make two variables to refer to the same
content. Meaning, when you do:
?php
$a = $b;
?
it means that $a and $b point to the same content. Note: $a and $b are
completely equal here, that's not $a is pointing to $b or vice versa,
that's $a and $b pointing to the same place.
This works as far as it goes. What's left unsaid is that if $b is a
missing array key, the unset key will be created and the $b array will
grow.
Neither 'array' nor 'references' documentation specify this behavior.
They don't say whether or not array elements are created willy-nilly
when an array reference exists.
I find nothing in the reference manual that either specifies nor
suggests this behavior is intentional. I do find several user comments
about this bug. It's just never been reported as a bug before.
The impact is that we cannot trust the keys of an array.
If this is declared as missing documentation, we will have to live with
the bug.
I'd prefer to see it eventually fixed; php will be better for it.
[2007-02-23 20:13:24] [EMAIL PROTECTED]
Thank you for taking the time to write to us, but this is not
a bug. Please double-check the documentation available at
http://www.php.net/manual/ and the instructions on how to report
a bug at http://bugs.php.net/how-to-report.php
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/40610
--
Edit this bug report at http://bugs.php.net/?id=40610edit=1
[PHP-DOC] #40610 [Opn]: Array changes when missing array element is ref'd (w/ no assignment to array!)
ID: 40610
User updated by: Webbed dot Pete at gmail dot com
Reported By: Webbed dot Pete at gmail dot com
Status: Open
Bug Type: Documentation problem
Operating System: Windows, Linux
PHP Version: 5.2.1
Assigned To: colder
New Comment:
If we require a single function, to *fully* emulate 'isset with
default' (with only two parameters), [EMAIL PROTECTED] is correct.
A compromise is currently required involving separate functions or at
least separate parameters that isolate potential array keys or object
property names.
The above emulations are effective userland emulations.
Further emulations are also helpful, such as emulation of '(isset AND
true) with default', which was noted in an earlier comment. This too
can be emulated through a set of functions.
It gets messy to do these workarounds, but the resulting application
code is much cleaner.
Instead of coding
$x = (isset($var) $var) ? $var : $default;
$y = (isset($pref['key']) $pref['key']) ? $pref['key'] : $default;
one can code
$x = varsettrue($var, $default);
$y = arrsettrue($pref,'key',$default);
by creating function varsettrue() as noted above, and now
function arrsettrue($arr,$key,$default='') {
if ( isset($arr) is_array($arr) array_key_exists($key,$arr)
isset($arr[$key]) $arr[$key] ) return $arr[$key];
return $default;
}
The 'mess' is encapsulated in a set of userland functions. This frees
coders to write well-protected code that never generates notices.
Perhaps someday there can be built-in functions that accomplish all
this, but for now at least we know there are effective (if slow/messy)
workarounds. I now believe a single userland function may be possible;
will think on that.
Previous Comments:
[2007-02-24 09:16:27] [EMAIL PROTECTED]
function foo($a) {}
foo($a); // will create $a
$b = new stdclass;
foo($b-c); // will create the public property c
$d = array();
foo($d['index']); // Will create the array index
In each case, it will be assigned to null. Calling isset will return
false because isset() returns false on variables assigned to NULL.
However, there are other functions like array_key_exist() or
property_exist() that are able to detect the NULL value.
Conclusion: there is simply no solution to effectively emulate the
isset() construct with default value using an user land function.
[2007-02-24 03:20:18] Webbed dot Pete at gmail dot com
Typo on function arrset(). Instead of
... return $val;
it should be
... return $arr[$key];
[2007-02-24 00:38:43] Webbed dot Pete at gmail dot com
When you pass a non-existent variable by reference of course it HAS
to be created, or what do you think should be referenced?
Funny thing is, passing a reference to a non-existent normal variable
works fine. Only array elements require something to be created.
If we accept this as a requirement, I believe we arrive at the
following set of conclusions:
What we're declarng here is that
a) isset() is not identical to is created.
b) A php app has no way to discover if a variable is created.
c) Array elements must be treated distinctly from other variables
whenever the number of created keys is important.
d) For array elements, key references must be carried separately from
value references.
Thus, to accomplish the equivalent of isset() with default, without
causing side effects, can still be accomplished with some pain.
It requires separate functions for variables, constants and array
elements. I believe the following patterns would be correct:
function varset($val,$default='') {
if (isset($val)) return $val;
return $default;
}
function defset($str,$default='') {
if (defined($str)) return constant($str);
return $default;
}
function arrset($arr,$key,$default='') {
if ( isset($arr) is_array($arr) array_key_exists($key,$arr)
isset($arr[$key]) ) return $val;
return $default;
}
Corrections welcome.
Thanks!
[2007-02-23 23:38:31] [EMAIL PROTECTED]
Reclassified a docu problem.
When you pass a non-existent variable by reference of course it HAS to
be created, or what do you think should be referenced?
[2007-02-23 22:47:54] Webbed dot Pete at gmail dot com
I have double and triple checked the documentation...
http://us3.php.net/manual/en/language.references.whatdo.php
...tells us that
PHP references allow you to make two variables to refer to the same
content. Meaning, when you do:
?php
$a = $b;
?
it means that $a and $b point to the same content. Note: $a and $b are
completely equal here, that's not $a is pointing to $b or vice versa,
[PHP-DOC] #40610 [Opn]: Array changes when missing array element is ref'd (w/ no assignment to array!)
ID: 40610
User updated by: Webbed dot Pete at gmail dot com
Reported By: Webbed dot Pete at gmail dot com
Status: Open
Bug Type: Documentation problem
Operating System: Windows, Linux
PHP Version: 5.2.1
Assigned To: colder
New Comment:
Yes, a single userland function can take care of all but constants.
Here is a robust workaround (if messy and/or slow) for the undocumented
effect described in this bug report (i.e. that PHP creates array
elements and object properties when pass-by-reference is used).
// For PHP4 compatibility...
if (!function_exists('property_exists')) {
function property_exists($obj, $property) {
return array_key_exists($property, get_object_vars($obj));
}
}
// Pass potentially undefined array keys and object property names
separately else they get auto-created
function varset($var,$param,$default='') {
if (!isset($var))return $default;
if (is_scalar($var)) return $var;
if (is_array($var)) return (array_key_exists($param,$var)
isset($var[$param])) ? $var[$param] : $default;
if (is_object($var)) return (property_exists($var,$param)
isset($var-$param)) ? $var-$param : $default;
die('varset used on NULL or resource');
}
Notes:
1) I'll leave the argument to others over whether it is better to have
a single function when scalars have no need for the second parameter.
:)
2) varsettrue() is not replicated here; it simply adds $var,
$var[$param] or $var-$param to the end of each appropriate
test.
3) This example highlights a small inconsistency between
array_key_exists() and property_exists().
Previous Comments:
[2007-02-24 09:54:47] Webbed dot Pete at gmail dot com
If we require a single function, to *fully* emulate 'isset with
default' (with only two parameters), [EMAIL PROTECTED] is correct.
A compromise is currently required involving separate functions or at
least separate parameters that isolate potential array keys or object
property names.
The above emulations are effective userland emulations.
Further emulations are also helpful, such as emulation of '(isset AND
true) with default', which was noted in an earlier comment. This too
can be emulated through a set of functions.
It gets messy to do these workarounds, but the resulting application
code is much cleaner.
Instead of coding
$x = (isset($var) $var) ? $var : $default;
$y = (isset($pref['key']) $pref['key']) ? $pref['key'] : $default;
one can code
$x = varsettrue($var, $default);
$y = arrsettrue($pref,'key',$default);
by creating function varsettrue() as noted above, and now
function arrsettrue($arr,$key,$default='') {
if ( isset($arr) is_array($arr) array_key_exists($key,$arr)
isset($arr[$key]) $arr[$key] ) return $arr[$key];
return $default;
}
The 'mess' is encapsulated in a set of userland functions. This frees
coders to write well-protected code that never generates notices.
Perhaps someday there can be built-in functions that accomplish all
this, but for now at least we know there are effective (if slow/messy)
workarounds. I now believe a single userland function may be possible;
will think on that.
[2007-02-24 09:16:27] [EMAIL PROTECTED]
function foo($a) {}
foo($a); // will create $a
$b = new stdclass;
foo($b-c); // will create the public property c
$d = array();
foo($d['index']); // Will create the array index
In each case, it will be assigned to null. Calling isset will return
false because isset() returns false on variables assigned to NULL.
However, there are other functions like array_key_exist() or
property_exist() that are able to detect the NULL value.
Conclusion: there is simply no solution to effectively emulate the
isset() construct with default value using an user land function.
[2007-02-24 03:20:18] Webbed dot Pete at gmail dot com
Typo on function arrset(). Instead of
... return $val;
it should be
... return $arr[$key];
[2007-02-24 00:38:43] Webbed dot Pete at gmail dot com
When you pass a non-existent variable by reference of course it HAS
to be created, or what do you think should be referenced?
Funny thing is, passing a reference to a non-existent normal variable
works fine. Only array elements require something to be created.
If we accept this as a requirement, I believe we arrive at the
following set of conclusions:
What we're declarng here is that
a) isset() is not identical to is created.
b) A php app has no way to discover if a variable is created.
c) Array elements must be treated distinctly from other variables
whenever the number of created keys is important.
d) For array elements, key references must be carried separately from
value
[PHP-DOC] cvs: phpdoc /en/language references.xml
colder Sat Feb 24 11:19:24 2007 UTC
Modified files:
/phpdoc/en/language references.xml
Log:
Fix #40610 (Undefined variables get defined when used with references)
http://cvs.php.net/viewvc.cgi/phpdoc/en/language/references.xml?r1=1.46r2=1.47diff_format=u
Index: phpdoc/en/language/references.xml
diff -u phpdoc/en/language/references.xml:1.46
phpdoc/en/language/references.xml:1.47
--- phpdoc/en/language/references.xml:1.46 Fri Nov 18 16:20:48 2005
+++ phpdoc/en/language/references.xml Sat Feb 24 11:19:24 2007
@@ -1,5 +1,5 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.46 $ --
+!-- $Revision: 1.47 $ --
chapter id=language.references
titleReferences Explained/title
@@ -49,6 +49,32 @@
This is valid also for arrays passed by value to functions.
/para
/note
+ note
+para
+If you assign, pass or return an undefined variable by reference,
+it will get created.
+ example
+ titleUsing references with undefined variables/title
+ programlisting role=php
+![CDATA[
+?php
+function foo($var) { }
+
+foo($a); // $a is created and assigned to null
+
+$b = array();
+foo($b['b']);
+var_dump(array_key_exists('b', $b)); // bool(true)
+
+$c = new StdClass;
+foo($c-d);
+var_dump(property_exists($c, 'd')); // bool(true)
+?
+]]
+ /programlisting
+ /example
+/para
+ /note
para
The same syntax can be used with functions, that return references,
and with literalnew/literal operator (in PHP 4.0.4 and later):
[PHP-DOC] #40610 [Opn-Csd]: Array changes when missing array element is ref'd (w/ no assignment to array!)
ID: 40610
Updated by: [EMAIL PROTECTED]
Reported By: Webbed dot Pete at gmail dot com
-Status: Open
+Status: Closed
Bug Type: Documentation problem
Operating System: Windows, Linux
PHP Version: 5.2.1
Assigned To: colder
New Comment:
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.
Thank you for the report, and for helping us make our documentation
better.
isset() is a construct that doesn't affect in any way the variable
passed. So no, you can't fully emulate it.
Undefined variables will get created, which will hide potentially
important Undefined * notices.
Previous Comments:
[2007-02-24 11:00:03] Webbed dot Pete at gmail dot com
Yes, a single userland function can take care of all but constants.
Here is a robust workaround (if messy and/or slow) for the undocumented
effect described in this bug report (i.e. that PHP creates array
elements and object properties when pass-by-reference is used).
// For PHP4 compatibility...
if (!function_exists('property_exists')) {
function property_exists($obj, $property) {
return array_key_exists($property, get_object_vars($obj));
}
}
// Pass potentially undefined array keys and object property names
separately else they get auto-created
function varset($var,$param,$default='') {
if (!isset($var))return $default;
if (is_scalar($var)) return $var;
if (is_array($var)) return (array_key_exists($param,$var)
isset($var[$param])) ? $var[$param] : $default;
if (is_object($var)) return (property_exists($var,$param)
isset($var-$param)) ? $var-$param : $default;
die('varset used on NULL or resource');
}
Notes:
1) I'll leave the argument to others over whether it is better to have
a single function when scalars have no need for the second parameter.
:)
2) varsettrue() is not replicated here; it simply adds $var,
$var[$param] or $var-$param to the end of each appropriate
test.
3) This example highlights a small inconsistency between
array_key_exists() and property_exists().
[2007-02-24 09:54:47] Webbed dot Pete at gmail dot com
If we require a single function, to *fully* emulate 'isset with
default' (with only two parameters), [EMAIL PROTECTED] is correct.
A compromise is currently required involving separate functions or at
least separate parameters that isolate potential array keys or object
property names.
The above emulations are effective userland emulations.
Further emulations are also helpful, such as emulation of '(isset AND
true) with default', which was noted in an earlier comment. This too
can be emulated through a set of functions.
It gets messy to do these workarounds, but the resulting application
code is much cleaner.
Instead of coding
$x = (isset($var) $var) ? $var : $default;
$y = (isset($pref['key']) $pref['key']) ? $pref['key'] : $default;
one can code
$x = varsettrue($var, $default);
$y = arrsettrue($pref,'key',$default);
by creating function varsettrue() as noted above, and now
function arrsettrue($arr,$key,$default='') {
if ( isset($arr) is_array($arr) array_key_exists($key,$arr)
isset($arr[$key]) $arr[$key] ) return $arr[$key];
return $default;
}
The 'mess' is encapsulated in a set of userland functions. This frees
coders to write well-protected code that never generates notices.
Perhaps someday there can be built-in functions that accomplish all
this, but for now at least we know there are effective (if slow/messy)
workarounds. I now believe a single userland function may be possible;
will think on that.
[2007-02-24 09:16:27] [EMAIL PROTECTED]
function foo($a) {}
foo($a); // will create $a
$b = new stdclass;
foo($b-c); // will create the public property c
$d = array();
foo($d['index']); // Will create the array index
In each case, it will be assigned to null. Calling isset will return
false because isset() returns false on variables assigned to NULL.
However, there are other functions like array_key_exist() or
property_exist() that are able to detect the NULL value.
Conclusion: there is simply no solution to effectively emulate the
isset() construct with default value using an user land function.
[2007-02-24 03:20:18] Webbed dot Pete at gmail dot com
Typo on function arrset(). Instead of
... return $val;
it should be
... return $arr[$key];
[2007-02-24 00:38:43] Webbed dot Pete at gmail dot com
When you pass a non-existent variable by reference of course
[PHP-DOC] Shorten subjects of PHPDOC commit emails
Hello, everyb. Is it possible to shorten Subjects of commit emails for PHPDOC? To make it easier to see the end of line, i.e. exact file changed. From: [PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions feof.xml To: [PHP-DOC] cvs: /en/reference/filesystem/functions feof.xml The only confusion could be possible if commits were mailed to [PHP-DOC] from different CVS modules, but that is not true. t -- --[ http://wiki.phpdoc.info/DocLinks ]--
[PHP-DOC] #37784 [Bgs-Csd]: CHM file size is too small
ID: 37784 Updated by: [EMAIL PROTECTED] Reported By: tomkraw at po dot onet dot pl -Status: Bogus +Status: Closed Bug Type: Documentation problem Operating System: Windows PHP Version: Irrelevant New Comment: Thank you for your bug report. This issue has already been fixed in the latest released version of PHP, which you can download at http://www.php.net/downloads.php Previous Comments: [2006-07-03 21:28:27] [EMAIL PROTECTED] Yes, we are aware of the problem and we are working on it. [2006-07-03 21:20:33] tomkraw at po dot onet dot pl Polish downloadable chm file has no content. Probably compilation error has occured. [2006-06-12 09:55:18] [EMAIL PROTECTED] Please do not submit the same bug more than once. An existing bug report already describes this very problem. Even if you feel that your issue is somewhat different, the resolution is likely to be the same. Thank you for your interest in PHP. . [2006-06-12 09:50:23] tomkraw at po dot onet dot pl Description: Polish chm help file has only 400kb size and has no content, while English has 6,58MB. -- Edit this bug report at http://bugs.php.net/?id=37784edit=1
[PHP-DOC] #34885 [Opn-Fbk]: The Spanish Windows HTML Help (chm) brokes chars like �
ID: 34885 Updated by: [EMAIL PROTECTED] Reported By: ariel at doors dot com dot ar -Status: Open +Status: Feedback Bug Type: Documentation problem Operating System: Windows XP PHP Version: Irrelevant New Comment: Could you confirm that bug still exists? Previous Comments: [2005-10-17 21:53:58] ariel at doors dot com dot ar I will leave it open, but the french problem was solved. The issue has changed. [2005-10-17 21:09:18] [EMAIL PROTECTED] leave it open then. [2005-10-17 01:39:04] ariel at doors dot com dot ar It is fixed now. As nlopess at php dot net said, the only problem now is that chars like éàç are broken. Thank you. [2005-10-16 22:17:33] [EMAIL PROTECTED] Yeah, and I can't test anything after they're build as windows refuses to show them correctly... and people keep messing with the build system too... highly annoying. [2005-10-16 21:12:43] [EMAIL PROTECTED] As far as I could see it isn't in French.. The only problem I«m seeing is that the TOC is in UTF-8, but is beeing displayed as iso-8859-1 (so, chars like éàç are broken). The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/34885 -- Edit this bug report at http://bugs.php.net/?id=34885edit=1
[PHP-DOC] #40590 [Bgs-Opn]: list($k,$v) = $v; gives unexpected output
ID: 40590
User updated by: black at scene-si dot org
Reported By: black at scene-si dot org
-Status: Bogus
+Status: Open
-Bug Type: Variables related
+Bug Type: Documentation problem
Operating System: linux
PHP Version: 5.2.1
New Comment:
Consider fixing the documentation, to reflect this expected
behaviour. I changed the category to documentation problem and status
back to open.
Regards,
Tit
Previous Comments:
[2007-02-24 15:09:24] [EMAIL PROTECTED]
Thank you for taking the time to write to us, but this is not
a bug. Please double-check the documentation available at
http://www.php.net/manual/ and the instructions on how to report
a bug at http://bugs.php.net/how-to-report.php
In PHP 5 this is the expected behavior.
[2007-02-22 13:26:58] black at scene-si dot org
Description:
list() overwriting variable, unexpected result (different from php4).
Reproduce code:
---
$v = array(00,-- Day --);
list($k,$v) = $v;
var_dump(array($k,$v));
Expected result:
Var dump should return:
array(2) {
[0]= string(2) 00
[1]= string(11) -- Day --
}
Actual result:
--
Var dump returns:
array(2) {
[0]= string(1) -
[1]= string(11) -- Day --
}
--
Edit this bug report at http://bugs.php.net/?id=40590edit=1
[PHP-DOC] #40590 [Opn-Bgs]: list($k,$v) = $v; gives unexpected output
ID: 40590
Updated by: [EMAIL PROTECTED]
Reported By: black at scene-si dot org
-Status: Open
+Status: Bogus
Bug Type: Documentation problem
Operating System: linux
PHP Version: 5.2.1
New Comment:
This is already documented in function.list:
list() assigns the values starting with the right-most parameter. If
you are using plain variables, you don't have to worry about this. But
if you are using arrays with indices you usually expect the order of
the indices in the array the same you wrote in the list() from left to
right; which it isn't. It's assigned in the reverse order.
$v is being assigned in the first assignment of the list(). When that
new $v is used to calculate $k, you're getting the string.
S
Previous Comments:
[2007-02-24 15:17:28] black at scene-si dot org
Consider fixing the documentation, to reflect this expected
behaviour. I changed the category to documentation problem and status
back to open.
Regards,
Tit
[2007-02-24 15:09:24] [EMAIL PROTECTED]
Thank you for taking the time to write to us, but this is not
a bug. Please double-check the documentation available at
http://www.php.net/manual/ and the instructions on how to report
a bug at http://bugs.php.net/how-to-report.php
In PHP 5 this is the expected behavior.
[2007-02-22 13:26:58] black at scene-si dot org
Description:
list() overwriting variable, unexpected result (different from php4).
Reproduce code:
---
$v = array(00,-- Day --);
list($k,$v) = $v;
var_dump(array($k,$v));
Expected result:
Var dump should return:
array(2) {
[0]= string(2) 00
[1]= string(11) -- Day --
}
Actual result:
--
Var dump returns:
array(2) {
[0]= string(1) -
[1]= string(11) -- Day --
}
--
Edit this bug report at http://bugs.php.net/?id=40590edit=1
[PHP-DOC] cvs: phpdoc /en/language references.xml
colder Sat Feb 24 20:14:49 2007 UTC Modified files: /phpdoc/en/language references.xml Log: Remove bogous warning http://cvs.php.net/viewvc.cgi/phpdoc/en/language/references.xml?r1=1.47r2=1.48diff_format=u Index: phpdoc/en/language/references.xml diff -u phpdoc/en/language/references.xml:1.47 phpdoc/en/language/references.xml:1.48 --- phpdoc/en/language/references.xml:1.47 Sat Feb 24 11:19:24 2007 +++ phpdoc/en/language/references.xml Sat Feb 24 20:14:49 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.47 $ -- +!-- $Revision: 1.48 $ -- chapter id=language.references titleReferences Explained/title @@ -168,32 +168,6 @@ /example /para /note - warning -para - Complex arrays are sometimes rather copied than referenced. Thus following - example will not work as expected. - example - titleReferences with complex arrays/title - programlisting role=php -![CDATA[ -?php -$top = array( -'A' = array(), -'B' = array( -'B_b' = array(), -), -); - -$top['A']['parent'] = $top; -$top['B']['parent'] = $top; -$top['B']['B_b']['data'] = 'test'; -print_r($top['A']['parent']['B']['B_b']); // array() -? -]] - /programlisting - /example -/para - /warning para The second thing references do is to pass variables by-reference. This is done by making a local variable in a function and
[PHP-DOC] cvs: phpdoc /en/appendices ini.xml
dmytton Sat Feb 24 20:42:20 2007 UTC Modified files: /phpdoc/en/appendices ini.xml Log: Fixed #40614 Incorrect memory_limit documentation http://cvs.php.net/viewvc.cgi/phpdoc/en/appendices/ini.xml?r1=1.48r2=1.49diff_format=u Index: phpdoc/en/appendices/ini.xml diff -u phpdoc/en/appendices/ini.xml:1.48 phpdoc/en/appendices/ini.xml:1.49 --- phpdoc/en/appendices/ini.xml:1.48 Fri Feb 9 15:56:07 2007 +++ phpdoc/en/appendices/ini.xmlSat Feb 24 20:42:20 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.48 $ -- +!-- $Revision: 1.49 $ -- appendix id=ini titlephp.ini; directives/title @@ -2834,9 +2834,9 @@ para This sets the maximum amount of memory in bytes that a script is allowed to allocate. This helps prevent poorly written -scripts for eating up all available memory on a server. In order to -use this directive you must have enabled it at compile time. So, -your configure line would have included: +scripts for eating up all available memory on a server. Prior to +PHP 5.2.1, in order to use this directive you must have enabled +it at compile time. So, your configure line would have included: option role=configure--enable-memory-limit/option. Note that you have to set it to -1 if you don't want any limit for your memory. /para
[PHP-DOC] #40614 [Opn-Csd]: Incorrect memory_limit documentation
ID: 40614 Updated by: [EMAIL PROTECTED] Reported By: php at rebby dot com -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: Slackware Linux PHP Version: Irrelevant New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: [2007-02-23 21:06:19] php at rebby dot com Description: The documentation for the behavior of the memory_limit directive is incorrect for PHP 5.2.1. On http://www.php.net/manual/en/ini.core.php it is still noted: snip In order to use this directive you must have enabled it at compile time. So, your configure line would have included: --enable-memory-limit. /snip As of 5.2.1 this is no longer the case since the --enable-memory-limit was removed from the configure script and is now the default. -- Edit this bug report at http://bugs.php.net/?id=40614edit=1
[PHP-DOC] cvs: phpdoc /en/reference/image reference.xml
dmytton Sat Feb 24 20:57:32 2007 UTC Modified files: /phpdoc/en/reference/image reference.xml Log: Applied patch in #40525 http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/reference.xml?r1=1.29r2=1.30diff_format=u Index: phpdoc/en/reference/image/reference.xml diff -u phpdoc/en/reference/image/reference.xml:1.29 phpdoc/en/reference/image/reference.xml:1.30 --- phpdoc/en/reference/image/reference.xml:1.29Sun Jan 21 15:13:40 2007 +++ phpdoc/en/reference/image/reference.xml Sat Feb 24 20:57:32 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.29 $ -- +!-- $Revision: 1.30 $ -- !-- Purpose: utilspec.image -- !-- Membership: bundled -- @@ -102,7 +102,13 @@ row entryliteraljpeg-6b/literal/entry entryulink url=url.jpeg;url.jpeg;/ulink/entry - entry/entry + entry + When buliding the jpeg-v6b library (prior to building PHP) you + must use the option role=configure--enable-shared/option + option in the configure step. If you do not, you will receive + an error saying literallibjpeg.(a|so) not found/literal + when you get to the configure step of building PHP. + /entry /row row entryliteralpng/literal/entry
[PHP-DOC] #40525 [Opn-Csd]: PATCH: building libjpeg with enable-shared required
ID: 40525 Updated by: [EMAIL PROTECTED] Reported By: danielc at analysisandsolutions dot com -Status: Open +Status: Closed Bug Type:Documentation problem PHP Version: Irrelevant New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: [2007-02-17 20:34:02] danielc at analysisandsolutions dot com Description: Patch to explain options PHP needs when building libjpeg: http://www.analysisandsolutions.com/php/image.jpeg.option.diff -- Edit this bug report at http://bugs.php.net/?id=40525edit=1
[PHP-DOC] #40522 [Opn-Csd]: PATCH: reword encoding param note in mb-strrpos
ID: 40522 Updated by: [EMAIL PROTECTED] Reported By: danielc at analysisandsolutions dot com -Status: Open +Status: Closed Bug Type:Documentation problem PHP Version: Irrelevant New Comment: Your description in the patch was a little too verbose so I have reworded it myself. Previous Comments: [2007-02-17 18:16:59] danielc at analysisandsolutions dot com Description: The note for the encoding parameter in the mb-strrpos documentation is ambiguous to me. It can be mistakenly interpreted as meaning that the parameter was added in 5.2 when in reality it's behavior was modified. http://www.analysisandsolutions.com/php/mb-strrpos.encoding.explanation.diff -- Edit this bug report at http://bugs.php.net/?id=40522edit=1
[PHP-DOC] cvs: phpdoc /en/reference/mbstring/functions mb-strrpos.xml
dmytton Sat Feb 24 21:12:24 2007 UTC Modified files: /phpdoc/en/reference/mbstring/functions mb-strrpos.xml Log: Missed space in previous commit http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mbstring/functions/mb-strrpos.xml?r1=1.4r2=1.5diff_format=u Index: phpdoc/en/reference/mbstring/functions/mb-strrpos.xml diff -u phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.4 phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.5 --- phpdoc/en/reference/mbstring/functions/mb-strrpos.xml:1.4 Sat Feb 24 21:09:25 2007 +++ phpdoc/en/reference/mbstring/functions/mb-strrpos.xml Sat Feb 24 21:12:24 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.4 $ -- +!-- $Revision: 1.5 $ -- !-- splitted from ./en/functions/mbstring.xml, last change in rev 1.1 -- refentry id=function.mb-strrpos refnamediv @@ -50,7 +50,7 @@ /note note simpara - As of PHP 5.2.0, for back compatibility,parameterencoding/parameter + As of PHP 5.2.0, for back compatibility, parameterencoding/parameter can be specified as the third parameter. However, doing so is deprecated and will be removed from a future release of PHP. /simpara
[PHP-DOC] #40520 [Opn-Csd]: PATCH: wrong id in migration5.xml
ID: 40520 Updated by: [EMAIL PROTECTED] Reported By: danielc at analysisandsolutions dot com -Status: Open +Status: Closed Bug Type:Documentation problem PHP Version: Irrelevant New Comment: Thank you for taking the time to write to us, but this is not a bug. Please double-check the documentation available at http://www.php.net/manual/ and the instructions on how to report a bug at http://bugs.php.net/how-to-report.php Previous Comments: [2007-02-17 18:10:46] danielc at analysisandsolutions dot com Description: Error Reporting section has incorrect id attribute. http://www.analysisandsolutions.com/php/migration5.id.diff -- Edit this bug report at http://bugs.php.net/?id=40520edit=1
[PHP-DOC] #40523 [Opn]: PATCH: various new parameters in 5.2
ID: 40523 Updated by: [EMAIL PROTECTED] Reported By: danielc at analysisandsolutions dot com Status: Open Bug Type:Documentation problem PHP Version: Irrelevant New Comment: This sort of change must simultaneously be indicated via each functions changelog role (and parameter listing) otherwise it'll cause some confusion and/or be forgotten. Previous Comments: [2007-02-17 18:23:26] danielc at analysisandsolutions dot com Description: There are a few parameters added in PHP 5.2 have not been documented yet. Here's a patch adding them to the function signatures. While we'll still need to get someone to add the explanation for these parameters, this is a start and an indicator of what's needed. http://www.analysisandsolutions.com/php/parameters.52.diff -- Edit this bug report at http://bugs.php.net/?id=40523edit=1
[PHP-DOC] cvs: phpdoc /en/reference/stream/functions stream-socket-client.xml
dmytton Sat Feb 24 21:32:28 2007 UTC Modified files: /phpdoc/en/reference/stream/functions stream-socket-client.xml Log: Added note about timeout with async. Closes #40517 http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/stream/functions/stream-socket-client.xml?r1=1.13r2=1.14diff_format=u Index: phpdoc/en/reference/stream/functions/stream-socket-client.xml diff -u phpdoc/en/reference/stream/functions/stream-socket-client.xml:1.13 phpdoc/en/reference/stream/functions/stream-socket-client.xml:1.14 --- phpdoc/en/reference/stream/functions/stream-socket-client.xml:1.13 Wed Nov 10 08:30:45 2004 +++ phpdoc/en/reference/stream/functions/stream-socket-client.xml Sat Feb 24 21:32:27 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.13 $ -- +!-- $Revision: 1.14 $ -- refentry id=function.stream-socket-client refnamediv refnamestream_socket_client/refname @@ -46,6 +46,12 @@ connecting the socket. /simpara /note +note + simpara + The timeout parameter only applies if you are not making an asynchronous + connection attempt. + /simpara +/note para functionstream_socket_client/function returns a stream resource which may
[PHP-DOC] #40517 [Opn-Csd]: async connections do not obey connect timeout
ID: 40517
Updated by: [EMAIL PROTECTED]
Reported By: djgrrr+phpbugs at p2p-network dot net
-Status: Open
+Status: Closed
Bug Type: Documentation problem
Operating System: Linux 2.6
PHP Version: 5.2.1
New Comment:
A note has been added to the documentation about the timeout parameter.
Previous Comments:
[2007-02-20 17:32:52] djgrrr+phpbugs at p2p-network dot net
you completely missed my point..
stream_select() should return the failed aysnc connections as readable
connections after the timeout parameter has elapsed. I know for a fact
that this can be done, and its not hard to implement either.
Also, i use stream_get_meta_data() because feof() has a bug where it
locks up randomly for no reason, where as stream_get_meta_data() does
not. Don't try to tell me my code is flawed when i know its not.
[2007-02-20 16:01:24] [EMAIL PROTECTED]
The timeout parameter for stream_socket_client() only applies if you
are not making an async connection attempt. When you ask for an async
connection attempt, the function returns immediately and so cannot
possibly wait for the connection timeout interval.
The correct way to detect whether an async connection has completed is
to use stream_select() and wait for the socket to become readable. If
reading from that socket gives you an error, then the connection
attempt failed.
Also note that you really should not be using stream_get_meta_data() to
determine anything about the status of a network connection unless you
understand exactly how the PHP streams internals function. The manual
states this very clearly--your code is broken if you use it for any
kind of logic in your script.
Making this into a documentation problem.
[2007-02-19 13:18:34] djgrrr+phpbugs at p2p-network dot net
?php
$host = 'tcp://72.232.216.58:56004';
$sock = stream_socket_client($host, $errno, $err, 5,
(STREAM_CLIENT_CONNECT | STREAM_CLIENT_ASYNC_CONNECT));
stream_set_blocking($sock, false);
while (isset($sock)) {
$r = array($sock);
$w = $e = NULL;
stream_select($r, $w, $e, 1, 0);
if (count($r) 0) {
echo Ready to read:\n;
foreach($r as $rr) {
$md = stream_get_meta_data($rr);
var_dump($md, feof($rr), fgets($rr));
fclose($rr);
unset($sock);
echo $host.\n;
}
}
}
?
The above code should cause the stream_select to return a readable
connection after 5 seconds (in reality it takes around 3 minutes),
which when read from will return false, indicating its a failed
connection attempt. It would be nice if eof was set on the stream,
because the stream technically is at its end (although i'm not sure if
that would affect the use of stream_select or not).
[2007-02-19 09:46:08] [EMAIL PROTECTED]
Thank you for this bug report. To properly diagnose the problem, we
need a short but complete example script to be able to reproduce
this bug ourselves.
A proper reproducing script starts with ?php and ends with ?,
is max. 10-20 lines long and does not require any external
resources such as databases, etc. If the script requires a
database to demonstrate the issue, please make sure it creates
all necessary tables, stored procedures etc.
Please avoid embedding huge scripts into the report.
[2007-02-17 16:05:43] djgrrr+phpbugs at p2p-network dot net
Description:
when using stream_socket_client() with the flags (STREAM_CLIENT_CONNECT
| STREAM_CLIENT_ASYNC_CONNECT), the async connection does not obey the
timeout parameter.
Also, when the connection does time out (after around 3 minutes) it
does not set the eof flag; although it does return false if you try to
read from the connection, it would also make a lot of sense if the eof
flag was also set on the resource, so calls to feof() return true.
--
Edit this bug report at http://bugs.php.net/?id=40517edit=1
[PHP-DOC] #37926 [Opn-Bgs]: Session var don't get setted
ID: 37926 Updated by: [EMAIL PROTECTED] Reported By: thomas at ecommerce dot com -Status: Open +Status: Bogus Bug Type:Documentation problem PHP Version: 5.x New Comment: As described above, adding a note is not appropriate as it will more than likely add confusion. Previous Comments: [2006-11-07 14:08:53] mjwindsorREMOVE at CAPShotmail dot com I do not agree that this is a documentation problem, or that describing it as expected behaviour is a suitable response. If PHP is a robust language, it cannot have unexpected and obscure rules applied at random. $_SESSION should just be an array that persists between page requests, providing session_start() has been called: that is what everyone expects and that is how it is used. In every other case, $new_array = $existing_array; is a value assignment and simply copies one array to another and no alteration is made or should be expected to $existing_array or its properties. I have spent several days trying to work out why my sessions werent working as I expected and taken up the time of several helpful posters in various fora. I finally tracked the problem down to this issue and some code included in every page of a widely used forum; an otherwise robust and secure open source product. I seriously doubt that a note in the documentation would have saved me much of this work and none of the work needed to get around the issue, once it was identified. This will apply equally to all those who fall foul of this problem you need to know what the problem is before searches will turn up documentation. Mike [2006-07-06 11:18:36] [EMAIL PROTECTED] We welcome a patch from you. I however don't see the need to document it, will only add confusion. [2006-07-06 10:25:55] thomas at ecommerce dot com Updated information that this is general [2006-07-06 10:20:27] thomas at ecommerce dot com Any status update on this bug??? Not hard to add in documentation -.- [2006-06-30 09:54:15] thomas at ecommerce dot com So, does this get fixed at least in the documentation? :) I still don't understand why this can't get fixed, a lot of user crys because of the 'magic feature' of the session and such problems. The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/37926 -- Edit this bug report at http://bugs.php.net/?id=37926edit=1
[PHP-DOC] #38309 [Opn-Bgs]: SoapServer doesn't seem capable of processing SOAP Headers
ID: 38309 Updated by: [EMAIL PROTECTED] Reported By: hummel at channeladvisor dot de -Status: Open +Status: Bogus Bug Type: Documentation problem Operating System: Windows PHP Version: 5.1.4 New Comment: Processing headers is nothing to do with addFunction(). This isn't really a documentation issue because there is no function to process headers. I'm going to close this as a documentation issue. If you want to request it as a feature, reopen as a feature request. Previous Comments: [2006-08-03 13:13:34] hummel at channeladvisor dot de On the documentation page http://de2.php.net/manual/en/function.soap-soapserver-addfunction.php add the following note below the existing note: Note: You cannot process SOAP headers using addFunction. The only way to process SOAP headers is to extract them via $HTTP_RAW_POST_DATA and process them before calling SoapServer-handle(). [2006-08-03 13:00:51] [EMAIL PROTECTED] Please explain - what exactly should be documented? The fact that there is no such function? [2006-08-03 12:34:15] hummel at channeladvisor dot de Dear Tony, after reading my initial request, it is certainly clear what my request was. However, it should be documented that processing SoapHeaders within a SoapServer is not possible. [2006-08-03 12:22:31] [EMAIL PROTECTED] If it's not documented - it is not possible. Please express your thoughts more clearly next time. Thank you. [2006-08-03 12:06:16] hummel at channeladvisor dot de I guess my request was not clear. A developer can register SOAP functions via calling $server = new SoapServer(somewsdl); $server-addFunction(functionname); but there seems no method to do $server-addHeaderFunction(headerfunctionname); Given my example above, I want to process the header RequesterCredentials, so I would have to do something like $server-addHeaderFunction(RequesterCredentials); It is not documented wether header processing is possible using SoapServer or not. The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/38309 -- Edit this bug report at http://bugs.php.net/?id=38309edit=1
[PHP-DOC] #39453 [Opn-Bgs]: Misleading note in ODBC Functions (Unified)
ID: 39453 Updated by: [EMAIL PROTECTED] Reported By: nick dot gorham at easysoft dot com -Status: Open +Status: Bogus Bug Type:Documentation problem PHP Version: Irrelevant New Comment: This note is specific to the databases mentioned - Adabas D, IBM DB2, iODBC, Solid, and Sybase SQL Anywhere and whilst it says enables you to use any ODBC-compliant drivers with your PHP applications imo it doesn't imply that it is the only method. Feel free to submit a patch if you think you can reword it so it is clearer. Previous Comments: [2007-01-22 09:30:45] nick dot gorham at easysoft dot com Maybe I am going mad then. If I look at the page to be found at http://uk2.php.net/manual/en/ref.uodbc.php The third paragraph from the top contains the following Note: There is no ODBC involved when connecting to the above databases. The functions that you use to speak natively to them just happen to share the same names and syntax as the ODBC functions. The exception to this is iODBC. Building PHP with iODBC support enables you to use any ODBC-compliant drivers with your PHP applications. iODBC is maintained by OpenLink Software. More information on iODBC, as well as a HOWTO, is available at www.iodbc.org. Its not a user contributed note, its in the body of the text. [2007-01-22 01:57:15] [EMAIL PROTECTED] We cannot find the note you are referring to. Maybe it was a user contributed note (and it was deleted). = Closed. [2006-11-14 09:35:38] nick dot gorham at easysoft dot com I see the note on the top of the page here. http://uk.php.net/manual/en/ref.uodbc.php we can't possible accommodate users who don't set permissions properly (and decide to rebuild PHP). Ok, thats always your decision, but the problem I see in this case is its the note that was the reason the user decided to rebuild PHP, as it gave the indication that to do what he wanted to do, a rebuild was required replacing unixODBC with iODBC [2006-11-11 18:08:40] [EMAIL PROTECTED] Which note do you mean? The note I see doesn't say the same thing you indicate, but I might be just missing it. Also, while your documentation problem may be justified, we can't possible accommodate users who don't set permissions properly (and decide to rebuild PHP). [2006-11-09 17:14:27] nick dot gorham at easysoft dot com Description: On the Unified ODBC doc page, there is a note at the top that indicates that iODBC is the way to use ODBC via PHP. The problem with this (IMHO), is that it seems to be suggesting that iODBC is the only way. Of course unixODBC is still supported in the build, and last time I looked that was what most linux distribs came with. I have just had a user, causing himeself all sorts of problems, as he decided he needed to rebuild his copy of PHP because it was supplied built with unixODBC, and he needed to change to iODBC. That wasn't his problem at all, it was actually a permissions problem. -- Edit this bug report at http://bugs.php.net/?id=39453edit=1
[PHP-DOC] #40519 [Opn-Asn]: Migrating from PHP 5.1 to PHP 5.2
ID: 40519 Updated by: [EMAIL PROTECTED] Reported By: danielc at analysisandsolutions dot com -Status: Open +Status: Assigned Bug Type:Documentation problem PHP Version: Irrelevant -Assigned To: +Assigned To: philip New Comment: This has not been forgotten, I'm going through it making minor modifications and will commit... sometime. :) Previous Comments: [2007-02-17 20:20:51] danielc at analysisandsolutions dot com I updated the file a moment ago to fix some XML errors. [2007-02-17 18:08:43] danielc at analysisandsolutions dot com Description: Appendix entry for migrating to PHP 5.2 http://www.analysisandsolutions.com/php/migration52.xml -- Edit this bug report at http://bugs.php.net/?id=40519edit=1
[PHP-DOC] cvs: phpdoc / TODO manual.xml.in /RFC manual.xml.in /chm make_chm.php /en language-defs.ent preface.xml /phpbook/phpbook-dsssl html-locale.dsl.in /phpbook/phpbook-xsl htmlhelp.xsl
philip Sat Feb 24 22:59:43 2007 UTC Modified files: /phpdoc TODO manual.xml.in /phpdoc/RFC manual.xml.in /phpdoc/chm make_chm.php /phpdoc/en language-defs.ent preface.xml /phpdoc/phpbook/phpbook-xsl htmlhelp.xsl /phpdoc/phpbook/phpbook-dsssl html-locale.dsl.in Log: Removed the word appendixes from the manual (in favor of appendices), this is in accordance to our nomenclature http://cvs.php.net/viewvc.cgi/phpdoc/TODO?r1=1.60r2=1.61diff_format=u Index: phpdoc/TODO diff -u phpdoc/TODO:1.60 phpdoc/TODO:1.61 --- phpdoc/TODO:1.60Sat Nov 4 14:15:15 2006 +++ phpdoc/TODO Sat Feb 24 22:59:43 2007 @@ -59,7 +59,7 @@ - split install.configure.misc.xml, config.xml and maybe other huge files to manageable pieces - see: en/reference/rsusi.txt for progress - - get back lost indexes, but add them as appendixes + - get back lost indexes, but add them as appendices (index of tables, index of examples, index of config options) - merge back build system/style sheet improvements from phpGtk and pear manual (hartmut) http://cvs.php.net/viewvc.cgi/phpdoc/manual.xml.in?r1=1.215r2=1.216diff_format=u Index: phpdoc/manual.xml.in diff -u phpdoc/manual.xml.in:1.215 phpdoc/manual.xml.in:1.216 --- phpdoc/manual.xml.in:1.215 Mon Jan 22 15:59:32 2007 +++ phpdoc/manual.xml.inSat Feb 24 22:59:43 2007 @@ -2,7 +2,7 @@ !DOCTYPE book PUBLIC -//OASIS//DTD DocBook XML V4.5//EN @srcdir@/docbook/docbook-xml/docbookx.dtd [ -!-- $Revision: 1.215 $ -- +!-- $Revision: 1.216 $ -- !-- Add translated specific definitions and snippets -- !ENTITY % language-defs SYSTEM @srcdir@/@LANGDIR@/language-defs.ent @@ -153,8 +153,8 @@ faq.misc; /part - part id=appendixes - titleAppendixes;/title + part id=appendices + titleAppendices;/title appendices.history; appendices.migration5; appendices.migration4; http://cvs.php.net/viewvc.cgi/phpdoc/RFC/manual.xml.in?r1=1.19r2=1.20diff_format=u Index: phpdoc/RFC/manual.xml.in diff -u phpdoc/RFC/manual.xml.in:1.19 phpdoc/RFC/manual.xml.in:1.20 --- phpdoc/RFC/manual.xml.in:1.19 Fri Nov 12 08:50:18 2004 +++ phpdoc/RFC/manual.xml.inSat Feb 24 22:59:43 2007 @@ -2,7 +2,7 @@ !DOCTYPE book PUBLIC -//PHPDocGroup//DTD DocBook XML V4.1.2-Based Variant PHPBook V1.1//EN @srcdir@/dtds/phpbook.dtd [ -!-- $Revision: 1.19 $ -- !-- Last updated to comply to manual.xml.in 1.189 -- +!-- $Revision: 1.20 $ -- !-- Last updated to comply to manual.xml.in 1.189 -- !-- Add translated specific definitions and snippets -- !ENTITY % language-defs SYSTEM @srcdir@/@LANGDIR@/language-defs.ent @@ -402,8 +402,8 @@ faq.misc; /part - part id=appendixes - titleAppendixes;/title + part id=appendices + titleAppendices;/title appendices.history; appendices.migration5; appendices.migration4; http://cvs.php.net/viewvc.cgi/phpdoc/chm/make_chm.php?r1=1.25r2=1.26diff_format=u Index: phpdoc/chm/make_chm.php diff -u phpdoc/chm/make_chm.php:1.25 phpdoc/chm/make_chm.php:1.26 --- phpdoc/chm/make_chm.php:1.25Sun Sep 4 10:48:50 2005 +++ phpdoc/chm/make_chm.php Sat Feb 24 22:59:43 2007 @@ -27,7 +27,7 @@ funcref.html, internals.html, faq.html, -appendixes.html +appendices.html ); // Header for index and toc http://cvs.php.net/viewvc.cgi/phpdoc/en/language-defs.ent?r1=1.29r2=1.30diff_format=u Index: phpdoc/en/language-defs.ent diff -u phpdoc/en/language-defs.ent:1.29 phpdoc/en/language-defs.ent:1.30 --- phpdoc/en/language-defs.ent:1.29Wed Sep 6 20:40:36 2006 +++ phpdoc/en/language-defs.ent Sat Feb 24 22:59:43 2007 @@ -1,4 +1,4 @@ -!-- $Revision: 1.29 $ -- +!-- $Revision: 1.30 $ -- !-- Part titles used mostly in manual.xml itself -- !ENTITY PHPManual PHP Manual @@ -12,7 +12,7 @@ !ENTITY FunctionReference Function Reference !ENTITY PECLReference PECL Function Reference !ENTITY AddOnReferenceAddon Extension Function Reference -!ENTITY AppendixesAppendixes +!ENTITY AppendicesAppendices !ENTITY PEAR PEAR: the PHP Extension and Application Repository !ENTITY FAQ FAQ: Frequently Asked Questions !ENTITY FAQabbrev FAQ http://cvs.php.net/viewvc.cgi/phpdoc/en/preface.xml?r1=1.32r2=1.33diff_format=u Index: phpdoc/en/preface.xml diff -u phpdoc/en/preface.xml:1.32 phpdoc/en/preface.xml:1.33 --- phpdoc/en/preface.xml:1.32 Thu Feb 15 09:24:33 2007 +++ phpdoc/en/preface.xml Sat Feb 24 22:59:43 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.32 $ -- +!-- $Revision: 1.33 $ -- preface id=preface titlePreface/title @@ -21,7 +21,7 @@ function reference/link, but also contains a link linkend=langreflanguage reference/link, explanations of some of PHP's major link linkend=featuresfeatures/link, - and other link linkend=appendixessupplemental/link + and other link linkend=appendicessupplemental/link
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions eval.xml
takagi Sun Feb 25 01:51:37 2007 UTC Modified files: /phpdoc/en/reference/misc/functions eval.xml Log: typo. http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/misc/functions/eval.xml?r1=1.18r2=1.19diff_format=u Index: phpdoc/en/reference/misc/functions/eval.xml diff -u phpdoc/en/reference/misc/functions/eval.xml:1.18 phpdoc/en/reference/misc/functions/eval.xml:1.19 --- phpdoc/en/reference/misc/functions/eval.xml:1.18Mon Feb 19 00:03:13 2007 +++ phpdoc/en/reference/misc/functions/eval.xml Sun Feb 25 01:51:37 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.18 $ -- +!-- $Revision: 1.19 $ -- refentry id=function.eval refnamediv refnameeval/refname @@ -39,7 +39,7 @@ termparametercode_str/parameter/term listitem para - The code string to be avaluated. + The code string to be evaluated. parametercode_str/parameter does not have to contain link linkend=language.basic-syntax.phpmodePHP Opening tags/link. /para
[PHP-DOC] #40520 [Csd-Opn]: PATCH: wrong id in migration5.xml
ID: 40520 User updated by: danielc at analysisandsolutions dot com Reported By: danielc at analysisandsolutions dot com -Status: Closed +Status: Open Bug Type:Documentation problem PHP Version: Irrelevant New Comment: Hi David: The name of the file and the id in the root element is migration5. The standard is to use that as the base of all id's throughout the document. So how is using migrating5 in the errorrep id not a bug? Previous Comments: [2007-02-24 21:20:16] [EMAIL PROTECTED] Thank you for taking the time to write to us, but this is not a bug. Please double-check the documentation available at http://www.php.net/manual/ and the instructions on how to report a bug at http://bugs.php.net/how-to-report.php [2007-02-17 18:10:46] danielc at analysisandsolutions dot com Description: Error Reporting section has incorrect id attribute. http://www.analysisandsolutions.com/php/migration5.id.diff -- Edit this bug report at http://bugs.php.net/?id=40520edit=1
[PHP-DOC] #40522 [Csd-Opn]: PATCH: reword encoding param note in mb-strrpos
ID: 40522 User updated by: danielc at analysisandsolutions dot com Reported By: danielc at analysisandsolutions dot com -Status: Closed +Status: Open Bug Type:Documentation problem PHP Version: Irrelevant New Comment: Hi David: Please switch back to backward in the phrase for back compatibility. In addition, I feel the reworded explanation that got committed is just juggling around the old explanation. While this is clearer, it's not crystal clear. Previous Comments: [2007-02-24 21:10:08] [EMAIL PROTECTED] Your description in the patch was a little too verbose so I have reworded it myself. [2007-02-17 18:16:59] danielc at analysisandsolutions dot com Description: The note for the encoding parameter in the mb-strrpos documentation is ambiguous to me. It can be mistakenly interpreted as meaning that the parameter was added in 5.2 when in reality it's behavior was modified. http://www.analysisandsolutions.com/php/mb-strrpos.encoding.explanation.diff -- Edit this bug report at http://bugs.php.net/?id=40522edit=1
