unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



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



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 fixman(1M)							  fixman(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.

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






























 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000