[PHP-DOC] #42216 [Opn-Csd]: oop5 basics- extends. Sentence incorrect
ID: 42216 Updated by: [EMAIL PROTECTED] Reported By: elroy_chops at hotmail dot com -Status: Open +Status: Closed Bug Type:Documentation problem PHP Version: Irrelevant New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: [2007-08-06 03:09:31] elroy_chops at hotmail dot com Description: PHP Manual Classes and Objects (PHP 5) The Basics Extends Tiny change required to the below sentence from this page http://au3.php.net/manual/en/language.oop5.basic.php The inherited methods and members can be overridden, unless the parent class has defined a method as final, by redeclaring them within the same name defined in the parent class. The word 'within' should be replaced by the word 'with'. See below. The inherited methods and members can be overridden, unless the parent class has defined a method as final, by redeclaring them with the same name defined in the parent class. -- Edit this bug report at http://bugs.php.net/?id=42216edit=1
RE: [PHP-DOC] Linking to methods (was cvs: phpdoc /en/reference/http/HttpResponse setCacheControl.xml)
-Original Message- From: Hannes Magnusson [mailto:[EMAIL PROTECTED] Sent: 04 August 2007 15:01 To: phpdoc@lists.php.net Subject: [PHP-DOC] Linking to methods (was cvs: phpdoc /en/reference/http/HttpResponse setCacheControl.xml) HI all I may have forgot to let you guys know.. functionclassname::method/function and functionclassname-method/function work now. There is a catch though: It does ID lookup, meaning if the ID of the method is camelCased you'll have to functionclassName::camelCaseItToo/function. As per our standard, all IDs should be lowercased so that, in theory, isn't a problem. In the future (once we have fixed all the wrong IDs) I'd like to do strtolower() on the function / and then look it up. That will give the OO docs the possibility to camelCaseTheLinks without breaking our ID convention. -Hannes The wrong IDs is something I was looking at. Take a look at phpdoc/en/zip/functions/ziparchive-setCommentName.xml This has an id of function.ziparchive-setCommentName. If you now look at the function index http://www.php.net/manual/en/indexes.php, you'll see that ZipArchive::setCommentName() is not a link. There are MANY like this. Just over 700 aren't rendered as links. Some are also shown with double () and are also not shown as links. OOI. In the xCHM manual, they ARE shown as links, but don't link. The xCHM link is ... mk:@MSITStore:D:\Personal%20Files\Software\PHP\Manual\php_manual_en.chm: :/function.SoapClient-call().html The whole page name is incorrect. The actual page is ... mk:@MSITStore:D:\Personal%20Files\Software\PHP\Manual\php_manual_en.chm: :/function.soap-soapclient-call.html The ID in the /phpdoc/en/reference/soap/soap-soapclient-call.xml is xml:id=function.soap-soapclient-call. So url name and id match, but rendering of id as a link is not. I can fix the uppercase ones easily enough, but those like this I don't know enough, sorry. Richard.
[PHP-DOC] cvs: phpdoc /en/language/oop5 basic.xml
rquadling Mon Aug 6 08:41:56 2007 UTC Modified files: /phpdoc/en/language/oop5basic.xml Log: Fix #42216 http://cvs.php.net/viewvc.cgi/phpdoc/en/language/oop5/basic.xml?r1=1.22r2=1.23diff_format=u Index: phpdoc/en/language/oop5/basic.xml diff -u phpdoc/en/language/oop5/basic.xml:1.22 phpdoc/en/language/oop5/basic.xml:1.23 --- phpdoc/en/language/oop5/basic.xml:1.22 Wed Jun 20 22:24:13 2007 +++ phpdoc/en/language/oop5/basic.xml Mon Aug 6 08:41:56 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.22 $ -- +!-- $Revision: 1.23 $ -- sect1 xml:id=language.oop5.basic xmlns=http://docbook.org/ns/docbook; titleThe Basics/title @@ -194,7 +194,7 @@ para The inherited methods and members can be overridden, unless the parent class has defined a method as link linkend=language.oop5.finalfinal/link, -by redeclaring them within the same name defined in the parent class. +by redeclaring them with the same name defined in the parent class. It is possible to access the overridden methods or members by referencing them with link linkend=language.oop5.paamayim-nekudotayimparent::/link /para
Re: [PHP-DOC] Linking to methods (was cvs: phpdoc /en/reference/http/HttpResponse setCacheControl.xml)
On 8/6/07, Richard A. Quadling [EMAIL PROTECTED] wrote: -Original Message- From: Hannes Magnusson [mailto:[EMAIL PROTECTED] Sent: 04 August 2007 15:01 To: phpdoc@lists.php.net Subject: [PHP-DOC] Linking to methods (was cvs: phpdoc /en/reference/http/HttpResponse setCacheControl.xml) HI all I may have forgot to let you guys know.. functionclassname::method/function and functionclassname-method/function work now. There is a catch though: It does ID lookup, meaning if the ID of the method is camelCased you'll have to functionclassName::camelCaseItToo/function. As per our standard, all IDs should be lowercased so that, in theory, isn't a problem. In the future (once we have fixed all the wrong IDs) I'd like to do strtolower() on the function / and then look it up. That will give the OO docs the possibility to camelCaseTheLinks without breaking our ID convention. -Hannes The wrong IDs is something I was looking at. Take a look at phpdoc/en/zip/functions/ziparchive-setCommentName.xml This has an id of function.ziparchive-setCommentName. If you now look at the function index http://www.php.net/manual/en/indexes.php, you'll see that ZipArchive::setCommentName() is not a link. Thats exactly what I was talking about. Due to the fact IDs are mixed cases we cannot strtolower(ZipArchive::setCommentName) and then look it up. If the ID was function.ZipArchive-setCommentName however it would work. There are MANY like this. Just over 700 aren't rendered as links. Many of those will probably be fixed in the next build Some are also shown with double () and are also not shown as links. That is a problem with the generation script. It should not add (). (Which in turn, is the refname fault..) OOI. In the xCHM manual, they ARE shown as links, but don't link. The xCHM link is ... mk:@MSITStore:D:\Personal%20Files\Software\PHP\Manual\php_manual_en.chm: :/function.SoapClient-call().html The whole page name is incorrect. The actual page is ... mk:@MSITStore:D:\Personal%20Files\Software\PHP\Manual\php_manual_en.chm: :/function.soap-soapclient-call.html The ID in the /phpdoc/en/reference/soap/soap-soapclient-call.xml is xml:id=function.soap-soapclient-call. So url name and id match, but rendering of id as a link is not. No, it doesn't match. indexentryprimaryiefunctionSoapClient-#62;__call()/function/primaryie/indexentry I can fix the uppercase ones easily enough, but those like this I don't know enough, sorry. Well... that really is a totally another problem which will break bunch of things for people... My suggestion was fck it. lets fix all those filenames+IDs in one go but people didn't really like that idea... -Hannes
[PHP-DOC] cvs: phpdoc /en/reference/posix/functions posix-geteuid.xml
samesch Mon Aug 6 12:30:06 2007 UTC Modified files: /phpdoc/en/reference/posix/functionsposix-geteuid.xml Log: Fixed structure of refsects; trailing WS http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/posix/functions/posix-geteuid.xml?r1=1.7r2=1.8diff_format=u Index: phpdoc/en/reference/posix/functions/posix-geteuid.xml diff -u phpdoc/en/reference/posix/functions/posix-geteuid.xml:1.7 phpdoc/en/reference/posix/functions/posix-geteuid.xml:1.8 --- phpdoc/en/reference/posix/functions/posix-geteuid.xml:1.7 Wed Jun 20 22:25:15 2007 +++ phpdoc/en/reference/posix/functions/posix-geteuid.xml Mon Aug 6 12:30:06 2007 @@ -1,11 +1,11 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.7 $ -- +!-- $Revision: 1.8 $ -- refentry xml:id=function.posix-geteuid xmlns=http://docbook.org/ns/docbook; refnamediv refnameposix_geteuid/refname refpurposeReturn the effective user ID of the current process/refpurpose /refnamediv - + refsect1 role=description reftitle.description; methodsynopsis @@ -18,14 +18,21 @@ to convert this into a useable username. /para /refsect1 - + + refsect1 role=returnvalues + reftitle.returnvalues; + para + Returns the user id, as an typeinteger/type + /para + /refsect1 + refsect1 role=examples reftitle.examples; para example titlefunctionposix_geteuid/function example/title paraThis example will show the current user id then set the -effective user id to a separate id using +effective user id to a separate id using functionposix_seteuid/function, then show the difference between the real id and the effective id./para programlisting role=php @@ -42,13 +49,6 @@ /example /para /refsect1 - - refsect1 role=returnvalues - reftitle.returnvalues; - para - Returns the user id, as an typeinteger/type - /para - /refsect1 refsect1 role=seealso reftitle.seealso;
[PHP-DOC] cvs: phpdoc /en/reference/posix/functions posix-getgid.xml
samesch Mon Aug 6 12:44:40 2007 UTC Modified files: /phpdoc/en/reference/posix/functionsposix-getgid.xml Log: typo http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/posix/functions/posix-getgid.xml?r1=1.8r2=1.9diff_format=u Index: phpdoc/en/reference/posix/functions/posix-getgid.xml diff -u phpdoc/en/reference/posix/functions/posix-getgid.xml:1.8 phpdoc/en/reference/posix/functions/posix-getgid.xml:1.9 --- phpdoc/en/reference/posix/functions/posix-getgid.xml:1.8Wed Jun 20 22:25:15 2007 +++ phpdoc/en/reference/posix/functions/posix-getgid.xmlMon Aug 6 12:44:40 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.8 $ -- +!-- $Revision: 1.9 $ -- refentry xml:id=function.posix-getgid xmlns=http://docbook.org/ns/docbook; refnamediv refnameposix_getgid/refname @@ -30,8 +30,8 @@ example titlefunctionposix_getgid/function example/title para - This example will print out the real group id, even once it - the effective group id has been changed. + This example will print out the real group id, even once the effective + group id has been changed. /para programlisting role=php ![CDATA[
[PHP-DOC] #42221 [NEW]: spl_autoload_register parameter type
From: oliver dot saunders at gmail dot com Operating system: PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: spl_autoload_register parameter type Description: http://php.net/spl_autoload_register says that the function accepts a mixed parameter when it is in fact a callback. If this is not the case it is unclear and the function description should be revised. A link to information about the callback type would probably be useful as well. Expected result: bool spl_autoload_register ( [callback $autoload_function] ) Actual result: -- bool spl_autoload_register ( [mixed $autoload_function] ) -- Edit bug report at http://bugs.php.net/?id=42221edit=1 -- Try a CVS snapshot (PHP 4.4): http://bugs.php.net/fix.php?id=42221r=trysnapshot44 Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=42221r=trysnapshot52 Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=42221r=trysnapshot60 Fixed in CVS: http://bugs.php.net/fix.php?id=42221r=fixedcvs Fixed in release: http://bugs.php.net/fix.php?id=42221r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=42221r=needtrace Need Reproduce Script:http://bugs.php.net/fix.php?id=42221r=needscript Try newer version:http://bugs.php.net/fix.php?id=42221r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=42221r=support Expected behavior:http://bugs.php.net/fix.php?id=42221r=notwrong Not enough info: http://bugs.php.net/fix.php?id=42221r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=42221r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=42221r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=42221r=php3 Daylight Savings: http://bugs.php.net/fix.php?id=42221r=dst IIS Stability:http://bugs.php.net/fix.php?id=42221r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=42221r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=42221r=float No Zend Extensions: http://bugs.php.net/fix.php?id=42221r=nozend MySQL Configuration Error:http://bugs.php.net/fix.php?id=42221r=mysqlcfg
[PHP-DOC] #42215 [Opn]: dns_get_record not defined
ID: 42215 Updated by: [EMAIL PROTECTED] Reported By: developer-support at allknightaccess dot com Status: Open -Bug Type: HTTP related +Bug Type: Documentation problem Operating System: Mac OS 10.4.10, Apache 2.2.4 PHP Version: 5.2.4RC1 New Comment: Reclassified. This function is not available on *BSD systems. And IIRC, MacOSX is based on *BSD. Docs need to mention it though.. Previous Comments: [2007-08-06 02:43:45] developer-support at allknightaccess dot com Description: The function dns_get_record is not being defined on Mac OS 10.4.10. Reproduce code: --- ?php $result = dns_get_record(php.net); print_r($result); ? Expected result: Array ( [0] = Array ( [host] = php.net [type] = MX [pri] = 5 [target] = pair2.php.net [class] = IN [ttl] = 6765 ) [1] = Array ( [host] = php.net [type] = A [ip] = 64.246.30.37 [class] = IN [ttl] = 8125 ) ) Actual result: -- Fatal error: Call to undefined function dns_get_record() -- Edit this bug report at http://bugs.php.net/?id=42215edit=1
[PHP-DOC] #42224 [NEW]: spelling error on mssql_bind page
From: dwhytock at vigilant-services dot com Operating system: PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: spelling error on mssql_bind page Description: On the english page for mssql_bind, Wether should be Whether in two places. -- Edit bug report at http://bugs.php.net/?id=42224edit=1 -- Try a CVS snapshot (PHP 4.4): http://bugs.php.net/fix.php?id=42224r=trysnapshot44 Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=42224r=trysnapshot52 Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=42224r=trysnapshot60 Fixed in CVS: http://bugs.php.net/fix.php?id=42224r=fixedcvs Fixed in release: http://bugs.php.net/fix.php?id=42224r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=42224r=needtrace Need Reproduce Script:http://bugs.php.net/fix.php?id=42224r=needscript Try newer version:http://bugs.php.net/fix.php?id=42224r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=42224r=support Expected behavior:http://bugs.php.net/fix.php?id=42224r=notwrong Not enough info: http://bugs.php.net/fix.php?id=42224r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=42224r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=42224r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=42224r=php3 Daylight Savings: http://bugs.php.net/fix.php?id=42224r=dst IIS Stability:http://bugs.php.net/fix.php?id=42224r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=42224r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=42224r=float No Zend Extensions: http://bugs.php.net/fix.php?id=42224r=nozend MySQL Configuration Error:http://bugs.php.net/fix.php?id=42224r=mysqlcfg
[PHP-DOC] cvs: phpdoc /en/internals2/ze1/zendapi arguments.xml overview.xml possibilities.xml printing.xml
bjori Mon Aug 6 22:57:56 2007 UTC Modified files: /phpdoc/en/internals2/ze1/zendapi arguments.xml overview.xml possibilities.xml printing.xml Log: Really fix the build # $%$#%#/#$%!#$% http://cvs.php.net/viewvc.cgi/phpdoc/en/internals2/ze1/zendapi/arguments.xml?r1=1.6r2=1.7diff_format=u Index: phpdoc/en/internals2/ze1/zendapi/arguments.xml diff -u phpdoc/en/internals2/ze1/zendapi/arguments.xml:1.6 phpdoc/en/internals2/ze1/zendapi/arguments.xml:1.7 --- phpdoc/en/internals2/ze1/zendapi/arguments.xml:1.6 Sun Aug 5 21:17:40 2007 +++ phpdoc/en/internals2/ze1/zendapi/arguments.xml Mon Aug 6 22:57:56 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=ISO-8859-1 ? - !-- $Revision: 1.6 $ -- + !-- $Revision: 1.7 $ -- sect2 xml:id=internals2.ze1.zendapi.arguments xmlns=http://docbook.org/ns/docbook; titleAccepting Arguments/title para @@ -618,7 +618,7 @@ para You can find a demonstration of the behavior in filenamecross_conversion.php/filename on the accompanying - CD-ROM. xref linkend=internals2.ze1.zendapi.fig.cross-convert/ shows the output. + CD-ROM. /para /note mediaobject xml:id=internals2.ze1.zendapi.fig.cross-convert http://cvs.php.net/viewvc.cgi/phpdoc/en/internals2/ze1/zendapi/overview.xml?r1=1.5r2=1.6diff_format=u Index: phpdoc/en/internals2/ze1/zendapi/overview.xml diff -u phpdoc/en/internals2/ze1/zendapi/overview.xml:1.5 phpdoc/en/internals2/ze1/zendapi/overview.xml:1.6 --- phpdoc/en/internals2/ze1/zendapi/overview.xml:1.5 Sun Aug 5 20:15:40 2007 +++ phpdoc/en/internals2/ze1/zendapi/overview.xml Mon Aug 6 22:57:56 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=ISO-8859-1 ? - !-- $Revision: 1.5 $ -- + !-- $Revision: 1.6 $ -- sect2 xml:id=internals2.ze1.zendapi.overview xmlns=http://docbook.org/ns/docbook; titleOverview/title @@ -37,8 +37,9 @@ The name emphasisZend/emphasis refers to the language engine, PHP's core. The term emphasisPHP/emphasis refers to the complete system as it appears from the outside. This might sound -a bit confusing at first, but it's not that complicated (see -xref linkend=internals2.ze1.zendapi.fig.internal-struct/). To implement a Web script interpreter, you need +a bit confusing at first, but it's not that complicated ( +link linkend=internals2.ze1.zendapi.fig.internal-structsee + below/link). To implement a Web script interpreter, you need three parts: orderedlist listitem http://cvs.php.net/viewvc.cgi/phpdoc/en/internals2/ze1/zendapi/possibilities.xml?r1=1.2r2=1.3diff_format=u Index: phpdoc/en/internals2/ze1/zendapi/possibilities.xml diff -u phpdoc/en/internals2/ze1/zendapi/possibilities.xml:1.2 phpdoc/en/internals2/ze1/zendapi/possibilities.xml:1.3 --- phpdoc/en/internals2/ze1/zendapi/possibilities.xml:1.2 Wed Jun 20 22:39:09 2007 +++ phpdoc/en/internals2/ze1/zendapi/possibilities.xml Mon Aug 6 22:57:56 2007 @@ -1,10 +1,10 @@ ?xml version=1.0 encoding=ISO-8859-1 ? - !-- $Revision: 1.2 $ -- + !-- $Revision: 1.3 $ -- sect2 xml:id=internals2.ze1.zendapi.possibilities xmlns=http://docbook.org/ns/docbook; titleExtension Possibilities/title para - As shown in xref linkend=internals2.ze1.zendapi.fig.internal-struct/ above, PHP can be extended primarily at + As shown link linkend=internals2.ze1.zendapi.fig.internal-structabove/link, PHP can be extended primarily at three points: external modules, built-in modules, and the Zend engine. The following sections discuss these options. /para http://cvs.php.net/viewvc.cgi/phpdoc/en/internals2/ze1/zendapi/printing.xml?r1=1.5r2=1.6diff_format=u Index: phpdoc/en/internals2/ze1/zendapi/printing.xml diff -u phpdoc/en/internals2/ze1/zendapi/printing.xml:1.5 phpdoc/en/internals2/ze1/zendapi/printing.xml:1.6 --- phpdoc/en/internals2/ze1/zendapi/printing.xml:1.5 Sun Aug 5 20:15:40 2007 +++ phpdoc/en/internals2/ze1/zendapi/printing.xml Mon Aug 6 22:57:56 2007 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=ISO-8859-1 ? - !-- $Revision: 1.5 $ -- + !-- $Revision: 1.6 $ -- sect2 xml:id=internals2.ze1.zendapi.printing xmlns=http://docbook.org/ns/docbook; titlePrinting Information/title para @@ -31,7 +31,9 @@ zend_error(E_WARNING, This function has been called with empty arguments); ]] /programlisting -xref linkend=internals2.ze1.zendapi.tab.error-messages/ shows a list of possible values (see xref linkend=internals2.ze1.zendapi.fig.warning-messages/). These +xref linkend=internals2.ze1.zendapi.tab.error-messages/ shows a list +of possible values (see link + linkend=internals2.ze1.zendapi.fig.warning-messagesbelow/link). These values are also referred to in filenamephp.ini/filename. Depending on which error type you choose, your messages will be logged. table xml:id=internals2.ze1.zendapi.tab.error-messages