glfs/pst/printing/espgs.xml
Randy McMurchy 20560e4c48 Updated build entities and added indexing tags to ESP Ghostscript instructions
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3702 af4574ff-66df-0310-9fd7-8a98e5e911e0
2005-04-10 16:08:54 +00:00

218 lines
8.3 KiB
XML

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