Modifying the search path for reference pages

The standard man and xman commands can locate reference page files in various locations. These programs can use (but do not require) a search path specified by the MANPATH environment variable. If you want to read DevOps Code ClearCase® reference pages using these programs, add the DevOps Code ClearCase man directory to your reference pages search path.

Note: Read this section only if you plan to access DevOps Code ClearCase online reference pages with the standard man or xman commands. You can skip this section if you intend to rely on the Help system built in to the DevOps Code ClearCase graphical user interface or if you always use the cleartool man subcommand (which does not require a search path) to access reference pages.
Users of Linux or the UNIX system are accustomed to using the man(1) command to get online documentation. DevOps Code ClearCase includes a comprehensive set of reference pages, accessible in several ways:
  • Through the standard man command (Linux and UNIX system command-line interface)
  • Through the standard xman command (X Window System graphical interface)
  • Through the man subcommand built in to the cleartool program

On some systems such as those that do not have a full ClearCase installation, the reference documentation might be installed on a remote DevOps Code ClearCase server. Before defining the search path in these environments, mount the directory for the server where the documentation is hosted.

Table 1. Setting MANPATH to include the DevOps Code ClearCase reference pages location
Shell environment Standard installation location (opt/devops/clearcase) Alternate installation location (/opt/ccase)
.cshrc (C shell) 
setenv MANPATH ${MANPATH}:/opt/devops/clearcase/doc/man
 
setenv MANPATH ${MANPATH}:$CLEARCASEHOME/doc/man
.profile (Bourne or Korn shell) 
MANPATH=${MANPATH}:/opt/devops/clearcase/doc/man
export MANPATH
 
MANPATH=${MANPATH}:$CLEARCASEHOME/doc/man
export MANPATH
Note: The variable CLEARCASEHOME must be set if DevOps Code ClearCase is installed at a location other than /opt/devops/clearcase.

If your shell startup file does not set the MANPATH environment variable, see the reference page for the man command to determine your system default search path for man pages. Then, set MANPATH accordingly in your shell startup script, just before the commands shown in the previous table.

For example: 
# setenv MANPATH /usr/man:/usr/contrib/man:/usr/local/man

For Windows™, modifications to MANPATH are not required.