source: pst/printing/gs.xml@ 27cc55e9

11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 27cc55e9 was 27cc55e9, checked in by Douglas R. Reno <renodr@…>, 15 months ago

Package updates:

Update to seamonkey-2.53.9.1
Update to thunderbird-91.2.1
Update to ghostscript-9.55.0

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