Re: [Doxygen-users] conditional documentation

[Dimitri v. H. <di...@st...>]

On Wed, Aug 01, 2001 at 09:39:44AM +0200, Klaus Vrana wrote:
> Hi everybody!
> 
> I have the following question.
> 
> Is the feature of conditional documentation restricted to "docu" only?
> 
> I want to use the @if - @endif - feature like  
> 
>     /** @if MY_LABEL1
>     * @defgroup ctest1 Group1
>     * @endif 
>     */       
>        
>        
>    /** @if MY_LABEL2
>      * @defgroup ctest2 Group2
>      * @endif 
>      */
>      
>      
> 
> /** @class middle
> 
>     @if MY_LABEL1
>     
>     @ingroup ctest1 
> 
>     description 1
>     @endif
>     
>     @if MY_LABEL2
>     
>     @ingroup ctest2
>     description 2
>     @endif
>     
>  */  
> 
> but all used commands (@defgroup / @ingroup ) are ignored in the way that both groups are generated
> and that the class is added to each group. The description part itself is handled correctly.
> 
> Is this a bug or is it the way doxygen should work or what else is wrong?

It is kind-of a bug. Doxygen handles the @if's in the second parsing pass (in doc.l), while it
should have done it in the first pass (in scanner.l). That's why a number of commands 
(including @brief) cannot be properly @if'ed. I will fix this, but not before 1.2.9, which 
I am currently preparing.

Regards,
  Dimitri