diff options
Diffstat (limited to 'Master/xemtex/doc/ghostscript/Install.htm')
-rw-r--r-- | Master/xemtex/doc/ghostscript/Install.htm | 540 |
1 files changed, 0 insertions, 540 deletions
diff --git a/Master/xemtex/doc/ghostscript/Install.htm b/Master/xemtex/doc/ghostscript/Install.htm deleted file mode 100644 index 060de229bae..00000000000 --- a/Master/xemtex/doc/ghostscript/Install.htm +++ /dev/null @@ -1,540 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<head> -<title>How to install Ghostscript</title> -<!-- $Id: Install.htm,v 1.26.2.13.2.6 2003/05/17 14:39:00 giles Exp $ --> -<!-- Originally: install.txt --> -<link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style"> -</head> - -<body> -<!-- [1.0 begin visible header] ============================================ --> - -<!-- [1.1 begin headline] ================================================== --> - -<h1>How to install Ghostscript</h1> - -<!-- [1.1 end headline] ==================================================== --> - -<!-- [1.2 begin table of contents] ========================================= --> - -<h2>Table of contents</h2> - -<blockquote><ul> -<li><a href="#Overview">Overview of how to install Ghostscript</a> -<li><a href="#Install_Unix">Installing Ghostscript on Unix</a> -<ul> -<li><a href="#Shared_object">Ghostscript as a shared object</a> -<li><a href="#Install_GNULinux">Additional notes on GNU/Linux</a> -</ul> -<li><a href="#Install_Windows">Installing Ghostscript on MS Windows</a> -<li><a href="#Install_VMS">Installing Ghostscript on OpenVMS</a> -<li><a href="#Install_DOS">Installing Ghostscript on DOS</a> -<li><a href="#Install_OS2">Installing Ghostscript on OS/2 2.x</a> -</ul></blockquote> - -<!-- [1.2 end table of contents] =========================================== --> - -<!-- [1.3 begin hint] ====================================================== --> - -<p>For other information, see the <a href="Readme.htm">Ghostscript -overview</a> and "<a href="Make.htm">How to build Ghostscript from source -code</a>". - -<!-- [1.3 end hint] ======================================================== --> - -<hr> - -<!-- [1.0 end visible header] ============================================== --> - -<!-- [2.0 begin contents] ================================================== --> - -<h2><a name="Overview"></a>Overview of how to install Ghostscript</h2> - -<p> -You must have three things to run Ghostscript: -<ol> -<li>The Ghostscript executable file; on some operating -systems, more than one file is required. These are entirely -platform-specific. See below for details. - -<li>Initialization files that Ghostscript reads in when it -starts up; these are the same on all platforms. -<ul> -<li><b><tt>gs_</tt></b>*<b><tt>.ps</tt></b> unless Ghostscript was compiled -using the "compiled initialization files" option. See the documentation of -<a href="Psfiles.htm">PostScript files distributed with Ghostscript</a>. - -<li><b><tt>pdf_</tt></b>*<b><tt>.ps</tt></b> if Ghostscript was compiled -with the ability to interpret Adobe Portable Document Format (PDF) files, -that is, <b><tt>pdf.dev</tt></b> was included in -<b><tt>FEATURE_DEVS</tt></b> when Ghostscript was built. - -<li><b><tt>Fontmap</tt></b> and <b><tt>Fontmap.GS</tt></b> (or the -appropriate <b><tt>Fontmap.</tt></b><em>xxx</em> for your platform), unless -you plan always to invoke Ghostscript with the <a -href="Use.htm#FONTMAP_switch"><b><tt>-dNOFONTMAP</tt></b> switch</a>. -</ul> - -<li>Fonts, for rendering text. These are platform-independent, -but if you already have fonts of the right kind on your platform, -you may be able to use those. See below for details. Also see the -<a href="Fonts.htm">documentation on fonts</a>. -</ol> - -<p> -The <a href="Use.htm">usage documentation</a> describes the search -algorithms used to find initialization files and font files. The -per-platform descriptions that follow tell you where to install these -files. - -<hr> - -<h2><a name="Install_Unix"></a>Installing Ghostscript on Unix</h2> - -<p> -Ghostscript uses a GNU autoconf-based configure, build and install method -common to many modern software packages. In general the following with suffice -to build ghostscript: -<blockquote><tt><b> - ./configure<br> - make -</b></tt></blockquote> -and then it may be installed in the default location with: -<blockquote><b> - <tt>make install</tt> -</b></blockquote> -This last command may need to be performed with super user privileges. - -<p> -You can set the installation directory by adding <tt>--prefix=<em>path</em></tt> -to the configure invocation in the first step. The default prefix is <tt>/usr/local</tt>, -which is to say the <tt>gs</tt> executable is installed as <tt>/usr/local/bin/gs</tt>. - -</p>A list of similar configuration options is available via <tt>./configure --help</tt> - -<p> -For more detailed information on building Ghostscript see -<a href="Make.htm#Unix_build">how to build Ghostscript on Unix</a> in -the documentation on building Ghostscript, especially regarding information -on using the older <a href="Make.htm#UNIX_makefile">hand edited makefile</a> -approach. Whatever configuration method you use, execute "<b><tt>make -install</tt></b>" to install the executable and all the required and -ancillary files after the build is complete. - -<h3><a name="Unix_Fonts"></a>Fonts</h3> - -<p> -The makefile installs all the files except fonts under the directory -defined in the makefile as <b><tt>prefix</tt></b>. Fonts need to be -installed separately. The fonts should be installed in -<tt><em>{prefix}</em>/share/ghostscript/fonts</tt>. -(That is, <tt>/usr/local/share/ghostscript/fonts/</tt> if you used the default -configuration above.) - -<p> -You can have ghostscript use other fonts on your system by adding -entries to the fontmap or adding the directories to the GS_FONTMAP environment -variable. See the <a href="Use.htm#Font_lookup">usage documentation</a> for more -information. -For example, many GNU/Linux distributions place fonts under <tt>/usr/share/fonts</tt>. - -<h3><a name="Shared_object"></a>Ghostscript as a shared object</h3> -If you've built Ghostscript as a shared object, instead of '<tt>make install</tt>', -you must use '<tt>make soinstall</tt>'. -See <a href="Make.htm#Shared_object">how to build Ghostscript -as a shared object</a> for more details. - -<h3><a name="Install_GNULinux"></a>Additional notes on GNU/Linux</h3> - -<p> -For GNU/Linux, you may be able to install or upgrade Ghostscript from -precompiled <a href="http://www.rpm.org">RPM</a> files using: - -<blockquote><b><tt> -rpm -U ghostscript-N.NN-1.i386.rpm<br> -rpm -U ghostscript-fonts-N.NN-1.noarch.rpm -</tt></b></blockquote> - -<p> -However, please note that we do not create RPMs for Ghostscript, and we take -no responsibility for RPMs created by others. - -<hr> - -<h2><a name="Install_Windows"></a>Installing Ghostscript on MS Windows</h2> - -<p> -We usually distribute Ghostscript releases for Windows as self-extracting -archive files, since this is the most convenient form for users. These -files can also be unpacked as if they were plain zip files. - -<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). - -<h3><a name="Windows4"></a>Windows 95/98 and NT 4</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. -Run this file to install Ghostscript. - -<p> -Alternatively, if you have the zip file, unzip it to a temporary -directory then run the included <b><tt>setupgs.exe</tt></b>. -After the setup program has finished, remove the temporary files. - -<h3><a name="General_Windows"></a>General Windows configuration</h3> - -<p> -The archive includes files in these subdirectories: - -<blockquote><b><tt> -gs<em>#.##</em>\bin -<br>gs<em>#.##</em>\lib -<br>gs<em>#.##</em>\examples -<br>gs<em>#.##</em>\doc -<br>fonts -</tt></b></blockquote> - -<p> -The actual executable files, in the <b><tt>gs<em>#.##</em>\bin</tt></b> -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 -<tr valign=top> <td><b><tt>GSDLL32.DLL</tt></b> - <td> - <td>32-bit dynamic link library containing most of Ghostscript's -functionality -</table></blockquote> - -<p> -See "<a href="#Install_DOS">Installing Ghostscript on DOS</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 -"printer" by doing the following: - -<blockquote><ol> -<li>Open control panel and double-click on the "Printers" icon. -<li>Select your Postscript printer. -<li>Choose Setup. -<li>Choose Options. -<li>Choose Advanced. -<li>At the top of the dialog box you will see TrueType Fonts Send to -Printer As: Choose <em>(drop-down menu)</em> Adobe Type 1. -<li>Uncheck Use Printer Fonts for All TrueType Fonts and Use -Substitution -Table. -<li>OK. -<li>OK etc. -</ol></blockquote> - -<p> -That's it! Your TrueType fonts will automatically be downloaded in your -PostScript file for Ghostscript to use. - -<p> -For printer devices, the default output is: - -<blockquote><table cellpadding=0 cellspacing=0> -<tr valign=top> <td>The default printer - <td> - <td>Win95 or WinNT -<tr valign=top> <td>Prompt for a printer port - <td> - <td>Win32s (Windows 3.1) -</table></blockquote> - -<p> -This can be modified as follows. - -<blockquote> -<dl> -<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) -<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> - -<p> -If Ghostscript fails to find an environment variable, it looks for a -registry value of the same name under the key - -<blockquote><b><tt> -HKEY_CURRENT_USER\Software\GNU Ghostscript\#.## -</tt></b></blockquote> - -<p> -or if that fails, under the key - -<blockquote><b><tt> -HKEY_LOCAL_MACHINE\SOFTWARE\GNU 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). - -<p> -Ghostscript will attempt to load the Ghostscript dynamic link -library <b><tt>GSDLL32.DLL</tt></b> in the following order: -<ul> -<li> In the same directory as the Ghostscript executable. -<li> If the environment variable <b><tt>GS_DLL</tt></b> is defined, -Ghostscript tries to load the Ghostscript dynamic link library (DLL) -with the name given. -<li> Using the standard Windows library search method: the directory -from which the application loaded, the current directory, the Windows -system directory, the Windows directory and the directories listed in -the PATH environment variable. -</ul> - -<p> -The Ghostscript setup program will create registry values -for the environment variables <b><tt>GS_LIB</tt></b> -and <b><tt>GS_DLL</tt></b>. - -<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 some other specifier rather than just -"Ghostscript", depending on what version of Ghostscript was installed.) - -<hr> - -<h2><a name="Install_VMS"></a>Installing Ghostscript on OpenVMS</h2> - -<p> -You need the file <b><tt>GS.EXE</tt></b> to run Ghostscript on OpenVMS, and -installing Ghostscript on an OpenVMS system requires building it first: -please read <a href="Make.htm#VMS_build">how to build Ghostscript on VMS</a> -in the documentation on building Ghostscript. - -<p> -The following installation steps assume that the Ghostscript directory is -<b><tt>DISK1:[DIR.GHOSTSCRIPT]</tt></b>. Yours will almost certainly be in -a different location so adjust the following commands accordingly. - -<ul> - -<li>Download the fonts and unpack them into -<b><tt>DISK1:[DIR.GHOSTSCRIPT.LIB]</tt></b>. - -<li>Enable access to the program and support files for all users with: - -<blockquote><pre> -$ set file/prot=w:re DISK1:[DIR]GHOSTSCRIPT.dir -$ set file/prot=w:re DISK1:[DIR.GHOSTSCRIPT...]*.* -</pre></blockquote> - -<li>Optionally, add the Ghostscript help instructions to your system wide -help file: - -<blockquote><pre> -$ lib/help sys$help:HELPLIB.HLB DISK1:[DIR.GHOSTSCRIPT.DOC]GS-VMS.HLP -</pre></blockquote> - -<li>Lastly, add the following lines to the appropriate system wide or user -specific login script. - -<blockquote><pre> -$ define gs_exe DISK1:[DIR.GHOSTSCRIPT.BIN] -$ define gs_lib DISK1:[DIR.GHOSTSCRIPT.EXE] -$ gs :== $gs_exe:gs.exe -</pre></blockquote> - -</ul> - -<p> -If you have DECWindows/Motif installed, you may wish to replace the -<b><tt>FONTMAP.GS</tt></b> file with <b><tt>FONTMAP.VMS</tt></b>. Read the -comment at the beginning of the latter file for more information. - -<hr> - -<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>. - -<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 below 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: - -<blockquote><table cellpadding=0 cellspacing=0> -<tr valign=top> <td><b><tt>GSOS2.EXE</tt></b> - <td> - <td>A text application that will run windowed or full screen -<tr valign=top> <td><b><tt>GSDLL2.DLL</tt></b> - <td> - <td>A dynamic link library that must be in the same directory as - <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>" - 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 - directory as <b><tt>GSOS2.EXE</tt></b> or on the - <b><tt>PATH</tt></b> -</table></blockquote> - -<p> -<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 - -<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. - -<p> -OS/2 comes with some Adobe Type Manager fonts. If you wish to use these with -Ghostscript, you should replace the <b><tt>FONTMAP</tt></b> file with -<b><tt>FONTMAP.OS2</tt></b>, and add to the environment variable -<b><tt>GS_LIB</tt></b> (see below for more information about -<b><tt>GS_LIB</tt></b>) the name of the directory where the fonts are -located, usually <b><tt>C:\PSFONTS</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. - -<p> -Since <b><tt>GSOS2.EXE</tt></b> is not a PM application, it cannot -determine the depth of the PM display. You must provide this information -using the <b><tt>-dBitsPerPixel</tt></b> option. Valid values are 1, 4, 8 -(the default), and 24. - -<blockquote><table cellpadding=0 cellspacing=0> -<tr valign=bottom> - <th align=left>Use - <td> - <th align=left>For -<tr> <td colspan=3><hr> -<tr valign=top> <td><b><tt>-dBitsPerPixel=1</tt></b> - <td> - <td>VGA monochrome -<tr valign=top> <td><b><tt>-dBitsPerPixel=4</tt></b> - <td> - <td>VGA standard -<tr valign=top> <td><b><tt>-dBitsPerPixel=8</tt></b> - <td> - <td>SVGA 256 colors -</table></blockquote> - -<p> -A command file <b><tt>gspm.cmd</tt></b> containing the following line may -be useful: - -<blockquote><b><tt> -@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 -bit-per-pixel bitmaps to be displayed incorrectly. - -<p> -<b><tt>GSOS2.EXE</tt></b> and <b><tt>GSPMDRV.EXE</tt></b> will stay in -memory for the number of minutes specified in the environment variable -<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. - -<!-- [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> |