Automatically Generating Documents from C++ Source

A software company wants to produce a tool similar to javadoc that automatically generates various documents from C++ source code containing comments that include special XML tags. The comments may appear before declarations of namespaces, classes, members, files, and globals.

Ideally, the tool generates an XML link base from the source files associated with a C++ project. The tool allows users to dynamically generate programmer reference manuals, sample code that appears in tutorials, and API documents. These documents may be in various forms including HTML, DOC, and PPT.

Project

Research document generating systems and produce a RAD specification for the software this company needs. Your specification should go beyond the usual scope of a specification by attempting to educate the reader about the state-of-the-art of this technology.

References

Here are some references of Javadoc that might help:

http://www.doclet.com/

http://www.lordjoe.com/jdoc2/

http://www.developer.com/java/other/article.php/3085991

http://java.sun.com/j2se/javadoc/

http://java.sun.com/j2se/1.4.2/docs/tooldocs/javadoc/standard-doclet.html

http://java.sun.com/j2se/javadoc/faq/index.html#sourcedoclet