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