[Doxygen-users] alias example in manual does not work properly

[Phil E. <ph...@ja...>]

The manual for 1.2.14 shows an example for the \if command in section 22.37.  It involves an alias section like

    ALIASES = "english=\if english" \
              "endenglish=\endif" \
              "dutch=\if dutch" \
              "enddutch=\endif"

and then the conditional blocks are written

    \english
    ....
    \endenglish

We're using this exact same technique, but we get a warning,

  1556: Documentation block ended in the middle of a conditional section!

The line number is in the middle of a block of code, and the entire
documentation block is not emitted.  (I think this may actually be the
cause of the conditional documentation bug I reported earlier.)

Replacing the aliased \if and \endif commands with regular \if and \endif
causes the warning to stop and the conditional sections to work properly.
I haven't tested this with the code being used in the previous bug report (it
takes about ten minutes for a doxygen run, so I can't spend all day on it),
but if this works around the bug, then we'll just have to give up on using
aliases for conditional blocks.


Phil

-- 
If ye love wealth greater than liberty, the tranquility of servitude greater
than the animating contest for freedom, go home and leave us in peace.  We seek
not your counsel, nor your arms.  Crouch down and lick the hand that feeds you;
and may posterity forget that ye were our countrymen.            - Samuel Adams