source: pst/printing/gs.xml@ 63a0217

11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 63a0217 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 14 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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