Conventions

Typographic/stylistic

This manual uses a small collection of fonts and typefaces to denote different aspects of what is being discussed. Specifically...

Italics are used for the first appearance of a word or phrase within the manual or simply to bring emphasis to a point.

A courier monowidth typeface is used to show file/script/program names, the contents of files on the system, or a sample terminal output from a script or program.

Bold monowidth is used to distinguish what the user must type when entering text at the command line, or in response to script prompts.

Where appropriate, the hash character (`#') will appear when displaying entries made at the command line. It is meant to represent a generic system prompt.

On a similar note, there are instances where a single line of monowidth font won't fit nicely on a single line of the manual. On such occasions, the text will be presented as two lines and the first will finish with the standard UNIX line continuation character, `\'.

References to menu items and buttons are worded as "choose the ABC option from the XYZ menu" or "click the ABC button." Accelerator keys, if appropriate, are mentioned in parenthesis.

In the hope of clarity, the typographic convention "" is used to denote the tab character and "" is used to denote an empty input (namely, the enter key).

This manual occasionally refers to the generic user as male (he, him, his, etc.). Please do the mental substitution of `he/she', or `his/her' as appropriate.

Directory diagrams

As necessary in this manual, we provide a textual diagram to illustrate a directory structure. For example...

                /-- adm  - - - - - - -> ../var/adm
                |-- install
                |
                |-- nserve ------------ auth.info
                |
                |-- openwin ----------- modules
/etc -----------+
                |-- ppp
                |-- sm
                |-- spool  - - - - - -> ../var/spool
                |-- tmp  - - - - - - -> ../var/tmp
                |
                \-- uucp -------------- OLD

In such a diagram, only the names of directories are shown. The broken dashed lines represent a symbolic link to the actual directory.