Tagged a2ps.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4291 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Manuel Canales Esparcia 2005-05-16 11:37:10 +00:00
parent 7cac0e562d
commit db35990dc2

View File

@ -1,3 +1,4 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent"> <!ENTITY % general-entities SYSTEM "../../general.ent">
@ -12,67 +13,80 @@
]> ]>
<sect1 id="a2ps" xreflabel="a2ps-&a2ps-version;"> <sect1 id="a2ps" xreflabel="a2ps-&a2ps-version;">
<sect1info> <?dbhtml filename="a2ps.html"?>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="a2ps.html"?>
<title>a2ps-&a2ps-version;</title>
<sect2> <sect1info>
<title>Introduction to <application>a2ps</application></title> <othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<para><application>a2ps</application> is a filter utilitized mainly in the <title>a2ps-&a2ps-version;</title>
background and primarily by printing scripts to convert almost
every input format into PostScript output. The application's name expands
appropriately to "all to PostScript".</para>
<sect3><title>Package information</title> <indexterm zone="a2ps">
<itemizedlist spacing='compact'> <primary sortas="a-a2ps">a2ps</primary>
<listitem><para>Download (HTTP): <ulink </indexterm>
url="&a2ps-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&a2ps-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &a2ps-md5sum;</para></listitem>
<listitem><para>Download size: &a2ps-size;</para></listitem>
<listitem><para>Estimated disk space required:
&a2ps-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&a2ps-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Additional downloads</title> <sect2 role="package">
<itemizedlist spacing='compact'> <title>Introduction to a2ps</title>
<listitem><para>International fonts: <ulink
url="ftp://ftp.enst.fr/pub/unix/a2ps/i18n-fonts-0.1.tar.gz"/></para></listitem>
</itemizedlist>
</sect3>
<sect3><title><application>a2ps</application> dependencies</title> <para><application>a2ps</application> is a filter utilitized mainly
<sect4><title>Optional</title> in the background and primarily by printing scripts to convert almost
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), every input format into PostScript output. The application's name
<xref linkend="psutils"/>, expands appropriately to "all to PostScript".</para>
<xref linkend="tex"/>,
<xref linkend="gs"/> or <xref linkend="espgs"/>,
<ulink
url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>,
<ulink url="http://www.adobe.com/products/acrobat/readstep2.html">Adobe
Reader</ulink> and
<ulink
url="http://www.gnu.org/software/ghostview/ghostview.html">Ghostview</ulink>
</para>
</sect4>
</sect3>
</sect2> <bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&a2ps-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&a2ps-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &a2ps-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &a2ps-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &a2ps-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &a2ps-time;</para>
</listitem>
</itemizedlist>
<sect2> <bridgehead renderas="sect3">Additional Downloads</bridgehead>
<title>Installation of <application>a2ps</application></title> <itemizedlist spacing='compact'>
<listitem>
<para>International fonts: <ulink
url="ftp://ftp.enst.fr/pub/unix/a2ps/i18n-fonts-0.1.tar.gz"/></para>
</listitem>
</itemizedlist>
<para>Install <application>a2ps</application> by running the following <bridgehead renderas="sect3">a2ps Dependencies</bridgehead>
commands:</para>
<screen><userinput><command>sed -i -e "s|emacs||" contrib/Makefile.in &amp;&amp; <bridgehead renderas="sect4">Optional</bridgehead>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="psutils"/>,
<xref linkend="tex"/>,
<xref linkend="gs"/> or <xref linkend="espgs"/>,
<ulink
url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>,
<ulink url="http://www.adobe.com/products/acrobat/readstep2.html">Adobe
Reader</ulink> and
<ulink
url="http://www.gnu.org/software/ghostview/ghostview.html">Ghostview</ulink></para>
</sect2>
<sect2 role="installation">
<title>Installation of a2ps</title>
<para>Install <application>a2ps</application> by running the following
commands:</para>
<screen><userinput>sed -i -e "s|emacs||" contrib/Makefile.in &amp;&amp;
sed -i -e "s|/usr/local/share|/usr/share|" configure &amp;&amp; sed -i -e "s|/usr/local/share|/usr/share|" configure &amp;&amp;
sed -i -e "s|char \*malloc ();|/* &amp; */|" \ sed -i -e "s|char \*malloc ();|/* &amp; */|" \
lib/path-concat.c &amp;&amp; lib/path-concat.c &amp;&amp;
@ -80,119 +94,204 @@ sed -i -e "s|char \*malloc ();|/* &amp; */|" \
--sysconfdir=/etc/a2ps --localstatedir=/var \ --sysconfdir=/etc/a2ps --localstatedir=/var \
--enable-shared --with-medium=letter &amp;&amp; --enable-shared --with-medium=letter &amp;&amp;
make &amp;&amp; make &amp;&amp;
make install</command></userinput></screen> make install</userinput></screen>
</sect2> </sect2>
<sect2> <sect2 role="commands">
<title>Command explanations</title> <title>Command Explanations</title>
<para><command>sed -i -e "s|emacs||" contrib/Makefile.in</command>: <para><command>sed -i -e "s|emacs||" contrib/Makefile.in</command>:
This command eliminates the compiling and installing of the This command eliminates the compiling and installing of the
<application>Emacs</application> script files. If you have substituted <application>Emacs</application> script files. If you have substituted
<application>Emacs</application> for <application>Vi</application> as your <application>Emacs</application> for <application>Vi</application> as your
primary editor, skip this step.</para> primary editor, skip this step.</para>
<para><command>sed -i -e "s|/usr/local/share|/usr/share|" configure</command>: <para><command>sed -i -e "s|/usr/local/share|/usr/share|" configure</command>:
This command modifies the configure script to search for This command modifies the configure script to search for
<application>Ghostscript</application> fonts at the location where they were <application>Ghostscript</application> fonts at the location where they were
installed by the <acronym>BLFS</acronym> instructions.</para> installed by the BLFS instructions.</para>
<para><command>sed -i -e "s|char \*malloc ();|/* &amp; */|" <para><command>sed -i -e "s|char \*malloc ();|/* &amp; */|"
lib/path-concat.c</command>: This command fixes a build problem with lib/path-concat.c</command>: This command fixes a build problem with
<application><acronym>GCC</acronym></application>-3.4.x</para> <application>GCC</application>-3.4.x</para>
<para><parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data <para><parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data
is installed in <filename class="directory">/etc/a2ps</filename> instead of is installed in <filename class="directory">/etc/a2ps</filename> instead of
<filename class="directory">/usr/etc</filename>.</para> <filename class="directory">/usr/etc</filename>.</para>
<para><parameter>--enable-shared</parameter>: This switch enables building <para><parameter>--enable-shared</parameter>: This switch enables building
the dynamic <filename class='libraryfile'>liba2ps</filename> library.</para> the dynamic <filename class='libraryfile'>liba2ps</filename> library.</para>
<para><parameter>--with-medium=letter</parameter>: This switch changes <para><parameter>--with-medium=letter</parameter>: This switch changes
the default paper format of A4 to letter. Installations that utilize A4 the default paper format of A4 to letter. Installations that utilize A4
would eliminate this switch.</para> would eliminate this switch.</para>
</sect2> </sect2>
<sect2> <sect2 role="configuration">
<title>Configuring <application>a2ps</application></title> <title>Configuring a2ps</title>
<sect3><title>Config files</title> <sect3 id="a2ps-config">
<title>Config Files</title>
<para><filename>/etc/a2ps/a2ps.cfg</filename>, <para><filename>/etc/a2ps/a2ps.cfg</filename>,
<filename>/etc/a2ps/a2ps-site.cfg</filename></para> <filename>/etc/a2ps/a2ps-site.cfg</filename></para>
</sect3> <indexterm zone="a2ps a2ps-config">
<primary sortas="e-etc-a2ps-a2ps.cfg">/etc/a2ps/a2ps.cfg</primary>
</indexterm>
<sect3><title>Configuration Information</title> <indexterm zone="a2ps a2ps-config">
<primary sortas="e-etc-a2ps-a2ps-site.cfg">/etc/a2ps/a2ps-site.cfg</primary>
</indexterm>
<para>Information about configuring <application>a2ps</application> can be </sect3>
found in the comments contained in the above files, and also by
running <command>info a2ps</command>.</para>
</sect3>
</sect2> <sect3>
<title>Configuration Information</title>
<sect2> <para>Information about configuring <application>a2ps</application>
<title>Contents</title> can be found in the comments contained in the above files, and also
by running <command>info a2ps</command>.</para>
<para>The <application>a2ps</application> package </sect3>
contains <command>a2ps</command>, <command>card</command>,
<command>composeglyphs</command>, <command>fixnt</command>,
<command>fixps</command>, <command>ogonkify</command>,
<command>pdiff</command>, <command>psmandup</command>,
<command>psset</command>, <command>texi2dvi4a2ps</command>,
<filename class='libraryfile'>liba2ps</filename> libraries
and filter data.</para>
</sect2>
<sect2><title>Description</title> </sect2>
<sect3><title>a2ps</title> <sect2 role="content">
<para><command>a2ps</command> is a filter, utilized primarily by <title>Contents</title>
printing scripts, that converts standard input or supported files
to PostScript.</para></sect3>
<sect3><title>card</title> <segmentedlist>
<para><command>card</command> prints a reference card of a given program's <segtitle>Installed Programs</segtitle>
options.</para></sect3> <segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<sect3><title>composeglyphs</title> <seglistitem>
<para><command>composeglyphs</command> creates a composite font <seg>a2ps, card, composeglyphs, fixnt, fixps, ogonkify,
program.</para></sect3> pdiff, psmandup, psset, and texi2dvi4a2ps</seg>
<seg>liba2ps.[so,a] and filter data</seg>
<seg>Not determined at this time</seg>
</seglistitem>
</segmentedlist>
<sect3><title>fixnt</title> <variablelist>
<para><command>fixnt</command> is supposed to fix the problems in <bridgehead renderas="sect3">Short Descriptions</bridgehead>
the PostScript files generated by the Microsoft PostScript driver under <?dbfo list-presentation="list"?>
Windows NT (3.5 and 4.0).</para></sect3> <?dbhtml list-presentation="table"?>
<sect3><title>fixps</title> <varlistentry id="a2ps-prog">
<para><command>fixps</command> tries to fix common PostScript problems that <term><command>a2ps</command></term>
break postprocessing.</para></sect3> <listitem>
<para>is a filter, utilized primarily by printing scripts,
that converts standard input or supported files to PostScript.</para>
<indexterm zone="a2ps a2ps-prog">
<primary sortas="b-a2ps">a2ps</primary>
</indexterm>
</listitem>
</varlistentry>
<sect3><title>ogonkify</title> <varlistentry id="card">
<para><command>ogonkify</command> provides international support for <term><command>card</command></term>
Postscript by performing various munging of PostScript files <listitem>
related to printing in different languages.</para></sect3> <para>prints a reference card of a given program's options.</para>
<indexterm zone="a2ps card">
<primary sortas="b-card">card</primary>
</indexterm>
</listitem>
</varlistentry>
<sect3><title>pdiff</title> <varlistentry id="composeglyphs">
<para><command>pdiff</command> produces a pretty comparison between <term><command>composeglyphs</command></term>
files.</para></sect3> <listitem>
<para>creates a composite font program.</para>
<indexterm zone="a2ps composeglyphs">
<primary sortas="b-composeglyphs">composeglyphs</primary>
</indexterm>
</listitem>
</varlistentry>
<sect3><title>psmandup</title> <varlistentry id="fixnt">
<para><command>psmandup</command> tries to produce a version of a given <term><command>fixnt</command></term>
PostScript file to print in manual duplex.</para></sect3> <listitem>
<para>is supposed to fix the problems in the PostScript files
generated by the Microsoft PostScript driver under Windows NT
(3.5 and 4.0).</para>
<indexterm zone="a2ps fixnt">
<primary sortas="b-fixnt">fixnt</primary>
</indexterm>
</listitem>
</varlistentry>
<sect3><title>psset</title> <varlistentry id="fixps">
<para><command>psset</command> produces a version of a given PostScript file <term><command>fixps</command></term>
with a protected call to the PostScript operator 'setpagedevice'. Typical use <listitem>
is making a file print duplex, or on the manual tray, etc.</para></sect3> <para>tries to fix common PostScript problems that break
postprocessing.</para>
<indexterm zone="a2ps fixps">
<primary sortas="b-fixps"></primary>
</indexterm>
</listitem>
</varlistentry>
<sect3><title>texi2dvi4a2ps</title> <varlistentry id="ogonkify">
<para><command>texi2dvi4a2ps</command> compiles Texinfo and LaTeX files to <term><command>ogonkify</command></term>
<acronym>DVI</acronym> or <acronym>PDF</acronym></para></sect3> <listitem>
<para>provides international support for Postscript by performing
various munging of PostScript files related to printing in different
languages.</para>
<indexterm zone="a2ps ogonkify">
<primary sortas="b-ogonkify">ogonkify</primary>
</indexterm>
</listitem>
</varlistentry>
</sect2> <varlistentry id="pdiff">
<term><command>pdiff</command></term>
<listitem>
<para>produces a pretty comparison between files.</para>
<indexterm zone="a2ps pdiff">
<primary sortas="b-pdiff">pdiff</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="psmandup">
<term><command>psmandup</command></term>
<listitem>
<para>tries to produce a version of a given PostScript file to
print in manual duplex.</para>
<indexterm zone="a2ps psmandup">
<primary sortas="b-psmandup">psmandup</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="psset">
<term><command>psset</command></term>
<listitem>
<para>produces a version of a given PostScript file with a
protected call to the PostScript operator 'setpagedevice'.
Typical use is making a file print duplex, or on the manual
tray, etc.</para>
<indexterm zone="a2ps psset">
<primary sortas="b-psset">psset</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="texi2dvi4a2ps">
<term><command>texi2dvi4a2ps</command></term>
<listitem>
<para>compiles Texinfo and LaTeX files to DVI or PDF</para>
<indexterm zone="a2ps texi2dvi4a2ps">
<primary sortas="b-texi2dvi4a2ps">texi2dvi4a2ps</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1> </sect1>