xref: /plan9/sys/src/cmd/gs/doc/Install.htm (revision 593dc095aefb2a85c828727bbfa9da139a49bdf4)
13ff48bf5SDavid du Colombier<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
27dd7cddfSDavid du Colombier<html>
37dd7cddfSDavid du Colombier<head>
47dd7cddfSDavid du Colombier<title>How to install Ghostscript</title>
5*593dc095SDavid du Colombier<!-- $Id: Install.htm,v 1.56 2005/10/20 19:46:23 ray Exp $ -->
67dd7cddfSDavid du Colombier<!-- Originally: install.txt -->
73ff48bf5SDavid du Colombier<link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style">
87dd7cddfSDavid du Colombier</head>
97dd7cddfSDavid du Colombier
107dd7cddfSDavid du Colombier<body>
117dd7cddfSDavid du Colombier<!-- [1.0 begin visible header] ============================================ -->
127dd7cddfSDavid du Colombier
137dd7cddfSDavid du Colombier<!-- [1.1 begin headline] ================================================== -->
147dd7cddfSDavid du Colombier
153ff48bf5SDavid du Colombier<h1>How to install Ghostscript</h1>
167dd7cddfSDavid du Colombier
177dd7cddfSDavid du Colombier<!-- [1.1 end headline] ==================================================== -->
187dd7cddfSDavid du Colombier
197dd7cddfSDavid du Colombier<!-- [1.2 begin table of contents] ========================================= -->
207dd7cddfSDavid du Colombier
217dd7cddfSDavid du Colombier<h2>Table of contents</h2>
227dd7cddfSDavid du Colombier
237dd7cddfSDavid du Colombier<blockquote><ul>
247dd7cddfSDavid du Colombier<li><a href="#Overview">Overview of how to install Ghostscript</a>
257dd7cddfSDavid du Colombier<li><a href="#Install_Unix">Installing Ghostscript on Unix</a>
267dd7cddfSDavid du Colombier<ul>
273ff48bf5SDavid du Colombier<li><a href="#Shared_object">Ghostscript as a shared object</a>
287dd7cddfSDavid du Colombier<li><a href="#Install_Linux">Additional notes on Linux</a>
297dd7cddfSDavid du Colombier</ul>
307dd7cddfSDavid du Colombier<li><a href="#Install_Windows">Installing Ghostscript on MS Windows</a>
317dd7cddfSDavid du Colombier<li><a href="#Install_VMS">Installing Ghostscript on OpenVMS</a>
327dd7cddfSDavid du Colombier<li><a href="#Install_DOS">Installing Ghostscript on DOS</a>
337dd7cddfSDavid du Colombier<li><a href="#Install_OS2">Installing Ghostscript on OS/2 2.x</a>
347dd7cddfSDavid du Colombier</ul></blockquote>
357dd7cddfSDavid du Colombier
367dd7cddfSDavid du Colombier<!-- [1.2 end table of contents] =========================================== -->
377dd7cddfSDavid du Colombier
387dd7cddfSDavid du Colombier<!-- [1.3 begin hint] ====================================================== -->
397dd7cddfSDavid du Colombier
407dd7cddfSDavid du Colombier<p>For other information, see the <a href="Readme.htm">Ghostscript
417dd7cddfSDavid du Colombieroverview</a> and "<a href="Make.htm">How to build Ghostscript from source
427dd7cddfSDavid du Colombiercode</a>".
437dd7cddfSDavid du Colombier
447dd7cddfSDavid du Colombier<!-- [1.3 end hint] ======================================================== -->
457dd7cddfSDavid du Colombier
467dd7cddfSDavid du Colombier<hr>
477dd7cddfSDavid du Colombier
487dd7cddfSDavid du Colombier<!-- [1.0 end visible header] ============================================== -->
497dd7cddfSDavid du Colombier
507dd7cddfSDavid du Colombier<!-- [2.0 begin contents] ================================================== -->
517dd7cddfSDavid du Colombier
523ff48bf5SDavid du Colombier<h2><a name="Overview"></a>Overview of how to install Ghostscript</h2>
537dd7cddfSDavid du Colombier
547dd7cddfSDavid du Colombier<p>
557dd7cddfSDavid du ColombierYou must have three things to run Ghostscript:
567dd7cddfSDavid du Colombier<ol>
577dd7cddfSDavid du Colombier<li>The Ghostscript executable file; on some operating
587dd7cddfSDavid du Colombiersystems, more than one file is required.  These are entirely
597dd7cddfSDavid du Colombierplatform-specific.  See below for details.
607dd7cddfSDavid du Colombier
617dd7cddfSDavid du Colombier<li>Initialization files that Ghostscript reads in when it
627dd7cddfSDavid du Colombierstarts up; these are the same on all platforms.
637dd7cddfSDavid du Colombier<ul>
647dd7cddfSDavid du Colombier<li><b><tt>gs_</tt></b>*<b><tt>.ps</tt></b> unless Ghostscript was compiled
657dd7cddfSDavid du Colombierusing the "compiled initialization files" option.  See the documentation of
667dd7cddfSDavid du Colombier<a href="Psfiles.htm">PostScript files distributed with Ghostscript</a>.
677dd7cddfSDavid du Colombier
687dd7cddfSDavid du Colombier<li><b><tt>pdf_</tt></b>*<b><tt>.ps</tt></b> if Ghostscript was compiled
697dd7cddfSDavid du Colombierwith the ability to interpret Adobe Portable Document Format (PDF) files,
707dd7cddfSDavid du Colombierthat is, <b><tt>pdf.dev</tt></b> was included in
717dd7cddfSDavid du Colombier<b><tt>FEATURE_DEVS</tt></b> when Ghostscript was built.
727dd7cddfSDavid du Colombier
737dd7cddfSDavid du Colombier<li><b><tt>Fontmap</tt></b> and <b><tt>Fontmap.GS</tt></b> (or the
747dd7cddfSDavid du Colombierappropriate <b><tt>Fontmap.</tt></b><em>xxx</em> for your platform), unless
757dd7cddfSDavid du Colombieryou plan always to invoke Ghostscript with the <a
767dd7cddfSDavid du Colombierhref="Use.htm#FONTMAP_switch"><b><tt>-dNOFONTMAP</tt></b> switch</a>.
777dd7cddfSDavid du Colombier</ul>
787dd7cddfSDavid du Colombier
797dd7cddfSDavid du Colombier<li>Fonts, for rendering text.  These are platform-independent,
807dd7cddfSDavid du Colombierbut if you already have fonts of the right kind on your platform,
817dd7cddfSDavid du Colombieryou may be able to use those.  See below for details.  Also see the
827dd7cddfSDavid du Colombier<a href="Fonts.htm">documentation on fonts</a>.
837dd7cddfSDavid du Colombier</ol>
847dd7cddfSDavid du Colombier
857dd7cddfSDavid du Colombier<p>
867dd7cddfSDavid du ColombierThe <a href="Use.htm">usage documentation</a> describes the search
877dd7cddfSDavid du Colombieralgorithms used to find initialization files and font files.  The
887dd7cddfSDavid du Colombierper-platform descriptions that follow tell you where to install these
897dd7cddfSDavid du Colombierfiles.
907dd7cddfSDavid du Colombier
917dd7cddfSDavid du Colombier<hr>
927dd7cddfSDavid du Colombier
933ff48bf5SDavid du Colombier<h2><a name="Install_Unix"></a>Installing Ghostscript on Unix</h2>
947dd7cddfSDavid du Colombier
957dd7cddfSDavid du Colombier<p>
96*593dc095SDavid du ColombierGhostscript uses the common configure, build and install method common
97*593dc095SDavid du Colombierto many modern software packages. In general the following with suffice
98*593dc095SDavid du Colombierto build ghostscript:
99*593dc095SDavid du Colombier<blockquote><tt><b>
100*593dc095SDavid du Colombier	./configure<br>
101*593dc095SDavid du Colombier	make
102*593dc095SDavid du Colombier</b></tt></blockquote>
103*593dc095SDavid du Colombierand then it may be installed in the default location with:
104*593dc095SDavid du Colombier<blockquote><b>
105*593dc095SDavid du Colombier	<tt>make install</tt>
106*593dc095SDavid du Colombier</b></blockquote>
107*593dc095SDavid du ColombierThis last command may need to be performed with super user privileges.
1087dd7cddfSDavid du Colombier
109*593dc095SDavid du Colombier<p>
110*593dc095SDavid du ColombierYou can set the installation directory by adding <tt>--prefix=<em>path</em></tt>
111*593dc095SDavid du Colombierto the configure invocation in the first step. The default prefix is <tt>/usr/local</tt>,
112*593dc095SDavid du Colombierwhich is to say the <tt>gs</tt> executable is installed as <tt>/usr/local/bin/gs</tt>.
113*593dc095SDavid du Colombier
114*593dc095SDavid du Colombier</p>A list of similar configuration options is available via <tt>./configure --help</tt>
115*593dc095SDavid du Colombier
116*593dc095SDavid du Colombier<p>
117*593dc095SDavid du ColombierFor more detailed information on building Ghostscript see
118*593dc095SDavid du Colombier<a href="Make.htm#Unix_build">how to build Ghostscript on Unix</a> in
119*593dc095SDavid du Colombierthe documentation on building Ghostscript, especially regarding information
120*593dc095SDavid du Colombieron using the older <a href="Make.htm#UNIX_makefile">hand edited makefile</a>
121*593dc095SDavid du Colombierapproach. Whatever configuration method you use, execute "<b><tt>make
122*593dc095SDavid du Colombierinstall</tt></b>" to install the executable and all the required and
123*593dc095SDavid du Colombierancillary files after the build is complete.
124*593dc095SDavid du Colombier
125*593dc095SDavid du Colombier<h3><a name="Use_Acrobat_fonts_Unix"></a>Fonts</h3>
126*593dc095SDavid du Colombier
127*593dc095SDavid du Colombier<p>
1287dd7cddfSDavid du ColombierThe makefile installs all the files except fonts under the directory
129*593dc095SDavid du Colombierdefined in the makefile as <b><tt>prefix</tt></b>. Fonts need to be
130*593dc095SDavid du Colombierinstalled separately. The fonts should be installed in
131*593dc095SDavid du Colombier<tt><em>{prefix}</em>/share/ghostscript/fonts</tt>.
132*593dc095SDavid du Colombier(That is, <tt>/usr/local/share/ghostscript/fonts/</tt> if you used the default
133*593dc095SDavid du Colombierconfiguration above.)
134*593dc095SDavid du Colombier
135*593dc095SDavid du Colombier<p>
136*593dc095SDavid du ColombierIf you have Adobe Acrobat installed, you can use the Acrobat fonts
137*593dc095SDavid du Colombierin place of the ones distributed with with Ghostscript by adding the
138*593dc095SDavid du ColombierAcrobat fonts directory to
1397dd7cddfSDavid du Colombier<b><tt>GS_FONTPATH</tt></b> and removing these fonts from
1407dd7cddfSDavid du Colombier<b><tt>Fontmap.GS</tt></b>:
1417dd7cddfSDavid du Colombier
1427dd7cddfSDavid du Colombier<blockquote>
1437dd7cddfSDavid du ColombierCourier, Courier-Bold, Courier-BoldOblique, Courier-Oblique, Helvetica,
1447dd7cddfSDavid du ColombierHelvetica-Bold, Helvetica-BoldOblique, Helvetica-Oblique, Symbol, Times-Bold,
1457dd7cddfSDavid du ColombierTimes-BoldItalic, Times-Italic, Times-Roman, ZapfDingbats
1467dd7cddfSDavid du Colombier</blockquote>
1477dd7cddfSDavid du Colombier
148*593dc095SDavid du Colombier<p>
149*593dc095SDavid du ColombierSimilarly, you can have ghostscript use other fonts on your system by adding
150*593dc095SDavid du Colombierentries to the fontmap or adding the directories to the GS_FONTMAP environment
151*593dc095SDavid du Colombiervariable. See the <a href="Use.htm#Font_lookup">usage documentation</a> for more
152*593dc095SDavid du Colombierinformation.
153*593dc095SDavid du ColombierFor example, many linux distributions place fonts under <tt>/usr/share/fonts</tt>.
154*593dc095SDavid du Colombier
1553ff48bf5SDavid du Colombier<h3><a name="Shared_object"></a>Ghostscript as a shared object</h3>
156*593dc095SDavid du ColombierIf you've built Ghostscript as a shared object, instead of '<tt>make install</tt>',
157*593dc095SDavid du Colombieryou must use '<tt>make soinstall</tt>'.
1583ff48bf5SDavid du ColombierSee <a href="Make.htm#Shared_object">how to build Ghostscript
1593ff48bf5SDavid du Colombieras a shared object</a> for more details.
1603ff48bf5SDavid du Colombier
1613ff48bf5SDavid du Colombier<h3><a name="Install_Linux"></a>Additional notes on Linux</h3>
1627dd7cddfSDavid du Colombier
1637dd7cddfSDavid du Colombier<p>
1647dd7cddfSDavid du ColombierFor Linux, you may be able to install or upgrade Ghostscript from
1657dd7cddfSDavid du Colombierprecompiled <a href="http://www.rpm.org">RPM</a> files using:
1667dd7cddfSDavid du Colombier
1677dd7cddfSDavid du Colombier<blockquote><b><tt>
1687dd7cddfSDavid du Colombierrpm -U ghostscript-N.NN-1.i386.rpm<br>
1697dd7cddfSDavid du Colombierrpm -U ghostscript-fonts-N.NN-1.noarch.rpm
1707dd7cddfSDavid du Colombier</tt></b></blockquote>
1717dd7cddfSDavid du Colombier
1727dd7cddfSDavid du Colombier<p>
1733ff48bf5SDavid du ColombierHowever, please note that we do not create RPMs for Ghostscript, and we take
1743ff48bf5SDavid du Colombierno responsibility for RPMs created by others.
1757dd7cddfSDavid du Colombier
1767dd7cddfSDavid du Colombier<hr>
1777dd7cddfSDavid du Colombier
1783ff48bf5SDavid du Colombier<h2><a name="Install_Windows"></a>Installing Ghostscript on MS Windows</h2>
1797dd7cddfSDavid du Colombier
1807dd7cddfSDavid du Colombier<p>
1813ff48bf5SDavid du ColombierWe usually distribute Ghostscript releases for Windows as self-extracting
1823ff48bf5SDavid du Colombierarchive files, since this is the most convenient form for users.  These
1833ff48bf5SDavid du Colombierfiles can also be unpacked as if they were plain zip files.
1847dd7cddfSDavid du Colombier
1857dd7cddfSDavid du Colombier<p>
1867dd7cddfSDavid du ColombierThe self-extracting archive is normally named
1877dd7cddfSDavid du Colombier<b><tt>gs###w32.exe</tt></b>,
1883ff48bf5SDavid du Colombierwhere ### is the release number (e.g., 650 for Ghostscript 6.50,
1893ff48bf5SDavid du Colombier700 for Ghostscript 7.00).
1907dd7cddfSDavid du Colombier
1913ff48bf5SDavid du Colombier<h3><a name="Windows4"></a>Windows 95/98 and NT 4</h3>
1927dd7cddfSDavid du Colombier
1937dd7cddfSDavid du Colombier<p>
1947dd7cddfSDavid du ColombierTo install a self-extracting Ghostscript archive on Windows 95/98 or
1953ff48bf5SDavid du ColombierWindows NT4/2000, you need just this self-extracting archive file.
1963ff48bf5SDavid du ColombierRun this file to install Ghostscript.
1977dd7cddfSDavid du Colombier
1987dd7cddfSDavid du Colombier<p>
1997dd7cddfSDavid du ColombierAlternatively, if you have the zip file, unzip it to a temporary
2007dd7cddfSDavid du Colombierdirectory then run the included <b><tt>setupgs.exe</tt></b>.
2017dd7cddfSDavid du ColombierAfter the setup program has finished, remove the temporary files.
2027dd7cddfSDavid du Colombier
2037dd7cddfSDavid du Colombier<p>
2047dd7cddfSDavid du ColombierAfter installing Ghostscript, it is strongly recommended that you
205*593dc095SDavid du Colombierinstall the <b>GSview previewer</b>,
2067dd7cddfSDavid du Colombierwhich provides an easier to use graphical interface for Ghostscript.
2077dd7cddfSDavid du ColombierInformation on GSview is available from:
2087dd7cddfSDavid du Colombier
2097dd7cddfSDavid du Colombier<blockquote>
2107dd7cddfSDavid du Colombier<a
2113ff48bf5SDavid du Colombierhref="http://www.cs.wisc.edu/~ghost/gsview/"
2123ff48bf5SDavid du Colombierclass="offsite">http://www.cs.wisc.edu/~ghost/gsview/</a>
2137dd7cddfSDavid du Colombier</blockquote>
2147dd7cddfSDavid du Colombier
2153ff48bf5SDavid du Colombier<h3><a name="General_Windows"></a>General Windows configuration</h3>
2167dd7cddfSDavid du Colombier
2177dd7cddfSDavid du Colombier<p>
2187dd7cddfSDavid du ColombierThe archive includes files in these subdirectories:
2197dd7cddfSDavid du Colombier
2207dd7cddfSDavid du Colombier<blockquote><b><tt>
2213ff48bf5SDavid du Colombiergs<em>#.##</em>\bin
2223ff48bf5SDavid du Colombier<br>gs<em>#.##</em>\lib
2233ff48bf5SDavid du Colombier<br>gs<em>#.##</em>\examples
2243ff48bf5SDavid du Colombier<br>gs<em>#.##</em>\doc
2257dd7cddfSDavid du Colombier<br>fonts
2267dd7cddfSDavid du Colombier</tt></b></blockquote>
2277dd7cddfSDavid du Colombier
2287dd7cddfSDavid du Colombier<p>
2293ff48bf5SDavid du ColombierThe actual executable files, in the <b><tt>gs<em>#.##</em>\bin</tt></b>
2307dd7cddfSDavid du Colombiersubdirectory, are:
2317dd7cddfSDavid du Colombier
2327dd7cddfSDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
2337dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSWIN32.EXE</tt></b>
2347dd7cddfSDavid du Colombier	<td>&nbsp;
2357dd7cddfSDavid du Colombier	<td>32-bit Ghostscript using windows
2367dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSWIN32C.EXE</tt></b>
2377dd7cddfSDavid du Colombier	<td>&nbsp;
2387dd7cddfSDavid du Colombier	<td>32-bit Ghostscript using only the command line
2397dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSDLL32.DLL</tt></b>
2407dd7cddfSDavid du Colombier	<td>&nbsp;
2417dd7cddfSDavid du Colombier	<td>32-bit dynamic link library containing most of Ghostscript's
2427dd7cddfSDavid du Colombierfunctionality
2437dd7cddfSDavid du Colombier</table></blockquote>
2447dd7cddfSDavid du Colombier
2457dd7cddfSDavid du Colombier<p>
2467dd7cddfSDavid du ColombierSee "<a href="#Install_DOS">Installing Ghostscript on DOS</a>" below for
2477dd7cddfSDavid du Colombierinformation about using Adobe Type Manager, Adobe Type Basics, or Adobe
2487dd7cddfSDavid du ColombierAcrobat fonts.  If your system uses TrueType fonts, you can get them
2497dd7cddfSDavid du Colombierconverted to a Ghostscript-compatible format at the time you select your
2507dd7cddfSDavid du Colombier"printer" by doing the following:
2517dd7cddfSDavid du Colombier
2527dd7cddfSDavid du Colombier<blockquote><ol>
2537dd7cddfSDavid du Colombier<li>Open control panel and double-click on the "Printers" icon.
254*593dc095SDavid du Colombier<li>Select your PostScript printer.
2557dd7cddfSDavid du Colombier<li>Choose Setup.
2567dd7cddfSDavid du Colombier<li>Choose Options.
2577dd7cddfSDavid du Colombier<li>Choose Advanced.
2587dd7cddfSDavid du Colombier<li>At the top of the dialog box you will see TrueType Fonts Send to
2597dd7cddfSDavid du ColombierPrinter As: Choose <em>(drop-down menu)</em> Adobe Type 1.
2607dd7cddfSDavid du Colombier<li>Uncheck Use Printer Fonts for All TrueType Fonts and Use
2617dd7cddfSDavid du ColombierSubstitution
2627dd7cddfSDavid du ColombierTable.
2637dd7cddfSDavid du Colombier<li>OK.
2647dd7cddfSDavid du Colombier<li>OK etc.
2657dd7cddfSDavid du Colombier</ol></blockquote>
2667dd7cddfSDavid du Colombier
2677dd7cddfSDavid du Colombier<p>
2687dd7cddfSDavid du ColombierThat's it!  Your TrueType fonts will automatically be downloaded in your
2697dd7cddfSDavid du ColombierPostScript file for Ghostscript to use.
2707dd7cddfSDavid du Colombier
2717dd7cddfSDavid du Colombier<p>
2727dd7cddfSDavid du ColombierFor printer devices, the default output is:
2737dd7cddfSDavid du Colombier
2747dd7cddfSDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
2757dd7cddfSDavid du Colombier<tr valign=top>	<td>The default printer
2767dd7cddfSDavid du Colombier	<td>&nbsp;&nbsp;&nbsp;
2777dd7cddfSDavid du Colombier	<td>Win95 or WinNT
2787dd7cddfSDavid du Colombier<tr valign=top>	<td>Prompt for a printer port
2797dd7cddfSDavid du Colombier	<td>&nbsp;
2807dd7cddfSDavid du Colombier	<td>Win32s (Windows 3.1)
2817dd7cddfSDavid du Colombier</table></blockquote>
2827dd7cddfSDavid du Colombier
2837dd7cddfSDavid du Colombier<p>
2847dd7cddfSDavid du ColombierThis can be modified as follows.
2857dd7cddfSDavid du Colombier
2867dd7cddfSDavid du Colombier<blockquote>
2877dd7cddfSDavid du Colombier<dl>
2887dd7cddfSDavid du Colombier<dt><b><tt>-sOutputFile="LPT1:"</tt></b>
2897dd7cddfSDavid du Colombier<dd>Output to the named port.
2907dd7cddfSDavid du Colombier
2913ff48bf5SDavid du Colombier<dt><b><tt>-sOutputFile="%printer%printer name"</tt></b> (Windows 95, 98,
2923ff48bf5SDavid du ColombierNT or 2000)
2933ff48bf5SDavid du Colombier<dd>Output to the named printer.  If your printer is named "HP DeskJet 500"
2943ff48bf5SDavid du Colombierthen you would use <tt>-sOutputFile="%printer%HP DeskJet 500"</tt>.
2957dd7cddfSDavid du Colombier
2963ff48bf5SDavid du Colombier<dt><b><tt>-sOutputFile="\\spool\printer name"</tt></b> (Windows 3.1/Win32s)
2973ff48bf5SDavid du Colombier<dd>Output to the named printer.  Note that this is NOT a UNC name.
2983ff48bf5SDavid du Colombier
2997dd7cddfSDavid du Colombier</dl>
3007dd7cddfSDavid du Colombier</blockquote>
3017dd7cddfSDavid du Colombier
3027dd7cddfSDavid du Colombier<p>
3037dd7cddfSDavid du ColombierIf Ghostscript fails to find an environment variable, it looks for a
3047dd7cddfSDavid du Colombierregistry value of the same name under the key
3057dd7cddfSDavid du Colombier
3067dd7cddfSDavid du Colombier<blockquote><b><tt>
3073ff48bf5SDavid du ColombierHKEY_CURRENT_USER\Software\AFPL Ghostscript\#.##
3087dd7cddfSDavid du Colombier</tt></b></blockquote>
3097dd7cddfSDavid du Colombier
3107dd7cddfSDavid du Colombier<p>
3117dd7cddfSDavid du Colombieror if that fails, under the key
3127dd7cddfSDavid du Colombier
3137dd7cddfSDavid du Colombier<blockquote><b><tt>
3143ff48bf5SDavid du ColombierHKEY_LOCAL_MACHINE\SOFTWARE\AFPL Ghostscript\#.##
3157dd7cddfSDavid du Colombier</tt></b></blockquote>
3167dd7cddfSDavid du Colombier
3177dd7cddfSDavid du Colombier<p>
3187dd7cddfSDavid du Colombierwhere #.## is the Ghostscript version number.  This does not work under
3197dd7cddfSDavid du ColombierWin32s (that is, Windows 3.1, which doesn't support named registry
3207dd7cddfSDavid du Colombiervalues).
3217dd7cddfSDavid du Colombier
3227dd7cddfSDavid du Colombier<p>
3233ff48bf5SDavid du ColombierGhostscript will attempt to load the Ghostscript dynamic link
3243ff48bf5SDavid du Colombierlibrary <b><tt>GSDLL32.DLL</tt></b> in the following order:
3253ff48bf5SDavid du Colombier<ul>
3263ff48bf5SDavid du Colombier<li> In the same directory as the Ghostscript executable.
3273ff48bf5SDavid du Colombier<li> If the environment variable <b><tt>GS_DLL</tt></b> is defined,
3283ff48bf5SDavid du ColombierGhostscript tries to load the Ghostscript dynamic link library (DLL)
3293ff48bf5SDavid du Colombierwith the name given.
3303ff48bf5SDavid du Colombier<li> Using the standard Windows library search method: the directory
3313ff48bf5SDavid du Colombierfrom which the application loaded, the current directory, the Windows
3323ff48bf5SDavid du Colombiersystem directory, the Windows directory and the directories listed in
3333ff48bf5SDavid du Colombierthe PATH environment variable.
3343ff48bf5SDavid du Colombier</ul>
3357dd7cddfSDavid du Colombier
3367dd7cddfSDavid du Colombier<p>
3377dd7cddfSDavid du ColombierThe Ghostscript setup program will create registry values
3387dd7cddfSDavid du Colombierfor the environment variables <b><tt>GS_LIB</tt></b>
3397dd7cddfSDavid du Colombierand <b><tt>GS_DLL</tt></b>.
3407dd7cddfSDavid du Colombier
3413ff48bf5SDavid du Colombier<h3><a name="Uninstall_Windows"></a>Uninstalling Ghostscript on Windows</h3>
3427dd7cddfSDavid du Colombier
3437dd7cddfSDavid du Colombier<p>
3447dd7cddfSDavid du ColombierTo uninstall Ghostscript, use the Control Panel, Add/Remove Programs and
3453ff48bf5SDavid du Colombierremove "Ghostscript #.##" and "Ghostscript Fonts".  (The entries may be
3463ff48bf5SDavid du Colombiercalled "Aladdin Ghostscript" or "AFPL Ghostscript", rather than just
3473ff48bf5SDavid du Colombier"Ghostscript", depending on what version of Ghostscript was installed.)
3487dd7cddfSDavid du Colombier
3497dd7cddfSDavid du Colombier<hr>
3507dd7cddfSDavid du Colombier
3513ff48bf5SDavid du Colombier<h2><a name="Install_VMS"></a>Installing Ghostscript on OpenVMS</h2>
3527dd7cddfSDavid du Colombier
3537dd7cddfSDavid du Colombier<p>
3547dd7cddfSDavid du ColombierYou need the file <b><tt>GS.EXE</tt></b> to run Ghostscript on OpenVMS, and
3557dd7cddfSDavid du Colombierinstalling Ghostscript on an OpenVMS system requires building it first:
3563ff48bf5SDavid du Colombierplease read <a href="Make.htm#VMS_build">how to build Ghostscript on VMS</a>
3573ff48bf5SDavid du Colombierin the documentation on building Ghostscript.
3587dd7cddfSDavid du Colombier
3597dd7cddfSDavid du Colombier<p>
3603ff48bf5SDavid du ColombierThe following installation steps assume that the Ghostscript directory is
3613ff48bf5SDavid du Colombier<b><tt>DISK1:[DIR.GHOSTSCRIPT]</tt></b>.  Yours will almost certainly be in
3623ff48bf5SDavid du Colombiera different location so adjust the following commands accordingly.
3633ff48bf5SDavid du Colombier
3643ff48bf5SDavid du Colombier<ul>
3653ff48bf5SDavid du Colombier
3663ff48bf5SDavid du Colombier<li>Download the fonts and unpack them into
3673ff48bf5SDavid du Colombier<b><tt>DISK1:[DIR.GHOSTSCRIPT.LIB]</tt></b>.
3683ff48bf5SDavid du Colombier
3693ff48bf5SDavid du Colombier<li>Enable access to the program and support files for all users with:
3703ff48bf5SDavid du Colombier
3713ff48bf5SDavid du Colombier<blockquote><pre>
3723ff48bf5SDavid du Colombier$ set file/prot=w:re DISK1:[DIR]GHOSTSCRIPT.dir
3733ff48bf5SDavid du Colombier$ set file/prot=w:re DISK1:[DIR.GHOSTSCRIPT...]*.*
3743ff48bf5SDavid du Colombier</pre></blockquote>
3753ff48bf5SDavid du Colombier
3763ff48bf5SDavid du Colombier<li>Optionally, add the Ghostscript help instructions to your system wide
3773ff48bf5SDavid du Colombierhelp file:
3783ff48bf5SDavid du Colombier
3793ff48bf5SDavid du Colombier<blockquote><pre>
3803ff48bf5SDavid du Colombier$ lib/help sys$help:HELPLIB.HLB DISK1:[DIR.GHOSTSCRIPT.DOC]GS-VMS.HLP
3813ff48bf5SDavid du Colombier</pre></blockquote>
3823ff48bf5SDavid du Colombier
3833ff48bf5SDavid du Colombier<li>Lastly, add the following lines to the appropriate system wide or user
3843ff48bf5SDavid du Colombierspecific login script.
3853ff48bf5SDavid du Colombier
3863ff48bf5SDavid du Colombier<blockquote><pre>
3873ff48bf5SDavid du Colombier$ define gs_exe DISK1:[DIR.GHOSTSCRIPT.BIN]
3883ff48bf5SDavid du Colombier$ define gs_lib DISK1:[DIR.GHOSTSCRIPT.EXE]
3893ff48bf5SDavid du Colombier$ gs :== $gs_exe:gs.exe
3903ff48bf5SDavid du Colombier</pre></blockquote>
3913ff48bf5SDavid du Colombier
3923ff48bf5SDavid du Colombier</ul>
3937dd7cddfSDavid du Colombier
3947dd7cddfSDavid du Colombier<p>
3957dd7cddfSDavid du ColombierIf you have DECWindows/Motif installed, you may wish to replace the
3967dd7cddfSDavid du Colombier<b><tt>FONTMAP.GS</tt></b> file with <b><tt>FONTMAP.VMS</tt></b>.  Read the
3977dd7cddfSDavid du Colombiercomment at the beginning of the latter file for more information.
3987dd7cddfSDavid du Colombier
3997dd7cddfSDavid du Colombier<hr>
4007dd7cddfSDavid du Colombier
4013ff48bf5SDavid du Colombier<h2><a name="Install_DOS"></a>Installing Ghostscript on DOS</h2>
4027dd7cddfSDavid du Colombier
4037dd7cddfSDavid du Colombier<p>
4047dd7cddfSDavid du ColombierYou need the files <b><tt>GS386.EXE</tt></b> and <b><tt>DOS4GW.EXE</tt></b>
4057dd7cddfSDavid du Colombierto run Ghostscript.  You should install all the files except the fonts in
4067dd7cddfSDavid du Colombier<b><tt>C:\GS</tt></b>, and the fonts in <b><tt>C:\GS\FONTS</tt></b>.
4077dd7cddfSDavid du Colombier
4083ff48bf5SDavid du Colombier<p><a name="Use_platform_fonts_DOS"></a> If you have Adobe Type Manager
4093ff48bf5SDavid du Colombier(ATM) fonts installed on your system, and you wish to use them with
4103ff48bf5SDavid du ColombierGhostscript, you may wish to replace the <b><tt>FONTMAP</tt></b> file with
4113ff48bf5SDavid du Colombier<b><tt>FONTMAP.ATM</tt></b>, and to add to the environment variable
4123ff48bf5SDavid du Colombier<b><tt>GS_LIB</tt></b> the name of the directory where the fonts are located
413*593dc095SDavid du Colombier(see <a href="Use.htm#Finding_files">Use.htm</a> for more information
414*593dc095SDavid du Colombierabout <b><tt>GS_LIB</tt></b>).  Before you
4153ff48bf5SDavid du Colombierdo this, please read carefully the license that accompanies the ATM fonts;
4163ff48bf5SDavid du Colombierwe take no responsibility for any possible violations of such licenses.
4173ff48bf5SDavid du ColombierSimilarly, if you have Adobe Type Basics, you may wish to replace
4183ff48bf5SDavid du Colombier<b><tt>FONTMAP</tt></b> with <b><tt>FONTMAP.ATB</tt></b>.  Finally, if you
4193ff48bf5SDavid du Colombierhave neither ATM nor ATB but you have Adobe Acrobat installed, you can use
4203ff48bf5SDavid du Colombierthe Acrobat fonts in place of the ones provided with Ghostscript by adding
4213ff48bf5SDavid du Colombierthe Acrobat fonts directory to <b><tt>GS_FONTPATH</tt></b> and removing
4223ff48bf5SDavid du Colombierthese fonts from <b><tt>FONTMAP</tt></b>:
4237dd7cddfSDavid du Colombier
4247dd7cddfSDavid du Colombier<blockquote>
4257dd7cddfSDavid du ColombierCourier, Courier-Bold, Courier-BoldOblique, Courier-Oblique, Helvetica,
4267dd7cddfSDavid du ColombierHelvetica-Bold, Helvetica-BoldOblique, Helvetica-Oblique, Symbol, Times-Bold,
4277dd7cddfSDavid du ColombierTimes-BoldItalic, Times-Italic, Times-Roman, ZapfDingbats
4287dd7cddfSDavid du Colombier</blockquote>
4297dd7cddfSDavid du Colombier
4307dd7cddfSDavid du Colombier<hr>
4317dd7cddfSDavid du Colombier
4323ff48bf5SDavid du Colombier<h2><a name="Install_OS2"></a>Installing Ghostscript on OS/2 2.x</h2>
4337dd7cddfSDavid du Colombier
4347dd7cddfSDavid du Colombier<p>
4357dd7cddfSDavid du ColombierThe Ghostscript OS/2 implementation is designed for OS/2 2.1 or later.  A
4367dd7cddfSDavid du Colombierfew people have used it successfully under OS/2 2.0, but it has had very
4377dd7cddfSDavid du Colombierlittle testing.  You need these files to run Ghostscript on OS/2:
4387dd7cddfSDavid du Colombier
4397dd7cddfSDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
4407dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSOS2.EXE</tt></b>
4417dd7cddfSDavid du Colombier	<td>&nbsp;&nbsp;&nbsp;
4427dd7cddfSDavid du Colombier	<td>A text application that will run windowed or full screen
4437dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSDLL2.DLL</tt></b>
4447dd7cddfSDavid du Colombier	<td>&nbsp;
4457dd7cddfSDavid du Colombier	<td>A dynamic link library that must be in the same directory as
4467dd7cddfSDavid du Colombier	    <b><tt>GSOS2.EXE</tt></b> or on the <b><tt>LIBPATH</tt></b>.
4477dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSPMDRV.EXE</tt></b>
4487dd7cddfSDavid du Colombier	<td>&nbsp;
4497dd7cddfSDavid du Colombier	<td>An "external driver" used by the "<b><tt>os2pm</tt></b>"
4507dd7cddfSDavid du Colombier	    device, which is normally the default device and which displays
4517dd7cddfSDavid du Colombier	    output in a Presentation Manager window;
4527dd7cddfSDavid du Colombier	    <b><tt>GSPMDRV.EXE</tt></b> must be located in the same
4537dd7cddfSDavid du Colombier	    directory as <b><tt>GSOS2.EXE</tt></b> or on the
4547dd7cddfSDavid du Colombier	    <b><tt>PATH</tt></b>
4557dd7cddfSDavid du Colombier</table></blockquote>
4567dd7cddfSDavid du Colombier
4577dd7cddfSDavid du Colombier<p>
4587dd7cddfSDavid du Colombier<b><tt>GSOS2.EXE</tt></b>, <b><tt>GSDLL2.DLL</tt></b> and
4597dd7cddfSDavid du Colombier<b><tt>GSPMDRV.EXE</tt></b> are compiled using EMX/GCC 0.9d.  You must have
4607dd7cddfSDavid du Colombierthe EMX DLLs on your <b><tt>LIBPATH</tt></b>; they are available in a
4617dd7cddfSDavid du Colombierpackage <b><tt>emxrt.zip</tt></b> from many places on the Internet, so you
4627dd7cddfSDavid du Colombiercan find the package by using a search engine or an ftp lookup service such
4637dd7cddfSDavid du Colombieras the one at
4647dd7cddfSDavid du Colombier
4657dd7cddfSDavid du Colombier<blockquote>
4663ff48bf5SDavid du Colombier<a href="http://ftpsearch.lycos.com/"
4673ff48bf5SDavid du Colombierclass="offset">http://ftpsearch.lycos.com/</a>
4687dd7cddfSDavid du Colombier</blockquote>
4697dd7cddfSDavid du Colombier
4707dd7cddfSDavid du Colombier<p>
4717dd7cddfSDavid du ColombierThe system menu of the Ghostscript Image window includes a "Copy" command
4727dd7cddfSDavid du Colombierto copy the currently displayed bitmap to the Clipboard.
4737dd7cddfSDavid du Colombier
4747dd7cddfSDavid du Colombier<p>
4753ff48bf5SDavid du ColombierOS/2 comes with some Adobe Type Manager fonts. If you wish to use these with
4763ff48bf5SDavid du ColombierGhostscript, you should replace the <b><tt>FONTMAP</tt></b> file with
4777dd7cddfSDavid du Colombier<b><tt>FONTMAP.OS2</tt></b>, and add to the environment variable
478*593dc095SDavid du Colombier<b><tt>GS_LIB</tt></b> (see <a href="Use.htm#Finding_files">Use.htm</a>
479*593dc095SDavid du Colombierfor more information about
4807dd7cddfSDavid du Colombier<b><tt>GS_LIB</tt></b>) the name of the directory where the fonts are
4817dd7cddfSDavid du Colombierlocated, usually <b><tt>C:\PSFONTS</tt></b>.  Before you do this, please
4823ff48bf5SDavid du Colombierread carefully the license that accompanies the ATM fonts; we take no
4833ff48bf5SDavid du Colombierresponsibility for any possible violations of such licenses.
4847dd7cddfSDavid du Colombier
4857dd7cddfSDavid du Colombier<p>
4867dd7cddfSDavid du ColombierSince <b><tt>GSOS2.EXE</tt></b> is not a PM application, it cannot
4877dd7cddfSDavid du Colombierdetermine the depth of the PM display.  You must provide this information
4887dd7cddfSDavid du Colombierusing the <b><tt>-dBitsPerPixel</tt></b> option.  Valid values are 1, 4, 8
4897dd7cddfSDavid du Colombier(the default), and 24.
4907dd7cddfSDavid du Colombier
4917dd7cddfSDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
4927dd7cddfSDavid du Colombier<tr valign=bottom>
4937dd7cddfSDavid du Colombier	<th align=left>Use
4947dd7cddfSDavid du Colombier	<td>&nbsp;&nbsp;&nbsp;&nbsp;
4957dd7cddfSDavid du Colombier	<th align=left>For
4967dd7cddfSDavid du Colombier<tr>	<td colspan=3><hr>
4977dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>-dBitsPerPixel=1</tt></b>
4987dd7cddfSDavid du Colombier	<td>&nbsp;
4997dd7cddfSDavid du Colombier	<td>VGA monochrome
5007dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>-dBitsPerPixel=4</tt></b>
5017dd7cddfSDavid du Colombier	<td>&nbsp;
5027dd7cddfSDavid du Colombier	<td>VGA standard
5037dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>-dBitsPerPixel=8</tt></b>
5047dd7cddfSDavid du Colombier	<td>&nbsp;
5057dd7cddfSDavid du Colombier	<td>SVGA 256 colors
5067dd7cddfSDavid du Colombier</table></blockquote>
5077dd7cddfSDavid du Colombier
5087dd7cddfSDavid du Colombier<p>
5097dd7cddfSDavid du ColombierA command file <b><tt>gspm.cmd</tt></b> containing the following line may
5107dd7cddfSDavid du Colombierbe useful:
5117dd7cddfSDavid du Colombier
5127dd7cddfSDavid du Colombier<blockquote><b><tt>
5137dd7cddfSDavid du Colombier@c:\gs\gsos2.exe -Ic:/gs;c:/gs/fonts;c:/psfonts -sDEVICE=os2pm -dBitsPerPixel=8 -sPAPERSIZE=a4 %1 %2 %3 %4 %5 %6 %7 %8
5147dd7cddfSDavid du Colombier</tt></b></blockquote>
5157dd7cddfSDavid du Colombier
5167dd7cddfSDavid du Colombier<p>
5177dd7cddfSDavid du ColombierWhile drawing, the <b><tt>os2pm</tt></b> driver updates the display every 5
5187dd7cddfSDavid du Colombierseconds.  On slow computers this is undesirable, and a different interval
5197dd7cddfSDavid du Colombiercan be specified in milliseconds with the <b><tt>-dUpdateInterval</tt></b>
5207dd7cddfSDavid du Colombieroption, with a default of <b><tt>-dUpdateInterval=5000</tt></b>; to disable
5217dd7cddfSDavid du Colombierupdate, use <b><tt>-dUpdateInterval=0</tt></b>.
5227dd7cddfSDavid du Colombier
5237dd7cddfSDavid du Colombier<p>
5247dd7cddfSDavid du ColombierStandard VGA is very slow because it uses double buffering to avoid bugs
5257dd7cddfSDavid du Colombierand because of 1-plane to 4-plane conversion; it's better to use a
5267dd7cddfSDavid du Colombier256-color display driver.  Many display drivers have bugs which cause 1
5277dd7cddfSDavid du Colombierbit-per-pixel bitmaps to be displayed incorrectly.
5287dd7cddfSDavid du Colombier
5297dd7cddfSDavid du Colombier<p>
5307dd7cddfSDavid du Colombier<b><tt>GSOS2.EXE</tt></b> and <b><tt>GSPMDRV.EXE</tt></b> will stay in
5317dd7cddfSDavid du Colombiermemory for the number of minutes specified in the environment variable
5327dd7cddfSDavid du Colombier<b><tt>GS_LOAD</tt></b>.
5337dd7cddfSDavid du Colombier
5347dd7cddfSDavid du Colombier<p>
5357dd7cddfSDavid du ColombierIf you run <b><tt>GS386</tt></b> in the OS/2 2.0 or 2.1 DOS box, you must
5367dd7cddfSDavid du Colombierselect the "ENABLED" setting for the DPMI_DOS_API option of the DOS box.
5377dd7cddfSDavid du Colombier<b><tt>GS386</tt></b> will not run with the "AUTO" setting.
5387dd7cddfSDavid du Colombier
5397dd7cddfSDavid du Colombier<p>
5407dd7cddfSDavid du ColombierFor printer devices, output goes to the default queue.  To print to a
5417dd7cddfSDavid du Colombierspecified queue, use <b><tt>-sOutputFile=\\spool\NullLPT1</tt></b>, where
5427dd7cddfSDavid du Colombier<b><tt>NullLPT1</tt></b> is the queue's physical name.
5437dd7cddfSDavid du Colombier
5443ff48bf5SDavid du Colombier<!-- [2.0 end contents] ==================================================== -->
5453ff48bf5SDavid du Colombier
5463ff48bf5SDavid du Colombier<!-- [3.0 begin visible trailer] =========================================== -->
5477dd7cddfSDavid du Colombier<hr>
5487dd7cddfSDavid du Colombier
5493ff48bf5SDavid du Colombier<p>
5503ff48bf5SDavid du Colombier<small>Copyright &copy; 1996, 2000 Aladdin Enterprises.  All rights
5513ff48bf5SDavid du Colombierreserved.</small>
5527dd7cddfSDavid du Colombier
5537dd7cddfSDavid du Colombier<p>
554*593dc095SDavid du ColombierThis software is provided AS-IS with no warranty, either express or
555*593dc095SDavid du Colombierimplied.
556*593dc095SDavid du Colombier
557*593dc095SDavid du ColombierThis software is distributed under license and may not be copied,
558*593dc095SDavid du Colombiermodified or distributed except as expressly authorized under the terms
559*593dc095SDavid du Colombierof the license contained in the file LICENSE in this distribution.
560*593dc095SDavid du Colombier
561*593dc095SDavid du ColombierFor more information about licensing, please refer to
562*593dc095SDavid du Colombierhttp://www.ghostscript.com/licensing/. For information on
563*593dc095SDavid du Colombiercommercial licensing, go to http://www.artifex.com/licensing/ or
564*593dc095SDavid du Colombiercontact Artifex Software, Inc., 101 Lucas Valley Road #110,
565*593dc095SDavid du ColombierSan Rafael, CA  94903, U.S.A., +1(415)492-9861.
5667dd7cddfSDavid du Colombier
5673ff48bf5SDavid du Colombier<p>
568*593dc095SDavid du Colombier<small>Ghostscript version 8.53, 20 October 2005
5697dd7cddfSDavid du Colombier
5707dd7cddfSDavid du Colombier<!-- [3.0 end visible trailer] ============================================= -->
5717dd7cddfSDavid du Colombier
5727dd7cddfSDavid du Colombier</body>
5737dd7cddfSDavid du Colombier</html>
574