diff options
Diffstat (limited to 'Master/xemtex/doc/ghostscript/README')
-rw-r--r-- | Master/xemtex/doc/ghostscript/README | 391 |
1 files changed, 0 insertions, 391 deletions
diff --git a/Master/xemtex/doc/ghostscript/README b/Master/xemtex/doc/ghostscript/README deleted file mode 100644 index 193c9f09192..00000000000 --- a/Master/xemtex/doc/ghostscript/README +++ /dev/null @@ -1,391 +0,0 @@ - - Overview of Ghostscript - - If this is your first contact with Ghostscript, before continuing here - you should read the documentation for new users, where you'll find - * what Ghostscript does (PostScript and PDF previewing, conversion, - and printing); - * its licensing terms (free for ordinary use); - * what platforms it runs on (every platform you're likely to be - interested in); - * where to find some useful programs that enhance Ghostscript (like - user-friendly previewers for Unix, VMS, MS Windows, DOS, and - Macintosh); and - * what to do if you need help. - - The rest of this document is a roadmap to the Ghostscript - documentation. After looking through it, if you want to install - Ghostscript and not only use it, we recommend you read how to install - Ghostscript, and how to compile Ghostscript from source code (which is - necessary before installing it on Unix and VMS systems). - _________________________________________________________________ - -Table of contents - - * Document roadmap by theme - + What should I read if I'm a new user? - + Before building Ghostscript - + What should I read if I'm not a new user? - + What if I'm a developer? - + What if I'm writing documentation? - * Presence on the World Wide Web - + Ghostscript's home pages - + Adobe PostScript, Encapsulated PostScript, and PDF reference - documentation - + Other material on the WWW - * Which document contains what? - + Primarily for users: - - Devices.htm - Helpers.htm - Humor.htm - New-user.htm - Ps2epsi.htm - Ps2pdf.htm - Readme.htm - Unix-lpr.htm - Use.htm - - + For both users and developers: - - Changes.htm - Current.htm - CJK.htm - Fonts.htm - Hershey.htm - History*.htm - Install.htm - Language.htm - Make.htm - News.htm - Psfiles.htm - - + Primarily for developers: - - API.htm - C-style.htm - CJKTTCID.htm - DLL.htm - Develop.htm - Drivers.htm - Htmstyle.htm - Issues.htm - Lib.htm - Maintain.htm - Projects.htm - Ps-style.htm - Release.htm - Source.htm - Xfonts.htm - _________________________________________________________________ - -Document roadmap by theme - - What should I read if I'm a new user? - - A new user of Ghostscript should begin by reading the material - specifically for new users, then as many of these documents as seem - useful: - * how to install Ghostscript - * how to use Ghostscript; some of this information information also - found in gs.1, the Unix "man" page for Ghostscript. - * the catalogs at the beginning of devs.mak and contrib.mak, which - list all the devices for which Ghostscript is able to produce - output (although if you got Ghostscript in binary form, it will - only include some of these devices) - * detailed information about some specific devices that Ghostscript - knows about - * more detailed information about how to use Ghostscript under Unix - with lpr as a filter for non-PostScript printers - * about the fonts distributed with Ghostscript, including how to add - or replace fonts - * a description of the Ghostscript language, and its differences - from the documented PostScript language - * about the postscript files distributed with Ghostscript (other - than fonts) - - Before building Ghostscript - - If you are going to compile Ghostscript, rather than just use an - executable you got from somewhere, you should read: - * how to build Ghostscript and install it - _________________________________________________________________ - -What should I read if I'm not a new user? - - If you have already used Ghostscript, when you receive a new release - you should begin by reading this file, then - * News.htm, for incompatible changes and new features in the current - release; - * Current.htm, for known problems in the current release; - * if you wish, Changes.htm, for a detailed list of changes in the - current release; - * if you wish, History#.htm (currently History7.htm), for changes in - other releases. - _________________________________________________________________ - -What if I'm a developer? - - If you are going to do any development on or with Ghostscript at all, - you should at least look at - * the roadmap documentation for Ghostscript's source files and - architecture - - If you are going to write a new driver for Ghostscript, you should - read - * the guide to the Ghostscript source code - * the interface between Ghostscript and device drivers - * about the external font interface between Ghostscript and - platform-supplied fonts (but read about drivers in general first) - - If you intend to use Ghostscript in the form of a dynamic link library - (DLL) under OS/2 or Microsoft Windows or in the form of shared object - under GNU/Linux, read - * documentation on Ghostscript Interpreter API - - If you want to use Ghostscript as part of another program--as a - callable PostScript language interpreter--and not as a DLL or as a - self-contained executable application, you should begin by reading - * the source file imain.h, the documented API for Ghostscript not as - a DLL - - or if you are going to use only the Ghostscript graphics library, - * about the structure of the Ghostscript library and its interfaces - _________________________________________________________________ - -What if I'm writing documentation? - - If you are editing or adding to Ghostscript's existing documentation - in HTML format, or writing a new document, you should read - * the coding and style guidelines for Ghostscript's HTML-based - documentation. - _________________________________________________________________ - -Presence on the World Wide Web - - Ghostscript's home page - - GNU Ghostscript has a home page on the World Wide Web with helpful - information. Pleave visit: - - http://www.gnu.org/software/ghostscript/ - - More material about Ghostscript can be found at - - http://www.ghostscript.com/ - - Adobe PostScript, Encapsulated PostScript, and PDF reference documentation - - Adobe makes a wealth of technical documentation available over the - Web, including the PostScript Language Reference Manual (Third - Edition); the Encapsulated PostScript (EPS) Format Specification - version 3, including Encapsulated PostScript Interchange (EPSI) - format; the PDF 1.3 specification; and the pdfmark, transparency and - Acrobat Distiller parameters documentation. Some of these documents - are also available at Adobe's ftp site, but not necessarily under the - same filenames. - - Other material on the WWW - - Much other material about Ghostscript is available on the World Wide - Web, both as web pages and as archived Usenet and mailing list - discussions. Use the well-known search engines to find such material. - - There is a good manual for Ghostscript available in PDF form, in - English and German (and soon in Japanese), at: - - http://www.pdflib.com/gsmanual - - There is a translation of the Ghostscript 'man' pages into Czech at: - - http://www.volny.cz/rebus/ghostscript/ - _________________________________________________________________ - -Which document contains what? - - Here is the list in alphabetic order of Ghostscript documentation, - with explanations of the contents. - - API.htm - On MS-Windows and OS/2, Ghostscript is compiled as a dynamic - link library (DLL). On GNU/Linux, Ghostscript can be compiled - as a shared object. This describes how to use it. For - developers. - - C-style.htm - Guidelines and style for C coding, which you should follow if, - for example, you write a new driver or add or change something - in Ghostscript. For developers. - - Changes.htm - A detailed list of all code changes in the current release or - pre-release, generated mechanically from the CVS logs. For - developers. - - CJK.htm - Usage of features to support CJK CID-keyed fonts in - Ghostscript. - - CJKTTCID.htm - Note providing information on utilization of CJK (Chinese, - Japanese and Korean) TrueType fonts as CIDFontType2 fonts from - the viewpoint of its validity and limitations. - - Current.htm - Information specifically about the current release of - Ghostscript. See also the latest news of changes. - - DLL.htm - On OS/2, MS Windows-16 and MS Windows-32 platforms, Ghostscript - is compiled as a dynamic link library (DLL). This describes how - to use it. For developers. This DLL interface is obsolete. Use - API.htm instead. - - Develop.htm - Code orientation for developers. Contains a detailed breakdown - of the source files by functional group, and overviews of the - major architectural features and services. - - Devices.htm - Detailed information about some specific devices for which - Ghostscript can produce output. Run "gs -h" to see which - devices a particular version of Ghostscript is built to use. - - Drivers.htm - Describes the interface between Ghostscript and device drivers. - If you do this, you should also read and use the C style and - coding guidelines. Necessary to develop a new driver. For - developers. - - Fonts.htm - All about fonts freely available for Ghostscript, and how to - add and use new fonts. Also describes how to use Ghostscript - fonts as X Windows fonts. For both users and developers. - - Helpers.htm - A note of thanks to people who have helped in the development - of Ghostscript. - - Hershey.htm - Part 1 of the five-part original Usenet distribution of the - free Hershey fonts, giving the terms of use and describing - their encoding. - - History*.htm - The history of changes in all Ghostscript releases: - - History7.htm for Ghostscript versions 7.n - History6.htm for Ghostscript versions 6.n - History5.htm for Ghostscript versions 5.n - History4.htm for Ghostscript versions 4.n - History3.htm for Ghostscript versions 3.n - History2.htm for Ghostscript versions 2.n - History1.htm for Ghostscript versions 1.n - - Htmstyle.htm - The guidelines and style for HTML coding of Ghostscript's - documentation, which you should follow if, for example, you - change existing HTML documentation or write new documents. For - writers and editors. - - Humor.htm - Another Ghostscript interpreter. - - Install.htm - How to install Ghostscript. See also how to build it. - - Issues.htm - A list of outstanding open issues in Ghostscript. These include - known limitations, minor bugs, performance issues, differences - from Adobe implementations, and others. - - Language.htm - The relationship between the Ghostscript interpreter and the - PostScript language as defined by Adobe. - - Lib.htm - A description of the Ghostscript library, a set of procedures - to implement the graphics and filtering capabilities that are - primitive operations in the PostScript language and in Adobe - Portable Document Format (PDF). For developers. - - Maintain.htm - Assorted Ghostscript maintenance procedures. For developers. - - Make.htm - How to build Ghostscript executables from the source code. See - also how to install it. It's not necessary to be a highly - experienced developer to build or install Ghostscript, but some - experience is needed. - - New-user.htm - Essential information for new users of Ghostscript. - - News.htm - A brief description of the latest release or pre-release of - Ghostscript, and a list of any incompatible changes in it. - Changes in older releases are described in the history files - "History*.htm", which are usually installed in the - documentation directory. Run "gs -h" to see where that is. - - Projects.htm - A list of Ghostscript development projects with which we would - like help. - - Ps-style.htm - The guidelines and style for postscript coding in Ghostscript. - Some of Ghostscript is implemented in the postscript language - itself, and various utilities and examples are distributed with - it. You should follow these guidelines if you're extending or - modifying those files. For developers. - - Ps2epsi.htm - Detailed information on how to use Ghostscript through ps2epsi - to convert PostScript to Adobe Encapsulated PostScript - Interchange (EPSI) format. - - Ps2pdf.htm - Detailed information on how to use Ghostscript through ps2pdf - to convert PostScript to Adobe Portable Document Format (PDF). - - Psfiles.htm - A description of the PostScript files (other than font files) - distributed with Ghostscript, including initialization - routines, utility programs, and sample printable files. - - Readme.htm - This document. - - Release.htm - A description of how to prepare and test a Ghostscript release. - Of interest only to developers who want to create new - Ghostscript versions for distribution. - - Source.htm - A guide to the Ghostscript source code, for development and - debugging. - - Unix-lpr.htm - How to set up Ghostscript as a Unix lpr filter. - - Use.htm - Detailed instructions on how to use Ghostscript, including such - matters as designating an output device; choosing a default - paper size; how Ghostscript finds files, including font files; - how it uses environment variables; notes on specific platforms, - including the X Window System; and command-line options. - - Xfonts.htm - Ghostscript's external font interface to a host platform's - font-rendering mechanism, for developers. - _________________________________________________________________ - - Copyright © 1996, 2000 Aladdin Enterprises. All rights reserved. - - This software is provided AS-IS with no warranty, either express or - implied. This software is distributed under license and may not be - copied, modified or distributed except as expressly authorized under - the terms of the license contained in the file LICENSE in this - distribution. - - Ghostscript version 7.07, 17 May 2003 |