Use doxygen para documentar membros de uma estrutura c fora da definição da estrutura
Estou usando doxygen para comentar meu código C. Estou usando uma API estrangeira (ou seja, não minha) para a qual a documentação é escassa, por isso pretendo documentar parte dessa API nos meus próprios arquivos de origem. EUFa possui o arquivo de cabeçalho da API estrangeira, mas não é prático adicionar meus próprios comentários a esse arquiv
Cabeçalho estrangeiro
struct foreignstruct
{
int a;
int b;
};
My Header
/** My structure comments...
struct mystruct
{
/** Describe field here... */
int field;
};
/** @struct foreignstruct
* @brief This structure blah blah blah...
* @??? a Member 'a' contains...
* @??? b Member 'b' contains...
*/
Que tag eu uso no lugar de@???
para obter a saída doxygen correta (onde 'correto' significa a saída gerada paramystruct
eforeignstruct
são os mesmos)