Re: [Doxygen-users] Custom tag tag that can generate docs similar to the TODO list

[Duane E. <Dua...@me...>]

>> sorry for a late answer...Besides the fact I just don't know how to get hold of the Filename / LineNo I'm just trying to figure out what you might need it for.

>> As the coding progresses, a printed document containing a discrete link to a line number will expire quite fast and render it unusable.

I would describe a different benefit.

Having this 'optionally' in the ToDo list might also be helpful.
Extracting this programatically would be just as helpful.

Here's why:

Sometimes you are actually working from a dead tree report, or an electronic equivelent. Example: one must collect all the "ToDo" items from multiple projects into a giant spreadsheet and present them for triage in a meeting, discussion, etc. The subject of that meeting might be: "We have lots of bugs - and ToDo items - which should we fix first?"

No mater what you do - the link will be out of date. Maybe you have a private doxygen generated build? Only accessable on *your*machine*.. That "on-line-link" is not so on line any more. Also - remember your user base.

The backup solution is: Filename and Line number, it gives at least a 'rough location'.

Ie: Which 1 file out of 50 files do I look in?
Ie: Where in that *HUGE* file do I look? (within 100 lines? Would be helpful)

It's a lot like GCC - issuing error messages in the filename & line number form.
You fix syntax errors - line numbers shift and change - you manage.

-Duane.