1INSTALLATION
2
3NOTE! The default configuration file has moved from
4/usr/lib/man.config or /etc/man.conf to /usr/share/misc/man.conf.
5Remove the former two.
6The country code dk has been replaced by the language code da.
7If you had Danish man pages installed, these should probably be moved.
8
9The quick installation goes in three steps:
10	1. configure -default
11	2. make
12	3. make install
13
14This should suffice for most people. The defaults are:
15   Only English man pages, no message catalogs, man not suid,
16   handle compressed man pages, compress cat pages, create cat pages
17   whenever the appropriate directory exists,
18   follow FHS by putting cat pages under /var/cache/man provided that
19   that directory exists.
20
21In order to select man pages in other languages, replace Step 1 by
22	1. configure +lang de,en,nl
23or perhaps (especially when making a general distribution) by
24	1. configure +lang all
25This yields all the defaults, except for the language setting.
26
27People who want something other than the default also use three steps:
281. configure -ask
292. make
303. make install
31but have to answer a lot of questions during configure.
32
33In somewhat greater detail:
34
351. Run configure.  This will grope around your system a bit and then
36   ask you a number of questions.  It will create a Makefile from the
37   file Makefile.in.  You may have to do some fine tuning to get things
38   to work exactly right on your system.  If you do, I'd like to know
39   what changes you had to make to get things working.
40
41   Man uses groff (nroff, troff) to format man pages. If you don't
42   have *roff, then you can only use preformatted man pages.
43
44   You can make man suid to some uid, say man, where man is the owner
45   of the directories (like /usr/man/cat*) for formatted man pages.
46   That way man can write formatted pages there, even when the directory
47   does not have universal write permission. However, it is fairly easy
48   to spoof man, so really this setup is not very different from the one
49   where /usr/man/cat* has universal write permission.
50   Never make man suid bin or daemon or root!
51
52   Of course it is not necessary at all to cache formatted man pages.
53   Formatting usually takes less than a second, and by not having
54   preformatted pages one avoids problems with window width, integrity, etc.
55
562. Look at the man.conf file. This determines the programs and extensions
57   used in compressing and uncompressing cat pages. It also determines
58   the system-wide mappings from bin directories to man page directories.
59   It was constructed by configure; you might want to make some changes.
60
613. Do a `make all', try it out, and then if you're happy with that, do
62   a `make install'.  You don't need to be root to use this set of
63   programs.
64   [Note: if you want to try man with the new, not yet installed, man.conf
65   file, use "man -C ./man.conf ...".]
66
674. Install the whatis database(s) by running makewhatis.  If you want
68   to keep things absolutely current, you'll need to run this whenever
69   you add new man pages.  You might want to add an entry in your
70   crontab. 
71