Before these files can be installed, each must be formatted using the command defined by
confNROFF (?§2.7.34.5 on page 88), withth e macro package defined by confMANDOC
(?§2.7.34.6 on page 88). In the following example, sendmail.8 is the troff source being
formatted:
${NROFF} ${MANDOC} sendmail.8 > sendmail.${MAN8SRC}
The formatted manual is placed into a file with the same base name as the input file, but
witha new tag as defined by the confMAN8SRC macro. Section 1 manuals use the confMAN1SRC
macro, section 5 manuals use the confMAN5SRC macro, and section 8 manuals use the
confMAN8SRC macro. In general, the confMAN*SRC macros should not be redefined* unless you
have a pressing need to do otherwise. For example, consider:
define(`confMAN1SRC??, `txt??)
define(`confMAN4SRC??, `txt??)
define(`confMAN5SRC??, `txt??)
define(`confMAN8SRC??, `txt??)
which would produce a formatting command that looks like this for sendmail.8:
${NROFF} ${MANDOC} sendmail.8 > sendmail.txt
The confMAN*SRC macros are also used when the manual pages are installed. In the
following example (which again uses sendmail.8 as the troff source), the formatted manuals
are copied with install(1) like this:
${INSTALL} -c -o ${MANOWN} -g ${MANGRP} -m ${MANMODE} sendmail.${MAN8SRC} ${MAN8}/sen
dmail.${MAN8EXT}
2.7.34.2 Where to install the manuals
Each of the three manual sections has a directory where the formatted files should be
installed.
Pages:
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178