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

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/!!!intro.1m
________________________________________________________________
___ ___
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.
Section 1M−−230 − 1 − HP-UX Release 11i: December 2000
___
___