xref: /plan9/sys/src/cmd/gs/doc/Install.htm (revision 3ff48bf5ed603850fcd251ddf13025d23d693782)
1*3ff48bf5SDavid 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*3ff48bf5SDavid du Colombier<!-- $Id: Install.htm,v 1.26.2.2 2002/02/01 05:31:25 raph Exp $ -->
67dd7cddfSDavid du Colombier<!-- Originally: install.txt -->
7*3ff48bf5SDavid 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
15*3ff48bf5SDavid 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>
27*3ff48bf5SDavid 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
52*3ff48bf5SDavid 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
93*3ff48bf5SDavid du Colombier<h2><a name="Install_Unix"></a>Installing Ghostscript on Unix</h2>
947dd7cddfSDavid du Colombier
957dd7cddfSDavid du Colombier<p>
967dd7cddfSDavid du ColombierYou need the file <b><tt>gs</tt></b> to run Ghostscript on Unix, and
977dd7cddfSDavid du Colombierinstalling Ghostscript on a Unix system requires building it first: please
987dd7cddfSDavid du Colombierread <a href="Make.htm#Unix_build">how to build Ghostscript on Unix</a> in
997dd7cddfSDavid du Colombierthe documentation on building Ghostscript, especially regarding how to
1007dd7cddfSDavid du Colombierdecide <a href="Make.htm#UNIX_makefile">which makefile to use</a> and how
1017dd7cddfSDavid du Colombieryou may need to edit it.  After building, execute "<b><tt>make
1027dd7cddfSDavid du Colombierinstall</tt></b>" to install the executable and all the required and
1037dd7cddfSDavid du Colombierancillary files.
1047dd7cddfSDavid du Colombier
1057dd7cddfSDavid du Colombier<p><a name="Use_Acrobat_fonts_Unix"></a>
1067dd7cddfSDavid du ColombierThe makefile installs all the files except fonts under the directory
1077dd7cddfSDavid du Colombierdefined in the makefile as "<b><tt>prefix</tt></b>",
1087dd7cddfSDavid du Colombier<b><tt>/usr/local</tt></b> by default.  The fonts should be installed in
1097dd7cddfSDavid du Colombier<em>{prefix}</em><b><tt>/share/ghostscript/fonts</tt></b>.
1107dd7cddfSDavid du ColombierConsult the makefile for more details.  If you have Adobe Acrobat
1117dd7cddfSDavid du Colombierinstalled, you can use the Acrobat fonts in place of the ones provided with
1127dd7cddfSDavid du ColombierGhostscript by adding the Acrobat fonts directory to
1137dd7cddfSDavid du Colombier<b><tt>GS_FONTPATH</tt></b> and removing these fonts from
1147dd7cddfSDavid du Colombier<b><tt>Fontmap.GS</tt></b>:
1157dd7cddfSDavid du Colombier
1167dd7cddfSDavid du Colombier<blockquote>
1177dd7cddfSDavid du ColombierCourier, Courier-Bold, Courier-BoldOblique, Courier-Oblique, Helvetica,
1187dd7cddfSDavid du ColombierHelvetica-Bold, Helvetica-BoldOblique, Helvetica-Oblique, Symbol, Times-Bold,
1197dd7cddfSDavid du ColombierTimes-BoldItalic, Times-Italic, Times-Roman, ZapfDingbats
1207dd7cddfSDavid du Colombier</blockquote>
1217dd7cddfSDavid du Colombier
122*3ff48bf5SDavid du Colombier<h3><a name="Shared_object"></a>Ghostscript as a shared object</h3>
123*3ff48bf5SDavid du ColombierInstead of using "<b><tt>make install</tt></b>", you should use
124*3ff48bf5SDavid du Colombier"<b><tt>make soinstall</tt></b>".
125*3ff48bf5SDavid du ColombierSee <a href="Make.htm#Shared_object">how to build Ghostscript
126*3ff48bf5SDavid du Colombieras a shared object</a> for more details.
127*3ff48bf5SDavid du Colombier
128*3ff48bf5SDavid du Colombier<h3><a name="Install_Linux"></a>Additional notes on Linux</h3>
1297dd7cddfSDavid du Colombier
1307dd7cddfSDavid du Colombier<p>
1317dd7cddfSDavid du ColombierRed Hat Linux 6 and later installs the Ghostscript base 35 fonts in
1327dd7cddfSDavid du Colombier<b><tt>/usr/share/fonts/default/Type1</tt></b>, and the other Ghostscript
1337dd7cddfSDavid du Colombierfonts in <b><tt>/usr/share/fonts/default/ghostscript</tt></b>.
1347dd7cddfSDavid du Colombier
1357dd7cddfSDavid du Colombier<p>
1367dd7cddfSDavid du ColombierFor Linux, you may be able to install or upgrade Ghostscript from
1377dd7cddfSDavid du Colombierprecompiled <a href="http://www.rpm.org">RPM</a> files using:
1387dd7cddfSDavid du Colombier
1397dd7cddfSDavid du Colombier<blockquote><b><tt>
1407dd7cddfSDavid du Colombierrpm -U ghostscript-N.NN-1.i386.rpm<br>
1417dd7cddfSDavid du Colombierrpm -U ghostscript-fonts-N.NN-1.noarch.rpm
1427dd7cddfSDavid du Colombier</tt></b></blockquote>
1437dd7cddfSDavid du Colombier
1447dd7cddfSDavid du Colombier<p>
145*3ff48bf5SDavid du ColombierHowever, please note that we do not create RPMs for Ghostscript, and we take
146*3ff48bf5SDavid du Colombierno responsibility for RPMs created by others.
1477dd7cddfSDavid du Colombier
1487dd7cddfSDavid du Colombier<hr>
1497dd7cddfSDavid du Colombier
150*3ff48bf5SDavid du Colombier<h2><a name="Install_Windows"></a>Installing Ghostscript on MS Windows</h2>
1517dd7cddfSDavid du Colombier
1527dd7cddfSDavid du Colombier<p>
153*3ff48bf5SDavid du ColombierWe usually distribute Ghostscript releases for Windows as self-extracting
154*3ff48bf5SDavid du Colombierarchive files, since this is the most convenient form for users.  These
155*3ff48bf5SDavid du Colombierfiles can also be unpacked as if they were plain zip files.
1567dd7cddfSDavid du Colombier
1577dd7cddfSDavid du Colombier<p>
1587dd7cddfSDavid du ColombierThe self-extracting archive is normally named
1597dd7cddfSDavid du Colombier<b><tt>gs###w32.exe</tt></b>,
160*3ff48bf5SDavid du Colombierwhere ### is the release number (e.g., 650 for Ghostscript 6.50,
161*3ff48bf5SDavid du Colombier700 for Ghostscript 7.00).
1627dd7cddfSDavid du Colombier
163*3ff48bf5SDavid du Colombier<h3><a name="Windows4"></a>Windows 95/98 and NT 4</h3>
1647dd7cddfSDavid du Colombier
1657dd7cddfSDavid du Colombier<p>
1667dd7cddfSDavid du ColombierTo install a self-extracting Ghostscript archive on Windows 95/98 or
167*3ff48bf5SDavid du ColombierWindows NT4/2000, you need just this self-extracting archive file.
168*3ff48bf5SDavid du ColombierRun this file to install Ghostscript.
1697dd7cddfSDavid du Colombier
1707dd7cddfSDavid du Colombier<p>
1717dd7cddfSDavid du ColombierAlternatively, if you have the zip file, unzip it to a temporary
1727dd7cddfSDavid du Colombierdirectory then run the included <b><tt>setupgs.exe</tt></b>.
1737dd7cddfSDavid du ColombierAfter the setup program has finished, remove the temporary files.
1747dd7cddfSDavid du Colombier
1757dd7cddfSDavid du Colombier<p>
1767dd7cddfSDavid du ColombierAfter installing Ghostscript, it is strongly recommended that you
1777dd7cddfSDavid du Colombierinstall the <a href="New-user.htm#GSview">GSview previewer</a>,
1787dd7cddfSDavid du Colombierwhich provides an easier to use graphical interface for Ghostscript.
1797dd7cddfSDavid du ColombierInformation on GSview is available from:
1807dd7cddfSDavid du Colombier
1817dd7cddfSDavid du Colombier<blockquote>
1827dd7cddfSDavid du Colombier<a
183*3ff48bf5SDavid du Colombierhref="http://www.cs.wisc.edu/~ghost/gsview/"
184*3ff48bf5SDavid du Colombierclass="offsite">http://www.cs.wisc.edu/~ghost/gsview/</a>
1857dd7cddfSDavid du Colombier</blockquote>
1867dd7cddfSDavid du Colombier
187*3ff48bf5SDavid du Colombier<h3><a name="General_Windows"></a>General Windows configuration</h3>
1887dd7cddfSDavid du Colombier
1897dd7cddfSDavid du Colombier<p>
1907dd7cddfSDavid du ColombierThe archive includes files in these subdirectories:
1917dd7cddfSDavid du Colombier
1927dd7cddfSDavid du Colombier<blockquote><b><tt>
193*3ff48bf5SDavid du Colombiergs<em>#.##</em>\bin
194*3ff48bf5SDavid du Colombier<br>gs<em>#.##</em>\lib
195*3ff48bf5SDavid du Colombier<br>gs<em>#.##</em>\examples
196*3ff48bf5SDavid du Colombier<br>gs<em>#.##</em>\doc
1977dd7cddfSDavid du Colombier<br>fonts
1987dd7cddfSDavid du Colombier</tt></b></blockquote>
1997dd7cddfSDavid du Colombier
2007dd7cddfSDavid du Colombier<p>
201*3ff48bf5SDavid du ColombierThe actual executable files, in the <b><tt>gs<em>#.##</em>\bin</tt></b>
2027dd7cddfSDavid du Colombiersubdirectory, are:
2037dd7cddfSDavid du Colombier
2047dd7cddfSDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
2057dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSWIN32.EXE</tt></b>
2067dd7cddfSDavid du Colombier	<td>&nbsp;
2077dd7cddfSDavid du Colombier	<td>32-bit Ghostscript using windows
2087dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSWIN32C.EXE</tt></b>
2097dd7cddfSDavid du Colombier	<td>&nbsp;
2107dd7cddfSDavid du Colombier	<td>32-bit Ghostscript using only the command line
2117dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSDLL32.DLL</tt></b>
2127dd7cddfSDavid du Colombier	<td>&nbsp;
2137dd7cddfSDavid du Colombier	<td>32-bit dynamic link library containing most of Ghostscript's
2147dd7cddfSDavid du Colombierfunctionality
2157dd7cddfSDavid du Colombier</table></blockquote>
2167dd7cddfSDavid du Colombier
2177dd7cddfSDavid du Colombier<p>
2187dd7cddfSDavid du ColombierSee "<a href="#Install_DOS">Installing Ghostscript on DOS</a>" below for
2197dd7cddfSDavid du Colombierinformation about using Adobe Type Manager, Adobe Type Basics, or Adobe
2207dd7cddfSDavid du ColombierAcrobat fonts.  If your system uses TrueType fonts, you can get them
2217dd7cddfSDavid du Colombierconverted to a Ghostscript-compatible format at the time you select your
2227dd7cddfSDavid du Colombier"printer" by doing the following:
2237dd7cddfSDavid du Colombier
2247dd7cddfSDavid du Colombier<blockquote><ol>
2257dd7cddfSDavid du Colombier<li>Open control panel and double-click on the "Printers" icon.
2267dd7cddfSDavid du Colombier<li>Select your Postscript printer.
2277dd7cddfSDavid du Colombier<li>Choose Setup.
2287dd7cddfSDavid du Colombier<li>Choose Options.
2297dd7cddfSDavid du Colombier<li>Choose Advanced.
2307dd7cddfSDavid du Colombier<li>At the top of the dialog box you will see TrueType Fonts Send to
2317dd7cddfSDavid du ColombierPrinter As: Choose <em>(drop-down menu)</em> Adobe Type 1.
2327dd7cddfSDavid du Colombier<li>Uncheck Use Printer Fonts for All TrueType Fonts and Use
2337dd7cddfSDavid du ColombierSubstitution
2347dd7cddfSDavid du ColombierTable.
2357dd7cddfSDavid du Colombier<li>OK.
2367dd7cddfSDavid du Colombier<li>OK etc.
2377dd7cddfSDavid du Colombier</ol></blockquote>
2387dd7cddfSDavid du Colombier
2397dd7cddfSDavid du Colombier<p>
2407dd7cddfSDavid du ColombierThat's it!  Your TrueType fonts will automatically be downloaded in your
2417dd7cddfSDavid du ColombierPostScript file for Ghostscript to use.
2427dd7cddfSDavid du Colombier
2437dd7cddfSDavid du Colombier<p>
2447dd7cddfSDavid du ColombierFor printer devices, the default output is:
2457dd7cddfSDavid du Colombier
2467dd7cddfSDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
2477dd7cddfSDavid du Colombier<tr valign=top>	<td>The default printer
2487dd7cddfSDavid du Colombier	<td>&nbsp;&nbsp;&nbsp;
2497dd7cddfSDavid du Colombier	<td>Win95 or WinNT
2507dd7cddfSDavid du Colombier<tr valign=top>	<td>Prompt for a printer port
2517dd7cddfSDavid du Colombier	<td>&nbsp;
2527dd7cddfSDavid du Colombier	<td>Win32s (Windows 3.1)
2537dd7cddfSDavid du Colombier</table></blockquote>
2547dd7cddfSDavid du Colombier
2557dd7cddfSDavid du Colombier<p>
2567dd7cddfSDavid du ColombierThis can be modified as follows.
2577dd7cddfSDavid du Colombier
2587dd7cddfSDavid du Colombier<blockquote>
2597dd7cddfSDavid du Colombier<dl>
2607dd7cddfSDavid du Colombier<dt><b><tt>-sOutputFile="LPT1:"</tt></b>
2617dd7cddfSDavid du Colombier<dd>Output to the named port.
2627dd7cddfSDavid du Colombier
263*3ff48bf5SDavid du Colombier<dt><b><tt>-sOutputFile="%printer%printer name"</tt></b> (Windows 95, 98,
264*3ff48bf5SDavid du ColombierNT or 2000)
265*3ff48bf5SDavid du Colombier<dd>Output to the named printer.  If your printer is named "HP DeskJet 500"
266*3ff48bf5SDavid du Colombierthen you would use <tt>-sOutputFile="%printer%HP DeskJet 500"</tt>.
2677dd7cddfSDavid du Colombier
268*3ff48bf5SDavid du Colombier<dt><b><tt>-sOutputFile="\\spool\printer name"</tt></b> (Windows 3.1/Win32s)
269*3ff48bf5SDavid du Colombier<dd>Output to the named printer.  Note that this is NOT a UNC name.
270*3ff48bf5SDavid du Colombier
2717dd7cddfSDavid du Colombier</dl>
2727dd7cddfSDavid du Colombier</blockquote>
2737dd7cddfSDavid du Colombier
2747dd7cddfSDavid du Colombier<p>
2757dd7cddfSDavid du ColombierIf Ghostscript fails to find an environment variable, it looks for a
2767dd7cddfSDavid du Colombierregistry value of the same name under the key
2777dd7cddfSDavid du Colombier
2787dd7cddfSDavid du Colombier<blockquote><b><tt>
279*3ff48bf5SDavid du ColombierHKEY_CURRENT_USER\Software\AFPL Ghostscript\#.##
2807dd7cddfSDavid du Colombier</tt></b></blockquote>
2817dd7cddfSDavid du Colombier
2827dd7cddfSDavid du Colombier<p>
2837dd7cddfSDavid du Colombieror if that fails, under the key
2847dd7cddfSDavid du Colombier
2857dd7cddfSDavid du Colombier<blockquote><b><tt>
286*3ff48bf5SDavid du ColombierHKEY_LOCAL_MACHINE\SOFTWARE\AFPL Ghostscript\#.##
2877dd7cddfSDavid du Colombier</tt></b></blockquote>
2887dd7cddfSDavid du Colombier
2897dd7cddfSDavid du Colombier<p>
2907dd7cddfSDavid du Colombierwhere #.## is the Ghostscript version number.  This does not work under
2917dd7cddfSDavid du ColombierWin32s (that is, Windows 3.1, which doesn't support named registry
2927dd7cddfSDavid du Colombiervalues).
2937dd7cddfSDavid du Colombier
2947dd7cddfSDavid du Colombier<p>
295*3ff48bf5SDavid du ColombierGhostscript will attempt to load the Ghostscript dynamic link
296*3ff48bf5SDavid du Colombierlibrary <b><tt>GSDLL32.DLL</tt></b> in the following order:
297*3ff48bf5SDavid du Colombier<ul>
298*3ff48bf5SDavid du Colombier<li> In the same directory as the Ghostscript executable.
299*3ff48bf5SDavid du Colombier<li> If the environment variable <b><tt>GS_DLL</tt></b> is defined,
300*3ff48bf5SDavid du ColombierGhostscript tries to load the Ghostscript dynamic link library (DLL)
301*3ff48bf5SDavid du Colombierwith the name given.
302*3ff48bf5SDavid du Colombier<li> Using the standard Windows library search method: the directory
303*3ff48bf5SDavid du Colombierfrom which the application loaded, the current directory, the Windows
304*3ff48bf5SDavid du Colombiersystem directory, the Windows directory and the directories listed in
305*3ff48bf5SDavid du Colombierthe PATH environment variable.
306*3ff48bf5SDavid du Colombier</ul>
3077dd7cddfSDavid du Colombier
3087dd7cddfSDavid du Colombier<p>
3097dd7cddfSDavid du ColombierThe Ghostscript setup program will create registry values
3107dd7cddfSDavid du Colombierfor the environment variables <b><tt>GS_LIB</tt></b>
3117dd7cddfSDavid du Colombierand <b><tt>GS_DLL</tt></b>.
3127dd7cddfSDavid du Colombier
313*3ff48bf5SDavid du Colombier<h3><a name="Uninstall_Windows"></a>Uninstalling Ghostscript on Windows</h3>
3147dd7cddfSDavid du Colombier
3157dd7cddfSDavid du Colombier<p>
3167dd7cddfSDavid du ColombierTo uninstall Ghostscript, use the Control Panel, Add/Remove Programs and
317*3ff48bf5SDavid du Colombierremove "Ghostscript #.##" and "Ghostscript Fonts".  (The entries may be
318*3ff48bf5SDavid du Colombiercalled "Aladdin Ghostscript" or "AFPL Ghostscript", rather than just
319*3ff48bf5SDavid du Colombier"Ghostscript", depending on what version of Ghostscript was installed.)
3207dd7cddfSDavid du Colombier
3217dd7cddfSDavid du Colombier<hr>
3227dd7cddfSDavid du Colombier
323*3ff48bf5SDavid du Colombier<h2><a name="Install_VMS"></a>Installing Ghostscript on OpenVMS</h2>
3247dd7cddfSDavid du Colombier
3257dd7cddfSDavid du Colombier<p>
3267dd7cddfSDavid du ColombierYou need the file <b><tt>GS.EXE</tt></b> to run Ghostscript on OpenVMS, and
3277dd7cddfSDavid du Colombierinstalling Ghostscript on an OpenVMS system requires building it first:
328*3ff48bf5SDavid du Colombierplease read <a href="Make.htm#VMS_build">how to build Ghostscript on VMS</a>
329*3ff48bf5SDavid du Colombierin the documentation on building Ghostscript.
3307dd7cddfSDavid du Colombier
3317dd7cddfSDavid du Colombier<p>
332*3ff48bf5SDavid du ColombierThe following installation steps assume that the Ghostscript directory is
333*3ff48bf5SDavid du Colombier<b><tt>DISK1:[DIR.GHOSTSCRIPT]</tt></b>.  Yours will almost certainly be in
334*3ff48bf5SDavid du Colombiera different location so adjust the following commands accordingly.
335*3ff48bf5SDavid du Colombier
336*3ff48bf5SDavid du Colombier<ul>
337*3ff48bf5SDavid du Colombier
338*3ff48bf5SDavid du Colombier<li>Download the fonts and unpack them into
339*3ff48bf5SDavid du Colombier<b><tt>DISK1:[DIR.GHOSTSCRIPT.LIB]</tt></b>.
340*3ff48bf5SDavid du Colombier
341*3ff48bf5SDavid du Colombier<li>Enable access to the program and support files for all users with:
342*3ff48bf5SDavid du Colombier
343*3ff48bf5SDavid du Colombier<blockquote><pre>
344*3ff48bf5SDavid du Colombier$ set file/prot=w:re DISK1:[DIR]GHOSTSCRIPT.dir
345*3ff48bf5SDavid du Colombier$ set file/prot=w:re DISK1:[DIR.GHOSTSCRIPT...]*.*
346*3ff48bf5SDavid du Colombier</pre></blockquote>
347*3ff48bf5SDavid du Colombier
348*3ff48bf5SDavid du Colombier<li>Optionally, add the Ghostscript help instructions to your system wide
349*3ff48bf5SDavid du Colombierhelp file:
350*3ff48bf5SDavid du Colombier
351*3ff48bf5SDavid du Colombier<blockquote><pre>
352*3ff48bf5SDavid du Colombier$ lib/help sys$help:HELPLIB.HLB DISK1:[DIR.GHOSTSCRIPT.DOC]GS-VMS.HLP
353*3ff48bf5SDavid du Colombier</pre></blockquote>
354*3ff48bf5SDavid du Colombier
355*3ff48bf5SDavid du Colombier<li>Lastly, add the following lines to the appropriate system wide or user
356*3ff48bf5SDavid du Colombierspecific login script.
357*3ff48bf5SDavid du Colombier
358*3ff48bf5SDavid du Colombier<blockquote><pre>
359*3ff48bf5SDavid du Colombier$ define gs_exe DISK1:[DIR.GHOSTSCRIPT.BIN]
360*3ff48bf5SDavid du Colombier$ define gs_lib DISK1:[DIR.GHOSTSCRIPT.EXE]
361*3ff48bf5SDavid du Colombier$ gs :== $gs_exe:gs.exe
362*3ff48bf5SDavid du Colombier</pre></blockquote>
363*3ff48bf5SDavid du Colombier
364*3ff48bf5SDavid du Colombier</ul>
3657dd7cddfSDavid du Colombier
3667dd7cddfSDavid du Colombier<p>
3677dd7cddfSDavid du ColombierIf you have DECWindows/Motif installed, you may wish to replace the
3687dd7cddfSDavid du Colombier<b><tt>FONTMAP.GS</tt></b> file with <b><tt>FONTMAP.VMS</tt></b>.  Read the
3697dd7cddfSDavid du Colombiercomment at the beginning of the latter file for more information.
3707dd7cddfSDavid du Colombier
3717dd7cddfSDavid du Colombier<hr>
3727dd7cddfSDavid du Colombier
373*3ff48bf5SDavid du Colombier<h2><a name="Install_DOS"></a>Installing Ghostscript on DOS</h2>
3747dd7cddfSDavid du Colombier
3757dd7cddfSDavid du Colombier<p>
3767dd7cddfSDavid du ColombierYou need the files <b><tt>GS386.EXE</tt></b> and <b><tt>DOS4GW.EXE</tt></b>
3777dd7cddfSDavid du Colombierto run Ghostscript.  You should install all the files except the fonts in
3787dd7cddfSDavid du Colombier<b><tt>C:\GS</tt></b>, and the fonts in <b><tt>C:\GS\FONTS</tt></b>.
3797dd7cddfSDavid du Colombier
380*3ff48bf5SDavid du Colombier<p><a name="Use_platform_fonts_DOS"></a> If you have Adobe Type Manager
381*3ff48bf5SDavid du Colombier(ATM) fonts installed on your system, and you wish to use them with
382*3ff48bf5SDavid du ColombierGhostscript, you may wish to replace the <b><tt>FONTMAP</tt></b> file with
383*3ff48bf5SDavid du Colombier<b><tt>FONTMAP.ATM</tt></b>, and to add to the environment variable
384*3ff48bf5SDavid du Colombier<b><tt>GS_LIB</tt></b> the name of the directory where the fonts are located
385*3ff48bf5SDavid du Colombier(see below for more information about <b><tt>GS_LIB</tt></b>).  Before you
386*3ff48bf5SDavid du Colombierdo this, please read carefully the license that accompanies the ATM fonts;
387*3ff48bf5SDavid du Colombierwe take no responsibility for any possible violations of such licenses.
388*3ff48bf5SDavid du ColombierSimilarly, if you have Adobe Type Basics, you may wish to replace
389*3ff48bf5SDavid du Colombier<b><tt>FONTMAP</tt></b> with <b><tt>FONTMAP.ATB</tt></b>.  Finally, if you
390*3ff48bf5SDavid du Colombierhave neither ATM nor ATB but you have Adobe Acrobat installed, you can use
391*3ff48bf5SDavid du Colombierthe Acrobat fonts in place of the ones provided with Ghostscript by adding
392*3ff48bf5SDavid du Colombierthe Acrobat fonts directory to <b><tt>GS_FONTPATH</tt></b> and removing
393*3ff48bf5SDavid du Colombierthese fonts from <b><tt>FONTMAP</tt></b>:
3947dd7cddfSDavid du Colombier
3957dd7cddfSDavid du Colombier<blockquote>
3967dd7cddfSDavid du ColombierCourier, Courier-Bold, Courier-BoldOblique, Courier-Oblique, Helvetica,
3977dd7cddfSDavid du ColombierHelvetica-Bold, Helvetica-BoldOblique, Helvetica-Oblique, Symbol, Times-Bold,
3987dd7cddfSDavid du ColombierTimes-BoldItalic, Times-Italic, Times-Roman, ZapfDingbats
3997dd7cddfSDavid du Colombier</blockquote>
4007dd7cddfSDavid du Colombier
4017dd7cddfSDavid du Colombier<hr>
4027dd7cddfSDavid du Colombier
403*3ff48bf5SDavid du Colombier<h2><a name="Install_OS2"></a>Installing Ghostscript on OS/2 2.x</h2>
4047dd7cddfSDavid du Colombier
4057dd7cddfSDavid du Colombier<p>
4067dd7cddfSDavid du ColombierThe Ghostscript OS/2 implementation is designed for OS/2 2.1 or later.  A
4077dd7cddfSDavid du Colombierfew people have used it successfully under OS/2 2.0, but it has had very
4087dd7cddfSDavid du Colombierlittle testing.  You need these files to run Ghostscript on OS/2:
4097dd7cddfSDavid du Colombier
4107dd7cddfSDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
4117dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSOS2.EXE</tt></b>
4127dd7cddfSDavid du Colombier	<td>&nbsp;&nbsp;&nbsp;
4137dd7cddfSDavid du Colombier	<td>A text application that will run windowed or full screen
4147dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSDLL2.DLL</tt></b>
4157dd7cddfSDavid du Colombier	<td>&nbsp;
4167dd7cddfSDavid du Colombier	<td>A dynamic link library that must be in the same directory as
4177dd7cddfSDavid du Colombier	    <b><tt>GSOS2.EXE</tt></b> or on the <b><tt>LIBPATH</tt></b>.
4187dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>GSPMDRV.EXE</tt></b>
4197dd7cddfSDavid du Colombier	<td>&nbsp;
4207dd7cddfSDavid du Colombier	<td>An "external driver" used by the "<b><tt>os2pm</tt></b>"
4217dd7cddfSDavid du Colombier	    device, which is normally the default device and which displays
4227dd7cddfSDavid du Colombier	    output in a Presentation Manager window;
4237dd7cddfSDavid du Colombier	    <b><tt>GSPMDRV.EXE</tt></b> must be located in the same
4247dd7cddfSDavid du Colombier	    directory as <b><tt>GSOS2.EXE</tt></b> or on the
4257dd7cddfSDavid du Colombier	    <b><tt>PATH</tt></b>
4267dd7cddfSDavid du Colombier</table></blockquote>
4277dd7cddfSDavid du Colombier
4287dd7cddfSDavid du Colombier<p>
4297dd7cddfSDavid du Colombier<b><tt>GSOS2.EXE</tt></b>, <b><tt>GSDLL2.DLL</tt></b> and
4307dd7cddfSDavid du Colombier<b><tt>GSPMDRV.EXE</tt></b> are compiled using EMX/GCC 0.9d.  You must have
4317dd7cddfSDavid du Colombierthe EMX DLLs on your <b><tt>LIBPATH</tt></b>; they are available in a
4327dd7cddfSDavid du Colombierpackage <b><tt>emxrt.zip</tt></b> from many places on the Internet, so you
4337dd7cddfSDavid du Colombiercan find the package by using a search engine or an ftp lookup service such
4347dd7cddfSDavid du Colombieras the one at
4357dd7cddfSDavid du Colombier
4367dd7cddfSDavid du Colombier<blockquote>
437*3ff48bf5SDavid du Colombier<a href="http://ftpsearch.lycos.com/"
438*3ff48bf5SDavid du Colombierclass="offset">http://ftpsearch.lycos.com/</a>
4397dd7cddfSDavid du Colombier</blockquote>
4407dd7cddfSDavid du Colombier
4417dd7cddfSDavid du Colombier<p>
4427dd7cddfSDavid du ColombierThe system menu of the Ghostscript Image window includes a "Copy" command
4437dd7cddfSDavid du Colombierto copy the currently displayed bitmap to the Clipboard.
4447dd7cddfSDavid du Colombier
4457dd7cddfSDavid du Colombier<p>
446*3ff48bf5SDavid du ColombierOS/2 comes with some Adobe Type Manager fonts. If you wish to use these with
447*3ff48bf5SDavid du ColombierGhostscript, you should replace the <b><tt>FONTMAP</tt></b> file with
4487dd7cddfSDavid du Colombier<b><tt>FONTMAP.OS2</tt></b>, and add to the environment variable
4497dd7cddfSDavid du Colombier<b><tt>GS_LIB</tt></b> (see below for more information about
4507dd7cddfSDavid du Colombier<b><tt>GS_LIB</tt></b>) the name of the directory where the fonts are
4517dd7cddfSDavid du Colombierlocated, usually <b><tt>C:\PSFONTS</tt></b>.  Before you do this, please
452*3ff48bf5SDavid du Colombierread carefully the license that accompanies the ATM fonts; we take no
453*3ff48bf5SDavid du Colombierresponsibility for any possible violations of such licenses.
4547dd7cddfSDavid du Colombier
4557dd7cddfSDavid du Colombier<p>
4567dd7cddfSDavid du ColombierSince <b><tt>GSOS2.EXE</tt></b> is not a PM application, it cannot
4577dd7cddfSDavid du Colombierdetermine the depth of the PM display.  You must provide this information
4587dd7cddfSDavid du Colombierusing the <b><tt>-dBitsPerPixel</tt></b> option.  Valid values are 1, 4, 8
4597dd7cddfSDavid du Colombier(the default), and 24.
4607dd7cddfSDavid du Colombier
4617dd7cddfSDavid du Colombier<blockquote><table cellpadding=0 cellspacing=0>
4627dd7cddfSDavid du Colombier<tr valign=bottom>
4637dd7cddfSDavid du Colombier	<th align=left>Use
4647dd7cddfSDavid du Colombier	<td>&nbsp;&nbsp;&nbsp;&nbsp;
4657dd7cddfSDavid du Colombier	<th align=left>For
4667dd7cddfSDavid du Colombier<tr>	<td colspan=3><hr>
4677dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>-dBitsPerPixel=1</tt></b>
4687dd7cddfSDavid du Colombier	<td>&nbsp;
4697dd7cddfSDavid du Colombier	<td>VGA monochrome
4707dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>-dBitsPerPixel=4</tt></b>
4717dd7cddfSDavid du Colombier	<td>&nbsp;
4727dd7cddfSDavid du Colombier	<td>VGA standard
4737dd7cddfSDavid du Colombier<tr valign=top>	<td><b><tt>-dBitsPerPixel=8</tt></b>
4747dd7cddfSDavid du Colombier	<td>&nbsp;
4757dd7cddfSDavid du Colombier	<td>SVGA 256 colors
4767dd7cddfSDavid du Colombier</table></blockquote>
4777dd7cddfSDavid du Colombier
4787dd7cddfSDavid du Colombier<p>
4797dd7cddfSDavid du ColombierA command file <b><tt>gspm.cmd</tt></b> containing the following line may
4807dd7cddfSDavid du Colombierbe useful:
4817dd7cddfSDavid du Colombier
4827dd7cddfSDavid du Colombier<blockquote><b><tt>
4837dd7cddfSDavid 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
4847dd7cddfSDavid du Colombier</tt></b></blockquote>
4857dd7cddfSDavid du Colombier
4867dd7cddfSDavid du Colombier<p>
4877dd7cddfSDavid du ColombierWhile drawing, the <b><tt>os2pm</tt></b> driver updates the display every 5
4887dd7cddfSDavid du Colombierseconds.  On slow computers this is undesirable, and a different interval
4897dd7cddfSDavid du Colombiercan be specified in milliseconds with the <b><tt>-dUpdateInterval</tt></b>
4907dd7cddfSDavid du Colombieroption, with a default of <b><tt>-dUpdateInterval=5000</tt></b>; to disable
4917dd7cddfSDavid du Colombierupdate, use <b><tt>-dUpdateInterval=0</tt></b>.
4927dd7cddfSDavid du Colombier
4937dd7cddfSDavid du Colombier<p>
4947dd7cddfSDavid du ColombierStandard VGA is very slow because it uses double buffering to avoid bugs
4957dd7cddfSDavid du Colombierand because of 1-plane to 4-plane conversion; it's better to use a
4967dd7cddfSDavid du Colombier256-color display driver.  Many display drivers have bugs which cause 1
4977dd7cddfSDavid du Colombierbit-per-pixel bitmaps to be displayed incorrectly.
4987dd7cddfSDavid du Colombier
4997dd7cddfSDavid du Colombier<p>
5007dd7cddfSDavid du Colombier<b><tt>GSOS2.EXE</tt></b> and <b><tt>GSPMDRV.EXE</tt></b> will stay in
5017dd7cddfSDavid du Colombiermemory for the number of minutes specified in the environment variable
5027dd7cddfSDavid du Colombier<b><tt>GS_LOAD</tt></b>.
5037dd7cddfSDavid du Colombier
5047dd7cddfSDavid du Colombier<p>
5057dd7cddfSDavid du ColombierIf you run <b><tt>GS386</tt></b> in the OS/2 2.0 or 2.1 DOS box, you must
5067dd7cddfSDavid du Colombierselect the "ENABLED" setting for the DPMI_DOS_API option of the DOS box.
5077dd7cddfSDavid du Colombier<b><tt>GS386</tt></b> will not run with the "AUTO" setting.
5087dd7cddfSDavid du Colombier
5097dd7cddfSDavid du Colombier<p>
5107dd7cddfSDavid du ColombierFor printer devices, output goes to the default queue.  To print to a
5117dd7cddfSDavid du Colombierspecified queue, use <b><tt>-sOutputFile=\\spool\NullLPT1</tt></b>, where
5127dd7cddfSDavid du Colombier<b><tt>NullLPT1</tt></b> is the queue's physical name.
5137dd7cddfSDavid du Colombier
514*3ff48bf5SDavid du Colombier<!-- [2.0 end contents] ==================================================== -->
515*3ff48bf5SDavid du Colombier
516*3ff48bf5SDavid du Colombier<!-- [3.0 begin visible trailer] =========================================== -->
5177dd7cddfSDavid du Colombier<hr>
5187dd7cddfSDavid du Colombier
519*3ff48bf5SDavid du Colombier<p>
520*3ff48bf5SDavid du Colombier<small>Copyright &copy; 1996, 2000 Aladdin Enterprises.  All rights
521*3ff48bf5SDavid du Colombierreserved.</small>
5227dd7cddfSDavid du Colombier
5237dd7cddfSDavid du Colombier<p>
524*3ff48bf5SDavid du Colombier<small>This file is part of AFPL Ghostscript.  See the
525*3ff48bf5SDavid du Colombier<a href="Public.htm">Aladdin Free Public License</a> (the "License") for
526*3ff48bf5SDavid du Colombierfull details of the terms of using, copying, modifying, and redistributing
527*3ff48bf5SDavid du ColombierAFPL Ghostscript.</small>
5287dd7cddfSDavid du Colombier
529*3ff48bf5SDavid du Colombier<p>
530*3ff48bf5SDavid du Colombier<small>Ghostscript version 7.04, 31 January 2002
5317dd7cddfSDavid du Colombier
5327dd7cddfSDavid du Colombier<!-- [3.0 end visible trailer] ============================================= -->
5337dd7cddfSDavid du Colombier
5347dd7cddfSDavid du Colombier</body>
5357dd7cddfSDavid du Colombier</html>
536