$title = "Manual pages"; $area = "Unix Support"; $metadata = "unix, manual, man, format, name, synopsis, description, option, environment, example, files, warnings, diagnostics, bugs"; $pfloc = ""; require '/usr/local/wwwdocs/ucs/fragments/header.phtml'; require '/usr/local/wwwdocs/ucs/fragments/header-bc.phtml'; ?>
The content of every man page is organised under a number of headings. At least NAME, SYNOPSIS and DESCRIPTION are available for every command.
NAME |
lists the exact name of the command(s) covered by this manual page and gives a short description of what the command does. |
SYNOPSIS |
gives a summary of command usage and enables you to see how options can be given to the command. For example: cp [-iprR] directory1 directory2 The first word or consecutive characters are the name of the command. The characters enclosed in [square brackets] are optional. A '-' (hyphen) preceding a character indicates that this is an option that can be applied to the command. Options grouped together after a single hyphen, like this, [-abcD] can be used in this format. If they are given separately, like this, [-n] [-r] [-Z] then they must be used in this format. Arguments are represented by a name such as file, filename or directory. |
DESCRIPTION |
gives a detailed description of how the command works. |
OPTIONS |
explains the action that each option has when used with the command. |
ENVIRONMENT |
gives the names of any environment variables used by the command and the value(s) that they can be set to. |
EXAMPLES |
provides examples of how the command can be used. It is often omitted. |
FILES |
gives details of the files used by the command. |
SEE ALSO |
refers to manual pages for commands that contain related information. Follow these references to learn which commands are associated with each other. |
WARNINGS |
warns against using the command in a way that might cause problems. |
DIAGNOSTICS |
explains the meaning of the various diagnostic messages that the command may present you with. Messages that are considered self explanatory are not included. |
BUGS |
advises about known 'bugs' or shortcomings with the command. |