RE: [PEAR-DOC] PHPDocumentor
| From: | LIMBOURG Arnaud | Date: | Mon, 25 Nov 2002 17:02:02 +0000 |
| Subject: | RE: [PEAR-DOC] PHPDocumentor | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-55@lists.php.net to get a copy of this message | ||
to answer myself i guess i can just put a dummy comment just above the
require.
> When generating documentation with PHPDocumentor 1.1.0 I have
> the following
>
> ERROR in Auth.php on line 137: AUTH_IDLED define's DocBlock
> has @package
> tag, illegal. ignoring tag "@package Auth"
>
> The lines are
>
> * @author Martin Jansen <mj@php.net>
> * @package Auth
> * @version $Revision: 1.38 $
> */
>
> define("AUTH_IDLED", -1);
>
> PHPDocumentor always takes the comments preceeding a line as
> relevant to the
> line.
>
> When having something like
>
> /**
> * class comments
> * @package foo
> */
> require 'PEAR.php';
>
> Class Bar
> {
>
> }
>
> it not happy and declares the @package tag illegal.
>
> How is tghis situation best handled ?
>
> Arnaud.
>
>