O PHPDoc foi baseado no JAVADoc da Sun e tem como objetivo padronizar a documentação de códigos PHP. Ele lê o código e analisa gramaticalmente procurando por tags especiais. A partir delas extrai toda documentação usando diferentes formatos (pdf, xml, html, chm Windows help e outros). Todas as tags especiais são escritas dentro do comentários do php /*comentários */ e necessariamente começam com o @ (arroba).
Descrição de algumas tags especiais:
@access Específica o tipo de acesso (public, protected e private).
@author Específica o autor do código/classe/função.
@copyright Específica os direitos autorais.
@deprecated Específica elementos que não devem ser usados.
@exemple Definir arquivo de exemplo, $path/to/example.php
@ignore Ignorar código
@internal Documenta função interna do código
@link Link do código
@see Define uma referência a outro elemento ou uma URI
@since Define a partir de qual versão os elementos estruturais foram disponibilizados
@name Especifica o apelido (alias).
@package Específica o nome do pacote pai, isto ajuda na organização das classes.
@param Especifica os paramêtros (muito usado em funções).
@return Especifica o tipo de retorno (muito usado em funções).
@subpackage Especifica o nome do pacote filho.
@version Especifica a versão da classe/função.
Para gerar a documentação, pode-se instalar a ferramenta utilizando PEAR, Composer ou download manual.
Referências:
Linha de Codigo
PHPDoc