source: pst/printing/gimp-print.xml@ 9f8f649

<!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          "5.2 MB">
  <!ENTITY gimp-print-buildsize     "27 MB">
  <!ENTITY gimp-print-time          "0.29 SBU">
]>

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

<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 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="pst-typesetting-tex"/>, 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 &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 <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:</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 
<command>gimpprint-config</command>, <command>escputil</command>, 
<filename class='libraryfile'>libgimpprint</filename> libraries and 
optionally, <command>rastertoprinter</command> and 
<command>pstopxl</command> filter scripts for 
<application><acronym>CUPS</acronym></application>, 
<command>cups-calibrate</command>, <command>ijsgimpprint</command> and a 
plugin that allows printing images from 
<application><acronym>GIMP</acronym>-1.2</application>.
</para>
</sect2>

<sect2>
<title>Description</title>

<sect3><title>gimpprint-config</title>
<para><command>gimpprint-config</command> is a script to get information about 
the installed version of gimpprint.</para></sect3>

<sect3><title>escputil</title>
<para><command>escputil</command> is a command line utility to perform various 
maintenance tasks on Epson Stylus inkjet printers.</para></sect3>

<sect3><title>cups-calibrate</title>
<para><command>cups-calibrate</command> 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></sect3>

<sect3><title>ijsgimpprint</title>
<para><command>ijsgimpprint</command> is a Ghostscript driver for 
<application>Gimp-Print</application>.</para></sect3>

</sect2>

</sect1>