Doc #73117 [Csd]: Documentation for multiple namespaces in one file needs a clarification.

Edit report at https://bugs.php.net/bug.php?id=73117&edit=1 ID: 73117 Updated by: peehaa@php.net Reported by: dominic_mayers at yahoo dot com Summary: Documentation for multiple namespaces in one file needs a clarification. Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant Assigned To: peehaa Block user comment: N Private report: N New Comment: Your note is also removed now. All should be fixed. Thanks. Previous Comments: ------------------------------------------------------------------------ [2016-09-20 11:59:17] dominic_mayers at yahoo dot com The instructions are clear: do not refer to other user notices and the reason given is exactly what happened : the notice was removed. I am guilty. Since I did not refer to it explicitly, I thought that it will be fine, but it's not. Also, I did not foresee at all that a notice with 78 up votes could be removed. ------------------------------------------------------------------------ [2016-09-20 10:02:48] dominic_mayers at yahoo dot com Can you remove my user notice as well. It became useless and was down voted, perhaps by myself. ------------------------------------------------------------------------ [2016-09-20 09:30:23] dominic_mayers at yahoo dot com The documentation in the page itself http://php.net/language.namespaces.definitionmultiple is perhaps the only page that contains relevant, valid and useful information on the issue - it is a good informative page. It says clearly that there are two syntaxes. It's clear from it that there is no semi columns just before the brackets in the bracketed syntax and no need for brackets in the other syntax. The problem was mainly the user notice that received so many up votes and, I agree, was confusing at best. I certainly have been confused by it: for a while, I thought that using a semi column between the namespace statement and the opening bracket was an undocumented version of the bracketed syntax. Because this user notice received so many up votes, I felt perhaps the documentation was not sufficient. ------------------------------------------------------------------------ [2016-09-20 08:27:56] peehaa@php.net 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. I have removed the user note because it was confusing at best. Al information is already in http://php.net/manual/en/language.namespaces.importing.php too. ------------------------------------------------------------------------ [2016-09-20 00:20:55] dominic_mayers at yahoo dot com This is a documentation problem. I don't know what I was thinking when I classed it in change/feature request. ------------------------------------------------------------------------ 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 https://bugs.php.net/bug.php?id=73117 -- Edit this bug report at https://bugs.php.net/bug.php?id=73117&edit=1