source: pst/printing/gs.xml@ 020b21d

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

Update to nghttp2-1.34.0.
Update to x265-2.9.
Update to liblinear-221.
Update to ghostscript-9.25.

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

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