stylesheets/evergreen_docbook_files/docbook-xsl-1.75.2/params/man.output.better.ps.enabled.xml

   1 <refentry xmlns="http://docbook.org/ns/docbook"\r
   2           xmlns:xlink="http://www.w3.org/1999/xlink"\r
   3           xmlns:xi="http://www.w3.org/2001/XInclude"\r
   4           xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"\r
   5           xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
   6           version="5.0" xml:id="man.output.better.ps.enabled">\r
   7 <refmeta>\r
   8 <refentrytitle>man.output.better.ps.enabled</refentrytitle>\r
   9 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
  10 </refmeta>\r
  11 <refnamediv>\r
  12 <refname>man.output.better.ps.enabled</refname>\r
  13 <refpurpose>Enable enhanced print/PostScript output?</refpurpose>\r
  14 </refnamediv>\r
  15 <refsynopsisdiv>\r
  16 <src:fragment xml:id="man.output.better.ps.enabled.frag">\r
  17 <xsl:param name="man.output.better.ps.enabled">0</xsl:param>\r
  18 </src:fragment>\r
  19 </refsynopsisdiv>\r
  20 <refsection><info><title>Description</title></info>\r
  21 \r
  22 <para>If the value of the\r
  23 <parameter>man.output.better.ps.enabled</parameter> parameter is\r
  24 non-zero, certain markup is embedded in each generated man page\r
  25 such that PostScript output from the <command>man -Tps</command>\r
  26 command for that page will include a number of enhancements\r
  27 designed to improve the quality of that output.</para>\r
  28 \r
  29 <para>If <parameter>man.output.better.ps.enabled</parameter> is\r
  30 zero (the default), no such markup is embedded in generated man\r
  31 pages, and no enhancements are included in the PostScript\r
  32 output generated from those man pages by the <command>man\r
  33  -Tps</command> command.</para>\r
  34 \r
  35 <warning>\r
  36   <para>The enhancements provided by this parameter rely on\r
  37     features that are specific to groff (GNU troff) and that are\r
  38     not part of “classic” AT&amp;T troff or any of its\r
  39     derivatives. Therefore, any man pages you generate with this\r
  40     parameter enabled will be readable only on systems on which\r
  41     the groff (GNU troff) program is installed, such as GNU/Linux\r
  42     systems. The pages <emphasis role="bold">will not not be\r
  43       readable on systems on with the classic troff (AT&amp;T\r
  44       troff) command is installed</emphasis>.</para>\r
  45 </warning>\r
  46 \r
  47 <para>The value of this parameter only affects PostScript output\r
  48   generated from the <command>man</command> command. It has no\r
  49   effect on output generated using the FO backend.</para>\r
  50 \r
  51 <tip>\r
  52   <para>You can generate PostScript output for any man page by\r
  53     running the following command:</para>\r
  54   <programlisting>  man <replaceable>FOO</replaceable> -Tps > <replaceable>FOO</replaceable>.ps</programlisting>\r
  55   <para>You can then generate PDF output by running the following\r
  56     command:</para>\r
  57   <programlisting>  ps2pdf <replaceable>FOO</replaceable>.ps</programlisting>\r
  58 </tip>\r
  59 \r
  60 </refsection>\r
  61 </refentry>\r