HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

f
fixman(1M) fixman(1M)
NAME
fixman - fix manual pages for faster viewing with man(1)
SYNOPSIS
/usr/sbin/fixman
[ -A alt-path]
DESCRIPTION
The
fixman command is a shell script that processes man pages in the
cat* directories to unexpand
spaces to tabs where possible, and to remove all character-backspace pairs (which usually exist to cause
overstriking or underscoring for printer output). Removal of unnecessary character sequences improves
the speed of man(1), and reduces disk space consumption. The
fixman command should be run after
using
catman to create formatted, cat-able manual entries from unformatted, nroff(1)-compatible source
files (see catman(1M)).
By default,
fixman searches for cat* subdirectories in the following parent directories in the order
indicated:
/usr/share/man
/usr/contrib/man
/usr/local/man
If the MANPATH environment variable is set, the directory paths specified by MANPATH are searched
instead of the default. See environ(5) for a description of the
MANPATH environment variable.
The fixman command does not remove duplicate blank lines. Thus, all files remain a multiple of one
page (66 lines) long and can still be passed directly to lp (see lp(1)). (Note that man(1) normally uses
more -s to accomplish this removal.)
To ensure success, fixman should be run by a user who has appropriate privileges. It will take awhile to
complete depending on system speed, load, memory size, etc. As a side-effect, file ownerships and permis-
sions may be changed.
Options
-A alt-path
Perform actions based on the given alternate root. With this option, alt-path will be prepended to all
directory paths, including default paths or the paths defined by
MANPATH.
EXTERNAL INFLUENCES
Environment Variables
MANPATH, if set, defines the directories to be searched for cat-able manual entries.
WARNING
If the value of
MANPATH is not the same while fixman is running as it was when
catman was run or
when manpage files were installed, some files may be missed and not processed (see catman(1M)).
EXAMPLES
Run fixman from a server to fix the manual pages on a diskless under the alternate root
/export/shared_roots/OS_700
:
fixman -A /export/shared_roots/OS_700
This will fix manpages in cat* directories under:
/export/shared_roots/OS_700/usr/share/man/
/export/shared_roots/OS_700/usr/contrib/man/
/export/shared_roots/OS_700/usr/local/man/
FILES
/usr/share/man/cat[.Z] Directories containing [compressed] nroff(1)-formatted versions of
manual entries
/usr/local/man/cat[.Z]
/usr/contrib/man/cat[.Z]
AUTHOR
fixman was developed by HP.
HP-UX 11i Version 1: September 2005 1 Hewlett-Packard Company Section 1M235