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