diff options
Diffstat (limited to 'Master/xemtex/doc/ghostscript/Readme.htm')
| -rw-r--r-- | Master/xemtex/doc/ghostscript/Readme.htm | 634 |
1 files changed, 634 insertions, 0 deletions
diff --git a/Master/xemtex/doc/ghostscript/Readme.htm b/Master/xemtex/doc/ghostscript/Readme.htm new file mode 100644 index 00000000000..b1ed5164975 --- /dev/null +++ b/Master/xemtex/doc/ghostscript/Readme.htm @@ -0,0 +1,634 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<head> +<title>Overview of Ghostscript</title> +<!-- $Id: Readme.htm,v 1.31.2.16.2.6 2003/05/17 14:39:00 giles Exp $ --> +<!-- Originally: README --> +<link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style"> +</head> + +<body> +<!-- [1.0 begin visible header] ============================================ --> + +<!-- [1.1 begin headline] ================================================== --> + +<h1>Overview of Ghostscript</h1> + +<!-- [1.1 end headline] ==================================================== --> + +<!-- [1.3 begin hint] ====================================================== --> + +<p> +If this is your first contact with Ghostscript, before continuing here you +should read the <a href="New-user.htm">documentation for new users</a>, +where you'll find + +<ul> +<li><a href="New-user.htm#Overview">what Ghostscript does</a> (PostScript +and PDF previewing, conversion, and printing); + +<li>its <a href="New-user.htm#Find_Ghostscript">licensing terms</a> (free +for ordinary use); + +<li>what <a href="New-user.htm#Platforms">platforms it runs on</a> (every +platform you're likely to be interested in); + +<li>where to find some <a href="New-user.htm#Previewers">useful +programs</a> that enhance Ghostscript (like user-friendly previewers for +Unix, VMS, MS Windows, DOS, and Macintosh); and + +<li>what to do <a href="New-user.htm#Need_help">if you need help</a>. +</ul> + +<p> +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 <a href="Install.htm">how to install +Ghostscript</a>, and <a href="Make.htm">how to compile Ghostscript</a> from +source code (which is necessary before installing it on Unix and VMS +systems). + +<!-- [1.3 end hint] ======================================================== --> + +<hr> + +<!-- [1.2 begin table of contents] ========================================= --> + +<h2>Table of contents</h2> + +<blockquote><ul> +<li><a href="#Theme_roadmap">Document roadmap by theme</a> +<ul> +<li><a href="#New_users">What should I read if I'm a new user?</a> +<li><a href="#Before_building">Before building Ghostscript</a> +<li><a href="#Not_a_new_user">What should I read if I'm not a new user?</a> +<li><a href="#Developer">What if I'm a developer?</a> +<li><a href="#Writer">What if I'm writing documentation?</a> +</ul> +<li><a href="#Web_presence">Presence on the World Wide Web</a> +<ul> +<li><a href="#Web_home_page">Ghostscript's home pages</a> +<li><a href="#Adobe_documentation">Adobe PostScript, Encapsulated +PostScript, and PDF reference documentation</a> +<li><a href="#Web_other">Other material on the WWW</a> +</ul> +<li><a href="#Ordered_roadmap">Which document contains what?</a> +<ul> +<li>Primarily for users: +<blockquote><table cellpadding=0 cellspacing=0> +<tr><td valign=top> +<a href="#Devices">Devices.htm</a><br> +<a href="#Helpers">Helpers.htm</a><br> +<td> <td valign=top> +<a href="#Humor">Humor.htm</a><br> +<a href="#New-user">New-user.htm</a><br> +<a href="#Ps2epsi">Ps2epsi.htm</a><br> +<a href="#Ps2pdf">Ps2pdf.htm</a><br> +<td> <td valign=top> +<a href="#Readme">Readme.htm</a><br> +<a href="#Unix-lpr">Unix-lpr.htm</a><br> +<a href="#Use">Use.htm</a><br> +<tr><td valign=top> +</table></blockquote> +<li>For both users and developers: +<blockquote><table cellpadding=0 cellspacing=0> +<tr><td valign=top> +<a href="#Changes">Changes.htm</a><br> +<a href="#Current">Current.htm</a><br> +<a href="#CJK">CJK.htm</a><br> +<a href="#Fonts">Fonts.htm</a><br> +<td> <td valign=top> +<a href="#Hershey">Hershey.htm</a><br> +<a href="#History">History*.htm</a><br> +<a href="#Install">Install.htm</a><br> +<a href="#Language">Language.htm</a><br> +<a href="#Make">Make.htm</a><br> +<td> <td valign=top> +<a href="#News">News.htm</a><br> +<a href="#Psfiles">Psfiles.htm</a><br> +</table></blockquote> +<li>Primarily for developers: +<blockquote><table cellpadding=0 cellspacing=0> +<tr><td valign=top> +<a href="#API">API.htm</a><br> +<a href="#C-style">C-style.htm</a><br> +<a href="#CJKTTCID">CJKTTCID.htm</a><br> +<a href="#DLL">DLL.htm</a><br> +<a href="#Develop">Develop.htm</a><br> +<a href="#Drivers">Drivers.htm</a><br> +<td> <td valign=top> +<a href="#Htmstyle">Htmstyle.htm</a><br> +<a href="#Issues">Issues.htm</a><br> +<a href="#Lib">Lib.htm</a><br> +<a href="#Maintain">Maintain.htm</a><br> +<a href="#Projects">Projects.htm</a><br> +<td> <td valign=top> +<a href="#Ps-style">Ps-style.htm</a><br> +<a href="#Release">Release.htm</a><br> +<a href="#Source">Source.htm</a><br> +<a href="#Xfonts">Xfonts.htm</a><br> +</table></blockquote> +</ul> +</ul></blockquote> + +<!-- [1.2 end table of contents] =========================================== --> + +<hr> + +<!-- [1.0 end visible header] ============================================== --> + +<!-- [2.0 begin contents] ================================================== --> + +<h2><a name="Theme_roadmap"></a>Document roadmap by theme</h2> + +<h3><a name="New_users"></a>What should I read if I'm a new user?</h3> + +<p> +A new user of Ghostscript should begin by reading the material +<a href="New-user.htm">specifically for new users</a>, then as many of +these documents as seem useful: + +<ul> +<li>how to <a href="Install.htm">install Ghostscript</a> + +<li>how to <a href="Use.htm">use Ghostscript</a>; some of this information +information also found in <b><tt>gs.1</tt></b>, the Unix +"man" page for Ghostscript. + +<li>the catalogs at the beginning of <b><tt>devs.mak</tt></b> and +<b><tt>contrib.mak</tt></b>, 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) + +<li>detailed information about <a href="Devices.htm">some specific +devices</a> that Ghostscript knows about + +<li>more detailed information about how to use Ghostscript under +Unix with <b><tt>lpr</tt></b> <a href="Unix-lpr.htm">as a filter</a> +for non-PostScript printers + +<li> about the <a href="Fonts.htm">fonts distributed with +Ghostscript</a>, including how to add or replace fonts + +<li> a description of <a href="Language.htm">the Ghostscript language</a>, +and its differences from the documented PostScript language + +<li> about the <a href="Psfiles.htm">postscript files distributed with +Ghostscript</a> (other than fonts) +</ul> + +<h3><a name="Before_building"></a>Before building Ghostscript</h3> + +<p> +If you are going to compile Ghostscript, rather than just use an executable +you got from somewhere, you should read: + +<ul> +<li> <a href="Make.htm">how to build Ghostscript</a> and +<a href="Install.htm">install it</a> +</ul> + +<hr> + +<h2><a name="Not_a_new_user"></a>What should I read if I'm not a new user?</h2> + +<p> +If you have already used Ghostscript, when you receive a new release you +should begin by reading this file, then + +<ul> +<li> <a href="News.htm">News.htm</a>, for incompatible changes and new +features in the current release; + +<li> <a href="Current.htm">Current.htm</a>, for known problems in the +current release; + +<li> if you wish, <a href="Changes.htm">Changes.htm</a>, for a detailed list +of changes in the current release; + +<li> if you wish, History#.htm (currently <a +href="History6.htm">History7.htm</a>), for changes in other releases. +</ul> + +<hr> + +<h2><a name="Developer"></a>What if I'm a developer?</h2> + +<p> +If you are going to do any development on or with Ghostscript at all, you +should at least look at + +<ul> +<li>the <a href="Develop.htm">roadmap documentation</a> for Ghostscript's +source files and architecture +</ul> + +<p> +If you are going to write a new driver for Ghostscript, you should read + +<ul> +<li> the <a href="Source.htm">guide to the Ghostscript source code</a> + +<li> the interface between Ghostscript and <a href="Drivers.htm">device +drivers</a> + +<li> about the <a href="Xfonts.htm">external font interface</a> between +Ghostscript and platform-supplied fonts (but read about +<a href="Drivers.htm">drivers in general</a> first) +</ul> + +<p> +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 + +<ul> +<li> documentation on <a href="API.htm">Ghostscript Interpreter API</a> +</ul> + +<p> +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 + +<ul> +<li> the source file <b><tt>imain.h</tt></b>, the documented +API for Ghostscript <em>not</em> as a DLL +</ul> + +<p> +or if you are going to use only the Ghostscript graphics library, + +<ul> +<li> about the structure of the <a href="Lib.htm">Ghostscript library</a> +and its interfaces +</ul> + +<hr> + +<h2><a name="Writer"></a>What if I'm writing documentation?</h2> + +<p> +If you are editing or adding to Ghostscript's existing documentation in +HTML format, or writing a new document, you should read + +<ul> +<li> the <a href="Htmstyle.htm">coding and style guidelines</a> for +Ghostscript's HTML-based documentation. +</ul> + +<hr> + +<h2><a name="Web_presence"></a>Presence on the World Wide Web</h2> + +<h3><a name="Web_home_page"></a>Ghostscript's home page</h3> + +<p> +GNU Ghostscript has a home page on the World Wide Web with helpful +information. Pleave visit: + +<blockquote> +<a href="http://www.gnu.org/software/ghostscript/" +class="offsite">http://www.gnu.org/software/ghostscript/</a> +</blockquote> + +<p> +More material about Ghostscript can be found at + +<blockquote> +<a href="http://www.ghostscript.com/" class="offsite">http://www.ghostscript.com/</a> +</blockquote> + +<h3><a name="Adobe_documentation"></a>Adobe PostScript, Encapsulated +PostScript, and PDF reference documentation</h3> + +<p> +Adobe makes a wealth of +<a href="http://partners.adobe.com/asn/developer/technotes.html" +class="offsite"> +technical documentation</a> available over the Web, including the +<a href="http://partners.adobe.com/asn/developer/pdfs/tn/PLRM.pdf" +class="offsite"> +PostScript Language Reference Manual (Third Edition)</a>; the +<a +href="http://partners.adobe.com/asn/developer/pdfs/tn/5002.EPSF_Spec.pdf" +class="offsite"> +Encapsulated PostScript</a> (EPS) Format Specification version 3, including +<a href="#Ps2epsi">Encapsulated PostScript Interchange (EPSI)</a> +format; the +<a +href="http://partners.adobe.com/asn/developer/acrosdk/DOCS/pdfspec.pdf" +class="offsite"> +PDF 1.3 specification</a>; and the +<a +href="http://partners.adobe.com/asn/developer/acrosdk/DOCS/pdfmark.pdf" +class="offsite"> +pdfmark</a>, +<a href="http://partners.adobe.com/asn/developer/acrosdk/docs/PDF_Transparency.pdf" +class="offsite">transparency</a> and +<a +href="http://partners.adobe.com/asn/developer/acrosdk/DOCS/distparm.pdf" +class="offsite"> +Acrobat Distiller parameters</a> documentation. Some of these documents +are also available at <a href="ftp://ftp.adobe.com/pub/adobe/" +class="offsite">Adobe's ftp +site</a>, but not necessarily under the same filenames. + +<h3><a name="Web_other"></a>Other material on the WWW</h3> + +<p> +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. + +<p> +There is a good manual for Ghostscript available in PDF form, +in English and German (and soon in Japanese), at: + +<blockquote> +<a href="http://www.pdflib.com" +class="offsite">http://www.pdflib.com/gsmanual</a> +</blockquote> + +<p> +There is a translation of the Ghostscript 'man' pages into Czech at: + +<blockquote> +<a href="http://www.volny.cz/rebus/ghostscript/" +class="offsite">http://www.volny.cz/rebus/ghostscript/</a> +</blockquote> + +<hr> + +<h2><a name="Ordered_roadmap"></a>Which document contains what?</h2> + +<p> Here is the list in alphabetic order of Ghostscript documentation, +with explanations of the contents. + +<dl> +<dt><a name="API"></a><a href="API.htm"><b>API.htm</b></a> +<dd> 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. +</dl> + +<dl> +<dt><a name="C-style"></a><a href="C-style.htm"><b>C-style.htm</b></a> +<dd> Guidelines and style for C coding, which you should follow +if, for example, you <a href="#Drivers">write a new driver</a> or add or +change something in Ghostscript. For developers. +</dl> + +<dl> +<dt><a name="Changes"></a><a href="Changes.htm"><b>Changes.htm</b></a> +<dd> A detailed list of all code changes in the current release or +pre-release, generated mechanically from the CVS logs. For developers. +</dl> + +<dl> +<dt><a name="CJK"></a><a href="CJK.htm"><b>CJK.htm</b></a> +<dd> Usage of features to support CJK CID-keyed fonts in Ghostscript. +</dl> + +<dl> +<dt><a name="CJKTTCID"></a><a href="CJKTTCID.htm"><b>CJKTTCID.htm</b></a> +<dd> Note providing information on utilization of CJK (Chinese, +Japanese and Korean) TrueType fonts as CIDFontType2 fonts from the +viewpoint of its validity and limitations. +</dl> + +<dl> +<dt><a name="Current"></a><a href="Current.htm"><b>Current.htm</b></a> +<dd> Information specifically about the current release of Ghostscript. +See also the <a href="#News">latest news</a> of changes. +</dl> + +<dl> +<dt><a name="DLL"></a><a href="DLL.htm"><b>DLL.htm</b></a> +<dd> 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. <b>This DLL interface is obsolete.</b> +Use <a href="#API"><b>API.htm</b></a> instead. +</dl> + +<dl> +<dt><a name="Develop"></a><a href="Develop.htm"><b>Develop.htm</b></a> +<dd> Code orientation for developers. Contains a detailed breakdown of +the source files by functional group, and overviews of the major +architectural features and services. +</dl> + +<dl> +<dt><a name="Devices"></a><a href="Devices.htm"><b>Devices.htm</b></a> +<dd> Detailed information about some specific devices for which Ghostscript +can produce output. Run "<b><tt>gs -h</tt></b>" to see which +devices a particular version of Ghostscript is built to use. +</dl> + +<dl> +<dt><a name="Drivers"></a><a href="Drivers.htm"><b>Drivers.htm</b></a> +<dd> Describes the interface between Ghostscript and device drivers. If +you do this, you should also read and use the <a href="#C-style">C style +and coding guidelines</a>. Necessary to develop a new driver. For +developers. +</dl> + +<dl> +<dt><a name="Fonts"></a><a href="Fonts.htm"><b>Fonts.htm</b></a> <dd> 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. +</dl> + +<dl> +<dt><a name="Helpers"></a><a href="Helpers.htm"><b>Helpers.htm</b></a> +<dd> A note of thanks to people who have helped in the development of +Ghostscript. +</dl> + +<dl> +<dt><a name="Hershey"></a><a href="Hershey.htm"><b>Hershey.htm</b></a> +<dd> Part 1 of the five-part original Usenet distribution of the free +Hershey fonts, giving the terms of use and describing their encoding. +</dl> + +<dl> +<dt><a name="History"></a><b>History*.htm</b> +<dd> The history of changes in all Ghostscript releases: +<blockquote> +<a href="History7.htm">History7.htm</a> for Ghostscript versions 7.n<br> +<a href="History6.htm">History6.htm</a> for Ghostscript versions 6.n<br> +<a href="History5.htm">History5.htm</a> for Ghostscript versions 5.n<br> +<a href="History4.htm">History4.htm</a> for Ghostscript versions 4.n<br> +<a href="History3.htm">History3.htm</a> for Ghostscript versions 3.n<br> +<a href="History2.htm">History2.htm</a> for Ghostscript versions 2.n<br> +<a href="History1.htm">History1.htm</a> for Ghostscript versions 1.n +</blockquote> +</dl> + +<dl> +<dt><a name="Htmstyle"></a><a href="Htmstyle.htm"><b>Htmstyle.htm</b></a> +<dd> 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. +</dl> + +<dl> +<dt><a name="Humor"></a><a href="Humor.htm"><b>Humor.htm</b></a> +<dd> Another Ghostscript interpreter. +</dl> + +<dl> +<dt><a name="Install"></a><a href="Install.htm"><b>Install.htm</b></a> +<dd> How to install Ghostscript. See also <a href="#Make">how to build +it</a>. +</dl> + +<dl> +<dt><a name="Issues"></a><a href="Issues.htm"><b>Issues.htm</b></a> +<dd> A list of outstanding open issues in Ghostscript. These include +known limitations, minor bugs, performance issues, differences from +Adobe implementations, and others. +</dl> + +<dl> +<dt><a name="Language"></a><a href="Language.htm"><b>Language.htm</b></a> +<dd> The relationship between the Ghostscript interpreter and the +PostScript language as defined by Adobe. +</dl> + +<dl> +<dt><a name="Lib"></a><a href="Lib.htm"><b>Lib.htm</b></a> +<dd> 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. +</dl> + +<dl> +<dt><a name="Maintain"></a><a href="Maintain.htm"><b>Maintain.htm</b></a> +<dd> Assorted Ghostscript maintenance procedures. For developers. +</dl> + +<dl> +<dt><a name="Make"></a><a href="Make.htm"><b>Make.htm</b></a> +<dd> How to build Ghostscript executables from the source code. See also +<a href="#Install">how to install it</a>. It's not necessary to be a highly +experienced developer to build or install Ghostscript, but some experience +is needed. +</dl> + +<dl> +<dt><a name="New-user"></a><a href="New-user.htm"><b>New-user.htm</b></a> +<dd> Essential information for new users of Ghostscript. +</dl> + +<dl> +<dt><a name="News"></a><a href="News.htm"><b>News.htm</b></a> +<dd> 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 "<b><tt>History*.htm</tt></b>", +which are usually installed in the documentation directory. Run +"<b><tt>gs -h</tt></b>" to see where that is. +</dl> + +<dl> +<dt><a name="Projects"></a><a href="Projects.htm"><b>Projects.htm</b></a> +<dd> A list of Ghostscript development projects with which we would like +help. +</dl> + +<dl> +<dt><a name="Ps-style"></a><a +href="Ps-style.htm"><b>Ps-style.htm</b></a> +<dd> 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. +</dl> + +<dl> +<dt><a name="Ps2epsi"></a><a href="Ps2epsi.htm"><b>Ps2epsi.htm</b></a> +<dd> Detailed information on how to use Ghostscript through +<tt><b>ps2epsi</b></tt> to convert PostScript to Adobe +Encapsulated PostScript Interchange (EPSI) format. +</dl> + +<dl> +<dt><a name="Ps2pdf"></a><a href="Ps2pdf.htm"><b>Ps2pdf.htm</b></a> +<dd> Detailed information on how to use Ghostscript through +<tt><b>ps2pdf</b></tt> to convert PostScript to Adobe +Portable Document Format (PDF). +</dl> + +<dl> +<dt><a name="Psfiles"></a><a href="Psfiles.htm"><b>Psfiles.htm</b></a> +<dd> A description of the PostScript files (other than font files) +distributed with Ghostscript, including initialization routines, utility +programs, and sample printable files. +</dl> + +<dl> +<dt><a name="Readme"></a><b>Readme.htm</b> +<dd> This document. +</dl> + +<dl> +<dt><a name="Release"></a><a href="Release.htm"><b>Release.htm</b></a> +<dd> 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. +</dl> + +<dl> +<dt><a name="Source"></a><a href="Source.htm"><b>Source.htm</b></a> +<dd> A guide to the Ghostscript source code, for development and debugging. +</dl> + +<dl> +<dt><a name="Unix-lpr"></a><a href="Unix-lpr.htm"><b>Unix-lpr.htm</b></a> +<dd> How to set up Ghostscript as a Unix <tt><b>lpr</b></tt> +filter. +</dl> + +<dl> +<dt><a name="Use"></a><a href="Use.htm"><b>Use.htm</b></a> +<dd> 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. +</dl> + +<dl> +<dt><a name="Xfonts"></a><a href="Xfonts.htm"><b>Xfonts.htm</b></a> +<dd> Ghostscript's external font interface to a host platform's +font-rendering mechanism, for developers. +</dl> + +<!-- [2.0 end contents] ==================================================== --> + +<!-- [3.0 begin visible trailer] =========================================== --> +<hr> + +<p> +<small>Copyright © 1996, 2000 Aladdin Enterprises. All rights +reserved.</small> + +<p> +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. + +<p> +<small>Ghostscript version 7.07, 17 May 2003 + +<!-- [3.0 end visible trailer] ============================================= --> + +</body> +</html> |