=================================================================== RCS file: /cvs/mandoc/INSTALL,v retrieving revision 1.7 retrieving revision 1.9 diff -u -p -r1.7 -r1.9 --- mandoc/INSTALL 2014/12/09 09:19:13 1.7 +++ mandoc/INSTALL 2014/12/11 07:44:46 1.9 @@ -1,4 +1,4 @@ -$Id: INSTALL,v 1.7 2014/12/09 09:19:13 schwarze Exp $ +$Id: INSTALL,v 1.9 2014/12/11 07:44:46 schwarze Exp $ About mdocml, the portable mandoc distribution ---------------------------------------------- @@ -155,11 +155,11 @@ Deployment requires the following steps: 1. Build and install mandoc as described above in steps 2 to 5 below "Installation". -2. If you system uses manpath(1), make sure it is configured +2. If your system uses manpath(1), make sure it is configured correctly, in particular, it returns all directory trees where manual pages are installed. If your system uses man.conf(5), make -sure it contains a "_whatdb" for each directory tree, and the order -of these lines meets your wishes. +sure it contains a "_whatdb" line for each directory tree, and the +order of these lines meets your wishes. 3. Run the command "sudo makewhatis" to build mandoc.db(5) databases in all the directory trees configured in step 2. @@ -168,7 +168,10 @@ At this point, your new man(1), apropos(1), and whatis Otherwise, please look at , both for help and to have these instructions improved. +Whenever installing new manual pages, re-run makewhatis(8) to update +the databases, or man(1) will not find the new pages. + Deployment using your system's native man(1) viewer --------------------------------------------------- This mode of deployment does not require database support, @@ -207,7 +210,8 @@ is pulled in as a dependency and used to install a pre "catpage" instead of directly as manual page source. For more background on switching operating systems to use mandoc(1) -instead of groff(1) to format manuals, see the two BSDCan presentations -by Ingo Schwarze: +instead of groff(1) to format manuals, see the BSDCan and EuroBSDCon +presentations by Ingo Schwarze: +