Changeset fa3edfef for pst/ps/a2ps.xml


Ignore:
Timestamp:
03/25/2020 12:06:24 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
81a73ed8
Parents:
47274444
Message:

Format pst

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22885 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • pst/ps/a2ps.xml

    r47274444 rfa3edfef  
    3232    <title>Introduction to a2ps</title>
    3333
    34     <para><application>a2ps</application> is a filter utilized mainly
    35     in the background and primarily by printing scripts to convert almost
    36     every input format into PostScript output. The application's name
    37     expands appropriately to <quote>all to PostScript</quote>.</para>
     34    <para>
     35      <application>a2ps</application> is a filter utilized mainly
     36      in the background and primarily by printing scripts to convert almost
     37      every input format into PostScript output. The application's name
     38      expands appropriately to <quote>all to PostScript</quote>.
     39    </para>
    3840
    3941    &lfs91_checked;
    4042
    4143    <caution>
    42       <para><application>a2ps</application> cannot convert UTF-8 encoded
    43       text to PostScript. The issue is discussed in detail in the
    44       <xref linkend="locale-not-valid-option"/> section of the
    45       <xref linkend="locale-issues"/> page.
    46       The solution is to use <xref linkend="paps"/> instead of
    47       <application>a2ps</application> for converting
    48       UTF-8 encoded text to PostScript.</para>
     44      <para>
     45        <application>a2ps</application> cannot convert UTF-8 encoded
     46        text to PostScript. The issue is discussed in detail in the
     47        <xref linkend="locale-not-valid-option"/> section of the
     48        <xref linkend="locale-issues"/> page.
     49        The solution is to use <xref linkend="paps"/> instead of
     50        <application>a2ps</application> for converting
     51        UTF-8 encoded text to PostScript.
     52      </para>
    4953    </caution>
    5054
    … …  
    5256    <itemizedlist spacing="compact">
    5357      <listitem>
    54         <para>Download (HTTP): <ulink url="&a2ps-download-http;"/></para>
    55       </listitem>
    56       <listitem>
    57         <para>Download (FTP): <ulink url="&a2ps-download-ftp;"/></para>
    58       </listitem>
    59       <listitem>
    60         <para>Download MD5 sum: &a2ps-md5sum;</para>
    61       </listitem>
    62       <listitem>
    63         <para>Download size: &a2ps-size;</para>
    64       </listitem>
    65       <listitem>
    66         <para>Estimated disk space required: &a2ps-buildsize;</para>
    67       </listitem>
    68       <listitem>
    69         <para>Estimated build time: &a2ps-time;</para>
     58        <para>
     59          Download (HTTP): <ulink url="&a2ps-download-http;"/>
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Download (FTP): <ulink url="&a2ps-download-ftp;"/>
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Download MD5 sum: &a2ps-md5sum;
     70        </para>
     71      </listitem>
     72      <listitem>
     73        <para>
     74          Download size: &a2ps-size;
     75        </para>
     76      </listitem>
     77      <listitem>
     78        <para>
     79          Estimated disk space required: &a2ps-buildsize;
     80        </para>
     81      </listitem>
     82      <listitem>
     83        <para>
     84          Estimated build time: &a2ps-time;
     85        </para>
    7086      </listitem>
    7187    </itemizedlist>
    … …  
    7490    <itemizedlist spacing='compact'>
    7591      <listitem>
    76         <para>International fonts: <ulink
    77         url="&sources-anduin-http;/i18n-fonts/i18n-fonts-&i18n-fonts-version;.tar.bz2"/></para>
     92        <para>
     93          International fonts: <ulink url=
     94            "&sources-anduin-http;/i18n-fonts/i18n-fonts-&i18n-fonts-version;.tar.bz2"/>
     95        </para>
    7896      </listitem>
    7997    </itemizedlist>
    … …  
    108126    <title>Installation of a2ps</title>
    109127
    110     <para>Install <application>a2ps</application> by running the following
    111     commands:</para>
     128    <para>
     129      Install <application>a2ps</application> by running the following
     130      commands:
     131    </para>
    112132
    113133<screen><userinput>autoconf &amp;&amp;
    … …  
    122142touch doc/*.info</userinput></screen>
    123143
    124     <para>To test the results, issue: <command>make check</command>.
    125     The <filename>printers.tst</filename> test will fail, as there is no default
    126     test printer.  The <filename>styles.tst</filename> may also fail, as the
    127     tests report some inconsistencies between the generated postscript and the
    128     reference sets.  This is caused by version number differences between the
    129     postscript test files and those generated by the tests &mdash; these do not
    130     affect the operation of the program and can be ignored.</para>
    131 
    132     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     144    <para>
     145      To test the results, issue: <command>make check</command>.
     146      The <filename>printers.tst</filename> test will fail, as there is no
     147      default test printer.  The <filename>styles.tst</filename> may also
     148      fail, as the tests report some inconsistencies between the generated
     149      postscript and the reference sets.  This is caused by version number
     150      differences between the postscript test files and those generated by
     151      the tests &mdash; these do not affect the operation of the program
     152      and can be ignored.
     153    </para>
     154
     155    <para>
     156      Now, as the <systemitem class="username">root</systemitem> user:
     157    </para>
    133158
    134159<screen role="root"><userinput>make install</userinput></screen>
    135160
    136     <para>If desired, install the downloaded i18n-fonts by running the following
    137     commands as the <systemitem class="username">root</systemitem> user:</para>
     161    <para>
     162      If desired, install the downloaded i18n-fonts by running the following
     163      commands as the <systemitem class="username">root</systemitem> user:
     164    </para>
    138165
    139166<screen role="root"><userinput>tar -xf ../i18n-fonts-&i18n-fonts-version;.tar.bz2 &amp;&amp;
    … …  
    150177    <title>Command Explanations</title>
    151178
    152     <para><command>autoconf</command>: This command is used to recreate the
    153     <command>configure</command> script. This is required because there is
    154     an issue in the mktime test which causes the
    155     <command>configure</command> script to hang for 60 seconds and then report
    156     that there is no working mktime function.</para>
    157 
    158     <para><command>sed -i "s/GPERF --version |/&amp; head -n 1 |/" configure</command>:
    159     This fixes a bug in the handling of the version output of
    160     <command>gperf</command>.</para>
    161 
    162     <para><command>sed -i "s|/usr/local/share|/usr/share|" configure</command>:
    163     This command modifies the <command>configure</command> script to search for
    164     <application>Ghostscript</application> fonts at the location where they were
    165     installed by the BLFS instructions.</para>
    166 
    167     <para><parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data
    168     is installed in <filename class="directory">/etc/a2ps</filename> instead of
    169     <filename class="directory">/usr/etc</filename>.</para>
    170 
    171     <para><parameter>--enable-shared</parameter>: This switch enables building
    172     the dynamic <filename class='libraryfile'>liba2ps</filename> library.</para>
    173 
    174     <para><parameter>--with-medium=letter</parameter>: This switch changes the
    175     default paper format to US letter. It can either be given here or set
    176     in <filename>/etc/a2ps/a2ps-site.cfg</filename> after installation. The
    177     default is A4, but there are several other options, in particular: A4dj or
    178     letterdj are good settings for HP Deskjet and other printers that need
    179     wider paper-handling margins. See <filename>/etc/a2ps/a2ps.cfg</filename>
    180     after installation.</para>
    181 
    182     <para><command>touch doc/*.info</command>: This command avoids trying to
    183     regenerate the info files. This is an older package and the current
    184     .texi files will produce errors preventing <command>make install</command>
    185     from working properly.</para>
     179    <para>
     180      <command>autoconf</command>: This command is used to recreate the
     181      <command>configure</command> script. This is required because there is
     182      an issue in the mktime test which causes the
     183      <command>configure</command> script to hang for 60 seconds and then
     184      report that there is no working mktime function.
     185    </para>
     186
     187    <para>
     188      <command>sed -i "s/GPERF --version |/&amp; head -n 1 |/" configure</command>:
     189      This fixes a bug in the handling of the version output of
     190      <command>gperf</command>.
     191    </para>
     192
     193    <para>
     194      <command>sed -i "s|/usr/local/share|/usr/share|" configure</command>:
     195      This command modifies the <command>configure</command> script to search
     196      for <application>Ghostscript</application> fonts at the location where
     197      they were installed by the BLFS instructions.
     198    </para>
     199
     200    <para>
     201      <parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data is
     202      installed in <filename class="directory">/etc/a2ps</filename> instead of
     203      <filename class="directory">/usr/etc</filename>.
     204    </para>
     205
     206    <para>
     207      <parameter>--enable-shared</parameter>: This switch enables building
     208      the dynamic <filename class='libraryfile'>liba2ps</filename> library.
     209    </para>
     210
     211    <para>
     212      <parameter>--with-medium=letter</parameter>: This switch changes the
     213      default paper format to US letter. It can either be given here or set
     214      in <filename>/etc/a2ps/a2ps-site.cfg</filename> after installation. The
     215      default is A4, but there are several other options, in particular: A4dj
     216      or letterdj are good settings for HP Deskjet and other printers that need
     217      wider paper-handling margins. See <filename>/etc/a2ps/a2ps.cfg</filename>
     218      after installation.
     219    </para>
     220
     221    <para>
     222      <command>touch doc/*.info</command>: This command avoids trying to
     223      regenerate the info files. This is an older package and the current
     224      <filename class="extension">.texi</filename> files will produce errors
     225      preventing <command>make install</command> from working properly.
     226    </para>
    186227
    187228  </sect2>
    … …  
    193234      <title>Config Files</title>
    194235
    195       <para><filename>/etc/a2ps/a2ps.cfg</filename>,
    196       <filename>/etc/a2ps/a2ps-site.cfg</filename></para>
     236      <para>
     237        <filename>/etc/a2ps/a2ps.cfg</filename> and
     238        <filename>/etc/a2ps/a2ps-site.cfg</filename>
     239      </para>
    197240
    198241      <indexterm zone="a2ps a2ps-config">
    … …  
    209252      <title>Configuration Information</title>
    210253
    211       <para>Information about configuring <application>a2ps</application>
    212       can be found in the comments contained in the above files, and also
    213       by running <command>info a2ps</command>.</para>
     254      <para>
     255        Information about configuring <application>a2ps</application>
     256        can be found in the comments contained in the above files, and also
     257        by running <command>info a2ps</command>.
     258      </para>
    214259
    215260    </sect3>
    … …  
    241286        <term><command>a2ps</command></term>
    242287        <listitem>
    243           <para>is a filter, utilized primarily by printing scripts,
    244           that converts standard input or supported files to PostScript.</para>
     288          <para>
     289            is a filter, utilized primarily by printing scripts,
     290            that converts standard input or supported files to PostScript.
     291          </para>
    245292          <indexterm zone="a2ps a2ps-prog">
    246293            <primary sortas="b-a2ps">a2ps</primary>
    … …  
    252299        <term><command>card</command></term>
    253300        <listitem>
    254           <para>prints a reference card of a given program's options.</para>
     301          <para>
     302            prints a reference card of a given program's options.
     303          </para>
    255304          <indexterm zone="a2ps card">
    256305            <primary sortas="b-card">card</primary>
    … …  
    262311        <term><command>composeglyphs</command></term>
    263312        <listitem>
    264           <para>creates a composite font program.</para>
     313          <para>
     314            creates a composite font program.
     315          </para>
    265316          <indexterm zone="a2ps composeglyphs">
    266317            <primary sortas="b-composeglyphs">composeglyphs</primary>
    … …  
    272323        <term><command>fixnt</command></term>
    273324        <listitem>
    274           <para>is supposed to fix the problems in the PostScript files
    275           generated by the Microsoft PostScript driver under Windows NT
    276           (3.5 and 4.0).</para>
     325          <para>
     326            is supposed to fix the problems in the PostScript files
     327            generated by the Microsoft PostScript driver under Windows NT
     328            (3.5 and 4.0).
     329          </para>
    277330          <indexterm zone="a2ps fixnt">
    278331            <primary sortas="b-fixnt">fixnt</primary>
    … …  
    284337        <term><command>fixps</command></term>
    285338        <listitem>
    286           <para>tries to fix common PostScript problems that break
    287           postprocessing.</para>
     339          <para>
     340            tries to fix common PostScript problems that break
     341            postprocessing.
     342          </para>
    288343          <indexterm zone="a2ps fixps">
    289344            <primary sortas="b-fixps">fixps</primary>
    … …  
    295350        <term><command>ogonkify</command></term>
    296351        <listitem>
    297           <para>provides international support for Postscript by performing
    298           various munging of PostScript files related to printing in different
    299           languages.</para>
     352          <para>
     353            provides international support for Postscript by performing various
     354            munging of PostScript files related to printing in different
     355            languages.
     356          </para>
    300357          <indexterm zone="a2ps ogonkify">
    301358            <primary sortas="b-ogonkify">ogonkify</primary>
    … …  
    307364        <term><command>pdiff</command></term>
    308365        <listitem>
    309           <para>produces a pretty comparison between files.</para>
     366          <para>
     367            produces a pretty comparison between files.
     368          </para>
    310369          <indexterm zone="a2ps pdiff">
    311370            <primary sortas="b-pdiff">pdiff</primary>
    … …  
    317376        <term><command>psmandup</command></term>
    318377        <listitem>
    319           <para>tries to produce a version of a given PostScript file to
    320           print in manual duplex.</para>
     378          <para>
     379            tries to produce a version of a given PostScript file to
     380            print in manual duplex.
     381          </para>
    321382          <indexterm zone="a2ps psmandup">
    322383            <primary sortas="b-psmandup">psmandup</primary>
    … …  
    328389        <term><command>psset</command></term>
    329390        <listitem>
    330           <para>produces a version of a given PostScript file with a
    331           protected call to the PostScript operator 'setpagedevice'.
    332           Typical use is making a file print duplex, or on the manual
    333           tray, etc.</para>
     391          <para>
     392            produces a version of a given PostScript file with a
     393            protected call to the PostScript operator 'setpagedevice'.
     394            Typical use is making a file print duplex, or on the manual
     395            tray, etc.
     396          </para>
    334397          <indexterm zone="a2ps psset">
    335398            <primary sortas="b-psset">psset</primary>
    … …  
    341404        <term><command>texi2dvi4a2ps</command></term>
    342405        <listitem>
    343           <para>compiles Texinfo and LaTeX files to DVI or PDF</para>
     406          <para>
     407            compiles Texinfo and LaTeX files to DVI or PDF.
     408          </para>
    344409          <indexterm zone="a2ps texi2dvi4a2ps">
    345410            <primary sortas="b-texi2dvi4a2ps">texi2dvi4a2ps</primary>
Note: See TracChangeset for help on using the changeset viewer.