#50417 [Bgs]: Separation of PCRE Pattern Syntax chapters
| From: | php at felixdd dot de | Date: | Wed, 06 Jan 2010 17:41:52 +0000 |
| Subject: | #50417 [Bgs]: Separation of PCRE Pattern Syntax chapters | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-3632@lists.php.net to get a copy of this message | ||
ID: 50417
User updated by: php at felixdd dot de
Reported By: php at felixdd dot de
Status: Bogus
Bug Type: Documentation problem
PHP Version: Irrelevant
New Comment:
Do you really mean PDF? I didn't found any PDF version at
php.net/download-docs.php. But there is a single HTML file version -
which is all but handy. Opening/rendering takes ages, consumes a huge
amount of memory and there is no way to only search in certain chapters.
Also a PDF version would have the same problems.
There is also a Windows Help file format, but the reader can't search
for phrases like "(?<!".
Previous Comments:
------------------------------------------------------------------------
[2010-01-06 09:01:57] kalle@php.net
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.
------------------------------------------------------------------------
[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