source: pst/printing/espgs.xml@ 20560e4

<!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 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     "128 MB (includes installing libgs.so and both font tarballs)">
  <!ENTITY espgs-time          "1.94 SBU (includes building and installing libgs.so)">

  <!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>
<indexterm zone="espgs">
<primary sortas="a-ESP-Ghostscript">ESP Ghostscript</primary></indexterm>

<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 <application><acronym>CUPS</acronym></application> 
raster driver to support <application><acronym>CUPS</acronym></application> 
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</command></userinput></screen>

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

<screen><userinput role='root'><command>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</command></userinput></screen>

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

<screen><userinput role='root'><command>make soinstall &amp;&amp;
install -v -d -m755 /usr/include/ps &amp;&amp;
install -v -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. Substitute appropriately in 
the command below for the fonts you wish to install:</para>

<screen><userinput role='root'><command>tar -zxvf ../<replaceable>[font-tarball]</replaceable> -C /usr/share/ghostscript &amp;&amp;
chown -v -R root:root /usr/share/ghostscript/fonts</command></userinput></screen>

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

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

<seglistitem>
<seg>bdftops, dvipdf, eps2eps, fixmswrd.pl, font2c, gs, gsbj, gsc, gsdj, 
gsdj500, gslj, gslp, gsnd, gsx, lprsetup.sh, pdf2dsc, pdf2ps, pdfopt, pf2afm, 
pfbtopfa, pj-gs.sh, printafm, ps2ascii, ps2epsi, ps2pdf, ps2pdf12, ps2pdf13, 
ps2pdf14, ps2pdfwr, ps2ps, pv.sh, sysvlp.sh, unix-lpr.sh, wftopfa</seg>
<seg>libgs.so </seg>
<seg>/usr/include/ps and /usr/share/ghostscript</seg>
</seglistitem>
</segmentedlist>

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

<varlistentry id="gs-prog-gs">
<term><command>gs</command></term>
<listitem><para>invokes <application>Ghostscript</application>, an interpreter 
of Adobe Systems' PostScript(tm) and Portable Document Format
(<acronym>PDF</acronym>) languages.</para>
<indexterm zone="espgs gs-prog-gs">
<primary sortas="b-gs">gs</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="pstoraster">
<term><filename>pstoraster</filename></term>
<listitem><para>is a filter used by 
<application><acronym>CUPS</acronym></application> 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>
<indexterm zone="espgs pstoraster">
<primary sortas="g-pstoraster">pstoraster</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>

<para><application><acronym>ESP</acronym> Ghostscript</application> provides 
many different scripts used 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.</para>

</sect2>

</sect1>