GDoc is a python script that is designed to extract formatted documentation comment blocks from source files and automatically generate html documentation from them. It is a very simplified relatively of documentation utilities such as Doxygen, that are designed generate API documentation for programs written in C, C++ and related languages.
The functionality of GDoc is a close imitation of that of ROBODoc, which inspired it. In truth, it was originally written primarily because I wanted to learn python, and this was a fun project for that purpose. GDoc and ROBODoc are "generic" documentation utilities in the sense that neither relies on knowledge of the syntax of the language being used: Both programs simply search source files for blocks of text that start and end with specific markers. Both are very configurable, and could be used to comment pretty much anything.
We use GDoc to generate the API documentation for Fortran 90 programs in our group, including our PSCF self-consistent field code. Here is the table of contents page for the documentation generated for PSCF. For each source file, GDoc generates one html file that contains only the contents of the documentation blocks that were extracted from the source file, with hyperlinks to other documentation items, and a second file that contains a browsable version of the source code. The comment blocks from which the documentation was extracted can thus be seen either by browsing the source code as html, or downloading PSCF and looking at the original source code in the src directory of the untarred package. The GDoc script itself also contains comments in GDoc format, and is used to document itself.
For now, the only detailed documenation of how to use GDoc is contained within long comment blocks within the GDoc.py script itself. To generate documentation, GDoc reads a driver file that contains the names of the files from which documentation should be extracted, and a variety of configuration parameters. The format of this file is documented in the documentation block for the read_config function. The file 'html.rc' that is included with the GDoc package is the driver file used to generate documentation for the GDoc package itself, which also serves as an example.