[gs-cvs] rev 7496 - trunk/gs/doc
ghostgum at ghostscript.com
ghostgum at ghostscript.com
Tue Dec 12 02:22:38 PST 2006
Author: ghostgum
Date: 2006-12-12 02:22:38 -0800 (Tue, 12 Dec 2006)
New Revision: 7496
Modified:
trunk/gs/doc/API.htm
trunk/gs/doc/Install.htm
Log:
Windows documentation updates.
Modified: trunk/gs/doc/API.htm
===================================================================
--- trunk/gs/doc/API.htm 2006-12-12 06:26:11 UTC (rev 7495)
+++ trunk/gs/doc/API.htm 2006-12-12 10:22:38 UTC (rev 7496)
@@ -93,10 +93,9 @@
for each platform:
<ul>
-<li>The Win32 DLL <b><tt>gsdll32.dll</tt></b> has
-MULTIPLE NONSHARED data segments. Under Win32s it can be used by only one
-program at a time, but under Windows 95/98 or Windows NT it can be called by
-multiple programs simultaneously.
+<li>The Win32 DLL <b><tt>gsdll32.dll</tt></b>
+can be used by multiple programs simultaneously, but only once
+within each process.
<li>The OS/2 DLL <b><tt>gsdll2.dll</tt></b> has
MULTIPLE NONSHARED data segments and can be called by multiple programs
Modified: trunk/gs/doc/Install.htm
===================================================================
--- trunk/gs/doc/Install.htm 2006-12-12 06:26:11 UTC (rev 7495)
+++ trunk/gs/doc/Install.htm 2006-12-12 10:22:38 UTC (rev 7496)
@@ -182,17 +182,26 @@
archive files, since this is the most convenient form for users. These
files can also be unpacked as if they were plain zip files.
+<h4><a name="Windows16"></a>Windows 3.1 (16-bit)</h4>
<p>
+The last version to run on 16-bit Windows 3.1 was Ghostscript 4.03.
+<h4><a name="Windows32"></a>Windows 95/98/Me/NT4/2000/XP/2003/Vista (32-bit)</h4>
+<p>
The self-extracting archive is normally named
<b><tt>gs###w32.exe</tt></b>,
where ### is the release number (e.g., 650 for Ghostscript 6.50,
-700 for Ghostscript 7.00).
+700 for Ghostscript 7.00).
+<h4><a name="Windows64"></a>Windows XP/2003/Vista (64-bit)</h4>
+<p>
+The x64 self-extracting archive is normally named
+<b><tt>gs###w64.exe</tt></b>
+This is for 64-bit Windows operating systems based on the x64 instruction set.
+Do not use this on 64-bit processors running 32-bit Windows.
-<h3><a name="Windows4"></a>Windows 95/98 and NT 4</h3>
-
+<h3><a name="Windows4"></a>Installing</h3>
<p>
-To install a self-extracting Ghostscript archive on Windows 95/98 or
-Windows NT4/2000, you need just this self-extracting archive file.
+To install a self-extracting Ghostscript archive on Windows,
+you need just this self-extracting archive file.
Run this file to install Ghostscript.
<p>
@@ -219,9 +228,10 @@
<blockquote><b><tt>
gs<em>#.##</em>\bin
-<br>gs<em>#.##</em>\lib
<br>gs<em>#.##</em>\examples
+<br>gs<em>#.##</em>\lib
<br>gs<em>#.##</em>\doc
+<br>gs<em>#.##</em>\Resource
<br>fonts
</tt></b></blockquote>
@@ -230,12 +240,13 @@
subdirectory, are:
<blockquote><table cellpadding=0 cellspacing=0>
-<tr valign=top> <td><b><tt>GSWIN32.EXE</tt></b>
- <td>
- <td>32-bit Ghostscript using windows
<tr valign=top> <td><b><tt>GSWIN32C.EXE</tt></b>
<td>
- <td>32-bit Ghostscript using only the command line
+ <td>Ghostscript as a command line Windows program.
+ This is usually the preferred executable.
+<tr valign=top> <td><b><tt>GSWIN32.EXE</tt></b>
+ <td>
+ <td>32-bit Ghostscript using its own window for commands
<tr valign=top> <td><b><tt>GSDLL32.DLL</tt></b>
<td>
<td>32-bit dynamic link library containing most of Ghostscript's
@@ -243,7 +254,7 @@
</table></blockquote>
<p>
-See "<a href="#Install_DOS">Installing Ghostscript on DOS</a>" below for
+See "<a href="#Use_platform_fonts_ATM">Using fonts from Adobe Type Manager</a>" below for
information about using Adobe Type Manager, Adobe Type Basics, or Adobe
Acrobat fonts. If your system uses TrueType fonts, you can get them
converted to a Ghostscript-compatible format at the time you select your
@@ -288,14 +299,10 @@
<dt><b><tt>-sOutputFile="LPT1:"</tt></b>
<dd>Output to the named port.
-<dt><b><tt>-sOutputFile="%printer%printer name"</tt></b> (Windows 95, 98,
-NT or 2000)
+<dt><b><tt>-sOutputFile="%printer%printer name"</tt></b>
<dd>Output to the named printer. If your printer is named "HP DeskJet 500"
then you would use <tt>-sOutputFile="%printer%HP DeskJet 500"</tt>.
-<dt><b><tt>-sOutputFile="\\spool\printer name"</tt></b> (Windows 3.1/Win32s)
-<dd>Output to the named printer. Note that this is NOT a UNC name.
-
</dl>
</blockquote>
@@ -304,20 +311,18 @@
registry value of the same name under the key
<blockquote><b><tt>
-HKEY_CURRENT_USER\Software\AFPL Ghostscript\#.##
+HKEY_CURRENT_USER\Software\GPL Ghostscript\#.##
</tt></b></blockquote>
<p>
or if that fails, under the key
<blockquote><b><tt>
-HKEY_LOCAL_MACHINE\SOFTWARE\AFPL Ghostscript\#.##
+HKEY_LOCAL_MACHINE\SOFTWARE\GPL Ghostscript\#.##
</tt></b></blockquote>
<p>
-where #.## is the Ghostscript version number. This does not work under
-Win32s (that is, Windows 3.1, which doesn't support named registry
-values).
+where #.## is the Ghostscript version number.
<p>
Ghostscript will attempt to load the Ghostscript dynamic link
@@ -338,14 +343,42 @@
for the environment variables <b><tt>GS_LIB</tt></b>
and <b><tt>GS_DLL</tt></b>.
+
+<h3><a name="Use_platform_fonts_ATM"></a>
+Using fonts from Adobe Type Manager</h3>
+<p>
+If you have Adobe Type Manager
+(ATM) fonts installed on your system, and you wish to use them with
+Ghostscript, you may wish to replace the <b><tt>FONTMAP</tt></b> file with
+<b><tt>FONTMAP.ATM</tt></b>, and to add to the environment variable
+<b><tt>GS_LIB</tt></b> the name of the directory where the fonts are located
+(see <a href="Use.htm#Finding_files">Use.htm</a> for more information
+about <b><tt>GS_LIB</tt></b>). Before you
+do this, please read carefully the license that accompanies the ATM fonts;
+we take no responsibility for any possible violations of such licenses.
+Similarly, if you have Adobe Type Basics, you may wish to replace
+<b><tt>FONTMAP</tt></b> with <b><tt>FONTMAP.ATB</tt></b>. Finally, if you
+have neither ATM nor ATB but you have Adobe Acrobat installed, you can use
+the Acrobat fonts in place of the ones provided with Ghostscript by adding
+the Acrobat fonts directory to <b><tt>GS_FONTPATH</tt></b> and removing
+these fonts from <b><tt>FONTMAP</tt></b>:
+
+<blockquote>
+Courier, Courier-Bold, Courier-BoldOblique, Courier-Oblique, Helvetica,
+Helvetica-Bold, Helvetica-BoldOblique, Helvetica-Oblique, Symbol, Times-Bold,
+Times-BoldItalic, Times-Italic, Times-Roman, ZapfDingbats
+</blockquote>
+
+
<h3><a name="Uninstall_Windows"></a>Uninstalling Ghostscript on Windows</h3>
<p>
To uninstall Ghostscript, use the Control Panel, Add/Remove Programs and
remove "Ghostscript #.##" and "Ghostscript Fonts". (The entries may be
-called "Aladdin Ghostscript" or "AFPL Ghostscript", rather than just
+called "GPL Ghostscript" or "AFPL Ghostscript", rather than just
"Ghostscript", depending on what version of Ghostscript was installed.)
+
<hr>
<h2><a name="Install_VMS"></a>Installing Ghostscript on OpenVMS</h2>
@@ -401,40 +434,19 @@
<h2><a name="Install_DOS"></a>Installing Ghostscript on DOS</h2>
<p>
-You need the files <b><tt>GS386.EXE</tt></b> and <b><tt>DOS4GW.EXE</tt></b>
-to run Ghostscript. You should install all the files except the fonts in
-<b><tt>C:\GS</tt></b>, and the fonts in <b><tt>C:\GS\FONTS</tt></b>.
+The last version to run on DOS was Aladdin Ghostscript 5.10,
+which used a 386 DOS extender.
+<p>
+If you are running MS Windows, then use the MS Windows Ghostscript
+command line executable <b><tt>GSWIN32C.EXE</tt></b>.
-<p><a name="Use_platform_fonts_DOS"></a> If you have Adobe Type Manager
-(ATM) fonts installed on your system, and you wish to use them with
-Ghostscript, you may wish to replace the <b><tt>FONTMAP</tt></b> file with
-<b><tt>FONTMAP.ATM</tt></b>, and to add to the environment variable
-<b><tt>GS_LIB</tt></b> the name of the directory where the fonts are located
-(see <a href="Use.htm#Finding_files">Use.htm</a> for more information
-about <b><tt>GS_LIB</tt></b>). Before you
-do this, please read carefully the license that accompanies the ATM fonts;
-we take no responsibility for any possible violations of such licenses.
-Similarly, if you have Adobe Type Basics, you may wish to replace
-<b><tt>FONTMAP</tt></b> with <b><tt>FONTMAP.ATB</tt></b>. Finally, if you
-have neither ATM nor ATB but you have Adobe Acrobat installed, you can use
-the Acrobat fonts in place of the ones provided with Ghostscript by adding
-the Acrobat fonts directory to <b><tt>GS_FONTPATH</tt></b> and removing
-these fonts from <b><tt>FONTMAP</tt></b>:
-
-<blockquote>
-Courier, Courier-Bold, Courier-BoldOblique, Courier-Oblique, Helvetica,
-Helvetica-Bold, Helvetica-BoldOblique, Helvetica-Oblique, Symbol, Times-Bold,
-Times-BoldItalic, Times-Italic, Times-Roman, ZapfDingbats
-</blockquote>
-
<hr>
<h2><a name="Install_OS2"></a>Installing Ghostscript on OS/2 2.x</h2>
<p>
-The Ghostscript OS/2 implementation is designed for OS/2 2.1 or later. A
-few people have used it successfully under OS/2 2.0, but it has had very
-little testing. You need these files to run Ghostscript on OS/2:
+The Ghostscript OS/2 implementation is designed for OS/2 2.1 or later.
+You need these files to run Ghostscript on OS/2:
<blockquote><table cellpadding=0 cellspacing=0>
<tr valign=top> <td><b><tt>GSOS2.EXE</tt></b>
@@ -446,7 +458,7 @@
<b><tt>GSOS2.EXE</tt></b> or on the <b><tt>LIBPATH</tt></b>.
<tr valign=top> <td><b><tt>GSPMDRV.EXE</tt></b>
<td>
- <td>An "external driver" used by the "<b><tt>os2pm</tt></b>"
+ <td>An "external driver" used by the <b><tt>display</tt></b>
device, which is normally the default device and which displays
output in a Presentation Manager window;
<b><tt>GSPMDRV.EXE</tt></b> must be located in the same
@@ -458,15 +470,8 @@
<b><tt>GSOS2.EXE</tt></b>, <b><tt>GSDLL2.DLL</tt></b> and
<b><tt>GSPMDRV.EXE</tt></b> are compiled using EMX/GCC 0.9d. You must have
the EMX DLLs on your <b><tt>LIBPATH</tt></b>; they are available in a
-package <b><tt>emxrt.zip</tt></b> from many places on the Internet, so you
-can find the package by using a search engine or an ftp lookup service such
-as the one at
+package <b><tt>emxrt.zip</tt></b> from many places on the Internet.
-<blockquote>
-<a href="http://ftpsearch.lycos.com/"
-class="offset">http://ftpsearch.lycos.com/</a>
-</blockquote>
-
<p>
The system menu of the Ghostscript Image window includes a "Copy" command
to copy the currently displayed bitmap to the Clipboard.
@@ -506,21 +511,6 @@
</table></blockquote>
<p>
-A command file <b><tt>gspm.cmd</tt></b> containing the following line may
-be useful:
-
-<blockquote><b><tt>
- at 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
-</tt></b></blockquote>
-
-<p>
-While drawing, the <b><tt>os2pm</tt></b> driver updates the display every 5
-seconds. On slow computers this is undesirable, and a different interval
-can be specified in milliseconds with the <b><tt>-dUpdateInterval</tt></b>
-option, with a default of <b><tt>-dUpdateInterval=5000</tt></b>; to disable
-update, use <b><tt>-dUpdateInterval=0</tt></b>.
-
-<p>
Standard VGA is very slow because it uses double buffering to avoid bugs
and because of 1-plane to 4-plane conversion; it's better to use a
256-color display driver. Many display drivers have bugs which cause 1
@@ -532,11 +522,6 @@
<b><tt>GS_LOAD</tt></b>.
<p>
-If you run <b><tt>GS386</tt></b> in the OS/2 2.0 or 2.1 DOS box, you must
-select the "ENABLED" setting for the DPMI_DOS_API option of the DOS box.
-<b><tt>GS386</tt></b> will not run with the "AUTO" setting.
-
-<p>
For printer devices, output goes to the default queue. To print to a
specified queue, use <b><tt>-sOutputFile=\\spool\NullLPT1</tt></b>, where
<b><tt>NullLPT1</tt></b> is the queue's physical name.
More information about the gs-cvs
mailing list