[blfs-book] r10364 - trunk/BOOK/pst/printing

andy at linuxfromscratch.org andy at linuxfromscratch.org
Tue Jun 26 07:57:54 PDT 2012


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>




More information about the blfs-book mailing list