man-inst.xml 2.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162
  1. <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
  2. <sect2>
  3. <title>Installation of Man</title>
  4. <para>We'll make three adjustments to the sources of Man.</para>
  5. <para>The first patch comments out the "MANPATH /usr/man" line in the
  6. <filename>man.conf</filename> file to prevent redundant results when using
  7. programs such as <userinput>whatis</userinput>:</para>
  8. <screen><userinput>patch -Np1 -i ../&man-manpath-patch;</userinput></screen>
  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. <screen><userinput>patch -Np1 -i ../&man-pager-patch;</userinput></screen>
  13. <para>The third and last patch prevents a problem when man pages not formatted
  14. with more than 80 columns are used in conjunction with recent releases of
  15. <userinput>groff</userinput>:</para>
  16. <screen><userinput>patch -Np1 -i ../&man-80cols-patch;</userinput></screen>
  17. <para>Now prepare Man for compilation:</para>
  18. <screen><userinput>./configure -default -confdir=/etc</userinput></screen>
  19. <para>The meaning of the configure options:</para>
  20. <itemizedlist>
  21. <listitem><para><userinput>-default</userinput>: This tells the configure script
  22. to select a sensible set of default options. For example: only English man
  23. pages, no message catalogs, man not suid, handle compressed man pages, compress
  24. cat pages, create cat pages whenever the appropriate directory exists, follow
  25. FHS by putting cat pages under /var/cache/man provided that that directory
  26. exists.</para></listitem>
  27. <listitem><para><userinput>-confdir=/etc</userinput>: This tells the
  28. <userinput>man</userinput> program to look for the <filename>man.conf</filename>
  29. configuration file in the <filename>/etc</filename> directory.</para></listitem>
  30. </itemizedlist>
  31. <para>Compile the package:</para>
  32. <screen><userinput>make</userinput></screen>
  33. <para>And install it:</para>
  34. <screen><userinput>make install</userinput></screen>
  35. <note><para>If you wish to disable SGR escape sequences, you should
  36. edit the man.conf file and add the <userinput>-c</userinput> argument
  37. to nroff.</para></note>
  38. <para>You may want to also take a look at the BLFS page at
  39. <ulink url="&blfs-root;view/cvs/postlfs/compressdoc.html"/> which deals with
  40. formatting and compression issues for man pages.</para>
  41. </sect2>