xref: /plan9/sys/src/cmd/gs/doc/README (revision 593dc095aefb2a85c828727bbfa9da139a49bdf4)
13ff48bf5SDavid du Colombier
27dd7cddfSDavid du Colombier                            Overview of Ghostscript
37dd7cddfSDavid du Colombier
4*593dc095SDavid du Colombier   This document is a roadmap to the Ghostscript documentation. After
5*593dc095SDavid du Colombier   looking through it, if you want to install Ghostscript and not only
6*593dc095SDavid du Colombier   use it, we recommend you read how to install Ghostscript, and how to
7*593dc095SDavid du Colombier   compile Ghostscript from source code (which is necessary before
8*593dc095SDavid du Colombier   installing it on Unix and VMS systems).
93ff48bf5SDavid du Colombier     _________________________________________________________________
107dd7cddfSDavid du Colombier
117dd7cddfSDavid du ColombierTable of contents
127dd7cddfSDavid du Colombier
137dd7cddfSDavid du Colombier     * Document roadmap by theme
143ff48bf5SDavid du Colombier          + What should I read if I'm a new user?
15*593dc095SDavid du Colombier          + AFPL Ghostscript and GPL Ghostscript
167dd7cddfSDavid du Colombier          + Before building Ghostscript
173ff48bf5SDavid du Colombier          + What should I read if I'm not a new user?
183ff48bf5SDavid du Colombier          + What if I'm a developer?
193ff48bf5SDavid du Colombier          + What if I'm writing documentation?
207dd7cddfSDavid du Colombier     * Presence on the World Wide Web
213ff48bf5SDavid du Colombier          + Ghostscript's home pages
223ff48bf5SDavid du Colombier          + Adobe PostScript, Encapsulated PostScript, and PDF reference
233ff48bf5SDavid du Colombier            documentation
243ff48bf5SDavid du Colombier          + Other material on the WWW
257dd7cddfSDavid du Colombier     * Which document contains what?
263ff48bf5SDavid du Colombier          + Primarily for users:
277dd7cddfSDavid du Colombier
283ff48bf5SDavid du Colombier   Bug-form.htm
293ff48bf5SDavid du Colombier   Bug-info.htm
30*593dc095SDavid du Colombier   Deprecated.htm
313ff48bf5SDavid du Colombier   Devices.htm
323ff48bf5SDavid du Colombier       Helpers.htm
333ff48bf5SDavid du Colombier   Humor.htm
343ff48bf5SDavid du Colombier   Ps2epsi.htm
353ff48bf5SDavid du Colombier       Ps2pdf.htm
36*593dc095SDavid du Colombier   Ps2ps2.htm
373ff48bf5SDavid du Colombier   Readme.htm
383ff48bf5SDavid du Colombier   Unix-lpr.htm
393ff48bf5SDavid du Colombier   Use.htm
407dd7cddfSDavid du Colombier
413ff48bf5SDavid du Colombier          + For both users and developers:
423ff48bf5SDavid du Colombier
433ff48bf5SDavid du Colombier   Changes.htm
443ff48bf5SDavid du Colombier   Commprod.htm
453ff48bf5SDavid du Colombier   Copying.htm
463ff48bf5SDavid du Colombier   Fonts.htm
473ff48bf5SDavid du Colombier   Hershey.htm
483ff48bf5SDavid du Colombier       History*.htm
493ff48bf5SDavid du Colombier   Install.htm
503ff48bf5SDavid du Colombier   Language.htm
513ff48bf5SDavid du Colombier   Make.htm
523ff48bf5SDavid du Colombier       News.htm
533ff48bf5SDavid du Colombier   Psfiles.htm
543ff48bf5SDavid du Colombier   Public.htm
553ff48bf5SDavid du Colombier
563ff48bf5SDavid du Colombier          + Primarily for developers:
573ff48bf5SDavid du Colombier
583ff48bf5SDavid du Colombier   API.htm
593ff48bf5SDavid du Colombier   C-style.htm
603ff48bf5SDavid du Colombier   DLL.htm
613ff48bf5SDavid du Colombier   Develop.htm
623ff48bf5SDavid du Colombier   Drivers.htm
633ff48bf5SDavid du Colombier       Htmstyle.htm
643ff48bf5SDavid du Colombier   Issues.htm
653ff48bf5SDavid du Colombier   Lib.htm
663ff48bf5SDavid du Colombier   Maintain.htm
673ff48bf5SDavid du Colombier   Projects.htm
683ff48bf5SDavid du Colombier       Ps-style.htm
693ff48bf5SDavid du Colombier   Release.htm
703ff48bf5SDavid du Colombier   Source.htm
71*593dc095SDavid du Colombier   Testing.htm
723ff48bf5SDavid du Colombier   Xfonts.htm
733ff48bf5SDavid du Colombier     _________________________________________________________________
747dd7cddfSDavid du Colombier
757dd7cddfSDavid du ColombierDocument roadmap by theme
767dd7cddfSDavid du Colombier
777dd7cddfSDavid du Colombier  What should I read if I'm a new user?
787dd7cddfSDavid du Colombier
79*593dc095SDavid du Colombier     * how to use Ghostscript. This includes both a quickstart
80*593dc095SDavid du Colombier       introduction to the commandline version and more extensive
81*593dc095SDavid du Colombier       reference material.
82*593dc095SDavid du Colombier     * detailed information about specific devices that Ghostscript can
83*593dc095SDavid du Colombier       use for output
843ff48bf5SDavid du Colombier     * information about reporting problems--but remember that
853ff48bf5SDavid du Colombier       Ghostscript comes with NO WARRANTY and NO SUPPORT
86*593dc095SDavid du Colombier     * more detailed information about how to use Ghostscript under Unix
87*593dc095SDavid du Colombier       with lpr as a filter for printing
887dd7cddfSDavid du Colombier
89*593dc095SDavid du Colombier  AFPL Ghostscript and GPL Ghostscript
907dd7cddfSDavid du Colombier
91*593dc095SDavid du Colombier   AFPL Ghostscript and GPL Ghostscript are different releases. If you
92*593dc095SDavid du Colombier   have AFPL Ghostscript, not the GPL Ghostscript releases, you should
93*593dc095SDavid du Colombier   read (or at least skim through):
943ff48bf5SDavid du Colombier     * additional information about AFPL Ghostscript releases that is not
95*593dc095SDavid du Colombier       relevant to GPL Ghostscript releases.
967dd7cddfSDavid du Colombier
973ff48bf5SDavid du Colombier   If you run into any questions, or if you are going to be using
983ff48bf5SDavid du Colombier   Ghostscript extensively, you should at least skim, and probably
993ff48bf5SDavid du Colombier   eventually read:
1003ff48bf5SDavid du Colombier     * about the fonts distributed with Ghostscript, including how to add
1013ff48bf5SDavid du Colombier       or replace fonts
1023ff48bf5SDavid du Colombier     * a description of the Ghostscript language, and its differences
1033ff48bf5SDavid du Colombier       from the documented PostScript language
1043ff48bf5SDavid du Colombier     * about the postscript files distributed with Ghostscript (other
1053ff48bf5SDavid du Colombier       than fonts)
1067dd7cddfSDavid du Colombier
1077dd7cddfSDavid du Colombier  Before building Ghostscript
1087dd7cddfSDavid du Colombier
109*593dc095SDavid du Colombier   If you are going to compile Ghostscript from source, rather than just
110*593dc095SDavid du Colombier   use an executable you got from somewhere, you may want to read:
1117dd7cddfSDavid du Colombier     * how to build Ghostscript and install it
1123ff48bf5SDavid du Colombier     _________________________________________________________________
1137dd7cddfSDavid du Colombier
1147dd7cddfSDavid du ColombierWhat should I read if I'm not a new user?
1157dd7cddfSDavid du Colombier
1163ff48bf5SDavid du Colombier   If you have already used Ghostscript, when you receive a new release
1173ff48bf5SDavid du Colombier   you should begin by reading this file, then
1183ff48bf5SDavid du Colombier     * News.htm, for incompatible changes and new features in the current
1193ff48bf5SDavid du Colombier       release;
1203ff48bf5SDavid du Colombier     * if you wish, Changes.htm, for a detailed list of changes in the
1213ff48bf5SDavid du Colombier       current release;
122*593dc095SDavid du Colombier     * if you wish, History#.htm (currently History8.htm), for changes in
1237dd7cddfSDavid du Colombier       other releases.
1243ff48bf5SDavid du Colombier     _________________________________________________________________
1257dd7cddfSDavid du Colombier
1267dd7cddfSDavid du ColombierWhat if I'm a developer?
1277dd7cddfSDavid du Colombier
1283ff48bf5SDavid du Colombier   If you are going to do any development on or with Ghostscript at all,
1293ff48bf5SDavid du Colombier   you should at least look at
1303ff48bf5SDavid du Colombier     * the roadmap documentation for Ghostscript's source files and
1313ff48bf5SDavid du Colombier       architecture
1327dd7cddfSDavid du Colombier
1333ff48bf5SDavid du Colombier   If you are going to write a new driver for Ghostscript, you should
1343ff48bf5SDavid du Colombier   read
1357dd7cddfSDavid du Colombier     * the guide to the Ghostscript source code
1367dd7cddfSDavid du Colombier     * the interface between Ghostscript and device drivers
1377dd7cddfSDavid du Colombier     * about the external font interface between Ghostscript and
138*593dc095SDavid du Colombier       platform-supplied fonts
1397dd7cddfSDavid du Colombier
140*593dc095SDavid du Colombier   If you are considering distributing Ghostscript (either AFPL or GPL
1413ff48bf5SDavid du Colombier   versions) in conjunction with a commercial product, you should read
1423ff48bf5SDavid du Colombier   the license carefully, and you should also read
1433ff48bf5SDavid du Colombier     * additional clarification of the circumstances under which
1443ff48bf5SDavid du Colombier       Ghostscript can be distributed with a commercial product
1457dd7cddfSDavid du Colombier
1463ff48bf5SDavid du Colombier   If you intend to use Ghostscript in the form of a dynamic link library
1473ff48bf5SDavid du Colombier   (DLL) under OS/2 or Microsoft Windows or in the form of shared object
1483ff48bf5SDavid du Colombier   under Linux, read
1493ff48bf5SDavid du Colombier     * documentation on Ghostscript Interpreter API
1507dd7cddfSDavid du Colombier
1513ff48bf5SDavid du Colombier   If you want to use Ghostscript as part of another program--as a
1523ff48bf5SDavid du Colombier   callable PostScript language interpreter--and not as a DLL or as a
1533ff48bf5SDavid du Colombier   self-contained executable application, you should begin by reading
1543ff48bf5SDavid du Colombier     * the source file imain.h, the documented API for Ghostscript not as
1553ff48bf5SDavid du Colombier       a DLL
1567dd7cddfSDavid du Colombier
1577dd7cddfSDavid du Colombier   or if you are going to use only the Ghostscript graphics library,
1587dd7cddfSDavid du Colombier     * about the structure of the Ghostscript library and its interfaces
1593ff48bf5SDavid du Colombier     _________________________________________________________________
1607dd7cddfSDavid du Colombier
1617dd7cddfSDavid du ColombierWhat if I'm writing documentation?
1627dd7cddfSDavid du Colombier
1633ff48bf5SDavid du Colombier   If you are editing or adding to Ghostscript's existing documentation
1643ff48bf5SDavid du Colombier   in HTML format, or writing a new document, you should read
1657dd7cddfSDavid du Colombier     * the coding and style guidelines for Ghostscript's HTML-based
1667dd7cddfSDavid du Colombier       documentation.
1673ff48bf5SDavid du Colombier     _________________________________________________________________
1687dd7cddfSDavid du Colombier
1697dd7cddfSDavid du ColombierPresence on the World Wide Web
1707dd7cddfSDavid du Colombier
1717dd7cddfSDavid du Colombier  Ghostscript's home page
1727dd7cddfSDavid du Colombier
1733ff48bf5SDavid du Colombier   Ghostscript has a home page on the World Wide Web with helpful
1743ff48bf5SDavid du Colombier   information such as the FAQ (Frequently Asked Questions) and a list of
1753ff48bf5SDavid du Colombier   known problems and workarounds for the current AFPL Ghostscript
1763ff48bf5SDavid du Colombier   release (in the "Obtaining" file for that release):
1777dd7cddfSDavid du Colombier
1787dd7cddfSDavid du Colombier     http://www.cs.wisc.edu/~ghost/
1797dd7cddfSDavid du Colombier
1803ff48bf5SDavid du Colombier   More material about Ghostscript can be found at
1817dd7cddfSDavid du Colombier
1827dd7cddfSDavid du Colombier     http://www.ghostscript.com/
1837dd7cddfSDavid du Colombier
1843ff48bf5SDavid du Colombier  Adobe PostScript, Encapsulated PostScript, and PDF reference documentation
1857dd7cddfSDavid du Colombier
1863ff48bf5SDavid du Colombier   Adobe makes a wealth of technical documentation available over the
1873ff48bf5SDavid du Colombier   Web, including the PostScript Language Reference Manual (Third
1883ff48bf5SDavid du Colombier   Edition); the Encapsulated PostScript (EPS) Format Specification
1893ff48bf5SDavid du Colombier   version 3, including Encapsulated PostScript Interchange (EPSI)
190*593dc095SDavid du Colombier   format; the PDF Reference manuals. The Acrobat SDK contains pdfmark
191*593dc095SDavid du Colombier   and Acrobat Distiller parameters documentation. Some of these
192*593dc095SDavid du Colombier   documents are also available at Adobe's ftp site, but not necessarily
193*593dc095SDavid du Colombier   under the same filenames.
1947dd7cddfSDavid du Colombier
1957dd7cddfSDavid du Colombier  Other material on the WWW
1967dd7cddfSDavid du Colombier
1973ff48bf5SDavid du Colombier   Much other material about Ghostscript is available on the World Wide
1983ff48bf5SDavid du Colombier   Web, both as web pages and as archived Usenet and mailing list
1993ff48bf5SDavid du Colombier   discussions. Use the well-known search engines to find such material.
2007dd7cddfSDavid du Colombier
2013ff48bf5SDavid du Colombier   There is a translation of the Ghostscript 'man' pages into Czech at:
2023ff48bf5SDavid du Colombier
2033ff48bf5SDavid du Colombier     http://www.volny.cz/rebus/ghostscript/
2043ff48bf5SDavid du Colombier     _________________________________________________________________
2057dd7cddfSDavid du Colombier
2067dd7cddfSDavid du ColombierWhich document contains what?
2077dd7cddfSDavid du Colombier
2083ff48bf5SDavid du Colombier   Here is the list in alphabetic order of Ghostscript documentation,
2093ff48bf5SDavid du Colombier   with explanations of the contents.
2103ff48bf5SDavid du Colombier
2113ff48bf5SDavid du Colombier   API.htm
2123ff48bf5SDavid du Colombier          On MS-Windows and OS/2, Ghostscript is compiled as a dynamic
2133ff48bf5SDavid du Colombier          link library (DLL). On Linux, Ghostscript can be compiled as a
2143ff48bf5SDavid du Colombier          shared object. This describes how to use it. For developers.
2157dd7cddfSDavid du Colombier
2167dd7cddfSDavid du Colombier   Bug-form.htm
2173ff48bf5SDavid du Colombier          A form to fill out and email to report a problem with AFPL
2183ff48bf5SDavid du Colombier          Ghostscript--but remember that Ghostscript comes with NO
2193ff48bf5SDavid du Colombier          WARRANTY and NO SUPPORT. Please read the instructions before
2203ff48bf5SDavid du Colombier          reporting a bug.
2213ff48bf5SDavid du Colombier
2223ff48bf5SDavid du Colombier   Bug-info.htm
2233ff48bf5SDavid du Colombier          Information about how to report problems with AFPL
2243ff48bf5SDavid du Colombier          Ghostscript--but remember that Ghostscript comes with NO
2253ff48bf5SDavid du Colombier          WARRANTY and NO SUPPORT. Please read this before reporting a
2263ff48bf5SDavid du Colombier          problem.
2277dd7cddfSDavid du Colombier
2287dd7cddfSDavid du Colombier   C-style.htm
2293ff48bf5SDavid du Colombier          Guidelines and style for C coding, which you should follow if,
2303ff48bf5SDavid du Colombier          for example, you write a new driver or add or change something
2313ff48bf5SDavid du Colombier          in Ghostscript. For developers.
2323ff48bf5SDavid du Colombier
2333ff48bf5SDavid du Colombier   Changes.htm
2343ff48bf5SDavid du Colombier          A detailed list of all code changes in the current release or
2353ff48bf5SDavid du Colombier          pre-release, generated mechanically from the CVS logs. For
2363ff48bf5SDavid du Colombier          developers.
2377dd7cddfSDavid du Colombier
2387dd7cddfSDavid du Colombier   Commprod.htm
2397dd7cddfSDavid du Colombier          The conditions under which Ghostscript may be distributed in a
2407dd7cddfSDavid du Colombier          commercial context. See also the Aladdin Free Public License.
2417dd7cddfSDavid du Colombier
2427dd7cddfSDavid du Colombier   Copying.htm
2433ff48bf5SDavid du Colombier          A reminder that AFPL Ghostscript is governed NOT by the Free
2443ff48bf5SDavid du Colombier          Software Foundation's GNU General Public License but by the
2453ff48bf5SDavid du Colombier          Aladdin Free Public License.
2467dd7cddfSDavid du Colombier
2477dd7cddfSDavid du Colombier   DLL.htm
2483ff48bf5SDavid du Colombier          On OS/2, MS Windows-16 and MS Windows-32 platforms, Ghostscript
2493ff48bf5SDavid du Colombier          is compiled as a dynamic link library (DLL). This describes how
2503ff48bf5SDavid du Colombier          to use it. For developers. This DLL interface is obsolete. Use
2513ff48bf5SDavid du Colombier          API.htm instead.
2523ff48bf5SDavid du Colombier
2533ff48bf5SDavid du Colombier   Develop.htm
2543ff48bf5SDavid du Colombier          Code orientation for developers. Contains a detailed breakdown
2553ff48bf5SDavid du Colombier          of the source files by functional group, and overviews of the
2563ff48bf5SDavid du Colombier          major architectural features and services.
2577dd7cddfSDavid du Colombier
258*593dc095SDavid du Colombier   Deprecated.htm
259*593dc095SDavid du Colombier          Documention for deprecated devices and features. Features
260*593dc095SDavid du Colombier          described here will be removed in future versions of
261*593dc095SDavid du Colombier          Ghostscript.
262*593dc095SDavid du Colombier
2637dd7cddfSDavid du Colombier   Devices.htm
2643ff48bf5SDavid du Colombier          Detailed information about some specific devices for which
2653ff48bf5SDavid du Colombier          Ghostscript can produce output. Run "gs -h" to see which
2663ff48bf5SDavid du Colombier          devices a particular version of Ghostscript is built to use.
2677dd7cddfSDavid du Colombier
2687dd7cddfSDavid du Colombier   Drivers.htm
2693ff48bf5SDavid du Colombier          Describes the interface between Ghostscript and device drivers.
2703ff48bf5SDavid du Colombier          If you do this, you should also read and use the C style and
2713ff48bf5SDavid du Colombier          coding guidelines. Necessary to develop a new driver. For
2723ff48bf5SDavid du Colombier          developers.
2737dd7cddfSDavid du Colombier
2747dd7cddfSDavid du Colombier   Fonts.htm
2753ff48bf5SDavid du Colombier          All about fonts freely available for Ghostscript, and how to
2763ff48bf5SDavid du Colombier          add and use new fonts. Also describes how to use Ghostscript
2773ff48bf5SDavid du Colombier          fonts as X Windows fonts. For both users and developers.
2787dd7cddfSDavid du Colombier
2797dd7cddfSDavid du Colombier   Helpers.htm
2803ff48bf5SDavid du Colombier          A note of thanks to people who have helped in the development
2813ff48bf5SDavid du Colombier          of Ghostscript.
2827dd7cddfSDavid du Colombier
2837dd7cddfSDavid du Colombier   Hershey.htm
2843ff48bf5SDavid du Colombier          Part 1 of the five-part original Usenet distribution of the
2853ff48bf5SDavid du Colombier          free Hershey fonts, giving the terms of use and describing
2863ff48bf5SDavid du Colombier          their encoding.
2877dd7cddfSDavid du Colombier
2887dd7cddfSDavid du Colombier   History*.htm
2897dd7cddfSDavid du Colombier          The history of changes in all Ghostscript releases:
2907dd7cddfSDavid du Colombier
291*593dc095SDavid du Colombier     History8.htm for Ghostscript versions 8.n
2923ff48bf5SDavid du Colombier     History7.htm for Ghostscript versions 7.n
2937dd7cddfSDavid du Colombier     History6.htm for Ghostscript versions 6.n
2947dd7cddfSDavid du Colombier     History5.htm for Ghostscript versions 5.n
2957dd7cddfSDavid du Colombier     History4.htm for Ghostscript versions 4.n
2967dd7cddfSDavid du Colombier     History3.htm for Ghostscript versions 3.n
2977dd7cddfSDavid du Colombier     History2.htm for Ghostscript versions 2.n
2987dd7cddfSDavid du Colombier     History1.htm for Ghostscript versions 1.n
2997dd7cddfSDavid du Colombier
3007dd7cddfSDavid du Colombier   Htmstyle.htm
3017dd7cddfSDavid du Colombier          The guidelines and style for HTML coding of Ghostscript's
3023ff48bf5SDavid du Colombier          documentation, which you should follow if, for example, you
3033ff48bf5SDavid du Colombier          change existing HTML documentation or write new documents. For
3043ff48bf5SDavid du Colombier          writers and editors.
3057dd7cddfSDavid du Colombier
3067dd7cddfSDavid du Colombier   Humor.htm
3077dd7cddfSDavid du Colombier          Another Ghostscript interpreter.
3087dd7cddfSDavid du Colombier
3097dd7cddfSDavid du Colombier   Install.htm
3107dd7cddfSDavid du Colombier          How to install Ghostscript. See also how to build it.
3117dd7cddfSDavid du Colombier
3123ff48bf5SDavid du Colombier   Issues.htm
3133ff48bf5SDavid du Colombier          A list of outstanding open issues in Ghostscript. These include
3143ff48bf5SDavid du Colombier          known limitations, minor bugs, performance issues, differences
3153ff48bf5SDavid du Colombier          from Adobe implementations, and others.
3163ff48bf5SDavid du Colombier
3177dd7cddfSDavid du Colombier   Language.htm
3183ff48bf5SDavid du Colombier          The relationship between the Ghostscript interpreter and the
3193ff48bf5SDavid du Colombier          PostScript language as defined by Adobe.
3207dd7cddfSDavid du Colombier
3217dd7cddfSDavid du Colombier   Lib.htm
3223ff48bf5SDavid du Colombier          A description of the Ghostscript library, a set of procedures
3233ff48bf5SDavid du Colombier          to implement the graphics and filtering capabilities that are
3243ff48bf5SDavid du Colombier          primitive operations in the PostScript language and in Adobe
3253ff48bf5SDavid du Colombier          Portable Document Format (PDF). For developers.
3263ff48bf5SDavid du Colombier
3273ff48bf5SDavid du Colombier   Maintain.htm
3283ff48bf5SDavid du Colombier          Assorted Ghostscript maintenance procedures. For developers.
3297dd7cddfSDavid du Colombier
3307dd7cddfSDavid du Colombier   Make.htm
3313ff48bf5SDavid du Colombier          How to build Ghostscript executables from the source code. See
3323ff48bf5SDavid du Colombier          also how to install it. It's not necessary to be a highly
3333ff48bf5SDavid du Colombier          experienced developer to build or install Ghostscript, but some
3343ff48bf5SDavid du Colombier          experience is needed.
3357dd7cddfSDavid du Colombier
3367dd7cddfSDavid du Colombier   News.htm
3373ff48bf5SDavid du Colombier          A brief description of the latest release or pre-release of
3383ff48bf5SDavid du Colombier          Ghostscript, and a list of any incompatible changes in it.
3393ff48bf5SDavid du Colombier          Changes in older releases are described in the history files
3403ff48bf5SDavid du Colombier          "History*.htm", which are usually installed in the
3413ff48bf5SDavid du Colombier          documentation directory. Run "gs -h" to see where that is.
3423ff48bf5SDavid du Colombier
3433ff48bf5SDavid du Colombier   Projects.htm
3443ff48bf5SDavid du Colombier          A list of Ghostscript development projects with which we would
3453ff48bf5SDavid du Colombier          like help.
3463ff48bf5SDavid du Colombier
3473ff48bf5SDavid du Colombier   Ps-style.htm
3483ff48bf5SDavid du Colombier          The guidelines and style for postscript coding in Ghostscript.
3493ff48bf5SDavid du Colombier          Some of Ghostscript is implemented in the postscript language
3503ff48bf5SDavid du Colombier          itself, and various utilities and examples are distributed with
3513ff48bf5SDavid du Colombier          it. You should follow these guidelines if you're extending or
3523ff48bf5SDavid du Colombier          modifying those files. For developers.
3533ff48bf5SDavid du Colombier
3543ff48bf5SDavid du Colombier   Ps2epsi.htm
3553ff48bf5SDavid du Colombier          Detailed information on how to use Ghostscript through ps2epsi
3563ff48bf5SDavid du Colombier          to convert PostScript to Adobe Encapsulated PostScript
3573ff48bf5SDavid du Colombier          Interchange (EPSI) format.
3587dd7cddfSDavid du Colombier
3597dd7cddfSDavid du Colombier   Ps2pdf.htm
3603ff48bf5SDavid du Colombier          Detailed information on how to use Ghostscript through ps2pdf
3613ff48bf5SDavid du Colombier          to convert PostScript to Adobe Portable Document Format (PDF).
3627dd7cddfSDavid du Colombier
363*593dc095SDavid du Colombier   Ps2ps2.htm
364*593dc095SDavid du Colombier          Detailed information on how to use Ghostscript through ps2ps2
365*593dc095SDavid du Colombier          to convert Adobe Portable Document Format (PDF) or Adobe
366*593dc095SDavid du Colombier          Postscript Level 3 into Adobe Postscript Level 2.
367*593dc095SDavid du Colombier
3687dd7cddfSDavid du Colombier   Psfiles.htm
3697dd7cddfSDavid du Colombier          A description of the PostScript files (other than font files)
3703ff48bf5SDavid du Colombier          distributed with Ghostscript, including initialization
3713ff48bf5SDavid du Colombier          routines, utility programs, and sample printable files.
3727dd7cddfSDavid du Colombier
3737dd7cddfSDavid du Colombier   Public.htm
3743ff48bf5SDavid du Colombier          The Aladdin Free Public License, which states the conditions
3753ff48bf5SDavid du Colombier          for using and redistributing AFPL Ghostscript.
3767dd7cddfSDavid du Colombier
3777dd7cddfSDavid du Colombier   Readme.htm
3787dd7cddfSDavid du Colombier          This document.
3797dd7cddfSDavid du Colombier
3807dd7cddfSDavid du Colombier   Release.htm
3813ff48bf5SDavid du Colombier          A description of how to prepare and test a Ghostscript release.
3823ff48bf5SDavid du Colombier          Of interest only to developers who want to create new
3833ff48bf5SDavid du Colombier          Ghostscript versions for distribution.
3847dd7cddfSDavid du Colombier
3857dd7cddfSDavid du Colombier   Source.htm
3863ff48bf5SDavid du Colombier          A guide to the Ghostscript source code, for development and
3873ff48bf5SDavid du Colombier          debugging.
3887dd7cddfSDavid du Colombier
389*593dc095SDavid du Colombier   Testing.htm
390*593dc095SDavid du Colombier          Documentation for using the test scripts located in the
391*593dc095SDavid du Colombier          toolbin/tests directory, and conventions for writing new
392*593dc095SDavid du Colombier          testing scripts.
3937dd7cddfSDavid du Colombier
3947dd7cddfSDavid du Colombier   Unix-lpr.htm
3957dd7cddfSDavid du Colombier          How to set up Ghostscript as a Unix lpr filter.
3967dd7cddfSDavid du Colombier
3977dd7cddfSDavid du Colombier   Use.htm
3983ff48bf5SDavid du Colombier          Detailed instructions on how to use Ghostscript, including such
3993ff48bf5SDavid du Colombier          matters as designating an output device; choosing a default
4003ff48bf5SDavid du Colombier          paper size; how Ghostscript finds files, including font files;
4013ff48bf5SDavid du Colombier          how it uses environment variables; notes on specific platforms,
4023ff48bf5SDavid du Colombier          including the X Window System; and command-line options.
4037dd7cddfSDavid du Colombier
4047dd7cddfSDavid du Colombier   Xfonts.htm
4057dd7cddfSDavid du Colombier          Ghostscript's external font interface to a host platform's
4067dd7cddfSDavid du Colombier          font-rendering mechanism, for developers.
4073ff48bf5SDavid du Colombier     _________________________________________________________________
4087dd7cddfSDavid du Colombier
409*593dc095SDavid du Colombier   Copyright � 1996-2002 artofcode LLC. All rights reserved.
4107dd7cddfSDavid du Colombier
411*593dc095SDavid du Colombier   This software is provided AS-IS with no warranty, either express or
412*593dc095SDavid du Colombier   implied. This software is distributed under license and may not be
413*593dc095SDavid du Colombier   copied, modified or distributed except as expressly authorized under
414*593dc095SDavid du Colombier   the terms of the license contained in the file LICENSE in this
415*593dc095SDavid du Colombier   distribution. For more information about licensing, please refer to
416*593dc095SDavid du Colombier   http://www.ghostscript.com/licensing/. For information on commercial
417*593dc095SDavid du Colombier   licensing, go to http://www.artifex.com/licensing/ or contact Artifex
418*593dc095SDavid du Colombier   Software, Inc., 101 Lucas Valley Road #110, San Rafael, CA 94903,
419*593dc095SDavid du Colombier   U.S.A., +1(415)492-9861.
4207dd7cddfSDavid du Colombier
421*593dc095SDavid du Colombier   Ghostscript version 8.53, 20 October 2005
422