1
Overview of Ghostscript
3
This document is a roadmap to the Ghostscript documentation. After
4
looking through it, if you want to install Ghostscript and not only use
5
it, we recommend you read how to install Ghostscript, and how to
6
compile Ghostscript from source code (which is necessary before
7
installing it on Unix and VMS systems).
8
__________________________________________________________________
12
* Document roadmap by theme
13
+ What should I read if I'm a new user?
14
+ GPL Ghostscript and commerical Ghostscript
15
+ Before building Ghostscript
16
+ What should I read if I'm not a new user?
17
+ What if I'm a developer?
18
+ What if I'm writing documentation?
19
* Presence on the World Wide Web
20
+ Ghostscript's home pages
21
+ Adobe PostScript, Encapsulated PostScript, and PDF reference
23
+ Other material on the WWW
24
* Which document contains what?
25
+ Primarily for users:
38
+ For both users and developers:
52
+ Primarily for developers:
68
__________________________________________________________________
70
Document roadmap by theme
72
What should I read if I'm a new user?
74
* how to use Ghostscript. This includes both a quickstart
75
introduction to the commandline version and more extensive
77
* detailed information about specific devices that Ghostscript can
79
* more detailed information about how to use Ghostscript under Unix
80
with lpr as a filter for printing
81
* for information about known problems or to report a new one, please
82
visit bugs.ghostscript.com but remember that free versions of
83
Ghostscript come with with NO WARRANTY and NO SUPPORT
85
GPL and commercial Ghostscript
87
GPL Ghostscript, Artifex Ghostscript and AFPL Ghostscript are different
89
* additional information about GPL Ghostscript releases that is not
90
relevant to commercial versions.
92
If you run into any questions, or if you are going to be using
93
Ghostscript extensively, you should at least skim, and probably
95
* about the fonts distributed with Ghostscript, including how to add
97
* a description of the Ghostscript language, and its differences from
98
the documented PostScript language
99
* about the postscript files distributed with Ghostscript (other than
102
Before building Ghostscript
104
If you are going to compile Ghostscript from source, rather than just
105
use an executable you got from somewhere, you may want to read:
106
* how to build Ghostscript and install it
107
__________________________________________________________________
109
What should I read if I'm not a new user?
111
If you have already used Ghostscript, when you receive a new release
112
you should begin by reading this file, then
113
* News.htm, for incompatible changes and new features in the current
115
* if you wish, Changes.htm, for a detailed list of changes in the
117
* if you wish, History#.htm (currently History8.htm), for changes in
119
__________________________________________________________________
121
What if I'm a developer?
123
If you are going to do any development on or with Ghostscript at all,
124
you should at least look at
125
* the roadmap documentation for Ghostscript's source files and
128
If you are going to write a new driver for Ghostscript, you should read
129
* the guide to the Ghostscript source code
130
* the interface between Ghostscript and device drivers
131
* about the external font interface between Ghostscript and
132
platform-supplied fonts
134
If you are considering distributing GPL Ghostscript in conjunction with
135
a commercial product, you should read the license carefully, and you
137
* additional clarification of the circumstances under which
138
Ghostscript can be distributed with a commercial product
140
If you intend to use Ghostscript in the form of a dynamic link library
141
(DLL) under OS/2 or Microsoft Windows or in the form of shared object
143
* documentation on Ghostscript Interpreter API
145
If you want to use Ghostscript as part of another program--as a
146
callable PostScript language interpreter--and not as a DLL or as a
147
self-contained executable application, you should begin by reading
148
* the source file imain.h, the documented API for Ghostscript not as
151
or if you are going to use only the Ghostscript graphics library,
152
* about the structure of the Ghostscript library and its interfaces
153
__________________________________________________________________
155
What if I'm writing documentation?
157
If you are editing or adding to Ghostscript's existing documentation in
158
HTML format, or writing a new document, you should read
159
* the coding and style guidelines for Ghostscript's HTML-based
161
__________________________________________________________________
163
Presence on the World Wide Web
165
Ghostscript's home page
167
Ghostscript has a home page on the World Wide Web with helpful
168
information such as the FAQ (Frequently Asked Questions) and a list of
169
known problems and workarounds for the current GPL Ghostscript release
170
(in the "Obtaining" file for that release):
172
http://www.cs.wisc.edu/~ghost/
174
More material about Ghostscript can be found at
176
http://www.ghostscript.com/
178
Adobe PostScript, Encapsulated PostScript, and PDF reference documentation
180
Adobe makes a wealth of technical documentation available over the Web,
181
including the PostScript Language Reference Manual (Third Edition); the
182
Encapsulated PostScript (EPS) Format Specification version 3, including
183
Encapsulated PostScript Interchange (EPSI) format; the PDF Reference
184
manuals. The Acrobat SDK contains pdfmark and Acrobat Distiller
185
parameters documentation. Some of these documents are also available at
186
Adobe's ftp site, but not necessarily under the same filenames.
188
Other material on the WWW
190
Much other material about Ghostscript is available on the World Wide
191
Web, both as web pages and as archived Usenet and mailing list
192
discussions. Use the well-known search engines to find such material.
194
There is a translation of the Ghostscript 'man' pages into Czech at:
196
http://www.volny.cz/rebus/ghostscript/
197
__________________________________________________________________
199
Which document contains what?
201
Here is the list in alphabetic order of Ghostscript documentation, with
202
explanations of the contents.
205
On MS-Windows and OS/2, Ghostscript is compiled as a dynamic
206
link library (DLL). On Linux, Ghostscript can be compiled as a
207
shared object. This describes how to use it. For developers.
210
Guidelines and style for C coding, which you should follow if,
211
for example, you write a new driver or add or change something
212
in Ghostscript. For developers.
215
A detailed list of all code changes in the current release or
216
pre-release, generated mechanically from the CVS logs. For
220
The conditions under which Ghostscript may be distributed in a
221
commercial context. See also the GNU General Public License.
224
On OS/2, MS Windows-16 and MS Windows-32 platforms, Ghostscript
225
is compiled as a dynamic link library (DLL). This describes how
226
to use it. For developers. This DLL interface is obsolete. Use
230
Code orientation for developers. Contains a detailed breakdown
231
of the source files by functional group, and overviews of the
232
major architectural features and services.
235
Documention for deprecated devices and features. Features
236
described here will be removed in future versions of
240
Detailed information about some specific devices for which
241
Ghostscript can produce output. Run "gs -h" to see which devices
242
a particular version of Ghostscript is built to use.
245
Describes the interface between Ghostscript and device drivers.
246
If you do this, you should also read and use the C style and
247
coding guidelines. Necessary to develop a new driver. For
251
All about fonts freely available for Ghostscript, and how to add
252
and use new fonts. Also describes how to use Ghostscript fonts
253
as X Windows fonts. For both users and developers.
256
A note of thanks to people who have helped in the development of
260
Part 1 of the five-part original Usenet distribution of the free
261
Hershey fonts, giving the terms of use and describing their
265
The history of changes in all Ghostscript releases:
267
History8.htm for Ghostscript versions 8.n
268
History7.htm for Ghostscript versions 7.n
269
History6.htm for Ghostscript versions 6.n
270
History5.htm for Ghostscript versions 5.n
271
History4.htm for Ghostscript versions 4.n
272
History3.htm for Ghostscript versions 3.n
273
History2.htm for Ghostscript versions 2.n
274
History1.htm for Ghostscript versions 1.n
277
The guidelines and style for HTML coding of Ghostscript's
278
documentation, which you should follow if, for example, you
279
change existing HTML documentation or write new documents. For
283
Another Ghostscript interpreter.
286
How to install Ghostscript. See also how to build it.
289
A list of outstanding open issues in Ghostscript. These include
290
known limitations, minor bugs, performance issues, differences
291
from Adobe implementations, and others.
294
The relationship between the Ghostscript interpreter and the
295
PostScript language as defined by Adobe.
298
A description of the Ghostscript library, a set of procedures to
299
implement the graphics and filtering capabilities that are
300
primitive operations in the PostScript language and in Adobe
301
Portable Document Format (PDF). For developers.
304
How to build Ghostscript executables from the source code. See
305
also how to install it. It's not necessary to be a highly
306
experienced developer to build or install Ghostscript, but some
307
experience is needed.
310
A brief description of the latest release or pre-release of
311
Ghostscript, and a list of any incompatible changes in it.
312
Changes in older releases are described in the history files
313
"History*.htm", which are usually installed in the documentation
314
directory. Run "gs -h" to see where that is.
317
A list of Ghostscript development projects with which we would
321
The guidelines and style for postscript coding in Ghostscript.
322
Some of Ghostscript is implemented in the postscript language
323
itself, and various utilities and examples are distributed with
324
it. You should follow these guidelines if you're extending or
325
modifying those files. For developers.
328
Detailed information on how to use Ghostscript through ps2epsi
329
to convert PostScript to Adobe Encapsulated PostScript
330
Interchange (EPSI) format.
333
Detailed information on how to use Ghostscript through ps2pdf to
334
convert PostScript to Adobe Portable Document Format (PDF).
337
Detailed information on how to use Ghostscript through ps2ps2 to
338
convert Adobe Portable Document Format (PDF) or Adobe Postscript
339
Level 3 into Adobe Postscript Level 2.
342
A description of the PostScript files (other than font files)
343
distributed with Ghostscript, including initialization routines,
344
utility programs, and sample printable files.
347
The GNU General Public License, which states the conditions for
348
using and redistributing GPL Ghostscript.
354
A description of how to prepare and test a Ghostscript release.
355
Of interest only to developers who want to create new
356
Ghostscript versions for distribution.
359
A guide to the Ghostscript source code, for development and
363
Documentation for using the test scripts located in the
364
toolbin/tests directory, and conventions for writing new testing
368
How to set up Ghostscript as a Unix lpr filter.
371
Detailed instructions on how to use Ghostscript, including such
372
matters as designating an output device; choosing a default
373
paper size; how Ghostscript finds files, including font files;
374
how it uses environment variables; notes on specific platforms,
375
including the X Window System; and command-line options.
378
Ghostscript's external font interface to a host platform's
379
font-rendering mechanism, for developers.
380
__________________________________________________________________
382
Copyright � 2000-2006 Artifex Software, Inc. All rights reserved.
384
This software is provided AS-IS with no warranty, either express or
385
implied. This software is distributed under license and may not be
386
copied, modified or distributed except as expressly authorized under
387
the terms of that license. Refer to licensing information at
388
http://www.artifex.com/ or contact Artifex Software, Inc., 7 Mt. Lassen
389
Drive - Suite A-134, San Rafael, CA 94903, U.S.A., +1(415)492-9861, for
392
Ghostscript version 8.61, 21 November 2007