NAME

fixman − fix manual pages for faster viewing with man(1)

SYNOPSIS

fixman

DESCRIPTION

fixman is a shell script that processes all ordinary files in default or specified man* and/or cat* directories.  fixman unexpands spaces to tabs where possible and removes 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. fixman should be run after using catman to create formatted, cat-able manual entries 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:

• /usr/man

• /usr/contrib/man

• /usr/local/man

If the MANPATH environment variable is set, the directory paths specified by MANPATH are searched for cat* directories. 

fixman 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, the script should be run by a user who has appropriate privileges.  It can take up to an hour or more to complete, depending on system speed.  As a side-effect, file ownerships and permissions may be changed. 

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)).

FILES

*/man/cat* Directories containing nroff-formatted versions of manual entries

AUTHOR

fixman was developed by HP. 

SEE ALSO

catman(1M), chmod(1), expand(1), lp(1), man(1), mv(1), rmnl(1), sed(1), environ(5). 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994