#20066 [NEW]: [Feature] PHPDoc dependency on *'s

From: Date: Thu, 24 Oct 2002 18:27:26 +0000
Subject: #20066 [NEW]: [Feature] PHPDoc dependency on *'s
Groups: php.pear.dev 
Request: Send a blank email to pear-dev+get-10222@lists.php.net to get a copy of this message
From: mattb@columbia.edu Operating system: GNU/Linux 2.4.18-17.7.x (RedHat) PHP version: 4.2.3 PHP Bug Type: PEAR related Bug description: [Feature] PHPDoc dependency on *'s Not sure if this is the correct forum for reporting PEAR bugs, but here goes... It seems like if the leading ' * 's are missing from the body of a PHPDoc comment, some information will be lost (namely the @... tags). For example, the following comment will not have an author or package: /** This is my class. There are many like it, but this one is mine. @author Me <me@myself.org> @package my_package */ However, this one works fine: /** * This is my class. There are many like it, but this one * is mine. * * @author Me <me@myself.org> * @package my_package */ Is there any reason why the *'s are required? Can the be made to be optional (comments are much easier to edit if they're not forced to be there)? Just my two cents.... -- Edit bug report at http://bugs.php.net/?id=20066&edit=1 -- Try a CVS snapshot: http://bugs.php.net/fix.php?id=20066&r=trysnapshot Fixed in CVS: http://bugs.php.net/fix.php?id=20066&r=fixedcvs Fixed in release: http://bugs.php.net/fix.php?id=20066&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=20066&r=needtrace Try newer version: http://bugs.php.net/fix.php?id=20066&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=20066&r=support Expected behavior: http://bugs.php.net/fix.php?id=20066&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=20066&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=20066&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=20066&r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=20066&r=php3 Daylight Savings: http://bugs.php.net/fix.php?id=20066&r=dst IIS Stability: http://bugs.php.net/fix.php?id=20066&r=isapi

« previous php.pear.dev (#10222) next »