source: pst/printing/gs.xml@ 595e58e

10.0 10.1 11.0 11.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 595e58e was 595e58e, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to ghostscript-9.21.
Update to xfwm4-4.12.4.
Update to php-7.1.3.
Update to libpng-1.6.29.

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

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