home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / languages / perl / scripts-convex / man.shar / man / FEATURES < prev    next >
Encoding:
Text File  |  1991-03-04  |  2.3 KB  |  84 lines
  1. Features include but are not limited to:
  2.  
  3.     *   almost always faster than standard man (try 'man me')
  4.  
  5.     *    take much less diskspace for catpages
  6.  
  7.     *    supports per-tree tmac macros
  8.     
  9.     *    compressed man and cat files
  10.  
  11.     *    user-definable man path via $MANPATH or -M optoin
  12.     
  13.     *  $MANPATH autoconfigged based on $PATH if not set
  14.  
  15.     *   user-definable section search order via -S or $MANSECT.  Thus
  16.     programmers can get stty(3) before stty(1).
  17.     
  18.     *    $PAGER support
  19.  
  20.     *    show all the places you would find a man page (-w option)
  21.     and in what order.
  22.  
  23.     *   display all available man page on a topic (-a option)
  24.     
  25.     *   no limits on what subsections go where (if you want to add 7x, ok)
  26.  
  27.     *   support for multi-char sections like man1m/*.1m or manavs/*.avs
  28.  
  29.     *   man -K for regexp apropos
  30.  
  31.     *   grep through all the man pages in $MANPATH
  32.  
  33.     *   section and subsection indexing for long man pages
  34.  
  35.     *   support for alternate architectures docs on same machine
  36.  
  37.     *    ability to run man on a local file 
  38.  
  39.     *    ability to easily troff (or preview) a man page
  40.  
  41.     *    recognizes embedded filter directives for tbl and eqn
  42.  
  43.     *    does the right thing for man tree that don't have DBM whatis files
  44.  
  45.     *   support for connecting online problem reports to right man page
  46.    
  47.     *   there's an extended usage message (man -U) for further help
  48.     and to show current defaults.
  49.  
  50.  
  51. Here are some features of this version of makewhatis:
  52.  
  53.     *    it's faster.
  54.  
  55.     *    tries hard to make pretty output, stripping troff directives.
  56.  
  57.     *   doesn't blow up on more files in a man directory 
  58.     than the shell will glob.  
  59.  
  60.     *   accepts troff string macros for the dashes in the
  61.     the NAME section.
  62.  
  63.     *   prints a diagnostic for a malformed NAME section.
  64.  
  65.     *   detects linked (hard, soft, or via .so) man pages
  66.  
  67.     *   finds *all* references in the NAME section.
  68.  
  69.     *   recognizes MH's man macros (and .Sh from lwall).
  70.  
  71.     *   many other things that makewhatis used to do wrong
  72.  
  73. Here are some supporting utilities that are included:
  74.  
  75.     *   catman -- new version that groks compressed files
  76.  
  77.     *   catwhatis -- display the whatis databases
  78.  
  79.     *     straycats -- find cat pages with no man page ancestor
  80.  
  81.     *   countman -- find how many man pages you can get at
  82.  
  83.     *   cfman -- find bad SEE ALSO references in man pages
  84.