source: pst/printing/espgs.xml@ 86af98a

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//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-md5sum        "d30bf5c09f2c7caa8291f6305cf03044">
  <!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">

  <!ENTITY espgs-standard-fonts-download "ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/fonts/ghostscript-fonts-std-8.11.tar.gz">
  <!ENTITY espgs-standard-fonts-md5sum   "6865682b095f8c4500c54b285ff05ef6">
  <!ENTITY espgs-standard-fonts-size     "3.7 MB">

  <!ENTITY espgs-other-fonts-download "http://ftp.gnu.org/pub/gnu/ghostscript/gnu-gs-fonts-other-6.0.tar.gz">
  <!ENTITY espgs-other-fonts-md5sum   "33457d3f37de7ef03d2eea05a9e6aa4f">
  <!ENTITY espgs-other-fonts-size     "796 KB">
]>

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

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

<para><application><acronym>ESP</acronym> Ghostscript</application> is a 
versatile processor for PostScript data with the ability to render PostScript 
to different targets. 
<application><acronym>ESP</acronym> 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 MD5 sum: &espgs-md5sum;</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>
<sect4><title>Standard fonts</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (FTP):
<ulink url="&espgs-standard-fonts-download;"/></para></listitem>
<listitem><para>Download MD5 sum:
&espgs-standard-fonts-md5sum;</para></listitem>
<listitem><para>Download size:
&espgs-standard-fonts-size;</para></listitem>
</itemizedlist>
</sect4>

<sect4><title>Other fonts</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&espgs-other-fonts-download;"/></para></listitem>
<listitem><para>Download MD5 sum:
&espgs-other-fonts-md5sum;</para></listitem>
<listitem><para>Download size:
&espgs-other-fonts-size;</para></listitem>
</itemizedlist>
</sect4>
</sect3>

<sect3><title><application><acronym>ESP</acronym> 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><acronym>ESP</acronym> 
Ghostscript</application></title>

<para>Install <application><acronym>ESP</acronym> 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>

<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><acronym>ESP</acronym> 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>