Author: andy
Date: 2012-06-26 08:57:50 -0600 (Tue, 26 Jun 2012)
New Revision: 10364
Modified:
trunk/BOOK/pst/printing/gs.xml
Log:
A note about --with-install-cups for the Ghostscript page
Modified: trunk/BOOK/pst/printing/gs.xml
===================================================================
--- trunk/BOOK/pst/printing/gs.xml 2012-06-26 12:57:55 UTC (rev 10363)
+++ trunk/BOOK/pst/printing/gs.xml 2012-06-26 14:57:50 UTC (rev 10364)
@@ -101,63 +101,85 @@
<bridgehead renderas="sect3">Ghostscript Dependencies</bridgehead>
<bridgehead renderas="sect4">Recommended</bridgehead>
- <para role="optional"><xref linkend="expat"/>,
- <xref linkend="freetype2"/>,
- <xref linkend="libjpeg"/>,
- <xref linkend="libpng"/>,
- <xref linkend="libtiff"/>, and
- <xref linkend="lcms2"/>.</para>
+ <para role="recommended">
+ <xref linkend="expat"/>,
+ <xref linkend="freetype2"/>,
+ <xref linkend="libjpeg"/>,
+ <xref linkend="libpng"/>,
+ <xref linkend="libtiff"/>, and
+ <xref linkend="lcms2"/>
+ </para>
<bridgehead renderas="sect4">Optional</bridgehead>
- <para role="optional"><xref linkend="cairo"/>,
- <xref linkend="fontconfig"/>,
- <xref linkend="gtk2"/>,
- <xref linkend="cups"/>,
- <xref linkend="jasper"/>,
- <xref linkend="lcms"/>,
- <xref linkend="libidn"/>,
- <xref linkend="x-window-system"/>, and <ulink
-
url="http://packages.debian.org/unstable/source/libpaper";>libpaper</ulink>.</para>
+ <para role="optional">
+ <xref linkend="cairo"/>,
+ <xref linkend="fontconfig"/>,
+ <xref linkend="gtk2"/>,
+ <xref linkend="cups"/>,
+ <xref linkend="jasper"/>,
+ <xref linkend="lcms"/>,
+ <xref linkend="libidn"/>,
+ <xref linkend="x-window-system"/> and
+ <ulink
url="http://packages.debian.org/unstable/source/libpaper";>libpaper</ulink>
+ </para>
- <para condition="html" role="usernotes">User Notes:
- <ulink url="&blfs-wiki;/gs"/></para>
+ <para condition="html" role="usernotes">
+ User Notes: <ulink url="&blfs-wiki;/gs"/>
+ </para>
</sect2>
<sect2 role="installation">
<title>Installation of Ghostscript</title>
- <para>Install <application>GPL Ghostscript</application> by running the
- following commands:</para>
+ <note>
+ <para>
+ The <application>Ghostscript</application> build system is not
+ user-friendly. In order to use system copies of various graphics
+ libraries, you must do it using unconventional methods.
+ </para>
+ </note>
- <note>
- <para>The <application>Ghostscript</application> build system is not
- user-friendly. In order to use system copies of various graphics
- libraries, you must do it using unconventional methods.</para>
- </note>
-
- <para><application>GPL Ghostscript</application> includes (old) copies of
+ <para>
+ <application>GPL Ghostscript</application> includes (old) copies of
several libraries. Some of these seem to have been patched to fix known
vulnerabilities, but others of these copies are less-well maintained.
To ensure that any future fixes are applied throughout the whole system,
- it is recommended that you install the released versions of these
+ it is recommended that you first install the released versions of these
libraries and then configure <application>GPL Ghostscript</application>
- to link to them.</para>
+ to link to them.
+ </para>
- <para>If you have installed these dependencies on your system, remove the
+ <para>
+ If you have installed these dependencies on your system, remove the
copies of <application>expat</application>,
<application>freetype</application>, <application>lcms2</application>,
<application>libjpeg</application>, <application>libpng</application>,
and <application>libtiff</application>:
- </para>
+ </para>
<screen><userinput>rm -rf expat freetype jpeg lcms2 libpng
tiff</userinput></screen>
<note>
- <para>If you have a multicore computer and try to run make with multiple
- jobs (eg, make -j4) then the build may fail due to race conditions in the
- <application>Ghostscript</application> build system.</para>
+ <para>
+ If you have a multicore computer and try to run make with multiple
+ jobs (eg, make -j4) then the build may fail due to race conditions in
+ the <application>Ghostscript</application> build system. You can work
+ around that problem by simply running make again (eg,
+ <command>make -j4 || make -j4</command>).
+ </para>
</note>
+ <note>
+ <para>
+ If you have installed Cups and your printer is <emphasis>not</emphasis>
+ a postscript printer you will need to add
+ <option>--with-install-cups</option> to the configure options below.
+ (This option makes Ghostscript compile and install the gstoraster
filter
+ and the gstoraster.convs configuration file that allow Cups to convert
a
+ PostScript file to raster.)
+ </para>
+ </note>
+
<para>Compile <application>Ghostscript</application>:</para>
<screen><userinput>rm -rf jasper lcms zlib &&
@@ -165,24 +187,31 @@
make</userinput></screen>
<note>
- <para>The shared library depends on <xref linkend="gtk2"/>. It is
- only used in external programs like <xref linkend="imagemagick"/>.</para>
+ <para>
+ The shared library depends on <xref linkend="gtk2"/>. It is only used
in
+ external programs like <xref linkend="imagemagick"/>.
+ </para>
</note>
- <para>To compile the shared library
- <filename class="libraryfile">libgs.so</filename>, run the
- following additional command as an unprivileged user:</para>
+ <para>
+ To compile the shared library
+ <filename class="libraryfile">libgs.so</filename>, run the following
+ additional command as an unprivileged user:
+ </para>
<screen><userinput>make so</userinput></screen>
- <para>This package does not come with a test suite. However, you may test
- the operation of the newly built <command>gs</command> program by
- issuing the following command (issue from an X Windows terminal):</para>
+ <para>
+ This package does not come with a test suite. However, you may test the
+ operation of the newly built <command>gs</command> program by issuing the
+ following command (issue from an X Windows terminal):
+ </para>
<screen><userinput>bin/gs -Ilib -dBATCH examples/tiger.eps</userinput></screen>
- <para>Now, as the <systemitem class="username">root</systemitem>
- user:</para>
+ <para>
+ Now, as the <systemitem class="username">root</systemitem> user:
+ </para>
<screen role="root"><userinput>make install</userinput></screen>
@@ -196,13 +225,15 @@
<screen role="root"><userinput>ln -sfv ../ghostscript/&gs-version;/doc
/usr/share/doc/ghostscript-&gs-version;</userinput></screen>
- <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
- <systemitem class="username">root</systemitem>:
- <systemitem class="groupname">root</systemitem>. Substitute
- <replaceable><font-tarball></replaceable> appropriately in
- the command below for the fonts you wish to install:</para>
+ <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
+ <systemitem class="username">root</systemitem>:
+ <systemitem class="groupname">root</systemitem>. Substitute
+ <replaceable><font-tarball></replaceable> appropriately in the
+ command below for the fonts you wish to install:
+ </para>
<screen role="root"><userinput>tar -xvf
../<replaceable><font-tarball></replaceable> -C /usr/share/ghostscript
--no-same-owner</userinput></screen>
</sect2>
@@ -210,34 +241,45 @@
<sect2 role="commands">
<title>Command Explanations</title>
- <para><command>rm -rf jasper lcms zlib</command>: The
- <application>Ghostscript</application> build system defaults to using its
- own version of <ulink url="http://www.openjpeg.org/";>OpenJpeg</ulink> for
- JPEG 2000 files <!-- I can't get it to compile using a system installed
- version of openjpeg. It seems the ghostscript version has been heavily
- modified... --> so we can all remove the jasper source. The default color
- management system is now <application>lcms2</application> so the
- <application>lcms</application> source is not needed.
- <application>Zlib</application> was installed as part of LFS.</para>
+ <para>
+ <command>rm -rf jasper lcms zlib</command>: The
+ <application>Ghostscript</application> build system defaults to using its
+ own version of <ulink url="http://www.openjpeg.org/";>OpenJpeg</ulink> for
+ JPEG 2000 files <!-- I can't get it to compile using a system installed
+ version of openjpeg. It seems the ghostscript version has been heavily
+ modified... --> so we can all remove the jasper source. The default color
+ management system is now <application>lcms2</application> so the
+ <application>lcms</application> source is not needed.
+ <application>Zlib</application> was installed as part of LFS.
+ </para>
- <para><option>--with-system-libtiff</option>: Remove this option if you've
- not installed <xref linkend="libtiff"/>.</para>
+ <para>
+ <option>--with-system-libtiff</option>: Remove this option if you've not
+ installed <xref linkend="libtiff"/>.
+ </para>
- <para><parameter>LIBS=-lz</parameter>: We use the LIBS variable to tell the
- linker (ld) to link against the system installed
- <application>zlib</application>.</para>
+ <para>
+ <parameter>LIBS=-lz</parameter>: We use the LIBS variable to tell the
+ linker (ld) to link against the system installed
+ <application>zlib</application>.
+ </para>
- <para><command>install -v -m644 base/*.h...</command>: Some packages
- (<application>ImageMagick</application> is one) need the
- <application>Ghostscript</application> interface headers in place to link
- to the shared library. These commands install the headers.</para>
+ <para>
+ <command>install -v -m644 base/*.h...</command>: Some packages
+ (<application>ImageMagick</application> is one) need the
+ <application>Ghostscript</application> interface headers in place to link
+ to the shared library. These commands install the headers.
+ </para>
- <para><command>ln -v -s ghostscript /usr/include/ps</command>: Some
packages
- expect to find the interface headers in an alternate location.</para>
+ <para>
+ <command>ln -v -s ghostscript /usr/include/ps</command>: Some packages
+ expect to find the interface headers in an alternate location.
+ </para>
- <para><command>ln -sfv ../ghostscript-&gs-version;/doc ...</command>:
- This puts a symbolic link to the documentation where it is expected to be
- found.</para>
+ <para>
+ <command>ln -sfv ../ghostscript-&gs-version;/doc ...</command>: This puts
+ a symbolic link to the documentation where it is expected to be found.
+ </para>
</sect2>
<sect2 role="content">
@@ -248,16 +290,21 @@
<segtitle>Installed Directories</segtitle>
<seglistitem>
- <seg>bdftops, dumphint, dvipdf, eps2eps, fixmswrd.pl, font2c, gs, gsbj,
- gsc (from soinstall), gsdj, gsdj500, gslj, gslp, gsnd, gsx
- (from soinstall), lprsetup.sh, pdf2dsc, pdf2ps, pdfopt,
- pf2afm, pfbtopfa, printafm, ps2ascii, ps2epsi, ps2pdf, ps2pdf12,
- ps2pdf13, ps2pdf14, ps2pdfwr, ps2ps, ps2ps2, pv.sh, unix-lpr.sh, and
- wftopfa</seg>
+ <seg>
+ bdftops, dumphint, dvipdf, eps2eps, fixmswrd.pl, font2c, gs, gsbj,
+ gsc (from soinstall), gsdj, gsdj500, gslj, gslp, gsnd, gsx
+ (from soinstall), lprsetup.sh, pdf2dsc, pdf2ps, pdfopt,
+ pf2afm, pfbtopfa, printafm, ps2ascii, ps2epsi, ps2pdf, ps2pdf12,
+ ps2pdf13, ps2pdf14, ps2pdfwr, ps2ps, ps2ps2, pv.sh, unix-lpr.sh, and
+ wftopfa
+ </seg>
<seg>libgs.so</seg>
- <seg>/usr/include/ghostscript, /usr/lib/ghostscript,
- /usr/share/ghostscript, and
- /usr/share/doc/ghostscript-&gs-version;</seg>
+ <seg>
+ /usr/include/ghostscript,
+ /usr/lib/ghostscript,
+ /usr/share/ghostscript and
+ /usr/share/doc/ghostscript-&gs-version;
+ </seg>
</seglistitem>
</segmentedlist>
@@ -269,8 +316,10 @@
<varlistentry id="gplgs-prog">
<term><command>gs</command></term>
<listitem>
- <para>is an interpreter for Adobe Systems' PostScript(tm) and
Portable
- Document Format (PDF).</para>
+ <para>
+ is an interpreter for Adobe Systems' PostScript(tm) and Portable
+ Document Format (PDF).
+ </para>
<indexterm zone="gs gplgs-prog">
<primary sortas="b-gs">gs</primary>
</indexterm>
@@ -280,10 +329,12 @@
<varlistentry id="libgs.so">
<term><filename class="libraryfile">libgs.so</filename></term>
<listitem>
- <para>provides <application>Ghostscript</application> functionality
- to other programs, such as <application>GSView</application>,
- <application>ImageMagick</application>, and
- <application>libspectre</application>.</para>
+ <para>
+ provides <application>Ghostscript</application> functionality to
+ other programs, such as <application>GSView</application>,
+ <application>ImageMagick</application>, and
+ <application>libspectre</application>.
+ </para>
<indexterm zone="gs libgs.so">
<primary sortas="c-libgs.so">libgs.so</primary>
</indexterm>
@@ -291,9 +342,11 @@
</varlistentry>
</variablelist>
- <para><application>GPL Ghostscript</application> provides many different
- scripts used to convert PostScript, PDF, and other formats. Please refer to
- the HTML documentation or the man pages for information about the
- capabilities provided.</para>
+ <para>
+ <application>GPL Ghostscript</application> provides many different
+ scripts used to convert PostScript, PDF, and other formats. Please refer
to
+ the HTML documentation or the man pages for information about the
+ capabilities provided.
+ </para>
</sect2>
</sect1>
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
