INSTALLATION

The quick installation goes in three steps:
	1. configure -default
	2. make
	3. make install

This should suffice for most people. The defaults are:
   Only English man pages, no message catalogs, man not suid,
   handle compressed man pages, compress cat pages, create cat pages
   whenever the appropriate directory exists,
   follow FSSTND by putting cat pages under /var/catman provided that
   that directory exists.

In order to select man pages in other languages, replace Step 1 by
	1. configure +lang de,en,nl
or perhaps (especially when making a general distribution) by
	1. configure +lang all
This yields all the defaults, except for the language setting.

People who want something other than the default also use three steps:
1. configure
2. make
3. make install
but have to answer a lot of questions during configure.

In somewhat greater detail:

1. Run configure.  This will grope around your system a bit and then
   ask you a number of questions.  It will create a Makefile from the
   file Makefile.in.  You may have to do some fine tuning to get things
   to work exactly right on your system.  If you do, I'd like to know
   what changes you had to make to get things working.

   Man uses groff (nroff, troff) to format man pages. If you don't
   have *roff, then you can only use preformatted man pages.

   You can make man suid to some uid, say man, where man is the owner
   of the directories (like /usr/man/cat*) for formatted man pages.
   That way man can write formatted pages there, even when the directory
   does not have universal write permission. However, it is fairly easy
   to spoof man, so really this setup is not very different from the one
   where /usr/man/cat* has universal write permission.
   Never make man suid bin or daemon or root!

2. Look at the man.config file. This determines the programs and extensions
   used in compressing and uncompressing cat pages. It also determines
   the system-wide mappings from bin directories to man page directories.
   It was constructed by configure; you might want to make some changes.

3. Do a `make all', try it out, and then if you're happy with that, do
   a `make install'.  You don't need to be root to use this set of
   programs.
   [Note: if you want to try man with the new, not yet installed, man.config
   file, use "man -C ./man.config ...".]

4. Install the whatis database(s) by running makewhatis.  If you want
   to keep things absolutely current, you'll need to run this whenever
   you add new man pages.  You might want to add an entry in your
   crontab. 

