Changeset db35990d for pst/ps/a2ps.xml


Ignore:
Timestamp:
05/16/2005 11:37:10 AM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
89f473d
Parents:
7cac0e5
Message:

Tagged a2ps.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • pst/ps/a2ps.xml

    r7cac0e5 rdb35990d  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
    12<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
    23   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    … …  
    1314
    1415<sect1 id="a2ps" xreflabel="a2ps-&a2ps-version;">
    15 <sect1info>
    16 <othername>$LastChangedBy$</othername>
    17 <date>$Date$</date>
    18 </sect1info>
    19 <?dbhtml filename="a2ps.html"?>
    20 <title>a2ps-&a2ps-version;</title>
    21 
    22 <sect2>
    23 <title>Introduction to <application>a2ps</application></title>
    24 
    25 <para><application>a2ps</application> is a filter utilitized mainly in the
    26 background and primarily by printing scripts to convert almost
    27 every input format into PostScript output. The application's name expands
    28 appropriately to "all to PostScript".</para>
    29 
    30 <sect3><title>Package information</title>
    31 <itemizedlist spacing='compact'>
    32 <listitem><para>Download (HTTP): <ulink
    33 url="&a2ps-download-http;"/></para></listitem>
    34 <listitem><para>Download (FTP): <ulink
    35 url="&a2ps-download-ftp;"/></para></listitem>
    36 <listitem><para>Download MD5 sum: &a2ps-md5sum;</para></listitem>
    37 <listitem><para>Download size: &a2ps-size;</para></listitem>
    38 <listitem><para>Estimated disk space required:
    39 &a2ps-buildsize;</para></listitem>
    40 <listitem><para>Estimated build time:
    41 &a2ps-time;</para></listitem></itemizedlist>
    42 </sect3>
    43 
    44 <sect3><title>Additional downloads</title>
    45 <itemizedlist spacing='compact'>
    46 <listitem><para>International fonts: <ulink
    47 url="ftp://ftp.enst.fr/pub/unix/a2ps/i18n-fonts-0.1.tar.gz"/></para></listitem>
    48 </itemizedlist>
    49 </sect3>
    50 
    51 <sect3><title><application>a2ps</application> dependencies</title>
    52 <sect4><title>Optional</title>
    53 <para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
    54 <xref linkend="psutils"/>,
    55 <xref linkend="tex"/>,
    56 <xref linkend="gs"/> or <xref linkend="espgs"/>,
    57 <ulink
    58 url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>,
    59 <ulink url="http://www.adobe.com/products/acrobat/readstep2.html">Adobe
    60 Reader</ulink> and
    61 <ulink
    62 url="http://www.gnu.org/software/ghostview/ghostview.html">Ghostview</ulink>
    63 </para>
    64 </sect4>
    65 </sect3>
    66 
    67 </sect2>
    68 
    69 <sect2>
    70 <title>Installation of <application>a2ps</application></title>
    71 
    72 <para>Install <application>a2ps</application> by running the following
    73 commands:</para>
    74 
    75 <screen><userinput><command>sed -i -e "s|emacs||" contrib/Makefile.in &amp;&amp;
     16  <?dbhtml filename="a2ps.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>a2ps-&a2ps-version;</title>
     24
     25  <indexterm zone="a2ps">
     26    <primary sortas="a-a2ps">a2ps</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to a2ps</title>
     31
     32    <para><application>a2ps</application> is a filter utilitized mainly
     33    in the background and primarily by printing scripts to convert almost
     34    every input format into PostScript output. The application's name
     35    expands appropriately to "all to PostScript".</para>
     36
     37    <bridgehead renderas="sect3">Package Information</bridgehead>
     38    <itemizedlist spacing="compact">
     39      <listitem>
     40        <para>Download (HTTP): <ulink url="&a2ps-download-http;"/></para>
     41      </listitem>
     42      <listitem>
     43        <para>Download (FTP): <ulink url="&a2ps-download-ftp;"/></para>
     44      </listitem>
     45      <listitem>
     46        <para>Download MD5 sum: &a2ps-md5sum;</para>
     47      </listitem>
     48      <listitem>
     49        <para>Download size: &a2ps-size;</para>
     50      </listitem>
     51      <listitem>
     52        <para>Estimated disk space required: &a2ps-buildsize;</para>
     53      </listitem>
     54      <listitem>
     55        <para>Estimated build time: &a2ps-time;</para>
     56      </listitem>
     57    </itemizedlist>
     58
     59    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     60    <itemizedlist spacing='compact'>
     61      <listitem>
     62        <para>International fonts: <ulink
     63        url="ftp://ftp.enst.fr/pub/unix/a2ps/i18n-fonts-0.1.tar.gz"/></para>
     64      </listitem>
     65    </itemizedlist>
     66
     67    <bridgehead renderas="sect3">a2ps Dependencies</bridgehead>
     68
     69    <bridgehead renderas="sect4">Optional</bridgehead>
     70    <para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
     71    <xref linkend="psutils"/>,
     72    <xref linkend="tex"/>,
     73    <xref linkend="gs"/> or <xref linkend="espgs"/>,
     74    <ulink
     75    url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>,
     76    <ulink url="http://www.adobe.com/products/acrobat/readstep2.html">Adobe
     77    Reader</ulink> and
     78    <ulink
     79    url="http://www.gnu.org/software/ghostview/ghostview.html">Ghostview</ulink></para>
     80
     81  </sect2>
     82
     83  <sect2 role="installation">
     84    <title>Installation of a2ps</title>
     85
     86    <para>Install <application>a2ps</application> by running the following
     87    commands:</para>
     88
     89<screen><userinput>sed -i -e "s|emacs||" contrib/Makefile.in &amp;&amp;
    7690sed -i -e "s|/usr/local/share|/usr/share|" configure &amp;&amp;
    7791sed -i -e "s|char \*malloc ();|/* &amp; */|" \
    … …  
    8195    --enable-shared --with-medium=letter &amp;&amp;
    8296make &amp;&amp;
    83 make install</command></userinput></screen>
    84 
    85 </sect2>
    86 
    87 <sect2>
    88 <title>Command explanations</title>
    89 
    90 <para><command>sed -i -e "s|emacs||" contrib/Makefile.in</command>:
    91 This command eliminates the compiling and installing of the
    92 <application>Emacs</application> script files. If you have substituted
    93 <application>Emacs</application> for <application>Vi</application> as your
    94 primary editor, skip this step.</para>
    95 
    96 <para><command>sed -i -e "s|/usr/local/share|/usr/share|" configure</command>:
    97 This command modifies the configure script to search for
    98 <application>Ghostscript</application> fonts at the location where they were
    99 installed by the <acronym>BLFS</acronym> instructions.</para>
    100 
    101 <para><command>sed -i -e "s|char \*malloc ();|/* &amp; */|"
    102 lib/path-concat.c</command>: This command fixes a build problem with
    103 <application><acronym>GCC</acronym></application>-3.4.x</para>
    104 
    105 <para><parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data
    106 is installed in <filename class="directory">/etc/a2ps</filename> instead of
    107 <filename class="directory">/usr/etc</filename>.</para>
    108 
    109 <para><parameter>--enable-shared</parameter>: This switch enables building
    110 the dynamic <filename class='libraryfile'>liba2ps</filename> library.</para>
    111 
    112 <para><parameter>--with-medium=letter</parameter>: This switch changes
    113 the default paper format of A4 to letter. Installations that utilize A4
    114 would eliminate this switch.</para>
    115 
    116 </sect2>
    117 
    118 <sect2>
    119 <title>Configuring <application>a2ps</application></title>
    120 
    121 <sect3><title>Config files</title>
    122 
    123 <para><filename>/etc/a2ps/a2ps.cfg</filename>,
    124 <filename>/etc/a2ps/a2ps-site.cfg</filename></para>
    125 
    126 </sect3>
    127 
    128 <sect3><title>Configuration Information</title>
    129 
    130 <para>Information about configuring <application>a2ps</application> can be
    131 found in the comments contained in the above files, and also by
    132 running <command>info a2ps</command>.</para>
    133 </sect3>
    134 
    135 </sect2>
    136 
    137 <sect2>
    138 <title>Contents</title>
    139 
    140 <para>The <application>a2ps</application> package
    141 contains <command>a2ps</command>, <command>card</command>,
    142 <command>composeglyphs</command>, <command>fixnt</command>,
    143 <command>fixps</command>, <command>ogonkify</command>,
    144 <command>pdiff</command>, <command>psmandup</command>,
    145 <command>psset</command>, <command>texi2dvi4a2ps</command>,
    146 <filename class='libraryfile'>liba2ps</filename> libraries
    147 and filter data.</para>
    148 </sect2>
    149 
    150 <sect2><title>Description</title>
    151 
    152 <sect3><title>a2ps</title>
    153 <para><command>a2ps</command> is a filter, utilized primarily by
    154 printing scripts, that converts standard input or supported files
    155 to PostScript.</para></sect3>
    156 
    157 <sect3><title>card</title>
    158 <para><command>card</command> prints a reference card of a given program's
    159 options.</para></sect3>
    160 
    161 <sect3><title>composeglyphs</title>
    162 <para><command>composeglyphs</command> creates a composite font
    163 program.</para></sect3>
    164 
    165 <sect3><title>fixnt</title>
    166 <para><command>fixnt</command> is supposed to fix the problems in
    167 the PostScript files generated by the Microsoft PostScript driver under
    168 Windows NT (3.5 and 4.0).</para></sect3>
    169 
    170 <sect3><title>fixps</title>
    171 <para><command>fixps</command> tries to fix common PostScript problems that
    172 break postprocessing.</para></sect3>
    173 
    174 <sect3><title>ogonkify</title>
    175 <para><command>ogonkify</command> provides international support for
    176 Postscript by performing various munging of PostScript files
    177 related to printing in different languages.</para></sect3>
    178 
    179 <sect3><title>pdiff</title>
    180 <para><command>pdiff</command> produces a pretty comparison between
    181 files.</para></sect3>
    182 
    183 <sect3><title>psmandup</title>
    184 <para><command>psmandup</command> tries to produce a version of a given
    185 PostScript file to print in manual duplex.</para></sect3>
    186 
    187 <sect3><title>psset</title>
    188 <para><command>psset</command> produces a version of a given PostScript file
    189 with a protected call to the PostScript operator 'setpagedevice'. Typical use
    190 is making a file print duplex, or on the manual tray, etc.</para></sect3>
    191 
    192 <sect3><title>texi2dvi4a2ps</title>
    193 <para><command>texi2dvi4a2ps</command> compiles Texinfo and LaTeX files to
    194 <acronym>DVI</acronym> or <acronym>PDF</acronym></para></sect3>
    195 
    196 </sect2>
     97make install</userinput></screen>
     98
     99  </sect2>
     100
     101  <sect2 role="commands">
     102    <title>Command Explanations</title>
     103
     104    <para><command>sed -i -e "s|emacs||" contrib/Makefile.in</command>:
     105    This command eliminates the compiling and installing of the
     106    <application>Emacs</application> script files. If you have substituted
     107    <application>Emacs</application> for <application>Vi</application> as your
     108    primary editor, skip this step.</para>
     109
     110    <para><command>sed -i -e "s|/usr/local/share|/usr/share|" configure</command>:
     111    This command modifies the configure script to search for
     112    <application>Ghostscript</application> fonts at the location where they were
     113    installed by the BLFS instructions.</para>
     114
     115    <para><command>sed -i -e "s|char \*malloc ();|/* &amp; */|"
     116    lib/path-concat.c</command>: This command fixes a build problem with
     117    <application>GCC</application>-3.4.x</para>
     118
     119    <para><parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data
     120    is installed in <filename class="directory">/etc/a2ps</filename> instead of
     121    <filename class="directory">/usr/etc</filename>.</para>
     122
     123    <para><parameter>--enable-shared</parameter>: This switch enables building
     124    the dynamic <filename class='libraryfile'>liba2ps</filename> library.</para>
     125
     126    <para><parameter>--with-medium=letter</parameter>: This switch changes
     127    the default paper format of A4 to letter. Installations that utilize A4
     128    would eliminate this switch.</para>
     129
     130  </sect2>
     131
     132  <sect2 role="configuration">
     133    <title>Configuring a2ps</title>
     134
     135    <sect3 id="a2ps-config">
     136      <title>Config Files</title>
     137
     138      <para><filename>/etc/a2ps/a2ps.cfg</filename>,
     139      <filename>/etc/a2ps/a2ps-site.cfg</filename></para>
     140
     141      <indexterm zone="a2ps a2ps-config">
     142        <primary sortas="e-etc-a2ps-a2ps.cfg">/etc/a2ps/a2ps.cfg</primary>
     143      </indexterm>
     144
     145      <indexterm zone="a2ps a2ps-config">
     146        <primary sortas="e-etc-a2ps-a2ps-site.cfg">/etc/a2ps/a2ps-site.cfg</primary>
     147      </indexterm>
     148
     149    </sect3>
     150
     151    <sect3>
     152      <title>Configuration Information</title>
     153
     154      <para>Information about configuring <application>a2ps</application>
     155      can be found in the comments contained in the above files, and also
     156      by running <command>info a2ps</command>.</para>
     157
     158    </sect3>
     159
     160  </sect2>
     161
     162  <sect2 role="content">
     163    <title>Contents</title>
     164
     165    <segmentedlist>
     166      <segtitle>Installed Programs</segtitle>
     167      <segtitle>Installed Libraries</segtitle>
     168      <segtitle>Installed Directories</segtitle>
     169
     170      <seglistitem>
     171        <seg>a2ps, card, composeglyphs, fixnt, fixps, ogonkify,
     172        pdiff, psmandup, psset, and texi2dvi4a2ps</seg>
     173        <seg>liba2ps.[so,a] and filter data</seg>
     174        <seg>Not determined at this time</seg>
     175      </seglistitem>
     176    </segmentedlist>
     177
     178    <variablelist>
     179      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     180      <?dbfo list-presentation="list"?>
     181      <?dbhtml list-presentation="table"?>
     182
     183      <varlistentry id="a2ps-prog">
     184        <term><command>a2ps</command></term>
     185        <listitem>
     186          <para>is a filter, utilized primarily by printing scripts,
     187          that converts standard input or supported files to PostScript.</para>
     188          <indexterm zone="a2ps a2ps-prog">
     189            <primary sortas="b-a2ps">a2ps</primary>
     190          </indexterm>
     191        </listitem>
     192      </varlistentry>
     193
     194      <varlistentry id="card">
     195        <term><command>card</command></term>
     196        <listitem>
     197          <para>prints a reference card of a given program's options.</para>
     198          <indexterm zone="a2ps card">
     199            <primary sortas="b-card">card</primary>
     200          </indexterm>
     201        </listitem>
     202      </varlistentry>
     203
     204      <varlistentry id="composeglyphs">
     205        <term><command>composeglyphs</command></term>
     206        <listitem>
     207          <para>creates a composite font program.</para>
     208          <indexterm zone="a2ps composeglyphs">
     209            <primary sortas="b-composeglyphs">composeglyphs</primary>
     210          </indexterm>
     211        </listitem>
     212      </varlistentry>
     213
     214      <varlistentry id="fixnt">
     215        <term><command>fixnt</command></term>
     216        <listitem>
     217          <para>is supposed to fix the problems in the PostScript files
     218          generated by the Microsoft PostScript driver under Windows NT
     219          (3.5 and 4.0).</para>
     220          <indexterm zone="a2ps fixnt">
     221            <primary sortas="b-fixnt">fixnt</primary>
     222          </indexterm>
     223        </listitem>
     224      </varlistentry>
     225
     226      <varlistentry id="fixps">
     227        <term><command>fixps</command></term>
     228        <listitem>
     229          <para>tries to fix common PostScript problems that break
     230          postprocessing.</para>
     231          <indexterm zone="a2ps fixps">
     232            <primary sortas="b-fixps"></primary>
     233          </indexterm>
     234        </listitem>
     235      </varlistentry>
     236
     237      <varlistentry id="ogonkify">
     238        <term><command>ogonkify</command></term>
     239        <listitem>
     240          <para>provides international support for Postscript by performing
     241          various munging of PostScript files related to printing in different
     242          languages.</para>
     243          <indexterm zone="a2ps ogonkify">
     244            <primary sortas="b-ogonkify">ogonkify</primary>
     245          </indexterm>
     246        </listitem>
     247      </varlistentry>
     248
     249      <varlistentry id="pdiff">
     250        <term><command>pdiff</command></term>
     251        <listitem>
     252          <para>produces a pretty comparison between files.</para>
     253          <indexterm zone="a2ps pdiff">
     254            <primary sortas="b-pdiff">pdiff</primary>
     255          </indexterm>
     256        </listitem>
     257      </varlistentry>
     258
     259      <varlistentry id="psmandup">
     260        <term><command>psmandup</command></term>
     261        <listitem>
     262          <para>tries to produce a version of a given PostScript file to
     263          print in manual duplex.</para>
     264          <indexterm zone="a2ps psmandup">
     265            <primary sortas="b-psmandup">psmandup</primary>
     266          </indexterm>
     267        </listitem>
     268      </varlistentry>
     269
     270      <varlistentry id="psset">
     271        <term><command>psset</command></term>
     272        <listitem>
     273          <para>produces a version of a given PostScript file with a
     274          protected call to the PostScript operator 'setpagedevice'.
     275          Typical use is making a file print duplex, or on the manual
     276          tray, etc.</para>
     277          <indexterm zone="a2ps psset">
     278            <primary sortas="b-psset">psset</primary>
     279          </indexterm>
     280        </listitem>
     281      </varlistentry>
     282
     283      <varlistentry id="texi2dvi4a2ps">
     284        <term><command>texi2dvi4a2ps</command></term>
     285        <listitem>
     286          <para>compiles Texinfo and LaTeX files to DVI or PDF</para>
     287          <indexterm zone="a2ps texi2dvi4a2ps">
     288            <primary sortas="b-texi2dvi4a2ps">texi2dvi4a2ps</primary>
     289          </indexterm>
     290        </listitem>
     291      </varlistentry>
     292
     293    </variablelist>
     294
     295  </sect2>
    197296
    198297</sect1>
Note: See TracChangeset for help on using the changeset viewer.