source: pst/printing/gs.xml@ 798c542

10.0 10.1 11.0 11.1 11.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 798c542 was 798c542, checked in by Pierre Labastie <pieere@…>, 5 years ago

Cosmetic changes to decrease the amount of manual editing needed in jhalfs

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@20085 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 <!-- When updating, ensure gs9xx is updated in url -->
8
9 <!ENTITY gs-download-http
10 "https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs923/ghostscript-&gs-version;.tar.gz">
11 <!ENTITY gs-download-ftp " ">
12 <!ENTITY gs-md5sum "5a47ab47cd22dec1eb5f51c06f1c9d9c">
13 <!ENTITY gs-size "42 MB">
14 <!ENTITY gs-buildsize "160 MB (with fonts and libgs.so)">
15 <!ENTITY gs-time "1.5 SBU (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 &lfs82_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<!--
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Required Patch: <ulink
80 url="&patch-root;/ghostscript-&gs-version;-security_fixes-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>
84-->
85 <para>If you wish, you can download additional fonts.</para>
86
87 <itemizedlist spacing="compact">
88 <title>Standard Fonts</title>
89 <listitem>
90 <para>Download (HTTP): <ulink url="&gs-standard-fonts-download;"/></para>
91 </listitem>
92 <listitem>
93 <para>Download MD5 sum: &gs-standard-fonts-md5sum;</para>
94 </listitem>
95 <listitem>
96 <para>Download size: &gs-standard-fonts-size;</para>
97 </listitem>
98 </itemizedlist>
99
100 <itemizedlist spacing="compact">
101 <title>Other Fonts</title>
102 <listitem>
103 <para>Download (HTTP): <ulink url="&gs-other-fonts-download;"/></para>
104 </listitem>
105 <listitem>
106 <para>Download MD5 sum: &gs-other-fonts-md5sum;</para>
107 </listitem>
108 <listitem>
109 <para>Download size: &gs-other-fonts-size;</para>
110 </listitem>
111 </itemizedlist>
112
113 <bridgehead renderas="sect3">Ghostscript Dependencies</bridgehead>
114
115 <bridgehead renderas="sect4">Recommended</bridgehead>
116 <para role="recommended">
117 <xref linkend="cups"/> (required for building the <quote>cups</quote>
118 device backend, which is needed by
119 <application>cups-filters</application>),
120 <xref linkend="fontconfig"/> (required, if you are installing any
121 suggested font),
122 <xref linkend="freetype2"/>,
123 <xref linkend="libjpeg"/>,
124 <xref linkend="libpng"/>,
125 <xref linkend="libtiff"/>, and
126 <xref linkend="lcms2"/>
127 </para>
128
129 <bridgehead renderas="sect4">Optional</bridgehead>
130 <para role="optional">
131 <xref linkend="cairo"/>,
132 <xref linkend="gtk3"/>,
133 <xref linkend="libidn"/>,
134 <xref linkend="libpaper"/>,
135 <xref linkend="lcms"/> (not used by default, nor if lcms2 is present or found), and
136 <xref linkend="x-window-system"/>
137 </para>
138
139 <para condition="html" role="usernotes">
140 User Notes: <ulink url="&blfs-wiki;/gs"/>
141 </para>
142 </sect2>
143
144 <sect2 role="installation">
145 <title>Installation of Ghostscript</title>
146
147 <note>
148 <para>
149 The <application>Ghostscript</application> build system is not
150 user-friendly. In order to use system copies of various graphics
151 libraries, you must do it using unconventional methods.
152 </para>
153 </note>
154
155 <para>
156 <application>GPL Ghostscript</application> includes (old) copies of
157 several libraries. Some of these seem to have been patched to fix known
158 vulnerabilities, but others of these copies are less-well maintained.
159 To ensure that any future fixes are applied throughout the whole system,
160 it is recommended that you first install the released versions of these
161 libraries and then configure <application>GPL Ghostscript</application>
162 to link to them.
163 </para>
164
165 <para>
166 If you have installed the recommended dependencies on your system,
167 remove the copies of
168 <application>freetype</application>, <application>lcms2</application>,
169 <application>libjpeg</application>, and <application>libpng</application>:
170 </para>
171
172<screen><userinput>rm -rf freetype lcms2 jpeg libpng</userinput></screen>
173
174 <para>Compile <application>Ghostscript</application>:</para>
175
176<screen><userinput>rm -rf zlib &amp;&amp;
177
178./configure --prefix=/usr \
179 --disable-compile-inits \
180 --enable-dynamic \
181 --with-system-libtiff &amp;&amp;
182make</userinput></screen>
183
184 <note>
185 <para>
186 The shared library depends on <xref linkend="gtk3"/>. It is only used by
187 external programs like <xref linkend="asymptote"/>, <xref
188 linkend="imagemagick"/>, and <xref linkend="texlive"/>.
189 </para>
190 </note>
191
192 <para>
193 To compile the shared library
194 <filename class="libraryfile">libgs.so</filename>, run the following
195 additional command as an unprivileged user:
196 </para>
197
198<screen><userinput>make so</userinput></screen>
199
200 <para>
201 This package does not come with a test suite. A set of example files
202 may be used for testing, but it is only possible after installation
203 of the package.
204 </para>
205
206 <para>
207 Now, as the <systemitem class="username">root</systemitem> user:
208 </para>
209
210<screen role="root"><userinput>make install</userinput></screen>
211
212 <para>If you want the shared library too:</para>
213
214<screen role="root"><userinput>make soinstall &amp;&amp;
215install -v -m644 base/*.h /usr/include/ghostscript &amp;&amp;
216ln -v -s ghostscript /usr/include/ps</userinput></screen>
217
218 <para>Now make the documentation accessible from the normal place:</para>
219
220<screen role="root"><userinput>ln -sfvn ../ghostscript/&gs-version;/doc /usr/share/doc/ghostscript-&gs-version;</userinput></screen>
221
222 <para>
223 If you have downloaded the fonts, unpack them to
224 <filename class="directory">/usr/share/ghostscript</filename> and ensure
225 the ownerships of the files are
226 <systemitem class="username">root</systemitem>:
227 <systemitem class="groupname">root</systemitem>.
228 </para>
229
230<screen role="root"><userinput>tar -xvf ../ghostscript-fonts-std-8.11.tar.gz -C /usr/share/ghostscript --no-same-owner &amp;&amp;
231tar -xvf ../gnu-gs-fonts-other-6.0.tar.gz -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.