Produce a compound document

Examples of use:

• compound
• rtf
• ps

Current status (of the auxiliary command line script):

• The references to external links or non html pages are being retained in the footer.
• No TOC produced. Anyway, this should now contain internal links, in case these are used by some conversion back-end (e.g. to RTF), or even for user convenience (some people might prefer to use compound pages and scroll back and forth -- it depends also on the browser: heavy graphical browsers occupate all the space available for one only window). It is possible also that the TOC should be generated only in the RTF file...
• The external links should be retained, and even possibly gathered to the reference part
• The script should support the results of the lbl CGI script (i.e. produce a compound version of an old or labelled tree). This will of course not result in DO sharing!

This cannot be run on the result produced by the nav script (which is not retained). Rerunning it would be sub-optimal.

The behaviour is similar, but not identical: part of it must be duplicated anyway (e.g. getting rid of the footers), and the ToC produced isn't suitable as such: one must remove the leaf entries from it.

It is a one pass-parsing (the files are opened only once). The output is buffered in a hash.

The title tags are ignored (apart for the topmost one).

Changing view doesn't work under clearmake (either using a view extended path or using setview with the IPC::ClearTool package):

clearmake: Warning: Configuration record will not include objects accessed using view "doc"

Note that with the apache server running as apache:apache, one needs to use sudo to run clearmake.
There is thus a sudoers setting to explicitly allow apache to run clearmake as vobadm.