#20066 [NEW]: [Feature] PHPDoc dependency on *'s
| From: | mattb at columbia dot edu | 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