[prev in list] [next in list] [prev in thread] [next in thread] 

List:       pear-doc
Subject:    PHPDocumentor
From:       LIMBOURG Arnaud <arnaud.limbourg () cegetel ! fr>
Date:       2002-11-25 16:59:02
[Download RAW message or body]


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.



[prev in list] [next in list] [prev in thread] [next in thread]