source: pst/printing/gs.xml@ 2b7420b

10.1 11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 2b7420b was 2b7420b, checked in by Bruce Dubbs <bdubbs@…>, 7 months ago

Tag printer stack, window managers, and misc

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

  • Property mode set to 100644
File size: 13.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- When updating, ensure gs9xx is updated in url -->
8
9 <!ENTITY gs-download-http
10 "https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs&gs-packver;/ghostscript-&gs-version;.tar.xz">
11 <!ENTITY gs-download-ftp " ">
12 <!ENTITY gs-md5sum "bf0b41d6e19fdeb4b050afad309248d2">
13 <!ENTITY gs-size "39 MB">
14 <!ENTITY gs-buildsize "247 MB (with fonts and libgs.so)">
15 <!ENTITY gs-time "0.7 SBU (Using parallelism=4; with libgs.so)">
16
17 <!ENTITY gs-standard-fonts-download
18 "&sourceforge-dl;/gs-fonts/ghostscript-fonts-std-8.11.tar.gz">
19 <!ENTITY gs-standard-fonts-md5sum "6865682b095f8c4500c54b285ff05ef6">
20 <!ENTITY gs-standard-fonts-size "3.7 MB">
21
22 <!ENTITY gs-other-fonts-download
23 "&sourceforge-dl;/gs-fonts/gnu-gs-fonts-other-6.0.tar.gz">
24 <!ENTITY gs-other-fonts-md5sum "33457d3f37de7ef03d2eea05a9e6aa4f">
25 <!ENTITY gs-other-fonts-size "796 KB">
26]>
27
28<sect1 id="gs" xreflabel="ghostscript-&gs-version;">
29 <?dbhtml filename="gs.html"?>
30
31 <sect1info>
32 <othername>$LastChangedBy$</othername>
33 <date>$Date$</date>
34 </sect1info>
35
36 <title>ghostscript-&gs-version;</title>
37
38 <indexterm zone="gs">
39 <primary sortas="a-Ghostscript">Ghostscript</primary>
40 </indexterm>
41
42 <sect2 role="package">
43 <title>Introduction to Ghostscript</title>
44
45 <para>
46 <application>Ghostscript</application> is a versatile processor
47 for PostScript data with the ability to render PostScript to different
48 targets. It is a mandatory part of the cups printing stack.
49 </para>
50
51 &lfs101_checked;
52
53 <bridgehead renderas="sect3">Package Information</bridgehead>
54 <itemizedlist spacing="compact">
55 <listitem>
56 <para>
57 Download (HTTP): <ulink url="&gs-download-http;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download (FTP): <ulink url="&gs-download-ftp;"/>
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download MD5 sum: &gs-md5sum;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Download size: &gs-size;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated disk space required: &gs-buildsize;
78 </para>
79 </listitem>
80 <listitem>
81 <para>
82 Estimated build time: &gs-time;
83 </para>
84 </listitem>
85 </itemizedlist>
86
87 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
88 <itemizedlist spacing="compact">
89 <listitem>
90 <para>
91 Required patch:
92 <ulink url="&patch-root;/ghostscript-&gs-version;-freetype_fix-1.patch"/>
93 </para>
94 </listitem>
95 </itemizedlist>
96
97 <para>
98 If you wish, you can download additional fonts.
99 </para>
100
101 <itemizedlist spacing="compact">
102 <title>Standard Fonts</title>
103 <listitem>
104 <para>
105 Download (HTTP): <ulink url="&gs-standard-fonts-download;"/>
106 </para>
107 </listitem>
108 <listitem>
109 <para>
110 Download MD5 sum: &gs-standard-fonts-md5sum;
111 </para>
112 </listitem>
113 <listitem>
114 <para>
115 Download size: &gs-standard-fonts-size;
116 </para>
117 </listitem>
118 </itemizedlist>
119
120 <itemizedlist spacing="compact">
121 <title>Other Fonts</title>
122 <listitem>
123 <para>
124 Download (HTTP): <ulink url="&gs-other-fonts-download;"/>
125 </para>
126 </listitem>
127 <listitem>
128 <para>
129 Download MD5 sum: &gs-other-fonts-md5sum;
130 </para>
131 </listitem>
132 <listitem>
133 <para>
134 Download size: &gs-other-fonts-size;
135 </para>
136 </listitem>
137 </itemizedlist>
138
139 <bridgehead renderas="sect3">Ghostscript Dependencies</bridgehead>
140
141 <bridgehead renderas="sect4">Recommended</bridgehead>
142 <para role="recommended">
143 <xref linkend="cups"/> (required for building the <quote>cups</quote>
144 device backend, which is needed by
145 <application>cups-filters</application>),
146 <xref linkend="fontconfig"/> (required, if you are installing any
147 suggested font),
148 <xref linkend="freetype2"/>,
149 <xref linkend="libjpeg"/>,
150 <xref linkend="libpng"/>,
151 <xref linkend="libtiff"/>, and
152 <xref linkend="openjpeg2"/>
153 </para>
154
155 <bridgehead renderas="sect4">Optional</bridgehead>
156 <para role="optional">
157 <xref linkend="cairo"/>,
158 <xref linkend="gtk3"/>,
159 <xref linkend="libidn"/>,
160 <xref linkend="libpaper"/>, and
161 <xref linkend="x-window-system"/>
162 </para>
163
164 <para condition="html" role="usernotes">
165 User Notes: <ulink url="&blfs-wiki;/gs"/>
166 </para>
167 </sect2>
168
169 <sect2 role="installation">
170 <title>Installation of Ghostscript</title>
171
172 <note>
173 <para>
174 The <application>Ghostscript</application> build system is not
175 user-friendly. In order to use system copies of various graphics
176 libraries, you must do it using unconventional methods.
177 </para>
178 </note>
179
180 <para>
181 <application>Ghostscript</application> includes (old) copies of
182 several libraries. Some of these seem to have been patched to fix known
183 vulnerabilities, but others of these copies are less-well maintained.
184 To ensure that any future fixes are applied throughout the whole system,
185 it is recommended that you first install the released versions of these
186 libraries and then configure <application>Ghostscript</application>
187 to link to them.
188 </para>
189
190 <para>
191 If you have installed the recommended dependencies on your system,
192 remove the copies of
193 <application>freetype</application>, <application>lcms2</application>,
194 <application>libjpeg</application>, <application>libpng</application>,
195 and <application>openjpeg</application>:
196 </para>
197
198<screen><userinput>rm -rf freetype lcms2mt jpeg libpng openjpeg</userinput></screen>
199
200 <para>
201 Apply a patch to fix a problem introduced by changes in freetype-2.10.3:
202 </para>
203
204<screen><userinput remap="pre">patch -Np1 -i ../ghostscript-&gs-version;-freetype_fix-1.patch</userinput></screen>
205
206 <para>
207 Compile <application>Ghostscript</application>:
208 </para>
209
210<screen><userinput>rm -rf zlib &amp;&amp;
211
212./configure --prefix=/usr \
213 --disable-compile-inits \
214 --enable-dynamic \
215 --with-system-libtiff &amp;&amp;
216make</userinput></screen>
217
218 <note>
219 <para>
220 The shared library depends on <xref linkend="gtk3"/>. It is only used by
221 external programs like <xref linkend="asymptote"/>, <xref
222 linkend="dvisvgm"/>, <xref linkend="imagemagick"/>, and <xref
223 linkend="texlive"/>.
224 </para>
225 </note>
226
227 <para>
228 To compile the shared library
229 <filename class="libraryfile">libgs.so</filename>, run the following
230 additional command as an unprivileged user:
231 </para>
232
233<screen><userinput>make so</userinput></screen>
234
235 <para>
236 This package does not come with a test suite. A set of example files
237 may be used for testing, but it is only possible after installation
238 of the package.
239 </para>
240
241 <para>
242 Now, as the <systemitem class="username">root</systemitem> user:
243 </para>
244
245<screen role="root"><userinput>make install</userinput></screen>
246
247 <para>
248 If you want the shared library too:
249 </para>
250
251<screen role="root"><userinput>make soinstall &amp;&amp;
252install -v -m644 base/*.h /usr/include/ghostscript &amp;&amp;
253ln -sfvn ghostscript /usr/include/ps</userinput></screen>
254
255 <para>
256 Now make the documentation accessible from the normal place:
257 </para>
258<!-- Starting with 9.23, the install does not seem to copy the examples any more -->
259
260<screen role="root"><userinput>mv -v /usr/share/doc/ghostscript/&gs-version; /usr/share/doc/ghostscript-&gs-version; &amp;&amp;
261rm -rfv /usr/share/doc/ghostscript &amp;&amp;
262cp -r examples/ /usr/share/ghostscript/&gs-version;/</userinput></screen>
263
264 <para>
265 If you have downloaded the fonts, unpack them to
266 <filename class="directory">/usr/share/ghostscript</filename> and ensure
267 the ownerships of the files are
268 <systemitem class="username">root</systemitem>:
269 <systemitem class="groupname">root</systemitem>.
270 </para>
271
272<screen role="root"><userinput>tar -xvf ../ghostscript-fonts-std-8.11.tar.gz -C /usr/share/ghostscript --no-same-owner &amp;&amp;
273tar -xvf ../gnu-gs-fonts-other-6.0.tar.gz -C /usr/share/ghostscript --no-same-owner &amp;&amp;
274fc-cache -v /usr/share/ghostscript/fonts/</userinput></screen>
275
276 <para>
277 You can now test the rendering of various postscript and pdf files from the
278 <filename class="directory">/usr/share/ghostscript/&gs-version;/examples
279 </filename>, for example (you need an X window system display):
280 </para>
281
282<screen remap="test"><userinput>gs -q -dBATCH /usr/share/ghostscript/&gs-version;/examples/tiger.eps</userinput></screen>
283
284 </sect2>
285
286 <sect2 role="commands">
287 <title>Command Explanations</title>
288
289 <para>
290 <command>rm -rf zlib </command>: <application>zlib</application>
291 was installed as part of LFS.
292 </para>
293
294 <para>
295 <parameter>--disable-compile-inits</parameter>: This option makes
296 <command>gs</command> and <filename>libgs.so</filename> slightly smaller.
297 </para>
298
299 <para>
300 <parameter>--with-system-libtiff</parameter>: Remove this option if
301 you've not installed <xref linkend="libtiff"/>.
302 </para>
303
304 <para>
305 <command>install -v -m644 base/*.h... </command>: Some packages
306 (<application>ImageMagick</application> is one) need the
307 <application>Ghostscript</application> interface headers in place to link
308 to the shared library. These commands install the headers.
309 </para>
310
311 <para>
312 <command>ln -sfvn ghostscript /usr/include/ps</command>: Some packages
313 expect to find the interface headers in an alternate location.
314 </para>
315
316 <para>
317 <command>mv -v /usr/share/doc/ghostscript/&gs-version;
318 /usr/share/doc/ghostscript-&gs-version;</command>: This moves the
319 documentation where it is expected to be found.
320 </para>
321
322 <para>
323 <option>--disable-cups</option>: this option will save a tiny amount of
324 space by not linking <command>gs</command> and <filename>libgs.so</filename>
325 to the <xref linkend="cups"/> libraries if you have installed those.
326 </para>
327 </sect2>
328
329 <sect2 role="content">
330 <title>Contents</title>
331 <segmentedlist>
332 <segtitle>Installed Programs</segtitle>
333 <segtitle>Installed Library</segtitle>
334 <segtitle>Installed Directories</segtitle>
335
336 <seglistitem>
337 <seg>
338 dvipdf, eps2eps, gs, gsbj, gsc (from soinstall), gsdj,
339 gsdj500, gslj, gslp, gsnd, gsx (from soinstall), lprsetup.sh,
340 pdf2dsc, pdf2ps, pf2afm, pfbtopfa, pphs, printafm, ps2ascii,
341 ps2epsi, ps2pdf, ps2pdf12, ps2pdf13, ps2pdf14, ps2pdfwr,
342 ps2ps, ps2ps2, and unix-lpr.sh
343 <!-- I don't see bdftops,fixmswrd.pl or pv.sh on my builds [ I don't
344 have any bdf tools from xorg ] but they are still referenced in
345 base/unixinst.mak -->
346 </seg>
347 <seg>libgs.so and
348 /usr/lib/ghostscript/&gs-version;/X11.so</seg>
349 <seg>
350 /usr/include/ghostscript,
351 /usr/lib/ghostscript,
352 /usr/share/ghostscript, and
353 /usr/share/doc/ghostscript-&gs-version;
354 </seg>
355 </seglistitem>
356 </segmentedlist>
357
358 <variablelist>
359 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
360 <?dbfo list-presentation="list"?>
361 <?dbhtml list-presentation="table"?>
362
363 <varlistentry id="gplgs-prog">
364 <term><command>gs</command></term>
365 <listitem>
366 <para>
367 is an interpreter for Adobe Systems' PostScript(tm) and Portable
368 Document Format (PDF)
369 </para>
370 <indexterm zone="gs gplgs-prog">
371 <primary sortas="b-gs">gs</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="libgs.so">
377 <term><filename class="libraryfile">libgs.so</filename></term>
378 <listitem>
379 <para>
380 provides <application>Ghostscript</application> functionality to
381 other programs, such as <application>GSView</application>,
382 <application>ImageMagick</application>, and
383 <application>libspectre</application>
384 </para>
385 <indexterm zone="gs libgs.so">
386 <primary sortas="c-libgs.so">libgs.so</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390 </variablelist>
391
392 <para>
393 <application>Ghostscript</application> provides many different
394 scripts used to convert PostScript, PDF, and other formats. Please refer to
395 the HTML documentation or the man pages for information about the
396 capabilities provided.
397 </para>
398 </sect2>
399
400</sect1>
Note: See TracBrowser for help on using the repository browser.