Я добавляю комментарии к устаревшему коду и столкнулся с небольшой проблемой в PHPDocumentor.
Вот пример:
/**
* Constructs the Widget object
*
* Basic constructor for the widget object.
* Another line of pointless explanation, badly worded.
*
* @param string $id The ID of the widget
* @param int $size The Size of the widget
* @throws InvalidArgumentException
*/
public function __construct($id, $size) {
if (!is_string($id) || !is_integer($size)) {
throw new InvalidArgumentException('$id must be a string, $size an integer');
}
$this->id = $id;
$this->size = $size;
}
Я запускаю PHPDocumentor из командной строки и получаю прекрасную папку с документацией.
Документация выглядит нормально, но я получаю ошибки компиляции PHPDocumentor в следующих строках:
Argument $id is missing from the Docblock of __construct
Это просто PHPDocumenator без необходимости ноет, или есть что-то очевидное, что я упускаю?