PHPDocumentor - 내 DocBlock의 문제점은 무엇입니까?

Question

일부 레거시 코드에 몇 가지 코멘트를 달았습니다. 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 
* @return void 
* @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 불필요하게 징징인가를, 또는 내가 부족 분명 뭔가가있다?

Answer 1

phpDocumentor 버전 2.8.1에서 동일한 문제가 발생했습니다. 이 버전의 버그 인 것 같습니다. enter link description here

저는 version 2.7.0을 사용 했으므로 이제는 문제가 없습니다.