#50417 [Opn->Bgs]: Separation of PCRE Pattern Syntax chapters
| From: | kalle@php.net | Date: | Wed, 06 Jan 2010 09:01:59 +0000 |
| Subject: | #50417 [Opn->Bgs]: Separation of PCRE Pattern Syntax chapters | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-3630@lists.php.net to get a copy of this message | ||
ID: 50417
Updated by: kalle@php.net
Reported By: php at felixdd dot de
-Status: Open
+Status: Bogus
Bug Type: Documentation problem
PHP Version: Irrelevant
New Comment:
PDF versions of the manual are available for download which is much
easier to search thru, but the separation of the syntax section will be
kept as it is now.
Previous Comments:
------------------------------------------------------------------------
[2009-12-08 21:35:12] php at felixdd dot de
Description:
------------
Separation of the chapters of PCRE Pattern Syntax causes a lot of work
to search for a specific pattern.
In a former version the chapter "Pattern Syntax" was one huge chapter.
http://php.net/manual/en/reference.pcre.pattern.syntax.php
Maybe a huge amount of information in one page is difficult to read,
but now it's difficult to search for a specific syntax.
As an example you want to know the meaning of (?: In one big chapter
you can use the search function of the browser (Ctrl+F). But now one has
to open each single page.
Even the general search function
"search for [(?: ] in the [online documentation]"
isn't helpful: no result.
Expected result:
----------------
Making again one big chapter isn't an option?
No? How about adding a very short form of the syntax to the list items
in this page
http://php.net/manual/en/reference.pcre.pattern.syntax.php
i.e.
...
* Subpatterns: (), (?:, (?P<name>
...
* Back references: \n, (?P=name)
* Assertions: (?=, (?!, (?<=, (?<!
...
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=50417&edit=1