Generating HTML
---------------
I've used the browser to generate the HTML versions of the Sather
libraries that are accessible from
http://www.icsi.berkeley.edu/~gomes/Sather/library.html
HTML like this may be generated by following these steps:
1) Startup the browser ( probably in an empty HTML accessible directory
- there are a number of generated files!). Under the graph menu,
choose the "Dump State" option. This generates a file called
doc-all-classes.gen.tcl 2) Run the tcl script genTopHTMLdoc.tcl which
will generate the two files
moduleClass-dir.gen.html [containing the top level library/modules]
classIndex.gen.html [containing an alphabetized listing of classes]
All classes will point at htmlified versions of the sather classes. To
generate these htmlified versions,
3) Run sather2html.tcl in the same directory. It will generate the
htmlified versions of the sather files that are refereed to.
(these will have line numbers, highlighting and a certain number of
cross references).
These generated files have names of the form:
lined-.gen.tcl
4) Point to moduleClass-dir.gen.html in your index file.
All these files must co-reside in the same directory (they refer to
each other directly)
5) Make sure that that directory has the gif files (bluestone and
campanile_smaller)
Note: All generated files have .gen somewhere in their names
Bugs:
* Cross references (especially when multiple classes occur on
a single line) can be wrong.
* Cross references don't work for parametrized classes.