#46713 [NEW]: Sub-namespace example lacks delimiter
| From: | mbr at arlsoft dot com | 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