Re: [PHP-DOC] Broken URL entities report
On Tue, Aug 09, 2011 at 08:00:01AM -0400, phpdoc@lists.php.net wrote: > Hello PHP Documentation team, > > Below is a list of URL entities that are experiencing fatal errors: > > UNKNOWN_HOST > - &url.pgsql.techdocs; : http://techdocs.postgresql.org/ > - &url.omnihttpd; : http://www.omnicron.ca/ > > > HTTP_NOT_FOUND > - &url.zend.future; : http://www.zend.com/zend/future.php > - &url.yacl; : http://www.sellsbrothers.com/links/dbox/yacl.zip > - &url.win32.build-libs; : > http://pecl2.php.net/downloads/php-windows-builds/php-libs/ > - &url.win32.binary-tools; : > http://pecl2.php.net/downloads/php-windows-builds/php-libs/binary-tools.zip > - &url.iiscfg; : http://www.genusa.com/iis/iiscfg.html > - &url.pecl.win.ext; : http://pecl4win.php.net/ext.php/ > - &url.pecl.timezonedb.dll; : > http://pecl4win.php.net/ext.php/php_timezonedb.dll > - &url.pecl.get.win.php5.0; : http://snaps.php.net/win32/PECL_5_0/ > - &url.pecl.get.win.php4.3; : http://snaps.php.net/win32/PECL_4_3/ > - &url.pecl.get.win.unstable; : http://snaps.php.net/win32/PECL_UNSTABLE/ > - &url.pecl.get.win; : http://snaps.php.net/win32/PECL_STABLE/ > - &url.openbsd.ports; : http://www.openbsd.org/ports.html > - &url.mongodb.ubuntu.9.04; : > http://javierav.com/articulos/php/2009-10-instalando-mongodb-driver-php-en-ubuntu-9-04 > - &url.ldap.mt; : http://fresh.t-systems-sfr.com/unix/src/misc/ldap-3.3.tar.Z > - &url.kadm5; : http://oss.gonicus.de/project/?group_id=7 > - &url.jpeg; : http://pecl2.php.net/downloads/php-windows-builds/source/ > - &url.freeodbc; : http://www.jepstone.net/FreeODBC/ > - &url.dcom.update; : > http://download.microsoft.com/msdownload/dcom/95/x86/en/dcom95.exe > - &url.dbstyle; : http://docbook.sourceforge.net/projects/dsssl/ > - &url.cgispec; : http://cgi-spec.golux.com/ncsa/env.html > - &url.cgispecs; : http://cgi-spec.golux.com/ncsa/ > - &url.cybermut; : > http://www.creditmutuel.fr/centre_commercial/vendez_sur_internet.html Has there been any discussion about the idea of having the documentation link to web.archive.org or webcitation.org for these broken entities? What about the idea of establishing new webcitation.org links for any new entites generated? It's a mixed bag, I know - you gain the fact that links will continue to work after the hosts have gone away, but you're no longer pointing directly to a regularly updated source...
[PHP-DOC] Bunch of notes deleted on crypt()
Earlier this year, with lots of help from Solar Designer and Pierre, I rewrote the crypt() documentation to clear up a lot of confusion. However, I failed to check over the existing user notes, and so am now deleting a bunch of notes that attempted to document what was missing in the main body, since we fixed most of these problems already. Just wanted to give you all a heads-up so you'd know why the flood of deletions came through on that entry.
[PHP-DOC] Patch for phpdoc/en/reference/classobj/functions/method-exists.xml
Attaching a patch for aforementioned file to reflect change in behaviour as of PHP5. Not sure what the rule is for commingled version docs, so I tried to follow what appeared to be the correct pattern. Index: method-exists.xml === RCS file: /repository/phpdoc/en/reference/classobj/functions/method-exists.xml,v retrieving revision 1.7 diff -p -u -r1.7 method-exists.xml --- method-exists.xml 14 Jan 2007 15:10:19 - 1.7 +++ method-exists.xml 3 Apr 2007 06:52:19 - @@ -9,12 +9,19 @@ &reftitle.description; boolmethod_exists - objectobject + mixedvar stringmethod_name - Checks if the class method exists in the given - object. + Checks if the class method exists in the given class or object + var. + + + + + In PHP4, this function only accepts instances, not class names. + + @@ -22,10 +29,10 @@ - object + var - An object instance + An object instance or class name @@ -44,7 +51,7 @@ &reftitle.returnvalues; Returns &true; if the method given by method_name - has been defined for the given object, &false; + has been defined for the given object or class var, &false; otherwise. @@ -52,7 +59,7 @@ &reftitle.examples; -method_exists example +method_exists object example + + method_exists class example + + + + &example.outputs; + + + +
[PHP-DOC] #35618 [Opn->Csd]: Ini option "allow_url_include" was not included in 5.1.0
ID: 35618
Updated by: [EMAIL PROTECTED]
Reported By: judas dot iscariote at gmail dot com
-Status: Open
+Status: Closed
Bug Type: Documentation problem
Operating System: Irrelevant
PHP Version: Irrelevant
Assigned To: nlopess
New Comment:
This option was added in PHP 5.2.0, and the documentation
has been changed to reflect that. It should show up in the
next push.
Previous Comments:
[2006-11-28 12:34:19] [EMAIL PROTECTED]
This setting is already used in 5.2.
http://cvs.php.net/viewvc.cgi/php-src/main/streams/streams.c?r1=1.82.2.6.2.1&r2=1.82.2.6.2.2&pathrev=PHP_5_2
Nuno, do you still want to take care of this one ? Assign it to me
otherwise.
[2005-12-26 18:02:55] [EMAIL PROTECTED]
script fixed.
[2005-12-13 10:53:26] [EMAIL PROTECTED]
That option exists from PHP 6.0.0..
[2005-12-10 05:51:38] judas dot iscariote at gmail dot com
changed to documentation problem.
I found no reference to the allow_url_include setting in the PHP
5.1.2-dev code.
but this page: http://www.php.net/manual/en/ini.php says:
"allow_url_include "0"PHP_INI_SYSTEM Available since PHP 5.1.0."
[2005-12-10 05:04:14] judas dot iscariote at gmail dot com
Description:
allow_url_include is not working as expected ( manual says it's
available since PHP 5.1.0)
Reproduce code:
---
allow_url_fopen = On
allow_url_include = Off
include('http://www.google.com');
Expected result:
should not include the url google.com
Actual result:
--
contents of google.com are included and displayed.
--
Edit this bug report at http://bugs.php.net/?id=35618&edit=1
[PHP-DOC] cvs: phpdoc /en/appendices ini.xml
joeyTue Dec 12 19:10:50 2006 UTC Modified files: /phpdoc/en/appendices ini.xml Log: allow_url_include available in 5.2.0 http://cvs.php.net/viewvc.cgi/phpdoc/en/appendices/ini.xml?r1=1.38&r2=1.39&diff_format=u Index: phpdoc/en/appendices/ini.xml diff -u phpdoc/en/appendices/ini.xml:1.38 phpdoc/en/appendices/ini.xml:1.39 --- phpdoc/en/appendices/ini.xml:1.38 Tue Jun 6 12:47:04 2006 +++ phpdoc/en/appendices/ini.xmlTue Dec 12 19:10:50 2006 @@ -1,5 +1,5 @@ - + &php.ini; directives @@ -39,7 +39,7 @@ allow_url_include "0" PHP_INI_SYSTEM - Available since PHP 6.0.0. + Available since PHP 5.2.0. always_populate_raw_post_data
[PHP-DOC] #39024 [Opn->Csd]: regex equivalent for ctype_alnum() is wrong
ID: 39024
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
-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.
Fixed in CVS.
Previous Comments:
[2006-10-03 10:56:34] [EMAIL PROTECTED]
Description:
The manual page for ctype_alnum() -
http://www.php.net/manual/en/function.ctype-alnum.php - states that
"the function is equivalent to preg_match('/^[a-z0-9]+$/i', $text).".
However $ matches a trailing newline as well as the end of the subject;
it should be replaced with \z which only matches the end of the subject.
Reproduce code:
---
$s = "abc\n";
var_dump(ctype_alnum($s), preg_match("/^[a-z0-9]+$/i", $s));
Expected result:
bool(false)
int(0)
Actual result:
--
bool(false)
int(1)
--
Edit this bug report at http://bugs.php.net/?id=39024&edit=1
[PHP-DOC] cvs: phpdoc /en/reference/ctype/functions ctype-alnum.xml
joeyTue Oct 3 11:02:51 2006 UTC
Modified files:
/phpdoc/en/reference/ctype/functionsctype-alnum.xml
Log:
Close #39024
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/ctype/functions/ctype-alnum.xml?r1=1.8&r2=1.9&diff_format=u
Index: phpdoc/en/reference/ctype/functions/ctype-alnum.xml
diff -u phpdoc/en/reference/ctype/functions/ctype-alnum.xml:1.8
phpdoc/en/reference/ctype/functions/ctype-alnum.xml:1.9
--- phpdoc/en/reference/ctype/functions/ctype-alnum.xml:1.8 Tue Jul 25
11:08:44 2006
+++ phpdoc/en/reference/ctype/functions/ctype-alnum.xml Tue Oct 3 11:02:51 2006
@@ -1,5 +1,5 @@
-
+
@@ -18,7 +18,7 @@
text, are alphanumeric. In the standard
C locale letters are just [A-Za-z]
and the function is equivalent to
- preg_match('/^[a-z0-9]+$/i', $text).
+ preg_match('/^[a-z0-9]+$/iD', $text).
[PHP-DOC] #38935 [Ana->Csd]: Strange results for object to array cast
ID: 38935
Updated by: [EMAIL PROTECTED]
Reported By: marcus at synchromedia dot co dot uk
-Status: Analyzed
+Status: Closed
Bug Type: Documentation problem
Operating System: All
PHP Version: 5.1.6
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.
The change should appear on the documentation next time it's
built.
Previous Comments:
[2006-09-25 21:36:58] marcus at synchromedia dot co dot uk
OK, Thanks for dealing with it.
[2006-09-25 21:25:44] [EMAIL PROTECTED]
We won't mark as closed until the doc patch has actually
been submitted (currently in review).
[2006-09-25 21:20:07] marcus at synchromedia dot co dot uk
It turns out that this was actually a documentation problem,
and apparently a fix has been posted in docs. So, the
'strange' entries are intentional, and the new docs will
explain them.
[2006-09-23 18:27:20] marcus at synchromedia dot co dot uk
Well, that's good to know, but it does mean that you're
justifying undocumented behaviour with yet more undocumented
behaviour.
I see that these null bytes are there, but they're not
separators; they're prefixes to both class and property
name, that is, the resulting array keys are of the form:
NULLNULL
I still fail to see how this is bogus when it's so wildly
different to what's documented, and is implemented in such a
way as to be useful in only the most obtuse of situations,
to the detriment of all other occasions. One change that
would make all this much more palatable while preserving the
additional information AND conforming closer to the docs:
only provide extended class information for properties that
are NOT in the current class. For example:
$v) {
echo bin2hex($k)."\n";
}
?>
At present this produces:
00420041
00410041
My suggestion is to change that to:
00420041
41
That way we will be in the situation that all unambiguous
properties in the current class are available using their
unmodified names, just like the docs say. The only remaining
issue is with protected values - I don't know that
preserving that status is of much value anyway - it's not as
if you can cast back from an array to an object anyway.
[2006-09-23 17:34:44] [EMAIL PROTECTED]
There are separators, null bytes.
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/38935
--
Edit this bug report at http://bugs.php.net/?id=38935&edit=1
[PHP-DOC] cvs: phpdoc /en/language types.xml
joeyTue Sep 26 00:37:57 2006 UTC Modified files: /phpdoc/en/language types.xml Log: Fix #38935, document changes in PHP5 when casting objects to arrays. http://cvs.php.net/viewvc.cgi/phpdoc/en/language/types.xml?r1=1.167&r2=1.168&diff_format=u Index: phpdoc/en/language/types.xml diff -u phpdoc/en/language/types.xml:1.167 phpdoc/en/language/types.xml:1.168 --- phpdoc/en/language/types.xml:1.167 Thu Aug 31 01:57:26 2006 +++ phpdoc/en/language/types.xmlTue Sep 26 00:37:57 2006 @@ -1,5 +1,5 @@ - + Types @@ -1820,7 +1820,33 @@ If you convert an object to an array, you get the properties (member variables) of that object as the array's elements. - The keys are the member variable names. + The keys are the member variable names with a few notable exceptions: + private variables have the class name prepended to the variable name; + protected variables have a '*' prepended to the variable name. + These prepended values have null bytes on either side. This can result + in some unexpected behaviour. + + + + + + + The above will appear to have two keys named 'AA', although one + of them is actually named '\0A\0A'.
[PHP-DOC] #38935 [Csd->Ana]: Strange results for object to array cast
ID: 38935
Updated by: [EMAIL PROTECTED]
Reported By: marcus at synchromedia dot co dot uk
-Status: Closed
+Status: Analyzed
Bug Type: Documentation problem
Operating System: All
PHP Version: 5.1.6
New Comment:
We won't mark as closed until the doc patch has actually
been submitted (currently in review).
Previous Comments:
[2006-09-25 21:20:07] marcus at synchromedia dot co dot uk
It turns out that this was actually a documentation problem,
and apparently a fix has been posted in docs. So, the
'strange' entries are intentional, and the new docs will
explain them.
[2006-09-23 18:27:20] marcus at synchromedia dot co dot uk
Well, that's good to know, but it does mean that you're
justifying undocumented behaviour with yet more undocumented
behaviour.
I see that these null bytes are there, but they're not
separators; they're prefixes to both class and property
name, that is, the resulting array keys are of the form:
NULLNULL
I still fail to see how this is bogus when it's so wildly
different to what's documented, and is implemented in such a
way as to be useful in only the most obtuse of situations,
to the detriment of all other occasions. One change that
would make all this much more palatable while preserving the
additional information AND conforming closer to the docs:
only provide extended class information for properties that
are NOT in the current class. For example:
$v) {
echo bin2hex($k)."\n";
}
?>
At present this produces:
00420041
00410041
My suggestion is to change that to:
00420041
41
That way we will be in the situation that all unambiguous
properties in the current class are available using their
unmodified names, just like the docs say. The only remaining
issue is with protected values - I don't know that
preserving that status is of much value anyway - it's not as
if you can cast back from an array to an object anyway.
[2006-09-23 17:34:44] [EMAIL PROTECTED]
There are separators, null bytes.
[2006-09-23 16:39:22] marcus at synchromedia dot co dot uk
I'm sorry but that's a bogus explanation. "Please double-
check the documentation"? What you describe is contrary to
the documentation.
The reasoning you express also fails completely on my point
about there being no separator between class name and
property name. How can you consider this to be reasonable
behaviour?:
class A {
private $A;
}
class B extends A {
private $A;
public $AA;
}
var_dump((array)new B());
array(3) {
["BA"]=>
NULL
["AA"]=>
NULL
["AA"]=>
NULL
}
Given that this undocumented behaviour is thus proven
ambiguous, unreliable and contrary to existing docs, how can
you say that it's 'needed'? Are you saying that there's
widespread code that depends on this weirdness, when 99% of
use cases will not expect it?
At the very least this is a valid documentation bug.
[2006-09-23 16:09:53] [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 class information is needed, see for example
class A {
private $p;
}
class B extends A {
private $p;
}
var_dump((array)new B());
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/38935
--
Edit this bug report at http://bugs.php.net/?id=38935&edit=1
[PHP-DOC] Doc patch for 38935
In response to the conversation surrounding note #69872, I've created the following patch against phpdoc HEAD. However, I don't keep up on our style guidelines, so I'd appreciate it if someone else could glance at the patch at make sure there are no glaring errors. If you do glance at it, feel free to submit the patch yourself. Index: types.xml === RCS file: /repository/phpdoc/en/language/types.xml,v retrieving revision 1.167 diff -u -r1.167 types.xml --- types.xml 31 Aug 2006 01:57:26 - 1.167 +++ types.xml 25 Sep 2006 17:28:35 - @@ -1820,7 +1820,33 @@ If you convert an object to an array, you get the properties (member variables) of that object as the array's elements. - The keys are the member variable names. + The keys are the member variable names with a few notable exceptions: + private variables have the class name prepended to the variable name; + protected variables have a '*' prepended to the variable name. + These prepended values have null bytes on either side. This can result + in some unexpected behaviour. + + + + + + + The above will appear to have two keys named 'AA', although one + of them is actually named '\0A\0A'.
[PHP-DOC] #28481 [Bgs->Ver]: sybase-db vs. sybase-ct
ID: 28481 Updated by: [EMAIL PROTECTED] Reported By: philip at cornado dot com -Status: Bogus +Status: Verified Bug Type:Documentation problem PHP Version: Irrelevant New Comment: That's sort of annoying. I managed to pick the IIS thing somehow...blame it on the fact that I'm using a GUI now instead of a console. Previous Comments: [2004-05-22 06:12:02] [EMAIL PROTECTED] We are aware of PHP's problems with stability under IIS and are working to rectify the problem. Unfortunatly your bug report does not contain any extra useful information and we already have enough bug reports open about this issue. If you can provide more detailed information such as a reproducable crash or a backtrace please do so and reopen this bug. Otherwise please keep trying new releases as we are working to resolve the problems on this platform Thanks for your interest in PHP. DB-Lib has been deprecated by the vendor, but is still in use in a lot of production databases. CT-Lib is the currently supported way to access Sybase databases. I'm not 100% certain PHP documentation needs to differentiate here, because the people who need sybase support generally know already which one they need. [2004-05-22 01:40:54] philip at cornado dot com Description: The Sybase documentation doesn't clearly differentiate between Sybase-DB and Sybase-CT. Some functions exist while compiling --with-sybase-ct that don't exist (undefined) when using --with-sybase and this needs to be recognized in the documentation. Is Sybase-DB deprecated? Perhaps someone familiar with Sybase/MSSQL can comment on all of this as I could be way off base here. AFAICT (as a person who's never used either Sybase) the following functions only exist in Sybase-CT: sybase_unbuffered_query() sybase_fetch_assoc() sybase_set_message_handler() sybase_deadlock_retry_count() Source files: http://lxr.php.net/source/php-src/ext/sybase_ct/php_sybase_ct.c http://lxr.php.net/source/php-src/ext/sybase/php_sybase_db.c This should all apply to MS SQL as well. -- Edit this bug report at http://bugs.php.net/?id=28481&edit=1
[PHP-DOC] #28481 [Opn->Bgs]: sybase-db vs. sybase-ct
ID: 28481 Updated by: [EMAIL PROTECTED] Reported By: philip at cornado dot com -Status: Open +Status: Bogus Bug Type:Documentation problem PHP Version: Irrelevant New Comment: We are aware of PHP's problems with stability under IIS and are working to rectify the problem. Unfortunatly your bug report does not contain any extra useful information and we already have enough bug reports open about this issue. If you can provide more detailed information such as a reproducable crash or a backtrace please do so and reopen this bug. Otherwise please keep trying new releases as we are working to resolve the problems on this platform Thanks for your interest in PHP. DB-Lib has been deprecated by the vendor, but is still in use in a lot of production databases. CT-Lib is the currently supported way to access Sybase databases. I'm not 100% certain PHP documentation needs to differentiate here, because the people who need sybase support generally know already which one they need. Previous Comments: [2004-05-22 01:40:54] philip at cornado dot com Description: The Sybase documentation doesn't clearly differentiate between Sybase-DB and Sybase-CT. Some functions exist while compiling --with-sybase-ct that don't exist (undefined) when using --with-sybase and this needs to be recognized in the documentation. Is Sybase-DB deprecated? Perhaps someone familiar with Sybase/MSSQL can comment on all of this as I could be way off base here. AFAICT (as a person who's never used either Sybase) the following functions only exist in Sybase-CT: sybase_unbuffered_query() sybase_fetch_assoc() sybase_set_message_handler() sybase_deadlock_retry_count() Source files: http://lxr.php.net/source/php-src/ext/sybase_ct/php_sybase_ct.c http://lxr.php.net/source/php-src/ext/sybase/php_sybase_db.c This should all apply to MS SQL as well. -- Edit this bug report at http://bugs.php.net/?id=28481&edit=1
[PHP-DOC] cvs: phpdoc /en/functions filesystem.xml
joeyTue Jan 6 13:41:32 2004 EDT Modified files: /phpdoc/en/functionsfilesystem.xml Log: Document "false" return for is_file(). Index: phpdoc/en/functions/filesystem.xml diff -u phpdoc/en/functions/filesystem.xml:1.144 phpdoc/en/functions/filesystem.xml:1.145 --- phpdoc/en/functions/filesystem.xml:1.144Sun Jun 2 15:03:06 2002 +++ phpdoc/en/functions/filesystem.xml Tue Jan 6 13:41:32 2004 @@ -8,7 +8,7 @@ instead --> - + Filesystem functions Filesystem @@ -1959,7 +1959,7 @@ stringfilename - Returns &true; if the filename exists and is a regular file. + Returns &true; if the filename exists and is a regular file, &false; otherwise. The results of this function are cached. See
[PHP-DOC] cvs: phpdoc /en/reference/math/functions exp.xml
joeySat Dec 13 02:51:38 2003 EDT Modified files: /phpdoc/en/reference/math/functions exp.xml Log: Some people don't know what "e" is. Index: phpdoc/en/reference/math/functions/exp.xml diff -u phpdoc/en/reference/math/functions/exp.xml:1.4 phpdoc/en/reference/math/functions/exp.xml:1.5 --- phpdoc/en/reference/math/functions/exp.xml:1.4 Fri May 16 03:49:30 2003 +++ phpdoc/en/reference/math/functions/exp.xml Sat Dec 13 02:51:37 2003 @@ -1,5 +1,5 @@ - + @@ -17,6 +17,12 @@ Returns e raised to the power of arg. + + + 'e' is the base of the natural system of logarithms, or approximately 2.718282. + + + See also log and
[PHP-DOC] cvs: phpdoc /entities global.ent
joeyThu Nov 20 12:06:27 2003 EDT Modified files: /phpdoc/entitiesglobal.ent Log: gettext manual URL has changed Index: phpdoc/entities/global.ent diff -u phpdoc/entities/global.ent:1.139 phpdoc/entities/global.ent:1.140 --- phpdoc/entities/global.ent:1.139Tue Nov 18 06:01:16 2003 +++ phpdoc/entities/global.ent Thu Nov 20 12:06:27 2003 @@ -1,6 +1,6 @@
[PHP-DOC] cvs: phpdoc /en/reference/shmop reference.xml
joeyThu Aug 21 00:02:30 2003 EDT Modified files: /phpdoc/en/reference/shmop reference.xml Log: Clear up cumbersome language. Index: phpdoc/en/reference/shmop/reference.xml diff -u phpdoc/en/reference/shmop/reference.xml:1.8 phpdoc/en/reference/shmop/reference.xml:1.9 --- phpdoc/en/reference/shmop/reference.xml:1.8 Mon Dec 2 07:55:40 2002 +++ phpdoc/en/reference/shmop/reference.xml Thu Aug 21 00:02:30 2003 @@ -1,5 +1,5 @@ - + Shared Memory Functions shmop @@ -9,10 +9,8 @@ &reftitle.intro; Shmop is an easy to use set of functions that allows PHP to read, - write, create and delete UNIX shared memory segments. These functions - will not typically work on Windows, as it does not support shared memory. - As of Windows 2000 though, enabling the php_shmop.dll - in your &php.ini; will enable this functionality though. + write, create and delete UNIX shared memory segments. Note that versions + of Windows previous to Windows 2000 do not support shared memory.
[PHP-DOC] cvs: phpdoc /en/reference/strings/functions setlocale.xml
joeyTue Jun 17 11:47:31 2003 EDT Modified files: /phpdoc/en/reference/strings/functions setlocale.xml Log: Fix typos Index: phpdoc/en/reference/strings/functions/setlocale.xml diff -u phpdoc/en/reference/strings/functions/setlocale.xml:1.9 phpdoc/en/reference/strings/functions/setlocale.xml:1.10 --- phpdoc/en/reference/strings/functions/setlocale.xml:1.9 Tue Jun 17 05:02:39 2003 +++ phpdoc/en/reference/strings/functions/setlocale.xml Tue Jun 17 11:47:31 2003 @@ -1,5 +1,5 @@ - + @@ -86,8 +86,8 @@ functionality is not implemented in the platform, the specified locale does not exist or the category name is invalid. An invalid category name also causes a warning message. Category/locale - names can be found in RFC 2915 - and ISO 639. + names can be found in RFC 1766 + and ISO 639. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/strings/functions setlocale.xml /entities global.ent
joeyTue Jun 17 05:02:40 2003 EDT Modified files: /phpdoc/en/reference/strings/functions setlocale.xml /phpdoc/entitiesglobal.ent Log: Incorporate some things from the notes. Index: phpdoc/en/reference/strings/functions/setlocale.xml diff -u phpdoc/en/reference/strings/functions/setlocale.xml:1.8 phpdoc/en/reference/strings/functions/setlocale.xml:1.9 --- phpdoc/en/reference/strings/functions/setlocale.xml:1.8 Fri Feb 28 18:47:31 2003 +++ phpdoc/en/reference/strings/functions/setlocale.xml Tue Jun 17 05:02:39 2003 @@ -1,5 +1,5 @@ - + @@ -85,7 +85,9 @@ Setlocale returns the new current locale, or &false; if the locale functionality is not implemented in the platform, the specified locale does not exist or the category name is invalid. - An invalid category name also causes a warning message. + An invalid category name also causes a warning message. Category/locale + names can be found in RFC 2915 + and ISO 639. Index: phpdoc/entities/global.ent diff -u phpdoc/entities/global.ent:1.111 phpdoc/entities/global.ent:1.112 --- phpdoc/entities/global.ent:1.111Sat May 31 18:05:54 2003 +++ phpdoc/entities/global.ent Tue Jun 17 05:02:40 2003 @@ -1,6 +1,6 @@
Re: [PHP-DOC] ISO 639 addition to global.ent
On Tue, Jun 17, 2003 at 10:21:49AM +0200, Gabor Hojtsy wrote: > > I don't think there is any problem with this. Why is this special? > > Goba Looking into this: http://news.php.net/article.php?group=php.doc&article=969354491 One of the notes references this ISO URL, and it seems useful. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] ISO 639 addition to global.ent
Anyone mind the following addition to global.ent? --- entities/global.ent 31 May 2003 22:05:54 - 1.111 +++ entities/global.ent 16 Jun 2003 21:35:35 - @@ -109,6 +109,7 @@ http://www.iptc.org/";> http://www.schumann.cx/ircg/";> http://lxr.php.net/source/php4/ext/ircg/README.txt";> +http://www.w3.org/WAI/ER/IG/ert/iso639.htm";> http://www.utm.edu/research/primes/glossary/JacobiSymbol.html";> http://www.jclark.com/jade/";> http://www.jclark.com/bio.htm";> (I wasn't sure if this was the right place/method for adding this.) -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/session reference.xml
joeyMon Jun 2 23:50:53 2003 EDT Modified files: /phpdoc/en/reference/sessionreference.xml Log: Use $_SESSION superglobal instead of assuming register_globals = On Index: phpdoc/en/reference/session/reference.xml diff -u phpdoc/en/reference/session/reference.xml:1.37 phpdoc/en/reference/session/reference.xml:1.38 --- phpdoc/en/reference/session/reference.xml:1.37 Mon May 19 08:09:26 2003 +++ phpdoc/en/reference/session/reference.xml Mon Jun 2 23:50:52 2003 @@ -1,5 +1,5 @@ - + Session handling functions Sessions @@ -268,12 +268,11 @@ -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/network/functions gethostbynamel.xml
joeyMon Jun 2 10:05:55 2003 EDT Modified files: /phpdoc/en/reference/network/functions gethostbynamel.xml Log: Use example.com instead of yahoo.com Index: phpdoc/en/reference/network/functions/gethostbynamel.xml diff -u phpdoc/en/reference/network/functions/gethostbynamel.xml:1.3 phpdoc/en/reference/network/functions/gethostbynamel.xml:1.4 --- phpdoc/en/reference/network/functions/gethostbynamel.xml:1.3Mon May 26 23:10:20 2003 +++ phpdoc/en/reference/network/functions/gethostbynamel.xmlMon Jun 2 10:05:55 2003 @@ -1,5 +1,5 @@ - + @@ -24,7 +24,7 @@ @@ -35,14 +35,7 @@ -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/sockets reference.xml
joeyMon Jun 2 09:52:59 2003 EDT
Modified files:
/phpdoc/en/reference/socketsreference.xml
Log:
Make example line buffered. Noticed by Benjamin Kuz.
Index: phpdoc/en/reference/sockets/reference.xml
diff -u phpdoc/en/reference/sockets/reference.xml:1.9
phpdoc/en/reference/sockets/reference.xml:1.10
--- phpdoc/en/reference/sockets/reference.xml:1.9 Thu Apr 17 17:44:32 2003
+++ phpdoc/en/reference/sockets/reference.xml Mon Jun 2 09:52:59 2003
@@ -1,5 +1,5 @@
-
+
Socket functions
Sockets
@@ -141,7 +141,7 @@
socket_write($msgsock, $msg, strlen($msg));
do {
-if (FALSE === ($buf = socket_read ($msgsock, 2048))) {
+if (FALSE === ($buf = socket_read ($msgsock, 2048, PHP_NORMAL_READ))) {
echo "socket_read() failed: reason: " . socket_strerror ($ret) . "\n";
break 2;
}
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/pgsql/functions pg-fetch-assoc.xml
joeyFri Jan 24 16:26:14 2003 EDT Modified files: /phpdoc/en/reference/pgsql/functionspg-fetch-assoc.xml Log: cardinal caught this one. Index: phpdoc/en/reference/pgsql/functions/pg-fetch-assoc.xml diff -u phpdoc/en/reference/pgsql/functions/pg-fetch-assoc.xml:1.1 phpdoc/en/reference/pgsql/functions/pg-fetch-assoc.xml:1.2 --- phpdoc/en/reference/pgsql/functions/pg-fetch-assoc.xml:1.1 Wed Oct 2 01:58:55 2002 +++ phpdoc/en/reference/pgsql/functions/pg-fetch-assoc.xml Fri Jan 24 16:26:14 +2003 @@ -1,5 +1,5 @@ - + @@ -37,6 +37,7 @@ See also pg_fetch_row, pg_fetch_array, +pg_fetch_assoc, pg_fetch_object and pg_fetch_result. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions fopen.xml
joeyThu Jan 16 21:11:08 2003 EDT
Modified files:
/phpdoc/en/reference/filesystem/functions fopen.xml
Log:
Open a file, not just the directory.
Index: phpdoc/en/reference/filesystem/functions/fopen.xml
diff -u phpdoc/en/reference/filesystem/functions/fopen.xml:1.7
phpdoc/en/reference/filesystem/functions/fopen.xml:1.8
--- phpdoc/en/reference/filesystem/functions/fopen.xml:1.7 Sun Jan 12 21:54:28
2003
+++ phpdoc/en/reference/filesystem/functions/fopen.xml Thu Jan 16 21:11:08 2003
@@ -1,5 +1,5 @@
-
+
@@ -124,7 +124,7 @@
$handle = fopen ("/home/rasmus/file.txt", "r");
$handle = fopen ("/home/rasmus/file.gif", "wb");
$handle = fopen ("http://www.example.com/";, "r");
-$handle = fopen ("ftp://user:[EMAIL PROTECTED]/";, "w");
+$handle = fopen ("ftp://user:[EMAIL PROTECTED]/somefile.txt";, "w");
?>
]]>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/pgsql reference.xml
joeyFri Nov 29 21:10:13 2002 EDT Modified files: /phpdoc/en/reference/pgsql reference.xml Log: Fixed a typo. Index: phpdoc/en/reference/pgsql/reference.xml diff -u phpdoc/en/reference/pgsql/reference.xml:1.10 phpdoc/en/reference/pgsql/reference.xml:1.11 --- phpdoc/en/reference/pgsql/reference.xml:1.10Sat Sep 14 17:24:54 2002 +++ phpdoc/en/reference/pgsql/reference.xml Fri Nov 29 21:10:12 2002 @@ -1,5 +1,5 @@ - + PostgreSQL functions PostgreSQL @@ -172,8 +172,8 @@ the feature required for the function. -It is also important that you use newer libpq than PostgreSQL -Server to be connected. If you use libpq older than PostgreSQL +It is also important that you do not use an older libpq than the PostgreSQL +Server to which you will be connecting. If you use libpq older than PostgreSQL Server expects, you may have problems. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/session/functions session-id.xml
joeyFri Nov 29 20:54:59 2002 EDT Modified files: /phpdoc/en/reference/session/functions session-id.xml Log: Corrected a typo Index: phpdoc/en/reference/session/functions/session-id.xml diff -u phpdoc/en/reference/session/functions/session-id.xml:1.4 phpdoc/en/reference/session/functions/session-id.xml:1.5 --- phpdoc/en/reference/session/functions/session-id.xml:1.4Sun Nov 17 08:52:05 2002 +++ phpdoc/en/reference/session/functions/session-id.xmlFri Nov 29 20:54:59 +2002 @@ -1,5 +1,5 @@ - + @@ -28,7 +28,7 @@ The constant SID can also be used to retrieve the current name and session id as a string suitable for adding to URLs. Note that SID is only defined if - the client didn't sent the right cookie. See also Session handling. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Possible new FAQ entry
I'd like to propose a new FAQ entry, maybe in the build section (?): Q: When I try to start Apache, I get the following message: fatal: relocation error: file /path/to/libphp4.so: symbol ap_block_alarms: referenced symbol not found A: Reconfigure apache, making sure to use at least the following flags: --enable-shared=max --enable-rule=SHARED_CORE It's one that comes up every now and again in #PHP... -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/functions mail.xml
joeyFri Aug 16 21:13:11 2002 EDT Modified files: /phpdoc/en/functionsmail.xml Log: Fix typo. Index: phpdoc/en/functions/mail.xml diff -u phpdoc/en/functions/mail.xml:1.39 phpdoc/en/functions/mail.xml:1.40 --- phpdoc/en/functions/mail.xml:1.39 Wed Apr 17 15:58:43 2002 +++ phpdoc/en/functions/mail.xmlFri Aug 16 21:13:10 2002 @@ -8,7 +8,7 @@ instead --> - + Mail functions Mail @@ -131,7 +131,7 @@ - You must use \r\n to seperate headers, although + You must use \r\n to separate headers, although some Unix mail transfer agents may work with just a single newline (\n). The Cc: header is case sensitive and must be written as Cc: on Win32 systems. The Bcc: -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/functions domxml.xml
joeyWed Jun 19 01:31:06 2002 EDT Modified files: /phpdoc/en/functionsdomxml.xml Log: The libxml requirement has been 2.4.x for almost a year now, and 2.4.14 for "quite some time" (according to the CVS logs for ext/domxml/config.m4). Index: phpdoc/en/functions/domxml.xml diff -u phpdoc/en/functions/domxml.xml:1.42 phpdoc/en/functions/domxml.xml:1.43 --- phpdoc/en/functions/domxml.xml:1.42 Wed Apr 17 15:58:42 2002 +++ phpdoc/en/functions/domxml.xml Wed Jun 19 01:31:05 2002 @@ -8,7 +8,7 @@ instead --> - + DOM XML functions DOM XML @@ -44,7 +44,7 @@ This extension is only available if PHP was configured with --with-dom=[DIR], using the GNOME xml library. -You will need at least libxml-2.2.7 +You will need at least libxml-2.4.14.
[PHP-DOC] cvs: phpdoc /en/faq using.xml
joeyWed Oct 3 15:16:08 2001 EDT Modified files: /phpdoc/en/faq using.xml Log: Correct a typo (user note [EMAIL PROTECTED]) Index: phpdoc/en/faq/using.xml diff -u phpdoc/en/faq/using.xml:1.7 phpdoc/en/faq/using.xml:1.8 --- phpdoc/en/faq/using.xml:1.7 Sun Sep 30 14:36:39 2001 +++ phpdoc/en/faq/using.xml Wed Oct 3 15:16:08 2001 @@ -1,5 +1,5 @@ - + Using PHP Using PHP @@ -339,7 +339,7 @@ This tells PHP to treat var as an array and each assignment of a value to var[] adds an item to the array. The first item becomes - $var[0], the next $var[0], etc. + $var[0], the next $var[1], etc. The count function can be used to determine how many options were selected, and the sort function can be used to sort the option array if necessary.
[PHP-DOC] Bug #13067 Updated: bool dbmreplace (int dbm_identifier, string key, string value)
ID: 13067
Updated by: joey
Reported By: [EMAIL PROTECTED]
Old Status: Open
Status: Feedback
Bug Type: Documentation problem
Operating System: na
PHP Version: 4.0.6
New Comment:
I'm not sure what is the right thing to do here. There *is*
a mismatch, but who is correct?
The proto says:
/* {{{ proto int dbmreplace(int dbm_identifier, string key, string value)
Replaces the value for a key in a dbm database */
So, by this reasoning, the function operates correctly.
However, it seems to me that what you want to know is
whether the replace worked or not...
Previous Comments:
[2001-08-30 16:03:59] [EMAIL PROTECTED]
in docs dbmreplace() returns bool
bool dbmreplace(int dbm_identifier, string key, string value)
but dbmreplace() returns int like dbminsert()
you all make a good job
gegards
robert
Edit this bug report at http://bugs.php.net/?id=13067&edit=1
[PHP-DOC] Bug #12868 Updated: Appendix G Descrepancies..
ID: 12868 Updated by: joey Reported By: [EMAIL PROTECTED] Old Status: Open Status: Feedback Bug Type: Documentation problem Operating System: win32 PHP Version: 4.0.6 New Comment: Update status... Previous Comments: [2001-08-21 01:28:13] [EMAIL PROTECTED] I don't understand why it matters which is the 'master' and which is the alias? I would guess that the reason for the inconsistency in the documentation is that it really doesn't matter which is which, so the doc team is not all that careful about it. But that's just a guess...this wouldn't be all that hard to clear up. FWIW, rtrim() is an alias to chop() and fputs() is an alias to fwrite(). [2001-08-21 00:12:18] [EMAIL PROTECTED] This is truly a followup to my previous post - message about what appears to be "descrepancies" in Appendix G.. which has further some confusion as to "which" functions are "truly" an alias and which is the "master function".. I guess I need to "understand" what the master function is supposed to be, and what an alias is supposed to be. Perhaps I have these backwards, and thus the confusion, but some of this doesn't quite set right.. The first function in the list (chop) is labeled as the master function, and it's alias as (rtrim).. but when you go to the master function, (chop) it's documentation indicates it's the alias. and to see rtrim for details. There are some functions in this list like - fwrite() and fputs() - where fwrite is labled as the master and fputs the alias.. while the documentaion for both functions do not indicate either as an alias.. This goes on.. naturally some of these make perfect sense, if you looke at is_double() marked as a master - having aliases of is_float() and is_real().. the documentation corresponds perfectly.. i.e. if you call up is_float() or is_real() it directs you to is_double().. which brings "some" understanding back. and jives with what "I" would preceive as the relationship between a "master function" and an alias. Input on this matter would "greatly" be appreciated.. thanks a bunch. Edit this bug report at http://bugs.php.net/?id=12868&edit=1
[PHP-DOC] Bug #12868 Updated: Appendix G Descrepancies..
ID: 12868 Updated by: joey Reported By: [EMAIL PROTECTED] Status: Open Bug Type: Documentation problem Operating System: win32 PHP Version: 4.0.6 New Comment: I don't understand why it matters which is the 'master' and which is the alias? I would guess that the reason for the inconsistency in the documentation is that it really doesn't matter which is which, so the doc team is not all that careful about it. But that's just a guess...this wouldn't be all that hard to clear up. FWIW, rtrim() is an alias to chop() and fputs() is an alias to fwrite(). Previous Comments: [2001-08-21 00:12:18] [EMAIL PROTECTED] This is truly a followup to my previous post - message about what appears to be "descrepancies" in Appendix G.. which has further some confusion as to "which" functions are "truly" an alias and which is the "master function".. I guess I need to "understand" what the master function is supposed to be, and what an alias is supposed to be. Perhaps I have these backwards, and thus the confusion, but some of this doesn't quite set right.. The first function in the list (chop) is labeled as the master function, and it's alias as (rtrim).. but when you go to the master function, (chop) it's documentation indicates it's the alias. and to see rtrim for details. There are some functions in this list like - fwrite() and fputs() - where fwrite is labled as the master and fputs the alias.. while the documentaion for both functions do not indicate either as an alias.. This goes on.. naturally some of these make perfect sense, if you looke at is_double() marked as a master - having aliases of is_float() and is_real().. the documentation corresponds perfectly.. i.e. if you call up is_float() or is_real() it directs you to is_double().. which brings "some" understanding back. and jives with what "I" would preceive as the relationship between a "master function" and an alias. Input on this matter would "greatly" be appreciated.. thanks a bunch. Edit this bug report at http://bugs.php.net/?id=12868&edit=1
[PHP-DOC] Filtering out translations?
Just wondering if anyone on php-doc happens to have a procmail receipe handy for filtering out the php-doc translation messages. I only speak English, and don't envision having time any day soon to rectify this, so these extra emails simply make it harder for me to stay on top of php-doc, and I thought someone may already have something like this sitting around. :)
[PHP-DOC] cvs: phpdoc /en/functions domxml.xml
joeyMon Jul 16 07:33:01 2001 EDT Modified files: /phpdoc/en/functionsdomxml.xml Log: Correct the parameters to domxml_root. Note that it wants an object of class "Dom document". Add comment to example that domxml_root() is also valid. Shouldn't there be a second set of links into the domxml functions that calls them by their method names? Index: phpdoc/en/functions/domxml.xml diff -u phpdoc/en/functions/domxml.xml:1.15 phpdoc/en/functions/domxml.xml:1.16 --- phpdoc/en/functions/domxml.xml:1.15 Sun Jul 8 09:01:18 2001 +++ phpdoc/en/functions/domxml.xml Mon Jul 16 07:33:01 2001 @@ -506,14 +506,14 @@ object domxml_root - array doc + object doc &warn.experimental.func; - Returns element node located at the root of a an DOM document. - There are actually other possible nodes like comments which are currently - disregarded. + domxml_root takes one argument, an object of class + "Dom document", and returns the root element node. There are actually + other possible nodes like comments which are currently disregarded. The following example returns just the element with name CHAPTER and @@ -550,6 +550,7 @@ } $root = $dom->root(); +/* or $root = domxml_root($dom); */ print_r($root); ?>
