php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Bug #46710 Missing backslashes in manual pages
Submitted: 2008-11-28 14:53 UTC Modified: 2008-11-29 20:06 UTC
From: jchaffer at gmail dot com Assigned: bjori (profile)
Status: Closed Package: Website problem
PHP Version: Irrelevant OS: n/a
Private report: No CVE-ID: None
View Developer Edit
 [2008-11-28 14:53 UTC] 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.

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2008-11-28 15:16 UTC] 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 15:21 UTC] 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-29 17:39 UTC] derick@php.net 
I've updated the PHP version now to PHP 5.3.0alpha3
 [2008-11-29 20:06 UTC] bjori@php.net 
And PhD is using the correct binary.
This should be fixed with the next phpdoc build on Friday.
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Mon Jul 14 07:01:32 2025 UTC