Re: [Doxygen-users] using short argument names $foo $bar in description

[Clemens F. <c....@os...>]

dr...@pe... wrote on 12.04.2019 at 14:25:
> 
> I have documentation like
> 
> 
> /// Calculates cost of rectangle with size @p sx x @p sy meters, using
> given @p price and adding discount if @p prio is  below 10.
> 
> float rect_cost(float sx, float sy, float price, int prio)
> 
> 
> the problem is that it is not comfortable to human-read nor to write,
> instead I was looking for something in terms of:
> 
> /// Calculates cost of rectangle with size $sx x $sy meters, using given
> $price and adding discount if $prio is  below 10.
> 
> Does such a thing exist, for parameters?
> 
> If not, could it please be added?
> 
> 
> Btw: for more general solution it seems that simply defining ALIAS on
> character, not on @something would work, something like:
> 
> CHAR_ALIASES="$=\p "
> 
> would do the trick here and as well allow user to define other custom
> special rules, from the set of characters that are not used and not
> reserved.
> 
> If characters are unicode it could have some interesting future use too.
> 

What is wrong with the ALIASES config option?

http://www.doxygen.nl/manual/config.html#cfg_aliases

This tag can be used to specify a number of aliases that act as commands 
in the documentation. An alias has the form: name=value