#46713 [NEW]: Sub-namespace example lacks delimiter

From: Date: Fri, 28 Nov 2008 18:28:42 +0000
Subject: #46713 [NEW]: Sub-namespace example lacks delimiter
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-1558@lists.php.net to get a copy of this message
From: mbr at arlsoft dot com Operating system: Whatever php.net's server runs PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: Sub-namespace example lacks delimiter Description: ------------ Your documentation page at http://www.php.net/manual/en/language.namespaces.nested.php gives the following example use of the "namespace" keyword for declaring sub-namespaces: namespace MyProjectSubLevel; Below the example, it explains, "The above example creates constant MyProject\Sub\Level\CONNECT_OK, class MyProject\Sub\Level\Connection and function MyProject\Sub\Level\Connection." Yet the name of the namespace given in the example contains no delimiters. I don't see how the PHP interpreter can know that "MyProject" is the first level namespace, "Sub" is the second level namespace, and "Level" is the third level namespace. So I'm guessing that the line in the example is missing some delimiter. Given that many Unix tools use the character "\" to quote the following character, it seems possible that whoever wrote the documentation inserted a single backslash where what was needed was to have the backslash itself quoted by being preceded by another backslash. Please check and fix the documentation, and make it clear exactly which character PHP recognizes as the delimiter between multiple levels of a namespace hierarchy. -- Edit bug report at http://bugs.php.net/?id=46713&edit=1 -- Try a CVS snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=46713&r=trysnapshot52 Try a CVS snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=46713&r=trysnapshot53 Try a CVS snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=46713&r=trysnapshot60 Fixed in CVS: http://bugs.php.net/fix.php?id=46713&r=fixedcvs Fixed in CVS and need be documented: http://bugs.php.net/fix.php?id=46713&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=46713&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=46713&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=46713&r=needscript Try newer version: http://bugs.php.net/fix.php?id=46713&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=46713&r=support Expected behavior: http://bugs.php.net/fix.php?id=46713&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=46713&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=46713&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=46713&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=46713&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=46713&r=dst IIS Stability: http://bugs.php.net/fix.php?id=46713&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=46713&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=46713&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=46713&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=46713&r=mysqlcfg

« previous php.doc.bugs (#1558) next »