Hi Albert,
Here is an example of the code and doxygen comments:
If I do the way below, ‘S_MyStruct’ is not found by Doxygen:
mySource.c:
/****************
\struct S_MyStruct
\brief blablabla
****************/
typedef struct {
unsigned short W_len;
unsigned char B_nb;
unsigned char Ba_Buf[10];
} S_MyStruct;
/****************
\brief it’s my function that uses \ref S_MyStruct
****************/
void myFunction()
{
…
}
Doxygen reports in warnings.txt:
mySource.c: 50: warning: unable to resolve reference to ‘S_MyStruct’ for \ref
command
BUT, if I put the structure declaration in “mySource.h”, ‘S_MyStruct’ is found
by Doxygen.
Doxygen version: 1.8.9.1
Thanks.
Regards,
Philippe
De : Albert [mailto:albert.te...@gmail.com]
Envoyé : jeudi 7 juillet 2016 19:26
À : MURESIANU Philippe
Cc : doxygen-users@lists.sourceforge.net
Objet : Re: [Doxygen-users] documenting C structure
Please add some code and the version of doxygen you used, so we can see what
you tried and it is easier to give an advise.
Albert
On Thu, Jul 7, 2016 at 11:33 AM, MURESIANU Philippe
<p.muresi...@oberthur.com<mailto:p.muresi...@oberthur.com>> wrote:
Hi,
When I declare a structure in my .c source file, the reference of the structure
is not found by Doxygen.
If I declare it in my header file (for test purpose), Doxygen finds the
reference.
I declare my structure in .c source on purpose and I can’t declare it in the
header file.
How can I fix my issue and make Doxygen finds the reference of this structure ?
Thanks.
Regards,
Philippe
------------------------------------------------------------------------------
Attend Shape: An AT&T Tech Expo July 15-16. Meet us at AT&T Park in San
Francisco, CA to explore cutting-edge tech and listen to tech luminaries
present their vision of the future. This family event has something for
everyone, including kids. Get more information and register today.
http://sdm.link/attshape
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net<mailto:Doxygen-users@lists.sourceforge.net>
https://lists.sourceforge.net/lists/listinfo/doxygen-users
------------------------------------------------------------------------------
Attend Shape: An AT&T Tech Expo July 15-16. Meet us at AT&T Park in San
Francisco, CA to explore cutting-edge tech and listen to tech luminaries
present their vision of the future. This family event has something for
everyone, including kids. Get more information and register today.
http://sdm.link/attshape
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
