[MPlayer-dev-eng] [PATCH] Doxygen and conditional compilation

[Diego Biurrun]

On Fri, Oct 21, 2011 at 02:17:00PM +0200, Ingo Brückl wrote:
> Diego Biurrun wrote on Mon, 19 Sep 2011 11:57:20 +0200:
> 
> > On Thu, Sep 15, 2011 at 11:30:19AM +0200, Ingo Brückl wrote:
> >> There are some conditional declarations within the GUI [...] that
> >> currently won't appear in the doxygen documentation, i.e. the generated
> >> documentation is rather one according to the personal settings than a
> >> general one. This could be changed by using the PREDEFINED tag.
> 
> >> -EXPAND_ONLY_PREDEF     = NO
> >> +EXPAND_ONLY_PREDEF     = YES
> 
> > What about setting MACRO_EXPANSION to "yes" instead?
> 
> Diego, did you make up your mind? Shall any tag (and if yes, which) be
> changed?

I still think this is brittle and I'm not sure it is really desirable to
have documentation for (locally) unavailable functions.  In any case there
is another option: try setting ENABLE_PREPROCESSING to "NO" and compare
the result.

Diego