Manual entries should be stored in the appropriate subdirectory in RTF format (and checked into RCS). Typing make from ~gh/man/src/rtf will check each subdirectory for files that need to be rebuilt and generate HTML documents for each. RTF files should not have a .rtf suffix. The generated HTML files are stored in ~gh/man/html and do not have a .html suffix. Pictures in GIF format are also stored here. The HTML storage area is flat for ease of cross referencing. Only the basename of a manual entry need be used when constructing a hyperlink.
The subdirectory Templates contains a set of RTF files which may be imported into Word on the Macintosh. These templates provide the styles with which manual entries are to be formatted. The RTF to HTML tool needs to be configured with a mapping from each RTF style to some HTML markup. Thus, only the styles provided in the templates should be used since these are the styles that the conversion tool presently understands. Should we need more styles in the future then the person in charge of manual maintenance should be notified.
Presently there are templates for the following kinds of manual entries:
Currently, overview pages are to be split into two or more sections. The first section will contain a hyperlink to the second section and a set of function prototypes each with a short description. The name of each function will be a hyperlink to a function style manual entry. The second section will contain all of the descriptive information about the subject of the overview. As an example of this, check the manual entry for managers.
A hyperlink contains two components which must be underlined. The first component is the name of another manual entry and must be formatted as hidden text (in addition to the underlining). The second component is concatenated with the first and requires no other formatting. This component is the hot text of the hyperlink. The components must appear in the order just described.