glfs/pst/printing/gutenprint.xml
Randy McMurchy 61d6f59edd Replaced the obsolete Gimp-Print package with Gutenprint-5.0.1
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7038 af4574ff-66df-0310-9fd7-8a98e5e911e0
2007-08-09 11:36:59 +00:00

220 lines
8.0 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gutenprint-download-http "http://downloads.sourceforge.net/gimp-print/gutenprint-&gutenprint-version;.tar.bz2">
<!ENTITY gutenprint-download-ftp " ">
<!ENTITY gutenprint-md5sum "4ec66d57c1014b503d6bea16b1c31d81">
<!ENTITY gutenprint-size "4.8 MB">
<!ENTITY gutenprint-buildsize "49 MB">
<!ENTITY gutenprint-time "0.9 SBU">
]>
<sect1 id="gutenprint" xreflabel="Gutenprint-&gutenprint-version;">
<?dbhtml filename="gutenprint.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>Gutenprint-&gutenprint-version;</title>
<indexterm zone="gutenprint">
<primary sortas="a-Gutenprint">Gutenprint</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Gutenprint</title>
<para>The <application>Gutenprint</application> (formerly
<application>Gimp-Print</application>) package contains high
quality drivers for many brands and models of printers for use with
<xref linkend="espgs"/>, <xref linkend="cups"/>,
<ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>,
<xref linkend="LPRng"/>, <command>lpr</command> and the
<application>GIMP-2.0</application>. See a list of supported printers at
<ulink url="http://gutenprint.sourceforge.net/p_Supported_Printers.php3"/>.
</para>
<!-- FIXME: APFL Ghostscript is not tested. Don't forget to check the license. -->
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gutenprint-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gutenprint-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &gutenprint-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &gutenprint-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gutenprint-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &gutenprint-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Gutenprint Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="cups"/>,
<ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>,
<ulink url="http://www.linuxprinting.org/ijs/">IJS</ulink>,
<xref linkend="gimp"/>,
<xref linkend="GTK"/>, and
<xref linkend="gtk2"/></para>
<bridgehead renderas="sect4">Optional (to Regenerate Documentation)</bridgehead>
<para role="optional"><xref linkend="imagemagick"/>,
<xref linkend="tetex"/>,
<xref linkend="doxygen"/>, and
<xref linkend="docbook-utils"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gutenprint"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Gutenprint</title>
<para>Install <application>Gutenprint</application> by running the
following commands:</para>
<screen><userinput>sed -i 's|$(PACKAGE)/doc|doc/$(PACKAGE)-$(VERSION)|' \
doc{,/developer}/Makefile.in &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>To test the results, issue <command>make check</command>. This
could take a very long time (100+ SBUs).</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprint{,ui2} &amp;&amp;
install -v -m644 doc/gutenprint/html/* \
/usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprint &amp;&amp;
install -v -m644 doc/gutenprintui2/html/* \
/usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprintui2</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>sed -i '...' doc{,/developer}/Makefile.in</command>: This
command is used so that the package documentation is installed in the
conventional <filename class='directory'>/usr/share/doc</filename>
directory structure instead of
<filename class='directory'>/usr/share/gutenprint/doc</filename>.</para>
<para><option>--with-translated-ppds=no</option>: When this parameter is
given, only US English PPD files for <application>CUPS</application>
will be built. Useful if the PPD files are not yet translated into your
native language and you want to save some space by not installing unneeded
translations.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring Gutenprint</title>
<sect3>
<title>Configuration Information</title>
<para>For <application>CUPS</application> to see newly installed PPD
files, it has to be restarted (as the <systemitem
class="username">root</systemitem> user):</para>
<screen role="root"><userinput>/etc/rc.d/init.d/cups restart</userinput></screen>
<para>This command may take a long time (up to 10 minutes)
to complete. Don't panic while <application>CUPS</application>
is rescanning the list of PPD files. The long delay will happen
only once.</para>
<para>Then point your web browser to <ulink url="http://localhost:631/"/>
to add a new printer to <application>CUPS</application>.</para>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>cups-calibrate, cups-genppd.5.0, cups-genppdconfig.5.0,
cups-genppdupdate.5.0, escputil, ijsgutenprint.5.0, and
testpattern</seg>
<seg>libgutenprint.{so,a}, libgutenprintui2.{so,a},
libgutenprintui2.{so,a} and optionally, various
<application>CUPS</application> filters and backend
drivers</seg>
<seg>/usr/include/gutenprint, /usr/lib/gimp/1.2, /usr/lib/gutenprint,
/usr/share/doc/gutenprint-&gutenprint-version; and
/usr/share/gutenprint</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="cups-calibrate">
<term><command>cups-calibrate</command></term>
<listitem>
<para>calibrates the color output of printers using the
<application>Gutenprint</application>,
<application>CUPS</application> or
<application>ESP Print Pro</application> drivers.</para>
<indexterm zone="gutenprint cups-calibrate">
<primary sortas="b-cups-calibrate">cups-calibrate</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="escputil">
<term><command>escputil</command></term>
<listitem>
<para>is a command line utility to perform various maintenance
tasks on Epson Stylus inkjet printers.</para>
<indexterm zone="gutenprint escputil">
<primary sortas="b-escputil">escputil</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="ijsgutenprint.5.0">
<term><command>ijsgutenprint.5.0</command></term>
<listitem>
<para>is a Ghostscript driver for
<application>Gutenprint</application>.</para>
<indexterm zone="gutenprint ijsgutenprint.5.0">
<primary sortas="b-ijsgutenprint.5.0">ijsgutenprint.5.0</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>