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