source: pst/printing/gs.xml@ 54a5556

10.0 10.1 11.0 11.1 8.0 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 54a5556 was 54a5556, checked in by Ken Moffat <ken@…>, 5 years ago

libwww-perl-6.19, tags for remaining tex-source packages.

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

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