Tool for scanning code comments and converting to standard format

I am working on a C project that has seen many different authors and many different documentation styles.

I am a big fan of doxygen and other documentation generation tools, and I would like to transfer this project to use it of these systems.

Does anyone know a tool that can scan source code comments for keywords such as Description, Author, File Name, and other contexts to intelligently convert comments to a standard format? If not, I suppose I could write a crazy script or convert manually.

thank

+3
source share
3 answers

The only thing I can come up with when I read O'Reilly's book on Lex + Yacc was that there was code for displaying comments on the command line, in chapter 2 there was a section that showed how to analyze code for comments, including //and /*..*/. .. There is a link on the page for an example, download the progs.zip file , the file you are looking for ch2-09.l, which you need to create, you can easily modify it to display comments. Then it can be used in the script to filter "Name", "Description", etc.

, , ?

: , , , .

, , , .

+2

, tommieb75 , - .

ANTLR, , , , , , .. - . 9.7 ANTLR.

+1

, Visual Studio ( IDE) ( "" ), , , , .

, , AtomineerUtils Pro Documentation. . XML Documentation, Doxygen, JavaDoc Qt ( - ), . . , Visual Studio , , , AtomineerUtils ( -, , , ).

. , AtomineerUtils documentaiton, - , .. , , ( , , ..), . , - , addin, , , , .

+1

Source: https://habr.com/ru/post/1730472/


All Articles