source: pst/printing/gimp-print.xml@ 4b93ac2

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/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-size          "4.9 MB">
  <!ENTITY gimp-print-buildsize     "22 MB">
  <!ENTITY gimp-print-time          "0.42 SBU">
]>

<sect1 id="gimp-print" xreflabel="Gimp-Print-&gimp-print-version;">
<?dbhtml filename="gimp-print.html"?>
<title>Gimp-Print-&gimp-print-version;</title>

<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>,
and the <xref linkend="gimp"/>. See the 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 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> and
<ulink url="http://www.linuxprinting.org/ijs/">IJS</ulink>
</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 &amp;&amp;
make install</command></userinput></screen>

</sect2>

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

<para><option>--with-translated-ppds=no</option>: When this switch is given,
only US English <acronym>PPD</acronym> files 
for <acronym>CUPS</acronym> 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 on 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>

<!-- &library-config; -->

<para>For <application><acronym>CUPS</acronym></application> to see newly installed
<acronym>PPD</acronym> files, it has to be restarted:</para>

<screen><userinput><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>

<para>The <application>Gimp-Print</application> package contains 
<filename>libgimpprint</filename> libraries, 
<command>rastertoprinter</command> filter for
<application><acronym>CUPS</acronym></application> that converts
the output of <command>pstoraster</command> to a form
understandable by printers,
and a plugin that allows printing images from
<application><acronym>GIMP</acronym>-1.2.5</application>.</para>
</sect2>

</sect1>