Re: [PHP-DOC] build failure [de]
The problem is the increased usage of xref. Previously authors were encouraged to use link to add internal links, which requires text content, so this was no problem. The adoption of xref lead to this problem. Should we avoid using xref? I don't think so that now it is an option. It is quite convinient in places like the extensions.xml file, where generated content is automatically translated with the titles, and this is the intention of using xref elsewhere too. Less work for translators to look up how exactly they translated some titles = more consistency in translations. 1. What would we put into para xreflabel=... in place of the dots in the missing-ids.xml file? The proper link-test? Sure, this depends on the content of the id=.. For the example para id=ini.com.allow-dcom this would become para id=ini.com.allow-dcom xreflabel=com.allow_dcom For ini stuff, this works because of some strict rules for naming. Otherwise we might not have this type of rule to generate a meaningful title. What if we do para id=ini.com.allow-dcom xreflabel=ini.com.allow-dcom (missing;) Where missing; is translated obviously. It would give some clue to users why clicking on that link leads to no content. :) Goba
[PHP-DOC] #34476 [NEW]: ulink doesn't appear on livedocs
From: [EMAIL PROTECTED] Operating system: PHP version: Irrelevant PHP Bug Type: Livedocs problem Bug description: ulink doesn't appear on livedocs Description: pdo_odbc/reference.xml: ulink url=http://connectionstrings.com/. The ulink doesn't appear on livedocs... It should appear and/or move the url to the url list file. -- Edit bug report at http://bugs.php.net/?id=34476edit=1 -- Try a CVS snapshot (php4): http://bugs.php.net/fix.php?id=34476r=trysnapshot4 Try a CVS snapshot (php5.0): http://bugs.php.net/fix.php?id=34476r=trysnapshot50 Try a CVS snapshot (php5.1): http://bugs.php.net/fix.php?id=34476r=trysnapshot51 Fixed in CVS:http://bugs.php.net/fix.php?id=34476r=fixedcvs Fixed in release:http://bugs.php.net/fix.php?id=34476r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=34476r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=34476r=needscript Try newer version: http://bugs.php.net/fix.php?id=34476r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=34476r=support Expected behavior: http://bugs.php.net/fix.php?id=34476r=notwrong Not enough info: http://bugs.php.net/fix.php?id=34476r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=34476r=submittedtwice register_globals:http://bugs.php.net/fix.php?id=34476r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=34476r=php3 Daylight Savings:http://bugs.php.net/fix.php?id=34476r=dst IIS Stability: http://bugs.php.net/fix.php?id=34476r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=34476r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=34476r=float No Zend Extensions: http://bugs.php.net/fix.php?id=34476r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=34476r=mysqlcfg
[PHP-DOC] #34390 [Asn-Opn]: Redefinition of static methods in subclasses
ID: 34390 Updated by: [EMAIL PROTECTED] Reported By: cbelin at free dot fr -Status: Assigned +Status: Open -Bug Type: Class/Object related +Bug Type: Documentation problem Operating System: Windows XP SP2 PHP Version: 5.0.4 Assigned To: sniper New Comment: Reclassified as docu bug. Previous Comments: [2005-09-12 11:37:54] [EMAIL PROTECTED] This is documentation bug. [2005-09-07 11:54:31] [EMAIL PROTECTED] Dmitry, shouldn't this procude an error..? [2005-09-06 13:49:50] cbelin at free dot fr Description: Manual says that static members and methods cannot be redefined in subclasses. It seems that it's not completely true (at least with PHP 5.0.4 under Windows XP), as redefining static methods in subclasses is allowed, and works fine (i.e. without triggering errors even if error level includes E_STRICT). Reproduce code: --- class Base { public static function foo() { return 'Foo...'; } } class Extended extends Base { public static function foo() { return 'Bar !!!'; } } echo Extended::foo(); Expected result: An error, or the output of Base::foo() Actual result: -- It works, and prints 'Bar !!!' -- Edit this bug report at http://bugs.php.net/?id=34390edit=1
Re: [PHP-DOC] build failure [de]
Gabor Hojtsy wrote: The problem is the increased usage of xref. Previously authors were encouraged to use link to add internal links, which requires text content, so this was no problem. The adoption of xref lead to this problem. Should we avoid using xref? I don't think so that now it is an option. It is quite convinient in places like the extensions.xml file, where generated content is automatically translated with the titles, and this is the intention of using xref elsewhere too. Less work for translators to look up how exactly they translated some titles = more consistency in translations. +1, xref is a neet feature. 1. What would we put into para xreflabel=... in place of the dots in the missing-ids.xml file? The proper link-test? Sure, this depends on the content of the id=.. For the example para id=ini.com.allow-dcom this would become para id=ini.com.allow-dcom xreflabel=com.allow_dcom For ini stuff, this works because of some strict rules for naming. Otherwise we might not have this type of rule to generate a meaningful title. What if we do para id=ini.com.allow-dcom xreflabel=ini.com.allow-dcom (missing;) Where missing; is translated obviously. It would give some clue to users why clicking on that link leads to no content. :) Fine with me, but we should place missing; at top of missing-ids.xml So the following should be the solution for this problem: missing-ids.xml: missing; para id=ini.com.allow-dcom xreflabel=ini.com.allow-dcom/para and put missing; in language-snippets.ent. Benefit: linking to appendix missing-stuff with a short explanation is working again ;-) Friedhelm
[PHP-DOC] cvs: phpdoc /en/reference/spl/functions class-implements.xml
vrana Mon Sep 12 09:09:40 2005 EDT Modified files: /phpdoc/en/reference/spl/functions class-implements.xml Log: Mention parents (bug #34455) http://cvs.php.net/diff.php/phpdoc/en/reference/spl/functions/class-implements.xml?r1=1.9r2=1.10ty=u Index: phpdoc/en/reference/spl/functions/class-implements.xml diff -u phpdoc/en/reference/spl/functions/class-implements.xml:1.9 phpdoc/en/reference/spl/functions/class-implements.xml:1.10 --- phpdoc/en/reference/spl/functions/class-implements.xml:1.9 Thu Aug 4 07:02:17 2005 +++ phpdoc/en/reference/spl/functions/class-implements.xml Mon Sep 12 09:09:37 2005 @@ -1,5 +1,5 @@ ?xml version='1.0' encoding='iso-8859-1'? -!-- $Revision: 1.9 $ -- +!-- $Revision: 1.10 $ -- refentry id=function.class-implements refnamediv refnameclass_implements/refname @@ -16,7 +16,7 @@ /methodsynopsis para This function returns an array with the names of the interfaces that the - given parameterclass/parameter implements. + given parameterclass/parameter and its parents implement. /para /refsect1
[PHP-DOC] #34455 [Opn-Csd]: class_implements and class_parents
ID: 34455 Updated by: [EMAIL PROTECTED] Reported By: jumo at gmx dot de -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: debian gnu/linux PHP Version: Irrelevant New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. 1. They are part of SPL thus they are under SPL. 2. I've mentioned parents in the function description. Previous Comments: [2005-09-11 13:29:38] jumo at gmx dot de and the search is not helpfull: http://www.php.net/manual-lookup.php?pattern=interface [2005-09-10 14:44:27] jumo at gmx dot de Description: Hi, why aren't the functions class_implements and class_parents here: http://www.php.net/manual/en/ref.classobj.php 2nd: the documentation of class_implements reads class_implements -- Return the interfaces which are implemented by the given class but it should be changed to something like: class_implements -- Return the interfaces which are implemented by the given class and its parent classes. Reproduce code: --- ?php interface A {} interface B {} class C implements A {} class D extends C implements B {} class E extends D {} $e = new E; print_r( class_implements( $e )); ? Expected result: Array() Actual result: -- Array ( [A] = A [B] = B ) -- Edit this bug report at http://bugs.php.net/?id=34455edit=1
Re: [PHP-DOC] cvs: phpdoc /en/reference/pdo reference.xml
Wow! That was an awesome set of PDO doc commits, Wez. Great stuff! Dan On 9/11/05, Wez Furlong [EMAIL PROTECTED] wrote: wez Sun Sep 11 23:44:39 2005 EDT Modified files: /phpdoc/en/reference/pdoreference.xml Log: fix interrupted sentence... http://cvs.php.net/diff.php/phpdoc/en/reference/pdo/reference.xml?r1=1.36r2=1.37ty=u Index: phpdoc/en/reference/pdo/reference.xml diff -u phpdoc/en/reference/pdo/reference.xml:1.36 phpdoc/en/reference/pdo/reference.xml:1.37 --- phpdoc/en/reference/pdo/reference.xml:1.36 Sun Sep 11 17:10:36 2005 +++ phpdoc/en/reference/pdo/reference.xml Sun Sep 11 23:44:38 2005 @@ -1,5 +1,5 @@ ?xml version='1.0' encoding='iso-8859-1'? -!-- $Revision: 1.36 $ -- +!-- $Revision: 1.37 $ -- !-- Purpose: database.abstract -- !-- Membership: pecl, bundled -- !-- State:experimental -- @@ -26,7 +26,7 @@ functions to issue queries and fetch data. PDO does emphasisnot/emphasis provide a emphasisdatabase/emphasis abstraction; it doesn't rewrite SQL or emulate missing features. You - should use a full-blown abstraction layer for PDO. + should use a full-blown abstraction layer if you need that facility. /para para PDO ships with PHP 5.1, and is available as a PECL extension for PHP 5.0;
Re: [PHP-DOC] build failure [de]
Fine with me, but we should place missing; at top of missing-ids.xml So the following should be the solution for this problem: missing-ids.xml: missing; para id=ini.com.allow-dcom xreflabel=ini.com.allow-dcom/para and put missing; in language-snippets.ent. Benefit: linking to appendix missing-stuff with a short explanation is working again ;-) I actually meant that every xreflabel (so every link generated for missing content) would include the translated version of the word missing, so that even before clicked a user (an experienced user at least) would know that it is not really benefical to click that link. Goba