source: pst/printing/gimp-print.xml@ e87ad87

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY gimp-print-download-http "http://prdownloads.sourceforge.net/gimp-print/gimp-print-&gimp-print-version;.tar.gz">
  <!ENTITY gimp-print-download-ftp  " ">
  <!ENTITY gimp-print-md5sum        "766be49f44a6a682d857e5aefec414d4">
  <!ENTITY gimp-print-size          "5.1 MB">
  <!ENTITY gimp-print-buildsize     "36 MB">
  <!ENTITY gimp-print-time          "0.32 SBU (additional 4.37 SBUs to run the test suite)">
]>

<sect1 id="gimp-print" xreflabel="Gimp-Print-&gimp-print-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="gimp-print.html"?>
<title>Gimp-Print-&gimp-print-version;</title>
<indexterm zone="gimp-print">
<primary sortas="a-Gimp-Print">Gimp-Print</primary></indexterm>

<sect2>
<title>Introduction to <application>Gimp-Print</application></title>

<para>The <application>Gimp-Print</application> package contains 
high quality drivers for Canon, Epson, Lexmark and <acronym>PCL</acronym> 
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><acronym>GIMP</acronym>-1.2</application>. See a list of 
supported printers at 
<ulink url="http://gimp-print.sourceforge.net/p_Supported_Printers.php3"/>.
</para>

<!-- FIXME: APFL Ghostscript is not tested. Don't forget to check the license. -->

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): 
<ulink url="&gimp-print-download-http;"/></para></listitem>
<listitem><para>Download (FTP): 
<ulink url="&gimp-print-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &gimp-print-md5sum;</para></listitem>
<listitem><para>Download size: &gimp-print-size;</para></listitem>
<listitem><para>Estimated disk space required: 
&gimp-print-buildsize;</para></listitem>
<listitem><para>Estimated build time: 
&gimp-print-time;</para></listitem>
</itemizedlist>
</sect3>

<sect3><title><application>Gimp-Print</application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="cups"/>, 
<ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>, 
<ulink url="http://www.linuxprinting.org/ijs/">IJS</ulink>, 
<xref linkend="tex"/>, 
<xref linkend="docbook-utils"/> and 
<xref linkend="espgs"/> or <xref linkend="gs"/></para>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>Gimp-Print</application></title>

<para>Install <application>Gimp-Print</application> by running the following 
commands:</para>

<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>make install</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<para><option>--with-translated-ppds=no</option>: When this switch is given,
only <acronym>US</acronym> English <acronym>PPD</acronym> files 
for <application><acronym>CUPS</acronym></application> will be built. Useful 
if the <acronym>PPD</acronym> files are not yet translated into your native
language and you want to save some space by not installing unneeded 
translations.</para>

<para><option>--enable-cups-level3-ps</option>: This option causes
the build process to generate PostScript level 3 <acronym>PPD</acronym> files
instead of level 2 ones.</para>

</sect2>

<sect2>
<title>Configuring <application>Gimp-Print</application></title>

<sect3><title>Configuration Information</title>

<para>For <application><acronym>CUPS</acronym></application> to see newly 
installed <acronym>PPD</acronym> files, it has to be restarted (as the root 
user):</para>

<screen><userinput role='root'><command>/etc/rc.d/init.d/cups restart</command></userinput></screen>

<note><para>This command may take a very long time (up to 10 minutes) to
complete. Don't panic while
<application><acronym>CUPS</acronym></application> is rescanning the
list of <acronym>PPD</acronym> files. The long delay will happen only
once.</para></note>

<para>Then point your web browser to <ulink url="http://127.0.0.1:631"/> to 
add a new printer to 
<application><acronym>CUPS</acronym></application>.</para>
</sect3>

</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>

<seglistitem>
<seg>cups-calibrate, escputil, gimpprint-config, ijsgimpprint and 
testpattern</seg>
<seg>libgimpprint.[so,a] and optionally, various 
<application><acronym>CUPS</acronym></application> filters and backend 
drivers</seg>
<seg>/usr/include/gimp-print, /usr/lib/gimp, /usr/share/cups/model/C and 
/usr/share/gimp-print</seg>
</seglistitem>
</segmentedlist>

<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>

<varlistentry id="cups-calibrate">
<term><command>cups-calibrate</command></term>
<listitem><para>calibrates the color output of printers using the 
<application>Gimp-Print</application>, 
<application><acronym>CUPS</acronym></application> or
<application><acronym>ESP</acronym> Print Pro</application> drivers.</para>
<indexterm zone="gimp-print 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="gimp-print escputil">
<primary sortas="b-escputil">escputil</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gimpprint-config">
<term><command>gimpprint-config</command></term>
<listitem><para>is a script to get information about the installed version 
of <application>Gimp-Print</application>.</para>
<indexterm zone="gimp-print gimpprint-config">
<primary sortas="b-gimpprint-config">gimpprint-config</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="ijsgimpprint">
<term><command>ijsgimpprint</command></term>
<listitem><para>is a Ghostscript driver for 
<application>Gimp-Print</application>.</para>
<indexterm zone="gimp-print ijsgimpprint">
<primary sortas="b-ijsgimpprint">ijsgimpprint</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>