[R] toggleDoc: clutter reduction mainly for S4 documentation files

Dieter Menne dieter.menne at menne-biomed.de
Mon Oct 23 21:04:05 CEST 2006

The following perl-script is available from


After it is tested on other systems (currently only Windows),
I plan to upload it to


toggleDoc.pl: Clutter reduction for S4-R documentation files.

Version 1.0, 23.10.2006

dieter.menne at menne-biomed.de

Perl script to optionally reduce clutter in the index file of S4 html and in
files with many repetitive functions documentation. For an example using the
documentation of the coin package, see
http://www.menne-biomed.de/download/00Index.html .

Install and Convert

Put the file toggleDoc.pl and the javascript file toggleDoc.js into the
directory (you should  find the R.css file there).
For the protection of your valuable assets,  when you run this script
new files 00IndexNew.html will be generated in each directory.

If you want to replace your original 00Index.html with the modified ones,
this script with the two commented lines a the bottom of the Perl script
commented out.

***** Warning: this script has been tested under Windows only.
Please report required changes for Linux to dieter.menne at menne-biomed.de

What it does:

Only 00Index.html files are changed by adding a javascript reference and a
checkbox to switch between the "Show All" mode and the short mode; the
is made the default on startup.
All references that have a "," are hidden in the short mode, e.g.


In addition, repetitive similar entries with a common target file are
to the first entry. For example, in R2HTML the following list only shows the
first HTML reference in short mode.

HTML              Outputs an object to a HTML file
HTML.anova.loglm  Outputs an object to a HTML file
HTML.aov 	        Outputs an object to a HTML file

The program does not touch files with the string "toggleDoc.js" in the
header, so if you want to protect single files from being processed, simply
add this string in a comment to the html file (but not that this will be
overridden anyway on the next update.)

The function has been tested with IE and Firefox 1.5.

More information about the R-help mailing list