NAME
fixman — fix manpages for faster viewing with man command
SYNOPSIS
/usr/sbin/fixman
[-A
alt-path]
DESCRIPTION
The
fixman
command is a shell script that processes manpages 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
manpages from unformatted,
nroff-compatible
source files (see
catman(1M)).
By default,
fixman
searches for
cat*
subdirectories in the following parent directories
in the order indicated:
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 permissions 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
manpages.
WARNINGS
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 manpages 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 manpages
- /usr/local/man/cat*[.Z]
- /usr/contrib/man/cat*[.Z]
AUTHOR
fixman
was developed by HP.