source: pst/printing/gs.xml@ d83a70a

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since d83a70a was d83a70a, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Fix ghostscript package extention

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