[d9ed058f] | 1 | <sect2><title> </title><para> </para></sect2>
|
---|
| 2 |
|
---|
[6370fa6] | 3 | <sect2>
|
---|
| 4 | <title>Installation of Man</title>
|
---|
| 5 |
|
---|
[9930287] | 6 | <para>There are three patches for Man. The first patch comments out one of the
|
---|
| 7 | lines in the <filename>man.conf</filename> file (MANPATH /usr/man) to
|
---|
| 8 | prevent redundant results when using programs such as
|
---|
| 9 | <userinput>whatis</userinput>:</para>
|
---|
[6370fa6] | 10 |
|
---|
[9930287] | 11 | <para><screen><userinput>patch -Np1 -i ../man-&man-manpath-patch-version;-manpath.patch</userinput></screen></para>
|
---|
| 12 |
|
---|
| 13 | <para>The second patch adds the <emphasis>-R</emphasis> option to the
|
---|
| 14 | <emphasis>PAGER</emphasis> variable so that escape sequences are
|
---|
| 15 | handled properly:</para>
|
---|
| 16 |
|
---|
| 17 | <para><screen><userinput>patch -Np1 -i ../man-&man-pager-patch-version;-pager.patch</userinput></screen></para>
|
---|
| 18 |
|
---|
| 19 | <para>The last patch prevents problem when man pages not formatted
|
---|
| 20 | with more than 80 columns are used in conjunction with recent releases
|
---|
| 21 | of <userinput>groff</userinput>:</para>
|
---|
| 22 |
|
---|
| 23 | <para><screen><userinput>patch -Np1 -i ../man-&man-80cols-patch-version;-80cols.patch</userinput></screen></para>
|
---|
| 24 |
|
---|
| 25 | <para>The paths to some programs are written into man's files.
|
---|
| 26 | Unfortunately, the configure script picks the last location in PATH
|
---|
| 27 | rather than the first place a program is found. By appending
|
---|
| 28 | <emphasis>/usr/bin:/bin</emphasis> to PATH for the
|
---|
| 29 | <userinput>./configure</userinput> command, we ensure that man doesn't
|
---|
| 30 | use the programs in the <filename class="directory">/static</filename>
|
---|
| 31 | directory.</para>
|
---|
[d9ed058f] | 32 |
|
---|
| 33 | <para>Prepare Man to be compiled:</para>
|
---|
| 34 |
|
---|
[9930287] | 35 | <para><screen><userinput>PATH=$PATH:/usr/bin:/bin \
|
---|
| 36 | ./configure -default -confdir=/etc</userinput></screen></para>
|
---|
[d9ed058f] | 37 |
|
---|
| 38 | <para>Continue with compiling the package:</para>
|
---|
| 39 |
|
---|
| 40 | <para><screen><userinput>make</userinput></screen></para>
|
---|
| 41 |
|
---|
| 42 | <para>And finish off installing the package:</para>
|
---|
| 43 |
|
---|
| 44 | <para><screen><userinput>make install</userinput></screen></para>
|
---|
[6370fa6] | 45 |
|
---|
[d9ed058f] | 46 | <note><para>If you wish to disable SGR escape sequences, you should
|
---|
[4bc6304] | 47 | edit the man.conf file and add the <userinput>-c</userinput> argument
|
---|
[d9ed058f] | 48 | to nroff.</para></note>
|
---|
[4bc6304] | 49 |
|
---|
[d920fb0] | 50 | <para>You may want to take a look at the man hint
|
---|
[2c094d6] | 51 | at <ulink url="&hints-root;man.txt"/>, which deals with formatting
|
---|
[d920fb0] | 52 | and compression issues for man pages.</para>
|
---|
[9a0cfdf] | 53 |
|
---|
[6370fa6] | 54 | </sect2>
|
---|
[d9ed058f] | 55 |
|
---|