INSTALLATION PROCEDURE FOR THE MAN 2.0 ALPHA PACKAGE.

1) ./configure
	
I would recommend the defaults at present (if possible) as they have 
had the most testing. Except the 'alternate' man tree option which
is not necessary in most cases and has NOT been tested at all.

2) EDIT manpath.config if necessary.

3) EDIT Makefile.

Only a couple of things might require change. Notably compiler
defines.

-DNDBM: add if you do not have gdbm (this is included in libc-4.5.21)

-DFSSTND: add if you want to have a FSSTND compliant cat tree.
	This allows readonly mounting of /usr (as long as 
	other software also complies).

-DDUPS=1 or -DDUPS=0: This will set the default behaviour of man and
	mandb. With a setting of 1, duplicate man pages, (such
	as /usr/man/man1/cat.1 and /usr/local/man/man1/cat.1) will
	not both be included in the database. Only the newer one will be.
	If you would like the default behaviour to be to include
	both, then set DUPS=0.

-DXMALLOC: In my lazyness, I don't check return values of malloc,
	realloc or strdup. If these fail, the program will just die.
	By defining this, you may get a message about a lack of
	memory just before death. You can decide on the usefulness.

ALSO, IF YOUR CURRENT CAT PAGES DO NOT HAVE A ".Z" EXTENSION, YOU WILL HAVE
TO CHANGE THE DEFINITION OF COMPRESS_EXT IN config.h. 

As long as it is ".something" eg. ".gz", ".z", ".Z" everything should work.

4) make
5) su
6) make install

While ROOT, you should also sort out the cat tree and it's perms (if you
want a cat tree - much faster but more space).

If you elect to go with the FSSTND you will need to create /var/catman and
/var/catman/? for all /usr/?/man trees. Eg. for /usr/X386/man, create
/var/catman/X386.

In all of the above directories, you will then have to create the relevant
cat subtree, ie. cat1, cat2, ..., cat9, catxyz ...

Now that you have the directories in place, you can transfer across any cat
pages you already have (from the /usr/man/cat? and asscociated directories). 
This is a wise move as you may have some stray cats, which can then be found
and dealt with. You may than delete all of these old cat directories found
under /usr.

Next, you will need to sort out the perms.
If you went with the 'secure man pages setuid' option earlier 
(highly recommended), you should do something like:

	chown -R daemon.root /var/catman
 
You are now set up for cat production.

You need to remain as root for a little while yet, 

7) mandb

This will create the global database and warn you of any oddities lurking in
your man tree. I advise you to delete or rename bogus, duplicate or possible
duplicate man files before progressing. You could then run mandb once more,
to check that there are no warnings.

8) straycats

This will scan your cat directories for stray cats. If you have no stray
cats, good - proceed to step (10).
If you have stray cats, they need to be registered in the relevant man
source tree, so that man can find them. READ THE STRAYCATS MANUAL PAGE.
Straycats will create and delete for you so it is important to know what you
are doing first! The default action is just to look. The defualt WRITE
action is to delete non-relative stray cats and create place-holders for the
rest.

9) mandb

This step is advised (but not needed as man will do it for you), if you
added place-holders in step (7). You can then deal with any warnings again.

10) Give up your root perms (exit) and try it out.
