fixman(1M)                                                       fixman(1M)




 NAME    [Toc]    [Back]
      fixman - fix manual pages for faster viewing with man(1)

 SYNOPSIS    [Toc]    [Back]
      /usr/sbin/fixman [-A alt-path]

 DESCRIPTION    [Toc]    [Back]
      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
      permissions may be changed.

    Options    [Toc]    [Back]
      -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    [Toc]    [Back]
    Environment Variables
      MANPATH, if set, defines the directories to be searched for cat-able
      manual entries.

 WARNING    [Toc]    [Back]
      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)).



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 fixman(1M)                                                       fixman(1M)




 EXAMPLES    [Toc]    [Back]
      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    [Toc]    [Back]
      /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    [Toc]    [Back]
      fixman was developed by HP.

 SEE ALSO    [Toc]    [Back]
      catman(1M), chmod(1), expand(1), lp(1), man(1), mv(1), sed(1),
      environ(5).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003