`man', `apropos', `whatis' and `catman' are simple-minded versions of the
UN*X manual paging, manual search and manual maintenance programs.
These versions were written by HPP Biersma (schuller@dutiag.tudelft.nl)
and come under the GNU public license; see the file "copying" for details.

These programs were written to be used under MiNT. They have not been
extensively tested under TOS. As the mintlib is used, it should work
just fine under TOS; however, no guarantees are given.

To use these programs, you need an `nroff' program, the `tmac.an' macro 
package for nroff, a pager like `less' or `more' and the `cat' program.
Installation is easy:
- Make sure `nroff' and `cat' are in the search path. For instance,
  if these programs reside in /bin, make sure the environment variable
  PATH includes /bin. If you can run these programs from your shell,
  all should be fine.
- Make sure `nroff' can find the tmac.an macro package. You may have
  to set an environement variable to do this. The `nroff' I use
  needs to have the searchpath set in the environment varaible TMACDIR.
- Set the environment variable PAGER to the pager you want to use.
  Do not forget to include parameters. The default is `less -r -e'.
  Of course, your pager should be in the search path, or the name of
  the pager must be set to an absolute path.
- Set the environment variable MANPATH to the directories containing
  manual pages. Directories must be separeted by a colon or semicolon.
  The default is /usr/man.
- Make sure the man?, cat? directories are properly set up.
  An example: all MiNT manual pages are from section 2. So, create a directory
  called `man2' within the man directory and copy all MiNT man pages there.
  If you want to keep formatted versions, create the directory `cat2' too.

The (unformatted) manual files "man.1", "apropos.1", "whatis.1" and 
"catman.8" contain manuals for `man', `apropos', `whatis' and `catman'. 
Short info: `man' displays reference manual pages, `apropos' and
`whatis' look up a command in the whatis database
and `catman' formats manual pages and builds the whatis database.


Notes:
- man, apropos, whatis and catman were written for:
  - gcc version 2.1, patchlevel 2 
  - mintlib patchlevel 20. 
  Thanks to Eric Smith and Jhawar Bammi for gcc, mintlib and MiNT.
- man, apropos, whatis and catman should work under MiNT and TOS.
- source code is in the files `man.c', `apropos.c', `whatis.c' and `catman.c'.
- man, apropos, whatis and catman come under the GNU public license. 
  See the file "copying" for details.
- bug reports, questions, comments: to schuller@dutiag.tudelft.nl
- if anyone has got a good version of `more' running under MiNT
  (one that doesn't drop lines), please mail me!
