Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX System Administrator's Guide: Configuration Management: HP-UX 11i Version 3

Chapter 8 Setting Up the Online Manpages

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Index

There are three ways to set up online manpages, each resulting in a different amount of disk usage and having a different response time:

  1. Fastest response to the man command (but heaviest disk space usage):

    Create a formatted version of all the manpages. This is a good method if you have enough disk space to hold the nroff originals and the formatted pages for the time it takes to finish formatting. To start the formatting process, enter:

    # catman

    Formatting all the manpages can take some time, so you might want to run the process at a lower priority.

  2. Medium response time to the man command (with medium disk space usage):

    Format only heavily used sections of the manpages. To format selected sections, enter:

    # catman sections

    where sections is one or more logical section IDs from the HP-UX Reference, such as 1, 1m, 2, 3. Note that the letter m is lowercase. For example,

    # catman 1m357

  3. Slowest response to the man command (but lightest disk space usage):

    Do not format any manpages. HP-UX will format each manpage the first time a user specifies the man command to call up a page. The formatted version is used in subsequent accesses (only if it is newer than the unformatted source file).

    To improve response time, you can make directories to hold the formatted manpages. To determine the directory names you need, check the MANPATH variable. For example, to create directories for the default /usr/share/man directory, execute the following script:

    # cd /usr/share/man # mkdir cat1.Z cat1m.Z cat2.Z cat3.Z cat4.Z cat5.Z \ > cat6.Z cat7.Z cat8.Z cat9.Z

    You only need to create the cat8.Z directory if /usr/share/man/man8.Z exists. To save disk space, make sure you use the cat*.Z directories (not cat*) because if both cat*.Z and cat* exist, both directories are updated by man.

To save disk space, you can NFS mount the manpages on a remote system.

Regardless of how you set up the manpages, you can recover disk space by removing the nroff source files.

CAUTION: Before removing any files, make a backup of the man directories you created in case you need to restore any files.

For example, to remove files for section 1 in /usr/share/man, enter:

# rm man1/* # rm man1.Z/*

This concept for recovering disk space also applies to localized manpages. For further details, see man(1) and catman(1M).

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2008 Hewlett-Packard Development Company, L.P.