#46710 [Asn->Csd]: Missing backslashes in manual pages
| From: | bjori@php.net | Date: | Sat, 29 Nov 2008 20:06:58 +0000 |
| Subject: | #46710 [Asn->Csd]: Missing backslashes in manual pages | ||
| References: | 1 | Groups: | php.webmaster |
| Request: | Send a blank email to php-webmaster+get-3169@lists.php.net to get a copy of this message | ||
ID: 46710
Updated by: bjori@php.net
Reported By: jchaffer at gmail dot com
-Status: Assigned
+Status: Closed
Bug Type: Website problem
Operating System: n/a
PHP Version: Irrelevant
Assigned To: bjori
New Comment:
And PhD is using the correct binary.
This should be fixed with the next phpdoc build on Friday.
Previous Comments:
------------------------------------------------------------------------
[2008-11-29 17:39:01] derick@php.net
I've updated the PHP version now to PHP 5.3.0alpha3
------------------------------------------------------------------------
[2008-11-28 15:21:46] jchaffer at gmail dot com
Makes sense. I haven't verified this, but it's possible that I was
seeing the characters show up in prose but not code examples. That
would
explain why it seemed hit-or-miss.
I can't really say for sure where the characters are missing, since I
don't know where they're supposed to be yet; hence, reading the
documentation. ;-)
------------------------------------------------------------------------
[2008-11-28 15:16:07] bjori@php.net
Gahh!
You are totally right.
The reason for this is PHP syntax highlighting.. PHP versions prior to
PHP5.3.0 do not understand the syntax and silently ignore "weird
syntax".
We'll need to update the PHP version generating the manual.
------------------------------------------------------------------------
[2008-11-28 14:53:38] jchaffer at gmail dot com
Description:
------------
It appears that backslash characters are being sporadically suppressed
on documentation pages. This is especially noticeable in the
documentation about namespaces; I was highly confused by much of the
language until I realized some very important characters were missing
from the code examples and descriptions!
For an illustration of the problem, see:
http://www.php.net/manual/en/language.namespaces.faq.php
Examples 1 and 2 are supposed to illustrate two different syntaxes, but
because of this problem are identical.
Nearly every page of the namespace section of the manual has an example
of the issue.
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=46710&edit=1