HP-UX Reference (11i v2 03/08) - 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 per-
missions 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.
Section 1M−−192 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003