version 1.7, 2014/12/09 09:19:13 |
version 1.9, 2014/12/11 07:44:46 |
Line 155 Deployment requires the following steps: |
|
Line 155 Deployment requires the following steps: |
|
1. Build and install mandoc as described above in steps 2 to 5 |
1. Build and install mandoc as described above in steps 2 to 5 |
below "Installation". |
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 |
correctly, in particular, it returns all directory trees where |
manual pages are installed. If your system uses man.conf(5), make |
manual pages are installed. If your system uses man.conf(5), make |
sure it contains a "_whatdb" for each directory tree, and the order |
sure it contains a "_whatdb" line for each directory tree, and the |
of these lines meets your wishes. |
order of these lines meets your wishes. |
|
|
3. Run the command "sudo makewhatis" to build mandoc.db(5) databases |
3. Run the command "sudo makewhatis" to build mandoc.db(5) databases |
in all the directory trees configured in step 2. |
in all the directory trees configured in step 2. |
Line 168 At this point, your new man(1), apropos(1), and whatis |
|
Line 168 At this point, your new man(1), apropos(1), and whatis |
|
Otherwise, please look at <http://mdocml.bsd.lv/contact.html>, both |
Otherwise, please look at <http://mdocml.bsd.lv/contact.html>, both |
for help and to have these instructions improved. |
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 |
Deployment using your system's native man(1) viewer |
--------------------------------------------------- |
--------------------------------------------------- |
This mode of deployment does not require database support, |
This mode of deployment does not require database support, |
Line 207 is pulled in as a dependency and used to install a pre |
|
Line 210 is pulled in as a dependency and used to install a pre |
|
"catpage" instead of directly as manual page source. |
"catpage" instead of directly as manual page source. |
|
|
For more background on switching operating systems to use mandoc(1) |
For more background on switching operating systems to use mandoc(1) |
instead of groff(1) to format manuals, see the two BSDCan presentations |
instead of groff(1) to format manuals, see the BSDCan and EuroBSDCon |
by Ingo Schwarze: |
presentations by Ingo Schwarze: |
<http://www.openbsd.org/papers/bsdcan11-mandoc-openbsd.html> |
<http://www.openbsd.org/papers/bsdcan11-mandoc-openbsd.html> |
<http://www.openbsd.org/papers/bsdcan14-mandoc.pdf> |
<http://www.openbsd.org/papers/bsdcan14-mandoc.pdf> |
|
<http://www.openbsd.org/papers/eurobsdcon2014-mandoc-paper.pdf> |