man-inst.xml 2.1 KB

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