problemas com doxygen/c [RESOLVIDO]

vinipsmaker
(usa Arch Linux)

Enviado em 20/11/2009 - 22:13h

Estou tendo problemas para documentar funções C com o doxygen. Pelo que percebi ele só "aceitou" a documentação de funções que não recebiam parâmetros. Há vários erros, que aparecem durante a geração da documentação, do tipo:

/home/ubuntu/eater-thief/include/include.h:123: Warning: Member existe_pilha(Pilha_id pilha) (function) of group pilhas is not documented.

/home/ubuntu/eater-thief/pilhas.c:368: Warning: no matching file member found for
Bool_t destruir_pilha()
Possible candidates:
Bool_t destruir_pilha(Pilha_id pilha)
Bool_t destruir_pilha(Pilha_id pilha)

Queria saber qual o erro. Criei a pouco um manual ( http://code.google.com/p/eater-thief/wiki/Doxygen ) do doxygen com quase tudo que eu sei sobre ele. Assim se eu informei (eu já pesquisei bastante e não encontrei problemas com minha sintaxe, de qualquer modo) alguma coisa errada deve ser esse o erro.

A documentação da r67 (mais recente no momento) do projeto:
http://eater-thief.googlecode.com/files/doc-html-r67.zip

vinipsmaker
(usa Arch Linux)

Enviado em 29/11/2009 - 13:04h

Um cara lá na ufal me ajudou a resolver o problema. Quem tiver tendo problemas parecidos a solução (e o problema):

O problema é que eu estava documentando as funções assim:
/**
*@fn void funcao
...
*/

E vc não precisa coloca @fn voi funcao

Basta colocar o comentário antes da função e tudo funciona.