[Doxygen-develop] Patch: Aliases with Arguments (TODO #28)

[Dirk R. <re...@ca...>]

    Hi Y'all (I've been living in Louisiana too long ;),

I wrote a little patch to support arguments in aliases. It's very simple 
and not very elegant, but it works fine.

Usage is trivial. In the aliases arguments need to be marked with 
^<number>^, like this:
 
ALIASES      = "al1=*AL1*" \
               "al2=*AL2:^1^*" \
               "al3=*AL3:^1^ -> ^2^*"

When using the alias the arguments are passed in parentheses after the 
alias (like C macros) and separated by ',' (which can be escaped if 
necessary):

Alias with one arg: \al2(ARG) will be "*AL2:ARG*"
Alias with one arg and escaped ',': \al2(ARG\,BLARG) will be 
"*AL2:ARG,BLARG*"
Alias with two args: \al3(FOO,BAR) will be "*AL3:FOO -> BAR*"

If an alias is called without () no argument substitution is done, so 
all existing documentation should work just fine.

Currently the maximum number of arguments is fixed at 20, which 
hopefully is enough.

The path is against current CVS.

Hope you find it useful
  
    Dirk