source: pst/printing/gs.xml@ 237d47f

krejzi/svn
Last change on this file since 237d47f was fde7a06, checked in by Krejzi <krejzi@…>, 10 years ago

Printing section.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/krejzi@14794 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 12.4 KB
RevLine 
[ed30f09]1<?xml version="1.0" encoding="ISO-8859-1"?>
[6732c094]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[73ddd1a0]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
[00b6675]6
[6b58d592]7 <!ENTITY gs-download-http
8 "http://downloads.ghostscript.com/public/ghostscript-&gs-version;.tar.bz2">
[de109d93]9 <!ENTITY gs-download-ftp " ">
[a3e2a06d]10 <!ENTITY gs-md5sum "0ee21d975c67a4883ba66bcc332418f5">
11 <!ENTITY gs-size "27 MB">
[95b8c6d]12 <!ENTITY gs-buildsize
[a3e2a06d]13 "217 MB (includes installing libgs.so, add 5 MB if the fonts are installed)">
[95b8c6d]14 <!ENTITY gs-time
[a3e2a06d]15 "2.5 SBU (includes building and installing libgs.so)">
[100786d]16
[95b8c6d]17 <!ENTITY gs-standard-fonts-download
18 "&sourceforge-repo;/gs-fonts/ghostscript-fonts-std-8.11.tar.gz">
[00b6675]19 <!ENTITY gs-standard-fonts-md5sum "6865682b095f8c4500c54b285ff05ef6">
[100786d]20 <!ENTITY gs-standard-fonts-size "3.7 MB">
[00b6675]21
[95b8c6d]22 <!ENTITY gs-other-fonts-download
23 "&sourceforge-repo;/gs-fonts/gnu-gs-fonts-other-6.0.tar.gz">
[100786d]24 <!ENTITY gs-other-fonts-md5sum "33457d3f37de7ef03d2eea05a9e6aa4f">
25 <!ENTITY gs-other-fonts-size "796 KB">
[73ddd1a0]26]>
27
[a027d7d3]28<sect1 id="gs" xreflabel="ghostscript-&gs-version;">
[ed30f09]29 <?dbhtml filename="gs.html"?>
30
31 <sect1info>
32 <othername>$LastChangedBy$</othername>
33 <date>$Date$</date>
34 </sect1info>
35
[a027d7d3]36 <title>ghostscript-&gs-version;</title>
[ed30f09]37
38 <indexterm zone="gs">
[aa8ef3bc]39 <primary sortas="a-GPL-Ghostscript">GPL Ghostscript</primary>
[ed30f09]40 </indexterm>
41
42 <sect2 role="package">
43 <title>Introduction to Ghostscript</title>
44
45 <para><application>Ghostscript</application> is a versatile processor
46 for PostScript data with the ability to render PostScript to different
[933ceec]47 targets. It used to be part of the cups printing stack, but is no longer
48 used for that.</para>
[ed30f09]49
[8c1b9f7]50 &lfs76_checked;
[aa8ef3bc]51
[ed30f09]52 <bridgehead renderas="sect3">Package Information</bridgehead>
53 <itemizedlist spacing="compact">
54 <listitem>
55 <para>Download (HTTP): <ulink url="&gs-download-http;"/></para>
56 </listitem>
57 <listitem>
58 <para>Download (FTP): <ulink url="&gs-download-ftp;"/></para>
59 </listitem>
60 <listitem>
61 <para>Download MD5 sum: &gs-md5sum;</para>
62 </listitem>
63 <listitem>
64 <para>Download size: &gs-size;</para>
65 </listitem>
66 <listitem>
67 <para>Estimated disk space required: &gs-buildsize;</para>
68 </listitem>
69 <listitem>
70 <para>Estimated build time: &gs-time;</para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
75
[933ceec]76 <para>If you wish, you can download additional fonts.</para>
77
[6b58d592]78 <itemizedlist spacing="compact">
[ed30f09]79 <title>Standard Fonts</title>
80 <listitem>
[fde7a06]81 <para>Download (FTP): <ulink url="&gs-standard-fonts-download;"/></para>
[ed30f09]82 </listitem>
83 <listitem>
84 <para>Download MD5 sum: &gs-standard-fonts-md5sum;</para>
85 </listitem>
86 <listitem>
87 <para>Download size: &gs-standard-fonts-size;</para>
88 </listitem>
89 </itemizedlist>
90
[6b58d592]91 <itemizedlist spacing="compact">
[ed30f09]92 <title>Other Fonts</title>
93 <listitem>
94 <para>Download (HTTP): <ulink url="&gs-other-fonts-download;"/></para>
95 </listitem>
96 <listitem>
97 <para>Download MD5 sum: &gs-other-fonts-md5sum;</para>
98 </listitem>
99 <listitem>
100 <para>Download size: &gs-other-fonts-size;</para>
101 </listitem>
102 </itemizedlist>
103
[b29ed97c]104 <bridgehead renderas="sect3">Ghostscript Dependencies</bridgehead>
[ed30f09]105
[de109d93]106 <bridgehead renderas="sect4">Recommended</bridgehead>
[2d37d32]107 <para role="recommended">
108 <xref linkend="freetype2"/>,
109 <xref linkend="libjpeg"/>,
[933ceec]110 <xref linkend="libpng"/>,
[1df1b16]111 <xref linkend="libtiff"/>, and
112 <xref linkend="lcms2"/>
[2d37d32]113 </para>
[de109d93]114
115 <bridgehead renderas="sect4">Optional</bridgehead>
[2d37d32]116 <para role="optional">
117 <xref linkend="cairo"/>,
[1ecdb18]118 <xref linkend="cups"/>,
[142f958b]119 <xref linkend="fontconfig"/> (required, if you are installing any
120 suggested font),
[2d37d32]121 <xref linkend="gtk2"/>,
[fde7a06]122 <xref linkend="lcms"/> (not used by default, nor if lcms2 is present or found),
[2d37d32]123 <xref linkend="libidn"/>,
[fde7a06]124 <xref linkend="libpaper"/>, and
[1ecdb18]125 <xref linkend="x-window-system"/>
[2d37d32]126 </para>
127
128 <para condition="html" role="usernotes">
129 User Notes: <ulink url="&blfs-wiki;/gs"/>
130 </para>
[ed30f09]131 </sect2>
132
133 <sect2 role="installation">
134 <title>Installation of Ghostscript</title>
135
[2d37d32]136 <note>
137 <para>
138 The <application>Ghostscript</application> build system is not
139 user-friendly. In order to use system copies of various graphics
140 libraries, you must do it using unconventional methods.
141 </para>
142 </note>
[100786d]143
[2d37d32]144 <para>
145 <application>GPL Ghostscript</application> includes (old) copies of
[de109d93]146 several libraries. Some of these seem to have been patched to fix known
147 vulnerabilities, but others of these copies are less-well maintained.
148 To ensure that any future fixes are applied throughout the whole system,
[2d37d32]149 it is recommended that you first install the released versions of these
[d453af5]150 libraries and then configure <application>GPL Ghostscript</application>
[2d37d32]151 to link to them.
152 </para>
[d453af5]153
[2d37d32]154 <para>
155 If you have installed these dependencies on your system, remove the
[d453af5]156 copies of <application>expat</application>,
[1df1b16]157 <application>freetype</application>, <application>lcms2</application>,
[fde7a06]158 <application>libjpeg</application>, <application>libpng</application>
159 and <application>zlib</application>:
[2d37d32]160 </para>
[ed30f09]161
[81f0120]162<screen><userinput>sed -i 's/ZLIBDIR=src/ZLIBDIR=$includedir/' configure.ac configure &amp;&amp;
[fde7a06]163rm -rf expat freetype lcms2 jpeg libpng zlib</userinput></screen>
[81f0120]164<!--
[6b58d592]165 <note>
[2d37d32]166 <para>
167 If you have a multicore computer and try to run make with multiple
168 jobs (eg, make -j4) then the build may fail due to race conditions in
169 the <application>Ghostscript</application> build system. You can work
170 around that problem by simply running make again (eg,
[defe82d]171 <command>make -j4 || make -j1</command>).
[2d37d32]172 </para>
[81f0120]173 </note>-->
[2d37d32]174
[6b58d592]175 <para>Compile <application>Ghostscript</application>:</para>
[de109d93]176
[fde7a06]177<screen><userinput>./configure --prefix=/usr \
178 --disable-compile-inits \
179 --enable-dynamic \
180 --with-system-libtiff &amp;&amp;
[038ea6ba]181make</userinput></screen>
182
[d453af5]183 <note>
[2d37d32]184 <para>
185 The shared library depends on <xref linkend="gtk2"/>. It is only used in
186 external programs like <xref linkend="imagemagick"/>.
187 </para>
[d453af5]188 </note>
[038ea6ba]189
[2d37d32]190 <para>
191 To compile the shared library
192 <filename class="libraryfile">libgs.so</filename>, run the following
193 additional command as an unprivileged user:
194 </para>
[038ea6ba]195
196<screen><userinput>make so</userinput></screen>
[73ddd1a0]197
[2d37d32]198 <para>
199 This package does not come with a test suite. However, you may test the
200 operation of the newly built <command>gs</command> program by issuing the
[365e27c9]201 following command (issue from an X Window System terminal):
[2d37d32]202 </para>
[d453af5]203
[933ceec]204<screen><userinput>bin/gs -Ilib -IResource/Init -dBATCH examples/tiger.eps</userinput></screen>
[d453af5]205
[2d37d32]206 <para>
207 Now, as the <systemitem class="username">root</systemitem> user:
208 </para>
[038ea6ba]209
[d453af5]210<screen role="root"><userinput>make install</userinput></screen>
211
212 <para>If you want the shared library too:</para>
213
[fde7a06]214<screen role="root"><userinput>make soinstall<!-- &amp;&amp;
[aa8ef3bc]215install -v -m644 base/*.h /usr/include/ghostscript &amp;&amp;
[fde7a06]216ln -v -s ghostscript /usr/include/ps--></userinput></screen>
[73ddd1a0]217
[933ceec]218 <para>Now make the documentation accessible from the normal place:</para>
[d453af5]219
[6b58d592]220<screen role="root"><userinput>ln -sfv ../ghostscript/&gs-version;/doc /usr/share/doc/ghostscript-&gs-version;</userinput></screen>
[73ddd1a0]221
[2d37d32]222 <para>
[933ceec]223 If you have downloaded any fonts, unpack them to
[2d37d32]224 <filename class="directory">/usr/share/ghostscript</filename> and ensure
225 the ownerships of the files are
226 <systemitem class="username">root</systemitem>:
227 <systemitem class="groupname">root</systemitem>. Substitute
228 <replaceable>&lt;font-tarball&gt;</replaceable> appropriately in the
229 command below for the fonts you wish to install:
230 </para>
[038ea6ba]231
[142f958b]232<screen role="root"><userinput>tar -xvf ../<replaceable>&lt;font-tarball&gt;</replaceable> -C /usr/share/ghostscript --no-same-owner &amp;&amp;
233fc-cache -v /usr/share/ghostscript/fonts/</userinput></screen>
[ed30f09]234 </sect2>
[73ddd1a0]235
[2ddf71a5]236 <sect2 role="commands">
237 <title>Command Explanations</title>
238
[81f0120]239 <para>
240 <command>sed -i 's/ZLIBDIR=src/ZLIBDIR=$includedir/' ... </command>:
[fde7a06]241 Fixes building with system <application>Zlib</application>.
[81f0120]242 </para>
243
[fde7a06]244 <!-- <para>
[933ceec]245 <command>rm -rf zlib</command>:
246 <application>zlib</application> was installed as part of LFS.
[fde7a06]247 </para> -->
[2d37d32]248
249 <para>
[2bb5c32]250 <parameter>--disable-compile-inits</parameter>: This option makes
[933ceec]251 <command>gs</command> and <filename>libgs.so</filename> slightly smaller.
[2d37d32]252 </para>
253
254 <para>
[142f958b]255 <parameter>--with-system-libtiff</parameter>: Remove this option if
256 you've not installed <xref linkend="libtiff"/>.
[2d37d32]257 </para>
258
[fde7a06]259 <!-- <para> Nothing needs these. The ones installed by soinstall are sufficient.
[81f0120]260 <command>install -v -m644 base/*.h... </command>: Some packages
[2d37d32]261 (<application>ImageMagick</application> is one) need the
262 <application>Ghostscript</application> interface headers in place to link
263 to the shared library. These commands install the headers.
264 </para>
265
[fde7a06]266 <para> Haven't found anything that needs this
[2d37d32]267 <command>ln -v -s ghostscript /usr/include/ps</command>: Some packages
268 expect to find the interface headers in an alternate location.
[fde7a06]269 </para> -->
[2d37d32]270
271 <para>
[81f0120]272 <command>ln -sfv ../ghostscript-&gs-version;/doc ... </command>: This puts
[2d37d32]273 a symbolic link to the documentation where it is expected to be found.
274 </para>
[933ceec]275
276 <para>
277 <option>--disable-cups</option>: this option will save a tiny amount of
278 space by not linking <command>gs</command> and <filename>libgs.so</filename>
279 to the <xref linkend="cups"/> libraries if you have installed those.
280 </para>
[fde7a06]281
[2ddf71a5]282 </sect2>
283
[ed30f09]284 <sect2 role="content">
285 <title>Contents</title>
[038ea6ba]286 <segmentedlist>
287 <segtitle>Installed Programs</segtitle>
288 <segtitle>Installed Library</segtitle>
289 <segtitle>Installed Directories</segtitle>
290
291 <seglistitem>
[2d37d32]292 <seg>
[81f0120]293 dvipdf, eps2eps, font2c, gs, gsbj, gsc (from soinstall), gsdj,
294 gsdj500, gslj, gslp, gsnd, gsx (from soinstall), lprsetup.sh,
295 pdf2dsc, pdf2ps, pf2afm, pfbtopfa, pphs, printafm, ps2ascii,
296 ps2epsi, ps2pdf, ps2pdf12, ps2pdf13, ps2pdf14, ps2pdfwr,
297 ps2ps, ps2ps2, unix-lpr.sh, and wftopfa
[933ceec]298 <!-- I don't see bdftops,fixmswrd.pl or pv.sh on my builds [ I don't
299 have any bdf tools from xorg ] but they are still referenced in
300 base/unixinst.mak -->
[2d37d32]301 </seg>
[81f0120]302 <seg>libgs.so and
303 /usr/lib/ghostscript/&gs-version;/X11.so</seg>
[2d37d32]304 <seg>
305 /usr/include/ghostscript,
306 /usr/lib/ghostscript,
[019052a1]307 /usr/share/ghostscript, and
[2d37d32]308 /usr/share/doc/ghostscript-&gs-version;
309 </seg>
[038ea6ba]310 </seglistitem>
311 </segmentedlist>
312
313 <variablelist>
314 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
315 <?dbfo list-presentation="list"?>
316 <?dbhtml list-presentation="table"?>
317
[d891148c]318 <varlistentry id="gplgs-prog">
[038ea6ba]319 <term><command>gs</command></term>
320 <listitem>
[2d37d32]321 <para>
322 is an interpreter for Adobe Systems' PostScript(tm) and Portable
323 Document Format (PDF).
324 </para>
[d891148c]325 <indexterm zone="gs gplgs-prog">
[038ea6ba]326 <primary sortas="b-gs">gs</primary>
327 </indexterm>
328 </listitem>
329 </varlistentry>
330
[d891148c]331 <varlistentry id="libgs.so">
332 <term><filename class="libraryfile">libgs.so</filename></term>
333 <listitem>
[2d37d32]334 <para>
335 provides <application>Ghostscript</application> functionality to
336 other programs, such as <application>GSView</application>,
337 <application>ImageMagick</application>, and
338 <application>libspectre</application>.
339 </para>
[d891148c]340 <indexterm zone="gs libgs.so">
341 <primary sortas="c-libgs.so">libgs.so</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
[038ea6ba]345 </variablelist>
346
[2d37d32]347 <para>
348 <application>GPL Ghostscript</application> provides many different
349 scripts used to convert PostScript, PDF, and other formats. Please refer to
350 the HTML documentation or the man pages for information about the
351 capabilities provided.
352 </para>
[ed30f09]353 </sect2>
[cabb2de]354</sect1>
Note: See TracBrowser for help on using the repository browser.