Re: [Doxygen-users] New feature : todo feature enhancement

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

>> Using the doxygen alias feature you can make your own custom commands
>> like \todo1, \todo2 or
>> \whatever. Look here: http://www.doxygen.nl/custcmd.html
>>
>> Clemens

10.02.2010 13:02, seb_kramm:
> Interesting, I didn't know nor use this command. But I'm not sure how the feature I
> suggested could be implemented that way.
>
> I tried the "module" grouping feature, and added:
> ALIASES += todo1="\addtogroup todo1"
> in a doxyfile. But this doesn't seem to work, the group doesn't get name "todo1".
>
> Would you have an idea how to do this this way?
> Sebastien

Hi Sebastien.

This has nothing to do with doxygen module grouping (\addtogroup).

http://www.doxygen.nl/commands.html#cmdxrefitem

explains the \xrefitem command:

--- quote ---

This command is a generalization of commands such as \todo and \bug. It 
can be used to create user-defined text sections which are automatically 
cross-referenced between the place of occurrence and a related page, 
which will be generated. On the related page all sections of the same 
type will be collected.

To get an idea on how to use the \xrefitem command and what its effect 
is, consider the todo list, which (for English output) can be seen an 
alias for the command

\xrefitem todo "Todo" "Todo List"

--- quote end ---

To make your "special" Todo list you can write:

ALIASES = "todo1=\xrefitem todo1\"High Priority To-DO\" \"To-DO List 1\""

Note the use of escaped quotes for the second and third argument of the 
\xrefitem command.

Clemens