Re: [Doxygen-develop] doxygen preprocessor, not always expands

[Stefan K. <ko...@im...>]

Hi Dimitri,

I've had a deeper look into it.

> === Problem 1:
> when running doxygen it expands the macro there, but complains about
> undocumented variables. Are the documentes inside the define dropped?
> 
> header1.h:6:Warning: Member id of class GitkWidget is not documented.
> header1.h:6:Warning: Member context of class GitkWidget is not documented.
> header1.h:6:Warning: Member type of class GitkWidget is not documented.
> 
As I've already found out it wish-item 49:
And it look to me that in 'src/pre.l' the following line need to be changed :
<SkipLine,SkipCommand,SkipCPPBlock>"//"	{
  					  g_lastCPPContext=YY_START;
  					  BEGIN(RemoveCPPComment);
					}
<SkipLine,SkipCommand,SkipCPPBlock>"/*"	{
					  g_lastCContext=YY_START;
  					  BEGIN(RemoveCComment);
  					}

so that doxygen-comments (/**) are not removed, e.g like below (this might not
work as I just have started to read about lex and co - I've never used them before).

<SkipLine,SkipCommand,SkipCPPBlock>"/*"{
					  g_lastCContext=YY_START;
  					  BEGIN(CComment);
  					}
<CComment>"*"				{
					  BEGIN{CopyCComment};
					}
<CComment>[^*]				{
  					  BEGIN(RemoveCComment);
					}

I would be really happy if this could be fixed soon, as I have a deadline at the
end of this year :-(.

Ciao
  Stefan

> === Problem 2:
> it does not expand the define in the second header file. Both, the data-fields
> list and the graph are missing the 'inherited' elements.
> 
> header2.h:3:Warning: Member GitkWidgetFields of class GitkrGtkWidget is not
> documented.
> 
> ===
> 
> Anyway, does anyone has a better idea, of how to do 'inheritance' in C (not
> C++). Unfortunately I am bound to use gcc 2.95 and this one does not support
> anonymous structs/unions.
> Wouldn't it be a good idea to have a @extends command (which should not be used
> in C++/Java) so that I call documents such relations even in C.
> 
> Ciao
>   Stefan

-- 
      \|/            Stefan Kost
     <@ @>           private            business
+-oOO-(_)-OOo------------------------------------------------------ - - -  -   -
|       __  Address  Simildenstr. 5     HTWK Leipzig, Fb IMN, Postfach 301166
|      ///           04277 Leipzig      04251 Leipzig
| __  ///            Germany            Germany
| \\\///    Phone    +49341 2253538     +49341 30766101
|  \__/     EMail    st_kost_at_gmx.net kost_at_imn.htwk-leipzig.de
|           WWW      www.sonicpulse.de  www.imn.htwk-leipzig.de/~kost/about.html
===-=-=--=---=---------------------------------- - - -  -    -