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

Reply via email to