This is a little cli program to find a list all comment-tags within a set of files and present them in an easily readable manor. Similar to the todo tool within JetBrains editors. A list of files and their 'todo's. This is a little more general.
@TODO: add usage examples
(this one is not a joke)
The general syntax is as such:
'begin of comment' '@' tag_name ( '(' author ')' )? ( ':' comment_text )?
Note
Configuration of the what to consider to be the beginning of a comment has not been implement as of yet. When done the ability to associate comment strings to file types will be available in a config file.
Important
Support for "mulitline" comments is not implemented and probably won't be.
So syntax like /* @TAG */ and <!-- @TAG --> will not work
// @HACK
# @TODO: Implement this thing one day
-- @FIXME(ketanr)
@NOTE(ketanr): This does it that way because I said so
@NOTE: We can also continue the comment/tag text on the next line
as long as it starts after the column the '@' is found in
and there is nothing between (this will not be a part of the above @NOTE)
@What_Ever_You_Want: As long as it is after the '@',
it is considered a part of the tag
// @NOTE: It does not work if the actual comment does not start on the same column
// such as like this
some line of code // @NOTE: they can even start after code
// such as like this
@TODO: include some screenshots
(this one is also not a joke)