#34702 [NEW]: preg_* functions area of the manual
| From: | ryan_huff at knl dot cc | Date: | Sat, 01 Oct 2005 18:04:51 +0000 |
| Subject: | #34702 [NEW]: preg_* functions area of the manual | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969370375@lists.php.net to get a copy of this message | ||
From: ryan_huff at knl dot cc
Operating system: Irrelevant
PHP version: Irrelevant
PHP Bug Type: Documentation problem
Bug description: preg_* functions area of the manual
Description:
------------
As a suggestion, I would like to see the preg_* areas of the manual
re-visited someday.
The format character syntax for preg can be extremely complex to someone
who is not familiar with such, especially when it comes to the dbl escape
for the search/replace of reserved words/characters. Then there is
knowing when you need to use the parens, or the brackets ...ect.
I feel that the manual barely explains how to use preg, even in
alien-speak. Sure, the manual gives the definition and outlines where all
the paramiters go but doesn't explian how to use them and more importantly,
what conditions have to exist to use them.
I think it would go along way to provide some more "basic" example code on
the page covering different / common use, that way the reader can break it
down in their head and apply it to their situation.
Thanks,
MsJetEngineError
Reproduce code:
---------------
http://us3.php.net/manual/en/function.preg-match.php
Expected result:
----------------
A more intuitive area of the manual for the preg_* functions
Actual result:
--------------
A barely understandable area of the manual
--
Edit bug report at http://bugs.php.net/?id=34702&edit=1
--
Try a CVS snapshot (php4): http://bugs.php.net/fix.php?id=34702&r=trysnapshot4
Try a CVS snapshot (php5.0): http://bugs.php.net/fix.php?id=34702&r=trysnapshot50
Try a CVS snapshot (php5.1): http://bugs.php.net/fix.php?id=34702&r=trysnapshot51
Fixed in CVS: http://bugs.php.net/fix.php?id=34702&r=fixedcvs
Fixed in release: http://bugs.php.net/fix.php?id=34702&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=34702&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=34702&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=34702&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=34702&r=support
Expected behavior: http://bugs.php.net/fix.php?id=34702&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=34702&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=34702&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=34702&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=34702&r=php3
Daylight Savings: http://bugs.php.net/fix.php?id=34702&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=34702&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=34702&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=34702&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=34702&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=34702&r=mysqlcfg