NAME

help - Print man page for Soar command

SYNOPSIS

help [-all | -usage | command-name]

DESCRIPTION

This command prints the formatted manual page for the given command-name.

The help command attempts to locate a pager program to use to display help pages page-by-page since some are longer than a typical screen. The command first examines the environment variable PAGER to see if the user has defined a preference there. If that is not present, the help system checks to see if one of the commonly used pagers "less", "more", or "page" is available (in that order). If no pager is available, then an error message is given. If no pagers exist on your system, then you can set the environment variable PAGER to "cat" and the help pages will simply be cat'ed to the screen. Since some pages are long, this will make it difficult to read an entire page.

OPTIONS

-all
List all commands for which help is available
-usage
List only the SYNOPSIS section of the man page. This includes the abbreviated syntax for the command.

FILES

The nroff sources for the manual pages are stored in the subdirectory .../doc/man. These files are used to generate the "cat" and "HTML" versions which are stored in .../doc/cat and .../doc/html, respectively.

ENVIRONMENT

PAGER
This variable contains the user's preferred paging program which shows text page by page rather than spewing all text at once to standard output. Typical pagers are more, less, and page.

WARNINGS

Some pages, such as less clear the screen upon exit, removing the help page from view. If you wish to retain the help page, use a pager such as more.