Re: documenting C structure

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:[email protected]]
Envoyé : jeudi 7 juillet 2016 19:26
À : MURESIANU Philippe
Cc : [email protected]
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 <[email protected]<mailto:[email protected]>> 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
[email protected]<mailto:[email protected]>
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
[email protected]
https://lists.sourceforge.net/lists/listinfo/doxygen-users