Adding documents to the help system

Man page style guidelines

The man(1) system on UnixWare 7 can handle man page files in any mix of man file formats: HTML, man macros, and preformatted ASCII (cat files). In addition to using the graphical SCOhelp browser to display these pages, you can also use the man command to display them on any character display. For such displays, the files are converted on the fly from HTML to ASCII. However, these displays do not support graphics, frames, HTML tables, or JavaScript, so HTML man pages should be kept to the simplest HTML markup. Preformat tables in manual pages using <PRE> instead of the <TABLE> tags (see ``Topic template'').

SCO-supplied man pages use a certain style when converting the man troff(1bsd) macros to HTML. The following two examples show the content before and after conversion.

Before:

    .TH cat 1
    .SH Name
   cat -- concatenate and display files
    .SH Synopsis
    .
    .
    .

After:

   <HTML>
   <HEAD>
   <TITLE>cat(1)</TITLE>
   </HEAD>
   <BODY>
   <H1>cat(1)</TITLE>
   <HR>
   <B>cat -- concatenate and display files</B>
   <P>
   <H2>Synopsis</H2>
    .
    .
    .
   </BODY>
   </HTML>