source: pst/printing/espgs.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 espgs-download-http "http://prdownloads.sourceforge.net/espgs/espgs-&espgs-version;-source.tar.bz2">
  <!ENTITY espgs-download-ftp  "ftp://ftp.gtlib.cc.gatech.edu/pub/slackware/slackware-current/source/ap/espgs/espgs-&espgs-version;-source.tar.bz2">
  <!ENTITY espgs-size          "5.3 MB">
  <!ENTITY espgs-buildsize     "116-140 MB (depends if libgs.so is installed)">
  <!ENTITY espgs-time          "1.65-3.20 SBU">
]>

<sect1 id="espgs" xreflabel="ESP Ghostscript-&espgs-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="espgs.html"?>
<title>ESP Ghostscript-&espgs-version;</title>

<sect2>
<title>Introduction to <application>Ghostscript</application></title>

<para><application>Ghostscript</application> is a versatile processor for 
PostScript data with the ability to render PostScript to different targets. 
<application>ESP Ghostscript</application> is a customized version of 
<acronym>GNU</acronym> Ghostscript that includes an enhanced configuration 
script, the <acronym>CUPS</acronym> raster driver to support 
<acronym>CUPS</acronym> raster printer drivers, and additional patches and 
drivers from various Linux distributors.</para>

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

<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Standard fonts: <ulink
url="ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/fonts/ghostscript-fonts-std-8.11.tar.gz"/>
</para></listitem>
<listitem><para>Other fonts: <ulink
url="http://ftp.gnu.org/pub/gnu/ghostscript/gnu-gs-fonts-other-6.0.tar.gz"/>
</para></listitem>
</itemizedlist></sect3>

<sect3><title><application>Ghostscript</application>
dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="cups"/>, <xref linkend="libjpeg"/>, 
<xref linkend="libpng"/>, X (<xref linkend="xfree86"/> or 
<xref linkend="xorg"/>), <xref linkend="GLib"/>, <xref linkend="GTK"/> and
<xref linkend="gimp-print"/>
</para></sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>Ghostscript</application></title>

<para>Install <application>Ghostscript</application> by running the following 
commands:</para>

<screen><userinput><command>./configure --prefix=/usr --without-gimp-print --without-omni &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

<para>To install the shared library 
<filename class='libraryfile'>libgs.so</filename> you
will need <xref linkend="GTK"/>.</para>

<para>Proceed with the following commands:</para>

<screen><userinput><command>make CFLAGS_SO='-fPIC $(ACDEFS)' so &amp;&amp;
make soinstall &amp;&amp;
install -d -m755 /usr/include/ps &amp;&amp;
install -m644 src/*.h /usr/include/ps</command></userinput></screen>

<note><para>The shared library is only used in external programs like
<xref linkend="gsview"/>.</para></note>

<para>To finish the installation, unpack all fonts you've downloaded to
<filename class="directory">/usr/share/ghostscript</filename> and ensure 
the ownerships of the files are root:root.</para>

</sect2>

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

<para><parameter>--without-gimp-print</parameter>: This switch disables
the building of the <application><acronym>GIMP</acronym></application> print 
driver as a <application>Ghostscript</application> device since this is 
deprecated. This driver may be still accessible via <acronym>IJS</acronym>
or <application><acronym>CUPS</acronym></application>,
and this is the preferred way.</para>
<!-- This also fails with Gimp-Print-4.2.6-rc1 or later -->

<para><option>--without-omni</option>: This switch disables the
omni driver support.</para>

<para><option>--without-ijs</option>: This switch disables the
<acronym>IJS</acronym> driver support.</para>

<para><command>install ...</command>: Some packages 
(<application>ImageMagick</application> is one) need the 
<application>Ghostscript</application> headers in place to link to the 
shared library. These commands install the headers.</para>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application>Ghostscript</application> package contains 
<command>gs</command>, the <filename class='libraryfile'>libgs</filename> 
library and many filters to render PostScript/<acronym>PDF</acronym> files 
back and forth. Please refer to the <acronym>HTML</acronym> documentation or 
try <command>man gs</command> for information about the capabilities provided 
by the package. <application><acronym>ESP</acronym> Ghostscript</application> 
also provides the <filename>pstoraster</filename> 
<application><acronym>CUPS</acronym></application> print filter.</para>

</sect2>

<sect2>
<title>Description</title>

<sect3>
<title>gs</title>
<para><command>gs</command> invokes <application>Ghostscript</application>, an 
interpreter of Adobe Systems' PostScript(tm) and Portable Document Format 
(<acronym>PDF</acronym>) languages.</para></sect3>

<sect3>
<title>pstoraster</title>
<para><application><acronym>CUPS</acronym></application> uses the 
<command>pstoraster</command> filter to convert PostScript to a generic raster 
image format that is acceptable as an input to drivers for non-PostScript 
printers (e.g., from <xref linkend="gimp-print"/>). It is built and installed 
only if <xref linkend="cups"/> is found.</para></sect3>

</sect2>

</sect1>