[PHP-DOC] need a svn account for update the php chinese document
Hi , PHP document team , my name is kendotom, php develper, live in ShangHai China now , i need a SVN account for update the php chinese document .
[PHP-DOC] session.gc_max_lifetime documented incorrectly?
Hello, I'm interested in correcting errors in the documentation of the session.gc_max_lifetime option. php.ini-dist states: ; After this number of seconds, stored data will be seen as 'garbage' and ; cleaned up by the garbage collection process. session.gc_maxlifetime = 1440 However the code itself deletes the session only if 1440 seconds have passed since the modification time of the session file (at least for file-based sessions). So gc_maxlifetime is mislabeled - it should be gc_maxidletime. Session lifetimes can be much longer as long as the user hits the server every gc_maxlifetime seconds. Renaming it is probably unrealistic, but its actual meaning should be documented. It did occur to me that things might not be precisely as I've described them if PHP tries to be subtle about it and not write to the session file in the event that its contents have not changed. However, I've done a little digging in the source code and I've found no evidence that PHP tries to avoid writing to the session file at shutdown time. Also, until somewhere in the 4.x series PHP used to use atime (access time) rather than mtime, and only backed off that because it was incompatible with operating systems that don't support atime. So it does appear that an idle timeout is the intention. The current contents of php.ini-dist and http://www.php.net/manual/en/session.configuration.php#ini.session.gc-maxlifetime refer to the lifetime of data, not the lifetime of a session. So they are not flat wrong. But they are confusing and I'd like to contribute a clarified version. How would I go about getting access to do that? Thanks! -- Tom Boutell P'unk Avenue 215 755 1330 punkave.com window.punkave.com
[PHP-DOC] #40675 [Asn]: Documentation for FILTER_VALIDATE_URL appears out of date
ID: 40675 User updated by: walter dot tom+php at gmail dot com Reported By: walter dot tom+php at gmail dot com Status: Assigned Bug Type:Documentation problem PHP Version: 5.2.1 Assigned To: pajoye New Comment: Thanks for responding so quickly! BTW I also added a feature suggestion #40676 that maybe a FILTER_VALIDATE_URI option could be added that would possibly be a good alternative to URL, since technically the RFC for a 'URL' does require it to have a host and scheme. I thought I should mention it since I get the impression that the reason the scheme and host required flags were removed originally was because of this. But either way I'm just happy as long as I can validate domains and relative URLs somehow. Thanks for your good work! Cheers Tom Previous Comments: [2007-03-01 16:51:15] [EMAIL PROTECTED] You bring up some good points. After briefly speaking with Pierre the following came to light: * The default behavior of FILTER_VALIDATE_URL was changed at some point * FILTER_FLAG_SCHEME_OPTIONAL should exist instead * Likely the same to create FILTER_FLAG_HOST_OPTIONAL, he'll look * So, at first glance, those two _REQUIRED constants have no meaning today As requested, this bug is being assigned to Pierre and he'll work on it this weekend. Thank you for the nice bug report :) [2007-03-01 03:09:03] walter dot tom+php at gmail dot com Oops, for some reason lost the version number when I first submitted. [2007-03-01 03:07:10] walter dot tom+php at gmail dot com Description: The current documentation for FILTER_VALIDATE_URL (http://www.php.net/filter) mentions flags for FILTER_FLAG_HOST_REQUIRED and FILTER_FLAG_SCHEME_REQUIRED, which suggest that an input that doesn't include a host or scheme such as a relative URL SHOULD validate as long as it doesn't include those flags. However they do not. Reproduce code: --- $var = filter_var('/mypath.html', FILTER_VALIDATE_URL); $var = filter_var('google.com', FILTER_VALIDATE_URL); Expected result: Both return false, however given the current documentation, one would expect them to return true. -- Edit this bug report at http://bugs.php.net/?id=40675&edit=1
[PHP-DOC] #40675 [Opn]: Documentation for FILTER_VALIDATE_URL appears out of date
ID: 40675 User updated by: walter dot tom+php at gmail dot com Reported By: walter dot tom+php at gmail dot com Status: Open Bug Type:Documentation problem -PHP Version: Irrelevant +PHP Version: 5.2.1 New Comment: Oops, for some reason lost the version number when I first submitted. Previous Comments: [2007-03-01 03:07:10] walter dot tom+php at gmail dot com Description: The current documentation for FILTER_VALIDATE_URL (http://www.php.net/filter) mentions flags for FILTER_FLAG_HOST_REQUIRED and FILTER_FLAG_SCHEME_REQUIRED, which suggest that an input that doesn't include a host or scheme such as a relative URL SHOULD validate as long as it doesn't include those flags. However they do not. Reproduce code: --- $var = filter_var('/mypath.html', FILTER_VALIDATE_URL); $var = filter_var('google.com', FILTER_VALIDATE_URL); Expected result: Both return false, however given the current documentation, one would expect them to return true. -- Edit this bug report at http://bugs.php.net/?id=40675&edit=1
[PHP-DOC] #40675 [NEW]: Documentation for FILTER_VALIDATE_URL appears out of date
From: walter dot tom+php at gmail dot com Operating system: PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: Documentation for FILTER_VALIDATE_URL appears out of date Description: The current documentation for FILTER_VALIDATE_URL (http://www.php.net/filter) mentions flags for FILTER_FLAG_HOST_REQUIRED and FILTER_FLAG_SCHEME_REQUIRED, which suggest that an input that doesn't include a host or scheme such as a relative URL SHOULD validate as long as it doesn't include those flags. However they do not. Reproduce code: --- $var = filter_var('/mypath.html', FILTER_VALIDATE_URL); $var = filter_var('google.com', FILTER_VALIDATE_URL); Expected result: Both return false, however given the current documentation, one would expect them to return true. -- Edit bug report at http://bugs.php.net/?id=40675&edit=1 -- Try a CVS snapshot (PHP 4.4): http://bugs.php.net/fix.php?id=40675&r=trysnapshot44 Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=40675&r=trysnapshot52 Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=40675&r=trysnapshot60 Fixed in CVS: http://bugs.php.net/fix.php?id=40675&r=fixedcvs Fixed in release: http://bugs.php.net/fix.php?id=40675&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=40675&r=needtrace Need Reproduce Script:http://bugs.php.net/fix.php?id=40675&r=needscript Try newer version:http://bugs.php.net/fix.php?id=40675&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=40675&r=support Expected behavior:http://bugs.php.net/fix.php?id=40675&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=40675&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=40675&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=40675&r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=40675&r=php3 Daylight Savings: http://bugs.php.net/fix.php?id=40675&r=dst IIS Stability:http://bugs.php.net/fix.php?id=40675&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=40675&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=40675&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=40675&r=nozend MySQL Configuration Error:http://bugs.php.net/fix.php?id=40675&r=mysqlcfg
[PHP-DOC] #37913 [Bgs->Opn]: preg_match_all typo
ID: 37913 User updated by: tom at foreignproperty dot com Reported By: tom at foreignproperty dot com -Status: Bogus +Status: Open Bug Type:Documentation problem PHP Version: Irrelevant New Comment: look at the array keys. it goes $matches[0], $matches[1], then jumps to $matches[3] and $matches[4] Shouldn't part 2 be matches[2], and part 3 be $matches[3]? Previous Comments: [2006-06-26 08:40:08] [EMAIL PROTECTED] No, that's perfectly correct. The regx is "/(<([\w]+)[^>]*>)(.*)(<\/\\2>)/". So, [1] correspond to (<([\w]+)[^>]*>), [2] correspond to ([\w]+), [3] correspond to (.*), and [4] correspond to (<\/\\2>). -------- [2006-06-26 08:16:06] tom at foreignproperty dot com Description: In the description for preg_match_all, in the 2nd example, Find matching HTML tags (greedy), the part 2 and part 3 array values are wrong ($matches[3], $matches[4]). echo "matched: " . $matches[0][$i] . "\n"; echo "part 1: " . $matches[1][$i] . "\n"; >> echo "part 2: " . $matches[3][$i] . "\n"; << >> echo "part 3: " . $matches[4][$i] . "\n\n"; << -- Edit this bug report at http://bugs.php.net/?id=37913&edit=1
[PHP-DOC] #37913 [NEW]: preg_match_all typo
From: tom at foreignproperty dot com Operating system: PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: preg_match_all typo Description: In the description for preg_match_all, in the 2nd example, Find matching HTML tags (greedy), the part 2 and part 3 array values are wrong ($matches[3], $matches[4]). echo "matched: " . $matches[0][$i] . "\n"; echo "part 1: " . $matches[1][$i] . "\n"; >> echo "part 2: " . $matches[3][$i] . "\n"; << >> echo "part 3: " . $matches[4][$i] . "\n\n"; << -- Edit bug report at http://bugs.php.net/?id=37913&edit=1 -- Try a CVS snapshot (PHP 4.4): http://bugs.php.net/fix.php?id=37913&r=trysnapshot44 Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=37913&r=trysnapshot52 Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=37913&r=trysnapshot60 Fixed in CVS: http://bugs.php.net/fix.php?id=37913&r=fixedcvs Fixed in release: http://bugs.php.net/fix.php?id=37913&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=37913&r=needtrace Need Reproduce Script:http://bugs.php.net/fix.php?id=37913&r=needscript Try newer version:http://bugs.php.net/fix.php?id=37913&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=37913&r=support Expected behavior:http://bugs.php.net/fix.php?id=37913&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=37913&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=37913&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=37913&r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=37913&r=php3 Daylight Savings: http://bugs.php.net/fix.php?id=37913&r=dst IIS Stability:http://bugs.php.net/fix.php?id=37913&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=37913&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=37913&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=37913&r=nozend MySQL Configuration Error:http://bugs.php.net/fix.php?id=37913&r=mysqlcfg
Re: [PHP-DOC] curl_copy_handle
Hi! Thanks =) Hows this ? I think maybe mail client is messing up a few lines so attached the diff in a text doc to. Thanks Tom [EMAIL PROTECTED] functions]$ cvs diff -u curl-copy-handle.xml Index: curl-copy-handle.xml === RCS file: /repository/phpdoc/en/reference/curl/functions/curl-copy- handle.xml,v retrieving revision 1.1 diff -u -r1.1 curl-copy-handle.xml --- curl-copy-handle.xml2 May 2004 15:46:36 - 1.1 +++ curl-copy-handle.xml15 Jun 2005 22:02:36 - @@ -13,9 +13,37 @@ resourcecurl_copy_handle resourcech + + This function copy's a cURL handle. + Returning a new cURL handle with the same preferences. + + + +Copying a cURL handle. + + + + + On Wed, 2005-06-15 at 21:53 +, Philip Olson wrote: > Hello! > > Watch your whitespace, no tabs, single space indention. And > use the PEAR Coding Standard (' versus "). And Put the > on a single line. That's all for now :) > > Regards, > Philip > > On Wed, 15 Jun 2005, Tom Westcott wrote: > > > Ok this is my first so be nice =) > > Please let me know if/how I screwed up. > > > > Thanks Tom > > > > [EMAIL PROTECTED] functions]$ cvs diff -u curl-copy-handle.xml > > Index: curl-copy-handle.xml > > === > > RCS file: /repository/phpdoc/en/reference/curl/functions/curl-copy- > > handle.xml,v > > retrieving revision 1.1 > > diff -u -r1.1 curl-copy-handle.xml > > --- curl-copy-handle.xml2 May 2004 15:46:36 - 1.1 > > +++ curl-copy-handle.xml15 Jun 2005 20:33:26 - > > @@ -13,9 +13,39 @@ > > resourcecurl_copy_handle > > > > resourcech > > > > + > > + This function copy's a cURL handle. > > + Returning a new cURL handle with the same preferences. > > + > > + > > + > > + > > + Copying a cURL handle. > > + > > + > > + > > + > > + > > + > > > > > > [EMAIL PROTECTED] functions]$ cvs diff -u curl-copy-handle.xml Index: curl-copy-handle.xml === RCS file: /repository/phpdoc/en/reference/curl/functions/curl-copy-handle.xml,v retrieving revision 1.1 diff -u -r1.1 curl-copy-handle.xml --- curl-copy-handle.xml2 May 2004 15:46:36 - 1.1 +++ curl-copy-handle.xml15 Jun 2005 22:02:36 - @@ -13,9 +13,37 @@ resourcecurl_copy_handle resourcech + + This function copy's a cURL handle. + Returning a new cURL handle with the same preferences. + + + +Copying a cURL handle. + + + + +
[PHP-DOC] curl_copy_handle
Ok this is my first so be nice =) Please let me know if/how I screwed up. Thanks Tom [EMAIL PROTECTED] functions]$ cvs diff -u curl-copy-handle.xml Index: curl-copy-handle.xml === RCS file: /repository/phpdoc/en/reference/curl/functions/curl-copy- handle.xml,v retrieving revision 1.1 diff -u -r1.1 curl-copy-handle.xml --- curl-copy-handle.xml2 May 2004 15:46:36 - 1.1 +++ curl-copy-handle.xml15 Jun 2005 20:33:26 - @@ -13,9 +13,39 @@ resourcecurl_copy_handle resourcech + + This function copy's a cURL handle. + Returning a new cURL handle with the same preferences. + + + + + Copying a cURL handle. + + + + + +
Re: [PHP-DOC] Volunteer
Great =), If I start making changes on the doc files, should I just email the files to this list ? Or do I need cvs account? Thanks Tom On Wed, 2005-06-15 at 10:14 +0200, Friedhelm Betz wrote: > Tom Westcott wrote: > > Hi, > > > > I would like to help on the English documentation team. > > php is an integral part of my job now and has been for the last 5 years. > > I would like to give something back, and help others. > > I have read the wiki at http://doc.php.net/php/en/dochowto/index.php. > > > > Please let me know if you could make use of me. > > > > I am pretty sure, we always welcome helping hands: > fixing bugs (bugs.php.net), managing user notes, document new features, > new extensions/functions etc., working on livedocs, docweb ... > > There are many tasks where you can get your hands dirty. > > Friedhelm >
[suspicious - maybe spam] [PHP-DOC] [suspicious - maybe spam] Volunteer
Hi, I would like to help on the English documentation team. php is an integral part of my job now and has been for the last 5 years. I would like to give something back, and help others. I have read the wiki at http://doc.php.net/php/en/dochowto/index.php. Please let me know if you could make use of me. Thanks Tom Westcott
[PHP-DOC] cvs: phpdoc /en/reference/info/functions phpversion.xml
tomsommer Fri Dec 3 18:40:27 2004 EDT Modified files: /phpdoc/en/reference/info/functions phpversion.xml Log: I changed my mind http://cvs.php.net/diff.php/phpdoc/en/reference/info/functions/phpversion.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/info/functions/phpversion.xml diff -u phpdoc/en/reference/info/functions/phpversion.xml:1.5 phpdoc/en/reference/info/functions/phpversion.xml:1.6 --- phpdoc/en/reference/info/functions/phpversion.xml:1.5 Fri Dec 3 18:38:04 2004 +++ phpdoc/en/reference/info/functions/phpversion.xml Fri Dec 3 18:40:27 2004 @@ -1,5 +1,5 @@ - + @@ -9,7 +9,7 @@ Description - mixedphpversion + stringphpversion stringextension
[PHP-DOC] cvs: phpdoc /en/reference/info/functions phpversion.xml
tomsommer Fri Dec 3 18:38:04 2004 EDT Modified files: /phpdoc/en/reference/info/functions phpversion.xml Log: - Fix type - Note that phpversion will also return false is an extension isn't loaded http://cvs.php.net/diff.php/phpdoc/en/reference/info/functions/phpversion.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/info/functions/phpversion.xml diff -u phpdoc/en/reference/info/functions/phpversion.xml:1.4 phpdoc/en/reference/info/functions/phpversion.xml:1.5 --- phpdoc/en/reference/info/functions/phpversion.xml:1.4 Sun Oct 17 07:08:04 2004 +++ phpdoc/en/reference/info/functions/phpversion.xml Fri Dec 3 18:38:04 2004 @@ -1,5 +1,5 @@ - + @@ -9,14 +9,15 @@ Description - stringphpversion + mixedphpversion stringextension Returns a string containing the version of the currently running PHP parser. If the optional extension parameter is specified, phpversion returns the version of that - extension, or &false; if there is no version information associated. + extension, or &false; if there is no version information associated or + the extension isn't enabled.
[PHP-DOC] Reference pages and international chars
Hi, LIVEDOCS: Reference pages dumps errors when a function description contains international chars (like æøå). This use to work, so someone broke it :) Notice how the function listing (in the bottom) stops once it hits a function with a description that contains these chars. Ref: http://phpdocs.tsn.dk/da/ref.strings.html -- Tom
Re: [PHP-DOC] UTF8 breaks everything
Sean Coates wrote: That should be added to the .htaccess created by livedocs. If you create the patch to .htaccess.in and submit it to bugs.php.net as "Livedocs problem", it'll likely get patched in short order. That's how I got the UTF-8 (for .php) in. Done, I reopened your bug, since it was not completely fixed. -- Tom
Re: [PHP-DOC] UTF8 breaks everything
Nuno Lopes wrote: Ref: http://phpdoc.tsn.dk/da/function.mail.html Your server is returning: Content-Type: text/html; charset=iso-8859-1 It needs to send: Content-Type: text/html; charset=UTF-8 AllowOverride was not set to "All" for the livedocs directory, fixing that solved the problem (because now the .htaccess file is read). However once the page has been generated, the php_value is nolonger in effect, because now it's just a plain .html file that is opened and not a PHP file, which makes the webserver send the content-type "iso-8859-1" and again produces the problem above? Looks like you need to add a .htaccess file with: AddCharset UTF-8 .html That should be added to the .htaccess created by livedocs. -- Tom
Re: [PHP-DOC] UTF8 breaks everything
Curt Zirzow wrote: * Thus wrote Tom Sommer: Hey Guys, Converting livedocs to UTF8 has completely broken the danish manual. Is it the intention that the translators should convert chars like ïïï into htmlentities, or what is the procedure? In any case, the danish (and other international?) manual does not play well with the change to UTF8, so please advise :) Ref: http://phpdoc.tsn.dk/da/function.mail.html Your server is returning: Content-Type: text/html; charset=iso-8859-1 It needs to send: Content-Type: text/html; charset=UTF-8 AllowOverride was not set to "All" for the livedocs directory, fixing that solved the problem (because now the .htaccess file is read). However once the page has been generated, the php_value is nolonger in effect, because now it's just a plain .html file that is opened and not a PHP file, which makes the webserver send the content-type "iso-8859-1" and again produces the problem above? -- Tom
[PHP-DOC] UTF8 breaks everything
Hey Guys, Converting livedocs to UTF8 has completely broken the danish manual. Is it the intention that the translators should convert chars like ÆØÅ into htmlentities, or what is the procedure? In any case, the danish (and other international?) manual does not play well with the change to UTF8, so please advise :) Ref: http://phpdoc.tsn.dk/da/function.mail.html Regards -- Tom
[PHP-DOC] cvs: phpdoc /en/reference/mysql/functions mysql-field-name.xml
tomsommer Fri Sep 10 14:24:47 2004 EDT Modified files: /phpdoc/en/reference/mysql/functionsmysql-field-name.xml Log: Bug #30055 - Incorrect example http://cvs.php.net/diff.php/phpdoc/en/reference/mysql/functions/mysql-field-name.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc/en/reference/mysql/functions/mysql-field-name.xml diff -u phpdoc/en/reference/mysql/functions/mysql-field-name.xml:1.9 phpdoc/en/reference/mysql/functions/mysql-field-name.xml:1.10 --- phpdoc/en/reference/mysql/functions/mysql-field-name.xml:1.9Fri Feb 20 12:36:42 2004 +++ phpdoc/en/reference/mysql/functions/mysql-field-name.xmlFri Sep 10 14:24:47 2004 @@ -1,5 +1,5 @@ - + @@ -42,9 +42,9 @@ * username * password. */ -$link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); -if (!$db_selected) { -die('Could not set $dbname: ' . mysql_error()); +$link = @mysql_connect('localhost', 'mysql_user', 'mysql_password'); +if (!$link) { +die('Could not connect to MySQL server: ' . mysql_error()); } $dbname = 'mydb'; $db_selected = mysql_select_db($dbname, $link);
Re: [PHP-DOC] cvs: phpdoc /scripts revcheck.php
Yannick Torres wrote: On Sunday 05 September 2004 22:35, Philip Olson wrote: Please check your diffs before commit, this diff is impossible to understand. Oops, sorry. My editor transforms the tabulations into space... I have "just" add new file to escape. Would you like me to revert this commit and commit just this change ? While tabs are evil, it seems your editor has, in the process, made some poor choices on how to convert from tabs to spaces, I think you should revert. -- Tom
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions tempnam.xml
tomsommer Sat Aug 28 10:54:16 2004 EDT Modified files: /phpdoc/en/reference/filesystem/functions tempnam.xml Log: Bug #29876 - Very minor inaccuracy in the doc for tempnam() http://cvs.php.net/diff.php/phpdoc/en/reference/filesystem/functions/tempnam.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/filesystem/functions/tempnam.xml diff -u phpdoc/en/reference/filesystem/functions/tempnam.xml:1.6 phpdoc/en/reference/filesystem/functions/tempnam.xml:1.7 --- phpdoc/en/reference/filesystem/functions/tempnam.xml:1.6Mon Dec 15 11:49:45 2003 +++ phpdoc/en/reference/filesystem/functions/tempnam.xmlSat Aug 28 10:54:16 2004 @@ -1,5 +1,5 @@ - + @@ -36,7 +36,7 @@ - Returns the new temporary filename, or the &false; string on + Returns the new temporary filename, or &false; on failure. tempnam example
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions php-check-syntax.xml
tomsommer Thu Aug 26 14:01:06 2004 EDT Modified files: /phpdoc/en/reference/misc/functions php-check-syntax.xml Log: Re-word http://cvs.php.net/diff.php/phpdoc/en/reference/misc/functions/php-check-syntax.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/misc/functions/php-check-syntax.xml diff -u phpdoc/en/reference/misc/functions/php-check-syntax.xml:1.6 phpdoc/en/reference/misc/functions/php-check-syntax.xml:1.7 --- phpdoc/en/reference/misc/functions/php-check-syntax.xml:1.6 Thu Aug 26 13:47:30 2004 +++ phpdoc/en/reference/misc/functions/php-check-syntax.xml Thu Aug 26 14:01:05 2004 @@ -1,5 +1,5 @@ - + php_check_syntax @@ -22,8 +22,8 @@ If the error_message parameter is used, it will - contain the error message from the syntax check. error_message - is passed in by + contain the error message generated by the syntax check. error_message + is passed by reference.
Re: [PHP-DOC] Livedocs
Curt Zirzow wrote: * Thus wrote Derick Rethans: Heya, livedocs is now running on docs.php.net (do not announce it yet!) but not automatically updating so far. Please fix the following errors: [Sat Aug 21 16:49:25 2004] [error] [client 80.197.147.147] File does not exist: /local/Web/sites/livedocs/www/style.css I've got a bunch of fixes for the php.net theme, i'll send in a patch later today. http://livedocs.zirzow.dyndns.org/ Could someone also look at the php.net theme. http://docs.php.net/en/install.problems.html#install.problems.bugs should have a height of 100%, right? What about we also indent each level in the navigation? To easier distinguish them. -- Tom
[PHP-DOC] cvs: phpdoc /en/reference/regex/functions ereg.xml
tomsommer Mon Aug 16 18:35:06 2004 EDT Modified files: /phpdoc/en/reference/regex/functionsereg.xml Log: Fix bug #29712 - ereg() does not return TRUE http://cvs.php.net/diff.php/phpdoc/en/reference/regex/functions/ereg.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc/en/reference/regex/functions/ereg.xml diff -u phpdoc/en/reference/regex/functions/ereg.xml:1.7 phpdoc/en/reference/regex/functions/ereg.xml:1.8 --- phpdoc/en/reference/regex/functions/ereg.xml:1.7Tue Aug 3 13:25:34 2004 +++ phpdoc/en/reference/regex/functions/ereg.xmlMon Aug 16 18:35:06 2004 @@ -1,5 +1,5 @@ - + @@ -9,7 +9,7 @@ Description - boolereg + mixedereg stringpattern stringstring array®s @@ -47,7 +47,7 @@ - Returns &true; if a match for pattern was + Returns the length of the matched string if a match for pattern was found in string, or &false; if no matches were found or an error occurred.
[PHP-DOC] Re: cvs: phpdoc /en/language/oop5 decon.xml
Curt Zirzow wrote: Modified files: /phpdoc/en/language/oop5 decon.xml Log: Some rewording, and proto definitions /usr/local/bin/onsgmls:/www/phpdoc/en/language/oop5/decon.xml:65:19:E: end tag for "methodsynopsis" which is not finished make: *** [test] Error 1 -- Tom
[PHP-DOC] cvs: phpdoc /en/reference/mysql/functions mysql-fetch-lengths.xml
tomsommer Sat Aug 7 21:20:20 2004 EDT Modified files: /phpdoc/en/reference/mysql/functionsmysql-fetch-lengths.xml Log: Fix wrong "See also" function http://cvs.php.net/diff.php/phpdoc/en/reference/mysql/functions/mysql-fetch-lengths.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/mysql/functions/mysql-fetch-lengths.xml diff -u phpdoc/en/reference/mysql/functions/mysql-fetch-lengths.xml:1.4 phpdoc/en/reference/mysql/functions/mysql-fetch-lengths.xml:1.5 --- phpdoc/en/reference/mysql/functions/mysql-fetch-lengths.xml:1.4 Wed Jul 14 17:08:10 2004 +++ phpdoc/en/reference/mysql/functions/mysql-fetch-lengths.xml Sat Aug 7 21:20:20 2004 @@ -1,5 +1,5 @@ - + @@ -64,7 +64,7 @@ - See also mysql_fetch_len, + See also mysql_field_len, mysql_fetch_row, and strlen.
Re: [PHP-DOC] Re: cvs: phpdoc /en language-snippets.ent
Gabor Hojtsy wrote: Rerun configure, please always rerun configure when new files are added, or you get missing entity errors! You should not get missing entity errors anytime, since if you have run configure, it generated a missing-entities.ent file with the missing entities plugging in the holes, so if you encounter such an error, it is your error. Thanks, got the lession on IRC :) Was hoping my post would just get ignored, will remember this in the future. Sorry. -- Tom
[PHP-DOC] Re: cvs: phpdoc /en language-snippets.ent /en/reference/crack configure.xml /en/reference/domxml configure.xml /en/reference/fribidi configure.xml /en/reference/hw configure.xml /en/reference/iisfunc reference.xml /en/reference/java configure.xml /en/reference/lzf configure.xml /en/reference/mailparse configure.xml /en/reference/memcache configure.xml constants.xml reference.xml /en/reference/printer configure.xml /en/reference/zip configure.xml
Philip Olson wrote: Added files: /phpdoc/en/reference/memcache configure.xml constants.xml /phpdoc/en/reference/memcache reference.xml make test: /usr/local/bin/openjade:/www/phpdoc/en/reference/memcache/reference.xml:33:4:W: cannot generate system identifier for general entity "reference.memcache.configure" /usr/local/bin/openjade:/www/phpdoc/en/reference/memcache/reference.xml:33:4:E: general entity "reference.memcache.configure" not defined and no default entity /usr/local/bin/openjade:/www/phpdoc/en/reference/memcache/reference.xml:33:32:E: reference to entity "reference.memcache.configure" for which no system identifier could be generated /usr/local/bin/openjade:/www/phpdoc/en/reference/memcache/reference.xml:33:3: entity was defined here /usr/local/bin/openjade:/www/phpdoc/en/reference/memcache/reference.xml:34:4:W: cannot generate system identifier for general entity "reference.memcache.constants" /usr/local/bin/openjade:/www/phpdoc/en/reference/memcache/reference.xml:34:4:E: general entity "reference.memcache.constants" not defined and no default entity /usr/local/bin/openjade:/www/phpdoc/en/reference/memcache/reference.xml:34:32:E: reference to entity "reference.memcache.constants" for which no system identifier could be generated /usr/local/bin/openjade:/www/phpdoc/en/reference/memcache/reference.xml:34:3: entity was defined here -- Tom
Re: [PHP-DOC] Crediting translators
Nuno Lopes wrote: The translator are used to add a '' to the bookinfo.xml file. Check other translation projects for an example (hu, fr,...). Thanks, sorry for the noise. -- Tom
[PHP-DOC] Crediting translators
I feel that since we are starting to publicly credit contributions to the manual, that it would be nice if we had a page for each translation where the translators was listed (like on revcheck). Perhaps we could even maintain the list by parsing translators.xml? or just have a similar file where the documentation lead could maintain the names of active and inactive translators and translation leads? (the latter might be the best) Comments? -- Tom
Re: [PHP-DOC] Re: cvs: phpdoc /en bookinfo.xml contributors.xml
Gabor Hojtsy wrote: Livedocs is complaining: Parse file: contributors.xml Parsing file ID 4111 XML Error: /www/phpdoc/en/contributors.xml:21 junk after document element: ' ' Should be fixed now. Please recheck. It's fixed, livedocs complains about: XML: 37:2 undefined entity Line: 37 is &contributors; when you visit preface.html - and the link in bookinfo.html to the contributors is not there. Might be livedocs only - not sure. Rebuild the index please :) I just deleted my livedocs webfiles (sqlite databases etc), I still get the error - might be a livedocs issue Strange. Try a complete ./configure since the manual.xml.in file changed too. No go - same problem,, ilia was talking about this on IRC the other day - dunno of he figured out what was wrong or if it was livedocs specific. -- Tom
Re: [PHP-DOC] Re: cvs: phpdoc /en bookinfo.xml contributors.xml
Gabor Hojtsy wrote: Livedocs is complaining: Parse file: contributors.xml Parsing file ID 4111 XML Error: /www/phpdoc/en/contributors.xml:21 junk after document element: ' ' Should be fixed now. Please recheck. It's fixed, livedocs complains about: XML: 37:2 undefined entity Line: 37 is &contributors; when you visit preface.html - and the link in bookinfo.html to the contributors is not there. Might be livedocs only - not sure. Rebuild the index please :) I just deleted my livedocs webfiles (sqlite databases etc), I still get the error - might be a livedocs issue -- Tom
Re: [PHP-DOC] Re: cvs: phpdoc /en bookinfo.xml contributors.xml
Gabor Hojtsy wrote: gobaFri Jul 16 11:45:02 2004 EDT Added files: /phpdoc/encontributors.xml Livedocs is complaining: Parse file: contributors.xml Parsing file ID 4111 XML Error: /www/phpdoc/en/contributors.xml:21 junk after document element: ' ' Should be fixed now. Please recheck. It's fixed, livedocs complains about: XML: 37:2 undefined entity Line: 37 is &contributors; when you visit preface.html - and the link in bookinfo.html to the contributors is not there. Might be livedocs only - not sure. -- Tom
Re: [PHP-DOC] "Official" IRC chan?
Ken Tossell wrote: +1 for freenode/#phpdoc :P #php.doc on EFNet is the place to be now :) // Tom
Re: [PHP-DOC] the tag,
Gabor Hojtsy wrote: The docweb project was largely advertised on all doc mailling lists. Livedocs is in alpha stage. It has a couple of well know bugs. So, first let's fix them, and then make it public. Is it the intention that http://docs.php.net is going to some day replace http://www.php.net/docs.php ? NO! NO! NO! The distributed and online documentation will stay on mirror sites! docs.php.net is intended to be a development machine for phpdoc related activities (revchecks, dochowto, and test server for under development stuff - now for livedocs). eh, okay - I think we cleared that in the previous comments.. -- Tom
Re: [PHP-DOC] a few coding standards
Philip Olson wrote: Personally I think http://www.php.net/manual/en/function.mysqli-close.php is one of the most confusing manual pages I have seen to date, MySQLi docs are a bit confusing... consider the mysqli close: Here's how livedocs outputs it, looks a bit better huh? Not sure what version of livedocs this is (or how old these docs are) but it's the only online livedocs I could find: http://livedocs.coggeshall.org/en/function.mysqli-close.html The dir class also looks a lot better here: http://livedocs.coggeshall.org/en/class.dir.html Oh yes, much better... All the more reason to bling livedocs // Tom
Re: [PHP-DOC] a few coding standards
Philip Olson wrote: For the exotic entries listed in that post perhaps we can simply surround those with and format accordingly. And here's an example using the new format: http://www.php.net/manual/en/function.mysqli-close.php Is it possible to do indentation in: --- class mysqli { bool close ( void ) } --- to --- class mysqli { bool close ( void ) } --- Personally I think http://www.php.net/manual/en/function.mysqli-close.php is one of the most confusing manual pages I have seen to date, http://www.php.net/manual/en/class.dir.php is also high on that list Indentation of pseudo-objects would help a great deal. Anyway, mysqli-close is confusing :) -- Tom
[PHP-DOC] Re: Where did user contributed notes go?
Anatoliy Samara wrote: Hello phpdoc, Tha last time i've downloaded a PHP manual long ago in 2002 it had tons of user contributed notes in it. The notes were very usefull for me. Recently i've decided to update the manual, so I downloaded one and to my surprise found no notes in it. Why, where did they go? Are there still manual versions with notes in them? http://bugs.php.net/bug.php?id=29321 The master server has crashed (yes, crashed) and therefore no comments can be found in the manual. // Tom
[PHP-DOC] cvs: phpdoc /en/reference/strings/functions hebrev.xml hebrevc.xml
tomsommer Tue Jul 27 20:10:34 2004 EDT Modified files: /phpdoc/en/reference/strings/functions hebrev.xml hebrevc.xml Log: Change wording to make sense http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/hebrev.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/strings/functions/hebrev.xml diff -u phpdoc/en/reference/strings/functions/hebrev.xml:1.2 phpdoc/en/reference/strings/functions/hebrev.xml:1.3 --- phpdoc/en/reference/strings/functions/hebrev.xml:1.2Wed Apr 17 02:44:15 2002 +++ phpdoc/en/reference/strings/functions/hebrev.xmlTue Jul 27 20:10:34 2004 @@ -1,5 +1,5 @@ - + @@ -17,8 +17,8 @@ The optional parameter max_chars_per_line - indicates maximum number of characters per line will be - output. The function tries to avoid breaking words. + indicates maximum number of characters per line that will be + returned. The function tries to avoid breaking words. See also hebrevc http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/hebrevc.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/strings/functions/hebrevc.xml diff -u phpdoc/en/reference/strings/functions/hebrevc.xml:1.2 phpdoc/en/reference/strings/functions/hebrevc.xml:1.3 --- phpdoc/en/reference/strings/functions/hebrevc.xml:1.2 Wed Apr 17 02:44:15 2002 +++ phpdoc/en/reference/strings/functions/hebrevc.xml Tue Jul 27 20:10:34 2004 @@ -1,5 +1,5 @@ - + @@ -19,8 +19,8 @@ This function is similar to hebrev with the difference that it converts newlines (\n) to "
\n". The optional parameter max_chars_per_line - indicates maximum number of characters per line will be - output. The function tries to avoid breaking words. + indicates maximum number of characters per line that will be + returned. The function tries to avoid breaking words. See also hebrev
Re: [PHP-DOC] the tag, time for a title? (livedocs integration)
Nuno Lopes wrote: Livedocs still has a main problem: the links. What problem? that they are not compatible? or? Maybe you've never looked at livedoc's code. I was one of the livedocs' hackers and I've reviewed the code several times. There are some problems with docbook IDs for example (just check your build log). I noticed that :) The docweb project was largely advertised on all doc mailling lists. Livedocs is in alpha stage. It has a couple of well know bugs. So, first let's fix them, and then make it public. Is it the intention that http://docs.php.net is going to some day replace http://www.php.net/docs.php ? No! doc.php.net is designed for developpers, documenters and translators. It isn't aimed for public. It will serve as a livedocs testbed, as well as revcheck for translators, list of undocumented functions, functions without examples, etc Okay, I just interpreted Philip's comment as the public was going to use it: "People will slowly use it this way and the more people start using it the more people will complain and more importantly the more people will fix problems and add features. If a major problem exists there we can redirect users to php.net/manual/" Sorry for the stupid questions and thanks for clearing them up :) // Tom
Re: [PHP-DOC] the tag, time for a title? (livedocs integration)
Nuno Lopes wrote: Livedocs still has a main problem: the links. What problem? that they are not compatible? or? Livedocs isn't also working well with windows. Latest changes by Wez to make the paths relatives broke livedocs on windows, because of diffences on slashes (/ versus \) between phpdoc build system and livedoc's. I've already reported this problem a while ago, along with some solutions/patches to solve the problem. Since the docs are going to be made and hosted on a linux server, I don't see the big problem with that in terms of making php.net run on livedocs Once ready for testing (now?), docs.php.net can simply be livedocs like it used to be (or a shell of docweb) and we won't "advertise" it. People will slowly use it this way and the more people start using it the more people will complain and more importantly the more people will fix problems and add features. If a major problem exists there we can redirect users to php.net/manual/ Also, it should add excitement to the docweb project, a project few know even exists right now[1]. The docweb project was largely advertised on all doc mailling lists. Livedocs is in alpha stage. It has a couple of well know bugs. So, first let's fix them, and then make it public. Is it the intention that http://docs.php.net is going to some day replace http://www.php.net/docs.php ? -- Tom
[PHP-DOC] Re: Failure in posting a note to PHP manual.
Julio Sergio Santana wrote: I have tried several times to submit a note to the documentation of the php manual. And, here is the notification I receive each time: "There was an internal error processing your submission. Please try to submit again later." This has happened for several days. Is there a problem with my submission or with your server? Hi Julio, The server is dead atm. please be patient. // Tom
Re: [PHP-DOC] the tag, time for a title?
Nuno Lopes wrote: Livedocs is many times faster than our current method, which takes up to 4 days to "compile" all the manuals, livedocs could do this in 40 minutes. On your pc :) On my linux box, 166 Mhz, it takes much more :) My PC is a 450 Mhz The machine which compiles the manuals is a Dual XEON 2.6 GHz, so I suspect 40 min. is not that far off :) // Tom
Re: [PHP-DOC] the tag, time for a title?
Philip Olson wrote: The day livedocs becomes live, that will be a great day. :) What are we doing to make this happen? Are we testing livedocs with php.net layout anywhere? Livedocs is many times faster than our current method, which takes up to 4 days to "compile" all the manuals, livedocs could do this in 40 minutes. Currently Derick has to kick off the compile once in a while; with livedocs we could just schedule it with cron. The sooner the better :) // Tom
[PHP-DOC] cvs: phpdoc /en/language/oop5 iterations.xml
tomsommer Fri Jul 23 16:36:57 2004 EDT Modified files: /phpdoc/en/language/oop5iterations.xml Log: Fix typo http://cvs.php.net/diff.php/phpdoc/en/language/oop5/iterations.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/language/oop5/iterations.xml diff -u phpdoc/en/language/oop5/iterations.xml:1.2 phpdoc/en/language/oop5/iterations.xml:1.3 --- phpdoc/en/language/oop5/iterations.xml:1.2 Fri Jul 23 16:06:04 2004 +++ phpdoc/en/language/oop5/iterations.xml Fri Jul 23 16:36:57 2004 @@ -1,9 +1,9 @@ - + Object Iteration - PHP 5 provides a way for objects to to be defined so it is possible + PHP 5 provides a way for objects to be defined so it is possible to iterate through a list of items, with, for example a statement. By default, all public properties will be used for the iteration.
Re: [PHP-DOC] Re: cvs: phpdoc /en bookinfo.xml contributors.xml
Gabor Hojtsy wrote: Hi Tom, gobaFri Jul 16 11:45:02 2004 EDT Added files: /phpdoc/encontributors.xml Livedocs is complaining: Parse file: contributors.xml Parsing file ID 4111 XML Error: /www/phpdoc/en/contributors.xml:21 junk after document element: ' ' I have checked the file, but found no reason for such an error. Are you absolutely sure you updated your phpdoc checkout properly? I still get the error, and yes I'm sure... In addition, I also get this: http://phpdoc.tsn.dk/en/preface.html -- Tom
[PHP-DOC] cvs: phpdoc /en language-snippets.ent
tomsommer Sat Jul 17 13:35:30 2004 EDT Modified files: /phpdoc/en language-snippets.ent Log: Add missing space Fix wording for simplexml.iteration http://cvs.php.net/diff.php/phpdoc/en/language-snippets.ent?r1=1.105&r2=1.106&ty=u Index: phpdoc/en/language-snippets.ent diff -u phpdoc/en/language-snippets.ent:1.105 phpdoc/en/language-snippets.ent:1.106 --- phpdoc/en/language-snippets.ent:1.105 Sat Jul 17 13:00:37 2004 +++ phpdoc/en/language-snippets.ent Sat Jul 17 13:35:30 2004 @@ -1,4 +1,4 @@ - + @@ -302,13 +302,13 @@ safe mode'> -From PHP 4.3.3 on you can use this function with the +As of PHP 4.3.3 you can use this function with the NSAPI server module in Netscape/iPlanet/SunONE webservers, too.'> SimpleXML has made a rule of adding -iterative properties to most methods. They cannot be viewed usingvar_dump +iterative properties to most methods. They cannot be viewed using var_dump or anything else which can examine objects.'>
[PHP-DOC] Re: cvs: phpdoc /en bookinfo.xml contributors.xml language-snippets.ent preface.xml
Gabor Hojtsy wrote: gobaFri Jul 16 11:45:02 2004 EDT Added files: /phpdoc/en contributors.xml Livedocs is complaining: Parse file: contributors.xml Parsing file ID 4111 XML Error: /www/phpdoc/en/contributors.xml:21 junk after document element: ' ' // Tom
[PHP-DOC] [Fwd: note 44133 added to language.oop5.visibility]
Original Message Subject: note 44133 added to language.oop5.visibility Date: 15 Jul 2004 21:05:47 - From: [EMAIL PROTECTED] To: [EMAIL PROTECTED] Newsgroups: php.notes "Protected limits visiblity only to the class that defines the item." should read "Private limits visiblity only to the class that defines the item.".
[PHP-DOC] Re: [PHP-NOTES] note 43927 added to function.rtrim]
Aidan Lister wrote: What's the question? "HEX 00" or \x00 is a 0byte. Yea, but the manual says \0x00, not \x00 There seems to be an inordinate amount of questions posted to the manual. Clearly people aren't reading the mass of information on the add-note page. I don't agree. I don't think questions is the problem. I see more "Delete folders recursively" or "check if a remote file exists" notes than questions. E-mail validators are rare atm. But I'm 100% sure that nobody reads the text on the add-note page :) We could either cut down the information to a couple of lines, or add a "if you are not asking a question, tick this box" approach. "you are not asking a question, UNtick this box", but i doubt it would help -- Tom
[PHP-DOC] [Fwd: [PHP-NOTES] note 43927 added to function.rtrim]
Anyone? Original Message Subject: [PHP-NOTES] note 43927 added to function.rtrim Date: 8 Jul 2004 21:15:07 - From: [EMAIL PROTECTED] To: [EMAIL PROTECTED] Probably typo.. The above example returns warning of invalid range... Also I am not aware of any HEX 00 character, let me know if you see one;) //not working $clean = rtrim($binary, "\0x00..\0x1F"); //working $clean = rtrim($binary, "\x01..\x1F"); ?>
Re: [PHP-DOC] The Online Generation System
Gabor Hojtsy wrote: The translations are only displayed in the main website and in the mirrors when they have some thousands files translated. Currently, you have few files translated, so there is no point in having them on-line. I know it's not displayed on the website, but according to the document the danish manual should still be built, even though it's not displayed on the php.net website. That's my point :) ATM if it's built it will appear on the site too. According to this: http://www.php.net/source.php?url=/docs.php & http://www.php.net/source.php?url=/include/languages.inc The language might be built, but won't be shown until it's added to languages.inc You mean: links will not be printed for it. But the manual files themselfs will get on the server AFAIK. That's exactly what I'm saying, or trying to say :) // Tom
Re: [PHP-DOC] The Online Generation System
Derick Rethans wrote: The translations are only displayed in the main website and in the mirrors when they have some thousands files translated. Currently, you have few files translated, so there is no point in having them on-line. I know it's not displayed on the website, but according to the document the danish manual should still be built, even though it's not displayed on the php.net website. That's my point :) ATM if it's built it will appear on the site too. According to this: http://www.php.net/source.php?url=/docs.php & http://www.php.net/source.php?url=/include/languages.inc The language might be built, but won't be shown until it's added to languages.inc // Tom
Re: [PHP-DOC] The Online Generation System
Derick Rethans wrote: The translations are only displayed in the main website and in the mirrors when they have some thousands files translated. Currently, you have few files translated, so there is no point in having them on-line. I know it's not displayed on the website, but according to the document the danish manual should still be built, even though it's not displayed on the php.net website. That's my point :) ATM if it's built it will appear on the site too. But is it built, if you re-spin it now? // Tom
Re: [PHP-DOC] The Online Generation System
Nuno Lopes wrote: In the near future, all languages will be avaliable in our doc website throught livedocs. Yea I use livedocs to check the doc-changes on my server, it's actually very good, but it seems to dump PHP errors in log.txt and forget my configure line after each ./build.sh If you do a ./configure --something=aaa it saves the options for every ./build.sh you might run. The build system now run almost perfectly (it still have some problems on windows, but works). Have you read the README? :-) Yeah, I've read the README, but it doesn't seem to honor my configure line, it forgets paths and languages upen each build.sh I'll try and make a method to reproduce it. // Tom
Re: [PHP-DOC] The Online Generation System
Nuno Lopes wrote: The translations are only displayed in the main website and in the mirrors when they have some thousands files translated. Currently, you have few files translated, so there is no point in having them on-line. I know it's not displayed on the website, but according to the document the danish manual should still be built, even though it's not displayed on the php.net website. That's my point :) In the near future, all languages will be avaliable in our doc website throught livedocs. Yea I use livedocs to check the doc-changes on my server, it's actually very good, but it seems to dump PHP errors in log.txt and forget my configure line after each ./build.sh // Tom
[PHP-DOC] The Online Generation System
Hey guys, From http://www.php.net/manual/howto/chapter-online-generation.html: "This system generates manuals for all languages with a language-defs.ent file in the translation directory. However the listing of languages at http://www.php.net/docs and http://www.php.net/get/docs are static, so only manually added languages show up in those listings." Wouldn't this mean that the danish translation could be found here: http://www.php.net/manual/da/ even though it's not listed on http://www.php.net/docs.php ? This doesn't seem to be the case? // Tom, phpdoc-da maintainer
[PHP-DOC] Re: user comments on page http://ca.php.net/variables.scope
Jerry Marbas wrote: I entered user comments as [EMAIL PROTECTED] and zafar 16-Jan-2004 03:34 just copied them word for word right above. I thought this was weird but thought nothing of it. Now I look on your pages and I see that my comments have been removed and now the credit of what I typed goes to zafar! This is not fair?! why did you keep zafars comments instead of mine... i think the earlier copy should have been kept. You are correct (I checked the history). I have given you credit for your comment. I dont get paid for this and i really dont care, but fair i fair... Oh please // Tom
[PHP-DOC] cvs: phpdoc /en/reference/strings/functions str-replace.xml
tomsommer Mon Jun 14 05:45:09 2004 EDT Modified files: /phpdoc/en/reference/strings/functions str-replace.xml Log: Back out bogus commit. Remind me to smack Mr. Holst http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/str-replace.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc/en/reference/strings/functions/str-replace.xml diff -u phpdoc/en/reference/strings/functions/str-replace.xml:1.14 phpdoc/en/reference/strings/functions/str-replace.xml:1.15 --- phpdoc/en/reference/strings/functions/str-replace.xml:1.14 Mon Jun 14 03:42:44 2004 +++ phpdoc/en/reference/strings/functions/str-replace.xml Mon Jun 14 05:45:09 2004 @@ -1,11 +1,11 @@ - - + + str_replace - Erstatter alle forekomster af søgestrengen med erstatningsstrengen. + Replace all occurrences of the search string with the replacement string @@ -18,44 +18,47 @@ int&count - Denne funktion returnerer en streng eller et array med alle forekomster - af search i subject - erstattet med den givne replace-værdi. Hvis du - ikke skal bruge smarte erstaningsregler (som regulære udtryk), bør du - altid bruge denne funktion i stedet for ereg_replace - eller preg_replace. + This function returns a string or an array with all occurrences of + search in subject + replaced with the given replace value. If you + don't need fancy replacing rules (like regular expressions), you should + always use this function instead of ereg_replace or + preg_replace. - Siden PHP 4.0.5, kan ethvert parameter i str_replace - være et array. + As of PHP 4.0.5, every parameter in str_replace + can be an array. - I PHP-versioner tidligere end 4.3.3 eksisterede der en fejl når man - brugte arrays både som search- og replace - parametre hvilket forårsagede at tomme - search-indekser blev ignoreret, uden at følge med - i hvor pointeren var placeret i replace-arrayet. - Dette er blevet rettet i PHP 4.3.3, alle scripts der - hvilket på denne fejl skulle fjerne tomme søgeværdier tidligere for at - få funktionen til at opføre sig som den bør. + In PHP versions prior to 4.3.3 a bug existed when using arrays as + both search and replace + parameters which caused empty search indexes + to be skipped without advancing the internal pointer on the + replace array. This has been corrected in + PHP 4.3.3, any scripts which relied on this bug + should remove empty search values prior to calling this function in + order to mimick the original behavior. - Hvis subject er et array, så bliver søgningen og - erstatningen udført med hvert element i subject, - og returværdien bliver også et array. + If subject is an array, then the search + and replace is performed with every entry of + subject, and the return value is an array + as well. - Hvis search og replace er - arrays, så tager str_replace én værdi fra hver array - og bruger dem til at foretage søg og erstat på - subject. Hvis replace har - færre værdier end search, så bliver der brugt en - tom streng til resten af erstatningerne. Hvis - search er et array og - replace er en streng; så vil denne erstatning - blive brugt for hvert element i search. + If search and + replace are arrays, then + str_replace takes a value from each array + and uses them to do search and replace on + subject. If + replace has fewer values than + search, then an empty string is used for + the rest of replacement values. If search + is an array and replace is a string; then + this replacement string is used for every value of + search. @@ -63,21 +66,21 @@
[PHP-DOC] livedocs?
Is there an online version somewhere? Regards // Tom
Re: [PHP-DOC] updating the PHP manual (Xitami server)
Gabor Hojtsy wrote: Could someone with fixed IP please resend this? I get a rejection email, since I have dynamic IP, and the imatix SMTP server does not seem to like this. I sent it, as you can see. I got no error back and the mailserver said the response from the remote MTA was 250 OK (iirc). -- Tom Sommer, Denmark
[PHP-DOC] updating the PHP manual (Xitami server)
Dear Imatix Support, We are in the process of seriously revising and updating the installation instructions presented in the PHP Manual. We have a short section on installing PHP with Xitami [1], and so a lot of users felt that they know that better, and added their instructions. We would like to present accurate and up to date instructions out of the box, so I would like to ask you to help us provide updated instructions for Xitami server, so our readers can get the information, and use PHP with your product with satisfaction. Note that this email is publicly archived, and we would like to ask you to reply with the 'reply all' function, so others in the team will be able to read the information. Note that your answer will also be publicly archived. [1] http://php.net/install.xitami Thanks, Tom Sommer - PHP Documentation
[PHP-DOC] [Fwd: note 42618 added to function.array-splice]
Indeed Original Message Subject: note 42618 added to function.array-splice Date: 24 May 2004 01:00:06 - From: [EMAIL PROTECTED] To: [EMAIL PROTECTED] Newsgroups: php.notes bug in the example: array_shift($x) is equivalent to array_splice($x, 0, 1)
[PHP-DOC] Beginning a new translation
Hey everyone, I'm about to start translating to manual into danish. I already have the CVS account etc. etc. and a few people willing to help. My question is that since I see livedocs (what the hell is that anyway?) in action and constant changing of the english manual (in terms of SGML tags, code-examples etc.), is this a good time to start translating things? Or is it better to wait for whatever reason? My main concern is that we translate something which later needs to be changed again. Regards -- Tom Sommer, Denmark
Re: [PHP-DOC] Requests for Danish PHP-doc Translation
Gabor Hojtsy wrote: Actually only the people at systems@ have the adequate access permissions to create a new repository, so we cannot do much, but hope that someone sometime will pick up your request at [EMAIL PROTECTED] Yeah okay, I was just hoping they might see this message and then have a look at systems@ Thanks anyway :) -- Tom Sommer, Denmark
[PHP-DOC] Requests for Danish PHP-doc Translation
Hi, I would like to request the creation of a CVS module named `phpdoc-da`, and a `doc-da` mailing list Both for the new Danish translation of the PHP Manual. At the same time I would like to request karma to the CVS module (if needed?) I havn't been getting replies of this request on [EMAIL PROTECTED], so now I'm trying here. Hope that doesn't qualify as spam :) Regards -- Tom Sommer, Denmark
[PHP-DOC] Re: Is the online manual accepting user updates?
Christopher Jones wrote: I've tried to add comments to http://au3.php.net/manual/en/function.ocifetchinto.php twice in the past couple of weeks (most recently 4-5 days ago) and they have not appeared yet. Hi, The first one has been declined, the second shows up here: http://www.php.net/manual/en/function.ocifetchinto.php Regards -- Tom Sommer, Denmark
AW: [PHP-DOC] Question concerning xsl-styles
Von: Hartmut Holzgraefe [mailto:[EMAIL PROTECTED] > Thomas Schöfbeck wrote: > > I've found a(n easy ;) solution for building PDFs, simply use FOP > > 0.20.5rc2 and include the hyphenation-files from 0.20.4 (otherwise it > > would take the whole night listing error-msgs)). There is still much > > work to do, but if you're interested in the result: > > > > http://www.t0.or.at/~sunny/php/php_manual_en.pdf.zip > > this is looking *very* promising :) Many thanks! > the paragraph layout is not as perfect as with TeX or other layout > systems (regarding whitespace distribution in justified text) > but it is definetly readable (about as good as what Word does IMHO) If you mean the empty lines in the grey boxes before and after the real text: this is a general problem (also in html), there doesn't exist something like a trim() in XPATH 1.0. I've thought already about a manual template "xsl" for it checking char by char, but considering all the different encodings, etc. it would be too messy and time-consuming during the build. The only thing I could offer is to change step by step all the e.g. to > looks like we're finally done with DSSSL then? > (ok, i assume the fancy style for www.php.net still needs porting?) Hmmm On one hand I'd like to have more testing and feedback before (I did these 3 styles in just one week beside my job, so there might be several bugs). On the other hand, if I remember James' mail that omitting manual-builds for almost 7 weeks is due to a "problem" "a: take forever" (while html takes almost the same time with 20min, bightml takes with xsl 11min and dsssl 80min{!}), and we've got again a mail concerning a "printable format" we should speed up things. But as you've already mentioned, phpweb needs porting, and the following things should also be done before: - ensure that the building machine has physically 1 GB RAM (is needed by fop - will decrease when the dev-part got a separate doc), otherwise it would swap around the whole night for a job of 2 min.) JAMES: Would you please take care of this while you move stuff around? - Check, if there are hyphenation-files for all languages (otherwise fop shows a whole night error-msgs). I didn't check if fop 0.20.4 has hyph-files for all languages we provide as translation (just in case that there are some missing: would you be so kind and provide me the missing hyph-files from tex to rewrite and implement them into fop.jar {I don't wanna search and download 100s of MEGS for just 2 or 3 files}?) - xmllib (xsltproc), java, and fop (0.20.5rc2 with our adapted fop.jar) should be installed on the generating-machine. JAMES? - The configure/makefile should be adapted (implementation of images (still a open bug!), paths, etc.) the best would be with a temporary possibility for a fallback, and a final agreement with the systems-group (JAMES?) what will be called (so that we finally have control over build-process again via these files (see bugs #18914 and #20077 which wouldn't even occur if they went over us)) - and all the things that won't come into my mind in this very moment ;) Cu, Thomas -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] Question concerning xsl-styles
> > It would be good if somebody could check the results of the xsl-styles > > (also build-experiences on other boxes would be nice ;). > > > > If somebody can't build them, he can find it at > > > > html:http://www.t0.or.at/~sunny/php/php_manual_en.zip, and > > bightml: http://www.t0.or.at/~sunny/php/php_manual_en.html.zip > > > > I've found a(n easy ;) solution for building PDFs, simply use FOP > > 0.20.5rc2 and include the hyphenation-files from 0.20.4 (otherwise it > > would take the whole night listing error-msgs)). There is still much > > work to do, but if you're interested in the result: > > > > http://www.t0.or.at/~sunny/php/php_manual_en.pdf.zip > > > > All 3 zip-files have about 4 MB. > > Sorry, but I cannot devote time to this. You know, we are putting > together the first PHP conference, and every second thought of mine is > about it... If I forget about this, please remind me after 2,5 weeks > (then the conference will be over :). > > Goba No prob, have a successful conference! Thomas -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] cvs: phpdoc /howto tools.xml
> > This is an operating system independent section, > > -as most of the tools are written in the Java > > +as most of the tools are eighter provided for several > > +operating systems, are written in the Java > > uhm? That sentence doesn't compute to me, what about changing 'eighter' > to 'either' ? :) > > Derick You're right, sorry. Maybe my fingers were quicker than the brain again and stumbled over themselves ;) Thomas -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] #18914 [Opn]: Where are PNG pictures?
ID: 18914 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] Status: Open Bug Type: Documentation problem Operating System: Windows XP PHP Version: 4.2.2 New Comment: This bug applies also to 'php_manual_en.tar.bz2' and can be solved only with the help of somebody with access to the generating-machine (php_manual_en.tar.bz2 worked with the automated builds). We need to know how the builds are generated currently, (and should agree on for the future), because at least *.tar.bz2 is not genereated via our makefile. Just a short comparison for de: log-entry: rm -f php_manual_de.tar.bz2 && (cd html; tar -cf - *.html ) | bzip2 -9 > php_manual_de.tar.bz2 makefile: -rm -f $@ && (cd html; tar -cf - *.html figures) | bzip2 -9 > $@ (note the 'figures' in the brackets...) Thomas Previous Comments: [2003-01-21 03:30:13] [EMAIL PROTECTED] hmm, the CHMs should include them, atleast they did for some time. Derick [2003-01-21 02:42:56] [EMAIL PROTECTED] Anyone have any idea if these will ever be included in the html or chm manuals? [2002-12-13 13:02:49] [EMAIL PROTECTED] i have downloaded http://www.php.net/distributions/manual/php_manual_en.tar.bz2 and the figures are still missed (as of Dic 13, 2002) [2002-08-15 04:39:55] [EMAIL PROTECTED] They're in CVS in /ZendAPI/figures. They probably will be included when we split the PHP-users manual from the PHP-internals manual. [2002-08-15 04:30:09] [EMAIL PROTECTED] After downloading php_manual_en.html.bz2 and extracting it to my server directory I looked at my Apache error.log file and there were .png files missing: [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_1_PHPs_internal_structure.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_1a_Directory_Layout.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_2_firstmod_output.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_3_wrong_parameter_count.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_4_cross_converter.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_5_reference_test.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_6_variable_creation.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_7_warning_messages.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_8_phpinfo_output.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_9_execution_info.png [Thu Aug 15 01:15:53 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_11_userland.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_1_PHPs_internal_structure.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_1a_Directory_Layout.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_3_wrong_parameter_count.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_2_firstmod_output.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_4_cross_converter.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_5_reference_test.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_6_variable_creation.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_7_warning_messages.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_8_phpinfo_output.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_9_execution_info.png [Thu Aug 15 01:16:14 2002] [error] [client 127.0.0.1] File does not exist: d:/server/figures/Extending_Zend_11_userland.png I then realized this files were displayed in the
[PHP-DOC] #21727 [Fbk->Csd]: [CHM] Wrong pagewidth in en/features.http-auth.html
ID: 21727 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Feedback +Status: Closed Bug Type: Documentation problem Operating System: Windows PHP Version: 4.3.0 New Comment: This bug has been fixed in CVS. In case this was a PHP problem, snapshots of the sources are packaged every three hours; this change will be in the next snapshot. You can grab the snapshot at http://snaps.php.net/. In case this was a documentation problem, the fix will show up soon at http://www.php.net/manual/. In case this was a PHP.net website problem, the change will show up on the PHP.net site and on the mirror sites in short time. Thank you for the report, and for helping us make PHP better. Previous Comments: [2003-01-18 09:00:34] [EMAIL PROTECTED] What is the problem really on that page? Can you provide a bit more information... [2003-01-18 08:58:11] [EMAIL PROTECTED] The windows help (CHM) release from 2002-01-15 and earlier realeaes too. Contains wrong pagewidth in en/features.http-auth.html. -- Edit this bug report at http://bugs.php.net/?id=21727&edit=1 -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] #19767 [Ana->Csd]: dl isn´t supported on multi-threading servers
ID: 19767 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Analyzed +Status: Closed Bug Type: Documentation problem Operating System: not apply PHP Version: 4.2.3 New Comment: This bug has been fixed in CVS. In case this was a PHP problem, snapshots of the sources are packaged every three hours; this change will be in the next snapshot. You can grab the snapshot at http://snaps.php.net/. In case this was a documentation problem, the fix will show up soon at http://www.php.net/manual/. In case this was a PHP.net website problem, the change will show up on the PHP.net site and on the mirror sites in short time. Thank you for the report, and for helping us make PHP better. Previous Comments: [2002-10-06 12:49:20] [EMAIL PROTECTED] feel free to join the documentation translation team. [2002-10-06 12:01:25] [EMAIL PROTECTED] please compare http://www.php.net/manual/en/function.dl.php http://www.php.net/manual/de/function.dl.php okay, but my bug report is your fault. e05 [2002-10-05 15:27:36] [EMAIL PROTECTED] http://www.php.net/manual/en/function.dl.php see the second note: Note: dl() is not supported in multithreaded Web servers. Use the extensions statement in your php.ini when operating under such an environment. However, the CGI and CLI build are not affected ! [2002-10-05 14:49:42] [EMAIL PROTECTED] yes it is no doc problem. But theres is no note for that in the manual. e05 [2002-10-05 08:08:31] [EMAIL PROTECTED] 1.) not a doc problem 2.) duplicate 3.) submitted twice 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/19767 -- Edit this bug report at http://bugs.php.net/?id=19767&edit=1 -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Update changelog
-- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Update changelog
Maybe it's time to update the changelog? http://www.php.net/ChangeLog-4.php -- * Tom Sommer * http://www.tsn.dk | webmaster(a)tsn.dk * Any sufficiently advanced bug is indistinguishable from a feature -- * Tom Sommer * http://www.tsn.dk | webmaster(a)tsn.dk * Any sufficiently advanced bug is indistinguishable from a feature -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Bug #14732 Updated: Broken links in global.ent
ID: 14732 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] Status: Open Bug Type: Documentation problem Operating System: all PHP Version: 4.1.1 New Comment: Just a short update on links with probs: Connect failure: url.icap, url.openssl Host not found: url.mersenne.twister 404: Not Found: url.nis, url.stepwise.macosx-client, spec.hyperwave Thomas Previous Comments: [2002-04-06 06:10:41] [EMAIL PROTECTED] According to the checkent script, the following urls are still (or again) broken: url.icap: Could not open document: url.ldap.ldapworld: Could not open document: url.mersenne.twister: unknown host: www.scp.syr.edu url.nis: Could not open document: url.pfpro.download: unknown host: testmanager.signio.com Segmentation fault A segfault??? Damn... [2001-12-28 10:33:56] [EMAIL PROTECTED] broken links fixed for - adabas - ldap - libiconv [2001-12-28 09:55:54] [EMAIL PROTECTED] Please commit that little script into phpdoc into the scripts directory. We have some scripts there to test XML files, such as the entities.php or dbtags.php. It would be nice to make this test from time to time. To answer your current bug report, I have not time currently to skim through these addresses and find the right, so anybody with sufficient time, or who knows some of the right links would be welcome :) -- Goba [2001-12-28 08:04:05] [EMAIL PROTECTED] Hi, just wrote a little script and checked global.ent url.adabas: unknown host (www.adabas.com) url.hyperwave-proto: document not found (http://www.hyperwave.de/7.17-hg-prot) url.iicm: unknown host (iicm.edu) url.iptc: document not found or unreachable (http://www.iptc.org/) url.ldap.ldapworld: document not found or unreachable (http://elvira.innosoft.com/ldapworld) url.libiconv: document not found (http://clisp.cons.org/~haible/packages-libiconv.html) url.malinimg: document not found (http://www.pvv.org/~ssb/malin/bilder/mi/twain001.jpg) url.mersenne.twister: unknown host (www.scp.syr.edu) url.nis: document not found (http://www.desy.de/~sieversm/ypdoku/ypdoku/ypdoku.html) Georg -- Edit this bug report at http://bugs.php.net/?id=14732&edit=1
[PHP-DOC] Bug #17190 Updated: Date() gives error for date prior to 1-1-1970
ID: 17190 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] Status: Open Bug Type: Documentation problem Operating System: Windows NT 4.0 PHP Version: 4.2.0 New Comment: Yep, the exact output is Invalid date range Warning: unexpected error in date() in D:\Test\t.php on line 8 Previous Comments: [2002-05-22 06:52:35] [EMAIL PROTECTED] Please, someone check on Windows the routine I wrote. Maybe on Windows date() return error if time is -1. [2002-05-22 06:50:46] [EMAIL PROTECTED] I'm using PHP 4.1.2 and no error on date() as got on: The only error is that date will allways show the date of time = -1 on invalid range (< 1970 OR > 2038). Is only a code bug. You should verify if $time is -1. [2002-05-14 04:08:10] [EMAIL PROTECTED] Look also www.php.net/strtotime [2002-05-14 03:53:09] [EMAIL PROTECTED] Reopening as a documentation problem. I threw a quick glance on the php.net/date page last night and I couldn't find it there. If it's nere, it needs to be outlined better, or well, documented at all. [2002-05-14 02:19:09] [EMAIL PROTECTED] Sorry, but the bug system is not the appropriate forum for asking support questions. Your problem does not imply a bug in PHP itself. For a list of more appropriate places to ask for help using PHP, please visit http://www.php.net/support.php Thank you for your interest in PHP. This is a problem in Windows, not in PHP. Derick 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/17190 -- Edit this bug report at http://bugs.php.net/?id=17190&edit=1
[PHP-DOC] Bug #12868 Updated: Appendix G Descrepancies..
ID: 12868 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: win32 PHP Version: 4.0.6 New Comment: This bug has been fixed in CVS. You can grab a snapshot of the CVS version at http://snaps.php.net/. In case this was a documentation problem, the fix will show up soon at http://www.php.net/manual/. In case this was a PHP.net website problem, the change will show up on the PHP.net site and on the mirror sites. Thank you for the report, and for helping us make PHP better. Previous Comments: [2001-12-11 16:50:39] [EMAIL PROTECTED] This seems okay now. But, maybe the alias appendix should be auto-generated via something like "genaliasindex" ? [2001-08-21 13:35:12] [EMAIL PROTECTED] It doesn't matter at all indeed. For chop/rtrim: chop used to be main function, but since it's in perl and behaving differently over there, _and_ rtrim is consistent with trim and ltrim, I decided to document chop as the alias. Will update aliases.xml too. I recently suggested a better indication to aliases (in phpdoc/README -> CONVENTIONS), but that hasn't been implemented yet -> be patient. Btw: is_float will be master now, is_double the alias... PHP doesn't have double-precision floats, there's only one flavour. [2001-08-21 01:28:38] [EMAIL PROTECTED] Update status... [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 #12839 Updated: Descrepancy in Manual (Appendix G)
ID: 12839 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: win32 (9x SE) PHP Version: 4.0.6 New Comment: This bug has been fixed in CVS. You can grab a snapshot of the CVS version at http://snaps.php.net/. In case this was a documentation problem, the fix will show up soon at http://www.php.net/manual/. In case this was a PHP.net website problem, the change will show up on the PHP.net site and on the mirror sites. Thank you for the report, and for helping us make PHP better. Previous Comments: [2001-08-19 09:44:53] [EMAIL PROTECTED] Follow up on previous - Here's a quick list of what appears to be erratta in Appendix G: function listed as aliases to themselves: xpath_eval xpath_eval_expression xpath_init xpath_new_context As I'm still working my way through these, there may be more.. like the msql function prevously noted. [2001-08-19 07:22:36] [EMAIL PROTECTED] This may just be my misunderstanding.. in either case, i'm sure that if I'm a little confused, others might be as well. I've been working on assembling an expression file for HomeSite.. in so doing I wanted to create a set which highlights those functions which are "aliases".. So, I'm working with Appendix G and noted the following: The appendix essentailly states the "reverse" of the function documentation... The manual indicates the chop() is an alias to rtrim(), while the appendix indicates the reverse, naming chop() the "master function".. and rtrim() the alias...??? Also, on a different note - msql_affected_rows is labeled as as alias of itself? how can a function be an alias of itself? Can someone please clarify Appendix G? from the manual on chop: This function is an alias of rtrim(). Whil Appendix G indicates that chop() is the master function? This is repeated with most functions listed in G. Thanks, in advance for the input. -- Edit this bug report at http://bugs.php.net/?id=12839&edit=1
[PHP-DOC] Bug #16792 Updated: [chm] bug on features.http-auth.html
ID: 16792 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] Status: Feedback Bug Type: Documentation problem Operating System: windows PHP Version: 4.1.2 New Comment: This bug can be closed after feedback about the version from http://weblabor.hu/php-doc-chm/manual_notes_test.zip tom Previous Comments: [2002-05-20 15:33:02] [EMAIL PROTECTED] Can you please test this with http://weblabor.hu/php-doc-chm/manual_notes_test.zip Thank you Goba [2002-04-24 14:01:47] [EMAIL PROTECTED] What OS do you exactly use? What IE do you have installed. Aren't there errors on other pages? This error should pop up on all pages all the time, or nowhere, or on all pages sometimes, depending on what is the real error ;) (Note for phpdoc bug readers: this is the form of bug reports from the new chms. I hope it is good enough. I have included automations to post page names and CHM dates for guys to be able to trace if this error is corrected since that CHM release or not.) [2002-04-24 09:14:07] [EMAIL PROTECTED] I have found a bug on page features.http-auth.html [chm date: 2002-04-20]... I found at least 2 bugs with the same message reported: 'document.all.unotes' is null or not an object Reported on openning following items: "HTTP authentication with PHP" and "Function reference" items on line 3, char 25. Manual php_manual_en.chm distributed in php_manual_sample_5.zip -- Edit this bug report at http://bugs.php.net/?id=16792&edit=1
[PHP-DOC] Bug #17028 Updated: [chm] bug on language.types.resource.html
ID: 17028 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] Status: Feedback Bug Type: Documentation problem Operating System: windows PHP Version: 4.1.2 New Comment: Hi, there seems to be a misunderstanding. While Goba asked about the software, I've meant the new version of the manual at http://www.php.net/download-docs.php (curr. build 2002-05-20). Thomas Previous Comments: [2002-05-17 20:26:00] [EMAIL PROTECTED] Now I can't do the "Edit Submission" on the actual bug, it states that I "can't change bug to that state"...Did I miss something? Anyway thanks...where is this newer version? All I see is the version 5, built March 20th. Dennis Williams [2002-05-16 14:51:10] [EMAIL PROTECTED] There is a new version available (built 2002-05-09), in which I don't get such an error. (Don't have the old version to check it). Would you please check this new version if the problem still persisits? Thomas [2002-05-06 09:23:01] [EMAIL PROTECTED] WinME (4.90.3000) + IE 5.5 (128-bit Cipher Strength) Thanks, Dennis Williams [2002-05-06 04:07:55] [EMAIL PROTECTED] Strange. I still cannot reproduce any of these bugs with IE6 + Winxp and IE5 + Win2k. What Win OS do you have? Goba [2002-05-06 01:06:31] [EMAIL PROTECTED] I have found a bug on page language.types.resource.html [chm date: 2002-04-20]... I don't know if this is exactly a bug...it seems to do with IE 5.5 and script debugging. (I do have Microsoft Script Debugger installed on my system.) Even though I have script debugging turned off (and continue flag set to true when scripting errors encountered) I still get this pop-up on most pages in the .chm format help file: Internet Explorer Script Error An error has occurred in the script on this page. Line: 3 Char: 25 Error: 'document.all.unotes' is null or not an object Code: 0 URL: ... Do you want to continue running scripts on this page? Yes|No Line number, character number and error message seem to remain constant on all pages where this occurs. Thanks, Dennis Williams -- Edit this bug report at http://bugs.php.net/?id=17028&edit=1
[PHP-DOC] Bug #17081 Updated: $_GET != $HTTP_GET_VARS
ID: 17081 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: RH 7.2 PHP Version: 4.2.0 New Comment: This bug has been fixed in CVS. You can grab a snapshot of the CVS version at http://snaps.php.net/. In case this was a documentation problem, the fix will show up soon at http://www.php.net/manual/. In case this was a PHP.net website problem, the change will show up on the PHP.net site and on the mirror sites. Thank you for the report, and for helping us make PHP better. Previous Comments: [2002-05-07 17:10:04] [EMAIL PROTECTED] This is not really a bug, making this a documentation issue. Derick [2002-05-07 15:58:11] [EMAIL PROTECTED] There is a problem with $_GET and $HTTP_GET_VARS. In documentation, in Predefined Variables is mentioned: "$HTTP_GET_VARS contains the same information, but is not an autoglobal." That's true only in one condition - when we are talking about REAL variables passed by GET. But when we set one variable explicity in $HTTP_GET_VARS it is doesn't set in $_GET and vice versa, ie: $HTTP_GET_VARS["sthnew"] = "some str"; echo $_GET["sthnew"]; // There is no such index And: $_GET["sthnew"] = "some str"; echo $HTTP_GET_VARS["sthnew"]; // There is no such index but !! $HTTP_SESSION_VARS["sthnew"] = "some str"; echo $_SESSION["sthnew"]; // Everything is OK I know that _GET and HTTP_GET_VARS shouldn't be set explicity, but I'm doing sth like URL coding and decoding to hide variables from being watched by users and I'm coding also session id. After decoding I write session sid in HTTP_GET_VARS and call session_start(). But session_start() use _only_ $_GET array, not $HTTP_GET_VARS and of course sessions doesn't work. I think you should change documentation or change this feature :) When I read: "$HTTP_GET_VARS contains the same information..." it means for me THE SAME ALL THE TIME... If it doesn't it is very confusing :( Especially that $_SESSION and $HTTP_SESSION_VARS contains the same information all the time. Adam -- Edit this bug report at http://bugs.php.net/?id=17081&edit=1
[PHP-DOC] Bug #17289 Updated: missing word in german translation
ID: 17289 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: N.A. PHP Version: 4.2.1 New Comment: This bug has been fixed in CVS. You can grab a snapshot of the CVS version at http://snaps.php.net/. In case this was a documentation problem, the fix will show up soon at http://www.php.net/manual/. In case this was a PHP.net website problem, the change will show up on the PHP.net site and on the mirror sites. Thank you for the report, and for helping us make PHP better. Thanks for the note! Previous Comments: [2002-05-17 10:42:23] [EMAIL PROTECTED] in http://de.php.net/manual/de/class.variant.php (german translation of the manual): VARIANT (unknown) VARIANT -- VARIANT Klasse Synopsis $vVar = new VARIANT($var) Beschreibung Ein einfacher Container, um Variablen VARIANT Strukturen zu verpacken. There is missing the word 'in' between 'Variablen' and 'VARIANT'. The correct sentence must be something like: Ein einfacher Container, um Variablen in VARIANT Strukturen zu verpacken. -- Edit this bug report at http://bugs.php.net/?id=17289&edit=1
[PHP-DOC] Bug #17028 Updated: [chm] bug on language.types.resource.html
ID: 17028 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Open +Status: Feedback Bug Type: Documentation problem Operating System: windows PHP Version: 4.1.2 New Comment: There is a new version available (built 2002-05-09), in which I don't get such an error. (Don't have the old version to check it). Would you please check this new version if the problem still persisits? Thomas Previous Comments: [2002-05-06 09:23:01] [EMAIL PROTECTED] WinME (4.90.3000) + IE 5.5 (128-bit Cipher Strength) Thanks, Dennis Williams [2002-05-06 04:07:55] [EMAIL PROTECTED] Strange. I still cannot reproduce any of these bugs with IE6 + Winxp and IE5 + Win2k. What Win OS do you have? Goba [2002-05-06 01:06:31] [EMAIL PROTECTED] I have found a bug on page language.types.resource.html [chm date: 2002-04-20]... I don't know if this is exactly a bug...it seems to do with IE 5.5 and script debugging. (I do have Microsoft Script Debugger installed on my system.) Even though I have script debugging turned off (and continue flag set to true when scripting errors encountered) I still get this pop-up on most pages in the .chm format help file: Internet Explorer Script Error An error has occurred in the script on this page. Line: 3 Char: 25 Error: 'document.all.unotes' is null or not an object Code: 0 URL: ... Do you want to continue running scripts on this page? Yes|No Line number, character number and error message seem to remain constant on all pages where this occurs. Thanks, Dennis Williams -- Edit this bug report at http://bugs.php.net/?id=17028&edit=1
[PHP-DOC] Bug #17132 Updated: [chm] bug on function.header.html
ID: 17132 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Open +Status: Feedback Bug Type: Documentation problem Operating System: windows PHP Version: 4.0CVS-2002-05-09 New Comment: There is a new version available (built 2002-05-09), in which I can't find an error at the "header" function. (Don't have the old version to check it). Would you please check this new version if the problem still persisits? Previous Comments: [2002-05-10 04:38:27] [EMAIL PROTECTED] Reclassified. [2002-05-09 23:50:06] [EMAIL PROTECTED] I have found a bug on page function.header.html [chm date: 2002-04-20]... 'document.all.unotes' is null or not an object -- Edit this bug report at http://bugs.php.net/?id=17132&edit=1
[PHP-DOC] Bug #16234 Updated: important language features only mentioned in passing
ID: 16234 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: WinXP PHP Version: 4.1.2 New Comment: "global" as well as "static" are listed in the "List of Keywords" (http://at.php.net/manual/en/reserved.php), and are described in the Language Reference (exactly Variable Scope, http://at.php.net/manual/en/language.variables.scope.php), which is also linked from the Keyword-list. Previous Comments: [2002-03-23 11:49:07] [EMAIL PROTECTED] There is no page for the keywords "global" or "static". Neither can be found in the index. There are many things like this that are only mentioned in passing, without having an actual definition. -- Edit this bug report at http://bugs.php.net/?id=16234&edit=1
[PHP-DOC] Bug #16220 Updated: mistake in writing
ID: 16220 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] -Status: Open +Status: Closed Bug Type:Documentation problem PHP Version: 4.1.2 New Comment: This is already fixed in CVS, and appear on the net after the next automatic build-process. Thanks for notification! Previous Comments: [2002-03-22 10:20:46] [EMAIL PROTECTED] reclassified [2002-03-22 09:20:04] [EMAIL PROTECTED] http://de.php.net/manual/de/preface.php there is a mistake in writing " Vorwort (...) Aber PHP knn noch mehr. (...)" you have to change "knn" and make "kann" out of it. please excuse my bad english. so long etrigan.de -- Edit this bug report at http://bugs.php.net/?id=16220&edit=1
[PHP-DOC] Bug #12037 Updated: Wrong description in german translation
ID: 12037 Updated by: tom Reported By: [EMAIL PROTECTED] Status: Closed Bug Type: Documentation problem Operating System: PHP Version: 4.0.6 New Comment: Sorry, just forgot to close it Previous Comments: [2001-07-11 05:19:06] [EMAIL PROTECTED] It's fixed, so closing [2001-07-11 05:17:15] [EMAIL PROTECTED] Is corrected in the CVS, and will be online tomorrow. [2001-07-11 03:48:30] [EMAIL PROTECTED] function array_pad(); Ist der Parameter !!! pad_value !!! positiv, wird das Array rechts erweitert, ist er negativ, dann erfolgt die Erweiterung links. It has to be: Ist der Parameter !!! pad_size !!! positiv, wird das Array rechts erweitert, ist er negativ, dann erfolgt die Erweiterung links. ATTENTION! Do NOT reply to this email! To reply, use the web interface found at http://bugs.php.net/?id=12037&edit=1
[PHP-DOC] Bug #12037 Updated: Wrong description in german translation
ID: 12037 Updated by: tom Reported By: [EMAIL PROTECTED] Status: Open Bug Type: Documentation problem Operating System: PHP Version: 4.0.6 New Comment: Is corrected in the CVS, and will be online tomorrow. Previous Comments: [2001-07-11 03:48:30] [EMAIL PROTECTED] function array_pad(); Ist der Parameter !!! pad_value !!! positiv, wird das Array rechts erweitert, ist er negativ, dann erfolgt die Erweiterung links. It has to be: Ist der Parameter !!! pad_size !!! positiv, wird das Array rechts erweitert, ist er negativ, dann erfolgt die Erweiterung links. ATTENTION! Do NOT reply to this email! To reply, use the web interface found at http://bugs.php.net/?id=12037&edit=1