Changeset 2d37d32 for pst


Ignore:
Timestamp:
06/26/2012 02:57:50 PM (12 years ago)
Author:
Andrew Benton <andy@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
14dcfecb
Parents:
4324f5af
Message:

A note about --with-install-cups for the Ghostscript page

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10364 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • pst/printing/gs.xml

    r4324f5af r2d37d32  
    102102
    103103    <bridgehead renderas="sect4">Recommended</bridgehead>
    104     <para role="optional"><xref linkend="expat"/>,
    105     <xref linkend="freetype2"/>,
    106     <xref linkend="libjpeg"/>,
    107     <xref linkend="libpng"/>,
    108     <xref linkend="libtiff"/>, and
    109     <xref linkend="lcms2"/>.</para>
     104    <para role="recommended">
     105      <xref linkend="expat"/>,
     106      <xref linkend="freetype2"/>,
     107      <xref linkend="libjpeg"/>,
     108      <xref linkend="libpng"/>,
     109      <xref linkend="libtiff"/>, and
     110      <xref linkend="lcms2"/>
     111    </para>
    110112
    111113    <bridgehead renderas="sect4">Optional</bridgehead>
    112     <para role="optional"><xref linkend="cairo"/>,
    113     <xref linkend="fontconfig"/>,
    114     <xref linkend="gtk2"/>,
    115     <xref linkend="cups"/>,
    116     <xref linkend="jasper"/>,
    117     <xref linkend="lcms"/>,
    118     <xref linkend="libidn"/>,
    119     <xref linkend="x-window-system"/>, and <ulink
    120     url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>.</para>
    121 
    122     <para condition="html" role="usernotes">User Notes:
    123     <ulink url="&blfs-wiki;/gs"/></para>
     114    <para role="optional">
     115      <xref linkend="cairo"/>,
     116      <xref linkend="fontconfig"/>,
     117      <xref linkend="gtk2"/>,
     118      <xref linkend="cups"/>,
     119      <xref linkend="jasper"/>,
     120      <xref linkend="lcms"/>,
     121      <xref linkend="libidn"/>,
     122      <xref linkend="x-window-system"/> and
     123      <ulink url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>
     124    </para>
     125
     126    <para condition="html" role="usernotes">
     127      User Notes: <ulink url="&blfs-wiki;/gs"/>
     128    </para>
    124129  </sect2>
    125130
    … …  
    127132    <title>Installation of Ghostscript</title>
    128133
    129     <para>Install <application>GPL Ghostscript</application> by running the
    130     following commands:</para>
    131 
    132       <note>
    133       <para>The <application>Ghostscript</application> build system is not
    134       user-friendly. In order to use system copies of various graphics
    135       libraries, you must do it using unconventional methods.</para>
    136       </note>
    137 
    138       <para><application>GPL Ghostscript</application> includes (old) copies of
     134    <note>
     135      <para>
     136        The <application>Ghostscript</application> build system is not
     137        user-friendly. In order to use system copies of various graphics
     138        libraries, you must do it using unconventional methods.
     139      </para>
     140    </note>
     141
     142    <para>
     143      <application>GPL Ghostscript</application> includes (old) copies of
    139144      several libraries. Some of these seem to have been patched to fix known
    140145      vulnerabilities, but others of these copies are less-well maintained.
    141146      To ensure that any future fixes are applied throughout the whole system,
    142       it is recommended that you install the released versions of these
     147      it is recommended that you first install the released versions of these
    143148      libraries and then configure <application>GPL Ghostscript</application>
    144       to link to them.</para>
    145 
    146       <para>If you have installed these dependencies on your system, remove the
     149      to link to them.
     150    </para>
     151
     152    <para>
     153      If you have installed these dependencies on your system, remove the
    147154      copies of <application>expat</application>,
    148155      <application>freetype</application>, <application>lcms2</application>,
    149156      <application>libjpeg</application>, <application>libpng</application>,
    150157      and <application>libtiff</application>:
     158    </para>
     159
     160<screen><userinput>rm -rf expat freetype jpeg lcms2 libpng tiff</userinput></screen>
     161
     162    <note>
     163      <para>
     164        If you have a multicore computer and try to run make with multiple
     165        jobs (eg, make -j4) then the build may fail due to race conditions in
     166        the <application>Ghostscript</application> build system. You can work
     167        around that problem by simply running make again (eg,
     168        <command>make -j4 || make -j4</command>).
    151169      </para>
    152 
    153 <screen><userinput>rm -rf expat freetype jpeg lcms2 libpng tiff</userinput></screen>
     170    </note>
    154171
    155172    <note>
    156       <para>If you have a multicore computer and try to run make with multiple
    157       jobs (eg, make -j4) then the build may fail due to race conditions in the
    158       <application>Ghostscript</application> build system.</para>
     173      <para>
     174        If you have installed Cups and your printer is <emphasis>not</emphasis>
     175        a postscript printer you will need to add
     176        <option>--with-install-cups</option> to the configure options below.
     177        (This option makes Ghostscript compile and install the gstoraster filter
     178        and the gstoraster.convs configuration file that allow Cups to convert a
     179        PostScript file to raster.)
     180      </para>
    159181    </note>
    160182
    … …  
    166188
    167189    <note>
    168       <para>The shared library depends on <xref linkend="gtk2"/>. It is
    169       only used in external programs like <xref linkend="imagemagick"/>.</para>
     190      <para>
     191        The shared library depends on <xref linkend="gtk2"/>. It is only used in
     192        external programs like <xref linkend="imagemagick"/>.
     193      </para>
    170194    </note>
    171195
    172     <para>To compile the shared library
    173     <filename class="libraryfile">libgs.so</filename>, run the
    174     following additional command as an unprivileged user:</para>
     196    <para>
     197      To compile the shared library
     198      <filename class="libraryfile">libgs.so</filename>, run the following
     199      additional command as an unprivileged user:
     200    </para>
    175201
    176202<screen><userinput>make so</userinput></screen>
    177203
    178     <para>This package does not come with a test suite. However, you may test
    179     the operation of the newly built <command>gs</command> program by
    180     issuing the following command (issue from an X Windows terminal):</para>
     204    <para>
     205      This package does not come with a test suite. However, you may test the
     206      operation of the newly built <command>gs</command> program by issuing the
     207      following command (issue from an X Windows terminal):
     208    </para>
    181209
    182210<screen><userinput>bin/gs -Ilib -dBATCH examples/tiger.eps</userinput></screen>
    183211
    184     <para>Now, as the <systemitem class="username">root</systemitem>
    185     user:</para>
     212    <para>
     213      Now, as the <systemitem class="username">root</systemitem> user:
     214    </para>
    186215
    187216<screen role="root"><userinput>make install</userinput></screen>
    … …  
    197226<screen role="root"><userinput>ln -sfv ../ghostscript/&gs-version;/doc /usr/share/doc/ghostscript-&gs-version;</userinput></screen>
    198227
    199     <para>To finish the installation, unpack all fonts you've downloaded to
    200     <filename class="directory">/usr/share/ghostscript</filename> and ensure
    201     the ownerships of the files are
    202     <systemitem class="username">root</systemitem>:
    203     <systemitem class="groupname">root</systemitem>. Substitute
    204     <replaceable>&lt;font-tarball&gt;</replaceable> appropriately in
    205     the command below for the fonts you wish to install:</para>
     228    <para>
     229      To finish the installation, unpack all fonts you've downloaded to
     230      <filename class="directory">/usr/share/ghostscript</filename> and ensure
     231      the ownerships of the files are
     232      <systemitem class="username">root</systemitem>:
     233      <systemitem class="groupname">root</systemitem>. Substitute
     234      <replaceable>&lt;font-tarball&gt;</replaceable> appropriately in the
     235      command below for the fonts you wish to install:
     236    </para>
    206237
    207238<screen role="root"><userinput>tar -xvf ../<replaceable>&lt;font-tarball&gt;</replaceable> -C /usr/share/ghostscript --no-same-owner</userinput></screen>
    … …  
    211242    <title>Command Explanations</title>
    212243
    213     <para><command>rm -rf jasper lcms zlib</command>: The
    214     <application>Ghostscript</application> build system defaults to using its
    215     own version of <ulink url="http://www.openjpeg.org/">OpenJpeg</ulink> for
    216     JPEG 2000 files <!-- I can't get it to compile using a system installed
    217     version of openjpeg. It seems the ghostscript version has been heavily
    218     modified... --> so we can all remove the jasper source. The default color
    219     management system is now <application>lcms2</application> so the
    220     <application>lcms</application> source is not needed.
    221     <application>Zlib</application> was installed as part of LFS.</para>
    222 
    223     <para><option>--with-system-libtiff</option>: Remove this option if you've
    224     not installed <xref linkend="libtiff"/>.</para>
    225 
    226     <para><parameter>LIBS=-lz</parameter>: We use the LIBS variable to tell the
    227     linker (ld) to link against the system installed
    228     <application>zlib</application>.</para>
    229 
    230     <para><command>install -v -m644 base/*.h...</command>: Some packages
    231     (<application>ImageMagick</application> is one) need the
    232     <application>Ghostscript</application> interface headers in place to link
    233     to the shared library. These commands install the headers.</para>
    234 
    235     <para><command>ln -v -s ghostscript /usr/include/ps</command>: Some packages
    236     expect to find the interface headers in an alternate location.</para>
    237 
    238     <para><command>ln -sfv ../ghostscript-&gs-version;/doc ...</command>:
    239     This puts a symbolic link to the documentation where it is expected to be
    240     found.</para>
     244    <para>
     245      <command>rm -rf jasper lcms zlib</command>: The
     246      <application>Ghostscript</application> build system defaults to using its
     247      own version of <ulink url="http://www.openjpeg.org/">OpenJpeg</ulink> for
     248      JPEG 2000 files <!-- I can't get it to compile using a system installed
     249      version of openjpeg. It seems the ghostscript version has been heavily
     250      modified... --> so we can all remove the jasper source. The default color
     251      management system is now <application>lcms2</application> so the
     252      <application>lcms</application> source is not needed.
     253      <application>Zlib</application> was installed as part of LFS.
     254    </para>
     255
     256    <para>
     257      <option>--with-system-libtiff</option>: Remove this option if you've not
     258      installed <xref linkend="libtiff"/>.
     259    </para>
     260
     261    <para>
     262      <parameter>LIBS=-lz</parameter>: We use the LIBS variable to tell the
     263      linker (ld) to link against the system installed
     264      <application>zlib</application>.
     265    </para>
     266
     267    <para>
     268      <command>install -v -m644 base/*.h...</command>: Some packages
     269      (<application>ImageMagick</application> is one) need the
     270      <application>Ghostscript</application> interface headers in place to link
     271      to the shared library. These commands install the headers.
     272    </para>
     273
     274    <para>
     275      <command>ln -v -s ghostscript /usr/include/ps</command>: Some packages
     276      expect to find the interface headers in an alternate location.
     277    </para>
     278
     279    <para>
     280      <command>ln -sfv ../ghostscript-&gs-version;/doc ...</command>: This puts
     281      a symbolic link to the documentation where it is expected to be found.
     282    </para>
    241283  </sect2>
    242284
    … …  
    249291
    250292      <seglistitem>
    251         <seg>bdftops, dumphint, dvipdf, eps2eps, fixmswrd.pl, font2c, gs, gsbj,
    252         gsc (from soinstall), gsdj, gsdj500, gslj, gslp, gsnd, gsx
    253         (from soinstall), lprsetup.sh, pdf2dsc, pdf2ps, pdfopt,
    254         pf2afm, pfbtopfa, printafm, ps2ascii, ps2epsi, ps2pdf, ps2pdf12,
    255         ps2pdf13, ps2pdf14, ps2pdfwr, ps2ps, ps2ps2, pv.sh, unix-lpr.sh, and
    256         wftopfa</seg>
     293        <seg>
     294          bdftops, dumphint, dvipdf, eps2eps, fixmswrd.pl, font2c, gs, gsbj,
     295          gsc (from soinstall), gsdj, gsdj500, gslj, gslp, gsnd, gsx
     296          (from soinstall), lprsetup.sh, pdf2dsc, pdf2ps, pdfopt,
     297          pf2afm, pfbtopfa, printafm, ps2ascii, ps2epsi, ps2pdf, ps2pdf12,
     298          ps2pdf13, ps2pdf14, ps2pdfwr, ps2ps, ps2ps2, pv.sh, unix-lpr.sh, and
     299          wftopfa
     300        </seg>
    257301        <seg>libgs.so</seg>
    258         <seg>/usr/include/ghostscript, /usr/lib/ghostscript,
    259         /usr/share/ghostscript, and
    260         /usr/share/doc/ghostscript-&gs-version;</seg>
     302        <seg>
     303          /usr/include/ghostscript,
     304          /usr/lib/ghostscript,
     305          /usr/share/ghostscript and
     306          /usr/share/doc/ghostscript-&gs-version;
     307        </seg>
    261308      </seglistitem>
    262309    </segmentedlist>
    … …  
    270317        <term><command>gs</command></term>
    271318        <listitem>
    272           <para>is an interpreter for Adobe Systems' PostScript(tm) and Portable
    273           Document Format (PDF).</para>
     319          <para>
     320            is an interpreter for Adobe Systems' PostScript(tm) and Portable
     321            Document Format (PDF).
     322          </para>
    274323          <indexterm zone="gs gplgs-prog">
    275324            <primary sortas="b-gs">gs</primary>
    … …  
    281330        <term><filename class="libraryfile">libgs.so</filename></term>
    282331        <listitem>
    283           <para>provides <application>Ghostscript</application> functionality
    284           to other programs, such as <application>GSView</application>,
    285           <application>ImageMagick</application>, and
    286           <application>libspectre</application>.</para>
     332          <para>
     333            provides <application>Ghostscript</application> functionality to
     334            other programs, such as <application>GSView</application>,
     335            <application>ImageMagick</application>, and
     336            <application>libspectre</application>.
     337          </para>
    287338          <indexterm zone="gs libgs.so">
    288339            <primary sortas="c-libgs.so">libgs.so</primary>
    … …  
    292343   </variablelist>
    293344
    294    <para><application>GPL Ghostscript</application> provides many different
    295    scripts used to convert PostScript, PDF, and other formats. Please refer to
    296    the HTML documentation or the man pages for information about the
    297    capabilities provided.</para>
     345   <para>
     346     <application>GPL Ghostscript</application> provides many different
     347     scripts used to convert PostScript, PDF, and other formats. Please refer to
     348     the HTML documentation or the man pages for information about the
     349     capabilities provided.
     350    </para>
    298351  </sect2>
    299352</sect1>
Note: See TracChangeset for help on using the changeset viewer.