Support for Doxygen translation

[dsogari]

Hello there. Thanks for making this project available. I'm using it to port a C+ library to JavaScript Node-API.

One feature I'm missing is the extraction of Doxygen comments found in C++ header files. I'd love to be able to understand how a class works or know the meaning of method parameters (especially when parameter names are not self-explanatory), by looking at the documentation comment.

There is some information on this subject on SWIG documentation, but it seems that currently JavaScript is not supported. Since you're adding TypeScript support, I wonder if this feature can be implemented for TypeScript as well (i.e., generate the declaration file with documentation comments).

[mmomtchev]

Yes, this is definitely planned, but it is a lot of work.