We’re responsible for generating all the HTML files from the object tree defined in code_objects.rb. We generate:
an html file for each input file given. These input files appear as objects of class TopLevel
an html file for each class or module encountered. These classes are not grouped by file: if a file contains four classes, we’ll generate an html file for the file itself, and four html files for the individual classes.
we generate three indices for files, classes, and methods. These are displayed in a browser like window with three index panes across the top and the selected description below
Method descriptions appear in whatever entity (file, class, or module) that contains them.
We generate files in a structure below a specified subdirectory, normally
opdir | |___ files | |__ per file summaries | |___ classes |__ per class/module descriptions
HTML is generated using the Template class.
Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.
If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.
If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.