Doxygen/Sphinx/Custom docs generation support

[Wrench56]

As mentioned in the tracker issue #228, comment docs and their parsing would be certeainly welcome. As per the format used, the most known ones are certeainly doxygen and sphinx. I would however advise to have some template based/regex based solution in order to make custom formats possible. Something I'm sure many use instead of doxygen or sphinx styled.

Any ideas, implementation details are welcome.