home *** CD-ROM | disk | FTP | other *** search
/ swCHIP 1991 January / swCHIP_95-1.bin / utility / gs333ini / gs3.33 / use.doc < prev    next >
Text File  |  1995-12-09  |  45KB  |  1,093 lines
  1.    Copyright (C) 1989, 1995 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17.  
  18. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  19.  
  20. This file, use.doc, describes how to use the Ghostscript language
  21. interpreter.
  22.  
  23. For an overview of Ghostscript and a list of the documentation files, see
  24. README.  
  25.  
  26. ********
  27. ******** How to install Ghostscript ********
  28. ********
  29.  
  30. To run Ghostscript, you need the executable program, and also some
  31. external initialization files:
  32.     gs_*.ps (see psfiles.doc for the full list), unless Ghostscript was
  33.       compiled using the "compiled initialization files" option
  34.     Fontmap
  35.  
  36. The file name of the executable program depends on the environment;
  37. see the instructions for the specific platforms below.
  38.  
  39. The Ghostscript fileset includes a set of fonts (.gsf files); you should
  40. have them on line as well, unless you have a complete set of other fonts
  41. (such as ATM or Display PostScript fonts) and are using a Fontmap and/or
  42. GS_FONTPATH that references them.
  43.  
  44. VMS
  45. ---
  46.  
  47. Installing Ghostscript on a VMS system requires compiling it first.  The
  48. name of the executable is GS.EXE.
  49.  
  50. You should install all the files, including the fonts, in the same
  51. directory as the executable and initialization files.  By default, this is
  52. the directory in which you did the compilation.  Consult the command file
  53. (VMS*.MAK) for more details.
  54.  
  55. If you have DECWindows/Motif installed, you may wish to replace the FONTMAP
  56. file with the file FONTMAP.VMS.  Read the comment at the beginning of the
  57. latter file for more information.
  58.  
  59. MS-DOS
  60. ------
  61.  
  62. There are two MS-DOS executables in the standard Ghostscript
  63. distribution:
  64.     - GS.EXE runs on any MS-DOS machine, but is limited to 640K.
  65.     - GS386.EXE runs on any 386 or 486 machine, and will use all
  66. available extended (not expanded) memory.
  67.  
  68. You should install all the files except the fonts in C:\GS, and the
  69. fonts in C:\GS\FONTS.
  70.  
  71. If you have Adobe Type Manager fonts installed on your system, and you wish
  72. to use them with Ghostscript, you may wish to replace the FONTMAP file with
  73. FONTMAP.ATM, and to add to the environment variable GS_LIB the name of the
  74. directory where the fonts are located (see below for more information about
  75. GS_LIB).  Before you do this, please read carefully the license that
  76. accompanies the ATM fonts; Aladdin Enterprises takes no responsibility for
  77. any possible violations of such licenses.  Similarly, if you have Adobe
  78. Type Basics, you may wish to replace FONTMAP with FONTMAP.ATB.
  79.  
  80. MS Windows
  81. ----------
  82.  
  83. The name of the executable is GSWIN.EXE.  Ghostscript probably requires
  84. Windows 3.1, and you must run Windows in 386 Enhanced or Standard (not
  85. Real) mode.  Since Ghostscript is a large program, you will need to run
  86. Windows in Enhanced mode (so that it can provide virtual memory) unless
  87. you have at least 6 Mb of RAM.
  88.  
  89. You should install all the files except the fonts in C:\GS, and the fonts
  90. in C:\GS\FONTS.
  91.  
  92. See under "MS-DOS" above for information about using Adobe Type Manager
  93. fonts with Ghostscript.
  94.  
  95. The files COMMDLG.DLL and SHELL.DLL supplied with Ghostscript are only for
  96. use with Windows 3.0.  If you have Windows 3.1, delete these files, since
  97. Windows itself provides versions of them.
  98.  
  99. If your system uses TrueType fonts, you can get them converted to a
  100. Ghostscript-compatible format at the time you select your "printer" by
  101. doing the following:
  102.  
  103. 1)    Open control panel and double click on the printers icon.
  104. 2)    Select your Postscript Printer.
  105. 3)    Choose Setup.
  106. 4)    Choose Options.
  107. 5)    Choose Advanced.
  108. 6)    At the top of the Dialog Box you will see TrueType Fonts
  109.     Send to Printer As: <drop down menu>
  110.     Choose Adobe Type 1.
  111. 7)    Uncheck Use Printer Fonts for All TrueType Fonts
  112.     and Use Substitution Table.
  113. 8)    OK.
  114. 9)    OK etc.
  115.  
  116. That's it!  Your TrueType fonts will automatically be downloaded in your
  117. PostScript file for Ghostscript to use.
  118.  
  119. OS/2 2.x
  120. --------
  121.  
  122. The Ghostscript OS/2 implementation is designed for OS/2 2.1.  A few people
  123. have used it successfully under OS/2 2.0, but it has had very little
  124. testing.
  125.  
  126. The name of the executable is GSOS2.EXE.  This is a text application that
  127. will run windowed or full screen.  The default device is "os2pm" which
  128. displays output in a Presentation Manager window using the external driver
  129. GSPMDRV.EXE.  GSPMDRV.EXE must be located in the same directory as
  130. GSOS2.EXE or on the PATH.
  131.  
  132. GSOS2.EXE and GSPMDRV.EXE are compiled using EMX/GCC 0.8h.  You must have
  133. the EMX DLL's on your LIBPATH.  These are available from
  134. ftp.cdrom.com:pub/os2/2_x/unix/gnu/emx08h/emxrt.zip.
  135.  
  136. The system menu of the Ghostscript Image window includes a "Copy" command
  137. to copy the currently displayed bitmap to the Clipboard.
  138.  
  139. OS/2 comes with some Adobe Type Manager fonts. If you wish to use these
  140. with Ghostscript, you should replace the FONTMAP file with FONTMAP.OS2,
  141. and add to the environment variable GS_LIB the name of the directory where
  142. the fonts are located, usually c:\psfonts.  (see below for more
  143. information about GS_LIB).  Before you do this, please read carefully the
  144. license that accompanies the ATM fonts; Aladdin Enterprises takes no
  145. responsibility for any possible violations of such licenses.
  146.  
  147. Since GSOS2.EXE is not a PM application, it cannot determine the depth of
  148. the PM display.  You must provide this information using the
  149. -dBitsPerPixel option.  The default is 8 bits/pixel.  Valid values are 1,
  150. 4, 8, 16 & 24.
  151.   For monochrome VGA use      -dBitsPerPixel=1
  152.   For standard VGA screen use -dBitsPerPixel=4
  153.   For 256 colour SVGA use     -dBitsPerPixel=8
  154. A command file gspm.cmd containing the following line may be useful:
  155.   @c:\gs\gsos2.exe -Ic:/gs;c:/gs/fonts;c:/psfonts -sDEVICE=os2pm 
  156.       -dBitsPerPixel=8 -sPAPERSIZE=a4 %1 %2 %3 %4 %5 %6 %7 %8
  157.  
  158. While drawing, the os2pm driver updates the display every 5 seconds.  On
  159. slow computers this is undesirable and a different interval can be
  160. specified in milliseconds with the -dUpdateInterval option.  The default
  161. is -dUpdateInterval=5000; to disable update use -dUpdateInterval=0.
  162.  
  163. Standard VGA is very slow due to double buffering to avoid bugs and due to
  164. 1 plane to 4 plane conversion.  Use a 256 color display driver by
  165. preference.  Many display drivers have bugs which cause 1 bit/pixel
  166. bitmaps to be displayed incorrectly.
  167.  
  168. GSOS2.EXE and GSPMDRV.EXE will stay in memory for the number of minutes
  169. specified in the environment variable GS_LOAD.
  170.  
  171. Ghostscript can also be run in a DOS box.  Please read the MS-DOS notes, 
  172. since they apply to this environment as well.
  173.  
  174. If you run GS386 in the OS/2 2.0 or 2.1 DOS Box, you must select the
  175. "ENABLED" setting for the DPMI_DOS_API option of the DOS Box.  GS386
  176. will not run with the "AUTO" setting.
  177.  
  178. Unix
  179. ----
  180.  
  181. Installing Ghostscript on a Unix system requires compiling it first.
  182. The name of the executable is gs.  The makefile installs all the
  183. files, except the fonts, in /usr/local or various subdirectories
  184. thereof.  The fonts should be installed in
  185. /usr/local/lib/ghostscript/fonts.  Consult the makefile for more
  186. details.
  187.  
  188. ********
  189. ******** Shell scripts for Ghostscript
  190. ********
  191.  
  192. The Ghostscript distribution includes several Unix shell scripts for
  193. driving Ghostscript in different environments.  These are all
  194. user-contributed code: please contact the user identified in the file, not
  195. Aladdin Enterprises, if you have questions.
  196.  
  197. > pv.sh - preview a specified page of a dvi file in an X window.
  198.  
  199. > sysvlp.sh - System V 3.2 lp interface for parallel printer.
  200.  
  201. > pj-gs.sh - printing on an H-P PaintJet under HP-UX.
  202.  
  203. > unix-lpr.sh - queue filter for lpr under Unix.
  204. > lprsetup.sh - setup for unix-lpr.sh.
  205.  
  206. If one of these serves your needs, you may be able to skip most of
  207. the rest of this document.
  208.  
  209. ********
  210. ******** How to use Ghostscript ********
  211. ********
  212.  
  213. To invoke the interpreter, give the command
  214.     gs <filename1> ... <filenameN>
  215. The interpreter will read in the files in sequence and execute them.
  216. After doing this, it reads further input from the primary input stream
  217. (normally the keyboard).  Each line (i.e. characters up to a <return>) is
  218. interpreted separately.  To exit from the interpreter, type quit<return>.
  219. The interpreter also exits gracefully if it encounters end-of-file.
  220. Typing the interrupt character, e.g., control-C, is also safe.
  221.  
  222. The interpreter recognizes several switches described below, which may appear
  223. anywhere in the command line and apply to all files thereafter.
  224.  
  225. You can get a brief help message by invoking Ghostscript with
  226.     gs -h
  227. or
  228.     gs -?
  229. This message also lists the available devices.  For a little more
  230. information about available devices, a one-line description of each device
  231. appears near the beginning of the file devs.mak.
  232.  
  233. Choosing the output device
  234. --------------------------
  235.  
  236. Ghostscript may be built with multiple output devices.  Ghostscript
  237. normally opens the first one and directs output to it.  To use device xyz
  238. as the initial output device, include the switch
  239.     -sDEVICE=xyz
  240. in the command line.  Note that this switch must precede the first .ps
  241. file, and only its first invocation has any effect.  For example, for
  242. printer output in a normal configuration that includes an Epson printer
  243. driver, you might use the shell command
  244.     gs -sDEVICE=epson myfile.ps
  245. instead of just
  246.     gs myfile.ps
  247. Alternatively, once you are inside Ghostscript, you can type
  248.     (epson) selectdevice
  249.     (myfile.ps) run
  250. All output then goes to the printer instead of the display until further
  251. notice.  You can switch devices at any time by using the selectdevice
  252. procedure, e.g.,
  253.     (vga) selectdevice
  254. or
  255.     (epson) selectdevice
  256. As yet a third alternative, you can define an environment variable
  257. GS_DEVICE as the desired default device name.  The order of precedence for
  258. these alternatives, highest to lowest, is:
  259.     selectdevice
  260.     (command line)
  261.     GS_DEVICE
  262.     (first device in build list)
  263.  
  264. To select the resolution on a printer, use the shell command
  265.     gs -sDEVICE=<device> -r<xres>x<yres>
  266. For example, on a 9-pin Epson-compatible printer, you can get the
  267. lowest-resolution (fastest) mode with
  268.     gs -sDEVICE=epson -r60x72
  269. and the highest-resolution mode with
  270.     gs -sDEVICE=epson -r240x72.
  271. On a 24-pin printer, the lowest resolution is
  272.     gs -sDEVICE=epson -r60x60
  273. and the highest-resolution 24-pin mode is
  274.     gs -sDEVICE=epson -r360x180
  275.  
  276. If you select a printer as the output device, Ghostscript also allows you
  277. to control where the device sends its output.  Normally, output goes
  278. directly to the printer (PRN) on MS-DOS systems, and to a scratch file on
  279. Unix or VMS systems.  To send the output to a series of files foo1.xyz,
  280. foo2.xyz, ..., use the switch
  281.     -sOutputFile=foo%d.xyz
  282. (For compatibility with older versions of Ghostscript, -sOUTPUTFILE=
  283. also works.)  The %d is a printf format specification; you can use
  284. other formats like %02d.  Each file will receive one page of output.
  285. Alternatively, to send the output to a single file foo.xyz, with all
  286. the pages concatenated, use the switch
  287.     -sOutputFile=foo.xyz
  288.  
  289. On Unix systems, you can send the output directly to a pipe.  For
  290. example, to pipe the output to the command `lpr' (which, on many Unix
  291. systems, is the command that spools output for a printer), use the
  292. switch
  293.     -sOutputFile=\|lpr
  294. You can also send output to stdout for piping with the switch
  295.     -sOutputFile=-
  296. In this case you must also use the -q switch, to prevent Ghostscript from
  297. writing messages to stdout.
  298.  
  299. File formats like PCX and PBM are also 'devices'.  When you select a file
  300. format as the 'device', you must also specify an output file, e.g.,
  301.     gs -sDEVICE=pcxmono -sOutputFile=xyz.pcx
  302.  
  303. To find out what devices are available, type
  304.     devicenames ==
  305. after starting up Ghostscript.  Alternatively you can use the -h or
  306. -? switch in the command line, as described above.
  307.  
  308. Choosing paper size
  309. -------------------
  310.  
  311. Ghostscript is normally configured to expect U.S. letter paper.  To select
  312. a different paper size as the default, find the line in gs_init.ps that
  313. says
  314.  
  315.     % Optionally choose a default paper size other than U.S. letter.
  316.  
  317. The next line begins
  318.  
  319.     % (a4)
  320.  
  321. To select A4 as the default paper size, remove the % but do not change
  322. anything else.  To select a different default paper size, remove the % and
  323. replace the word a4 with the name of the desired paper size.  You can use
  324. any paper size listed in the table at the beginning of gs_statd.ps.
  325. (Individual documents can also specify a paper size, which will take
  326. precedence over the one specified on the command line.)
  327.  
  328. Alternatively, to select a different paper size for a single invocation of
  329. Ghostscript, you can use the command line switch
  330.     -sPAPERSIZE=a_known_paper_size
  331. e.g.,
  332.     -sPAPERSIZE=a4
  333. or
  334.     -sPAPERSIZE=legal
  335.  
  336. Finally, most (but not all) of Ghostscript's printer drivers can be
  337. configured at compile time to use A4 paper as the default by including
  338. -DA4 in the CFLAGS switches in the makefile.  See make.doc for more
  339. details.
  340.  
  341. File searching
  342. --------------
  343.  
  344. When looking for the initialization files (gs_*.ps), the files related to
  345. fonts, or the file for the 'run' operator, Ghostscript first checks whether
  346. the file name specifies an explicit directory or drive (i.e., doesn't begin
  347. with '/' on Unix systems; doesn't contain a ':' or begin with a '/' or '\'
  348. on MS-DOS systems; doesn't contain a ':' or a square bracket on VMS
  349. systems).  If it does, Ghostscript simply tries to open the file using the
  350. given name.  Otherwise, Ghostscript will try directories in the following
  351. order:
  352.  
  353.     - The current directory;
  354.  
  355.     - The directory/ies specified by the -I switch(es) in the command
  356.       line (see below), if any;
  357.  
  358.     - The directory/ies specified by the GS_LIB environment variable,
  359.       if any;
  360.  
  361.     - The directory/ies specified by the GS_LIB_DEFAULT macro in the
  362.       Ghostscript makefile, if any.
  363.  
  364. Each of these (GS_LIB_DEFAULT, GS_LIB, and -I parameter) may be either a
  365. single directory, or a list of directories separated by a character
  366. appropriate for the operating system (':' on Unix systems, ';' on VMS
  367. systems, ';' on MS-DOS systems).  We think that trying the current
  368. directory first is a very bad idea -- it opens serious security loopholes
  369. and can lead to very confusing errors if one has more than one version of
  370. Ghostscript in one's environment -- but when we attempted to change it,
  371. users insisted that we change it back.
  372.  
  373. When Ghostscript starts up, it also looks at the GS_FONTPATH environment
  374. variable, which is also a list of directories.  It goes to those
  375. directories and looks for all files that appear to contain PostScript
  376. fonts; it then effectively adds all those files and fonts to its internal
  377. copy of the Fontmap (the catalog of fonts and the files that contain
  378. them).  If you are using one of the following types of computer, you may
  379. wish to set GS_FONTPATH to the indicated value so that Ghostscript will
  380. automatically acquire all the installed Type 1 fonts:
  381.  
  382.     System type        GS_FONTPATH
  383.     -----------        -----------
  384.     AIX            /usr/lpp/DPS/fonts/outlines
  385.     NeXT            /NextLibrary/Fonts/outline
  386.     OSF/1            /usr/lib/X11/fonts/Type1Adobe
  387.     Silicon Graphics    /usr/lib/DPS/outline/base
  388.     Sun (Solaris 2.3)    /usr/openwin/lib/X11/fonts/Type1/outline
  389.     Ultrix            /usr/lib/DPS/outline/decwin
  390.  
  391. These paths may not be exactly right for your installation; if the
  392. indicated directory doesn't contain files whose names are familiar font
  393. names like Courier and Helvetica, you may wish to ask your system
  394. administrator where to find these fonts.
  395.  
  396. Temporary files
  397. ---------------
  398.  
  399. By default, Ghostscript creates temporary files named _temp_XX.XXX in the
  400. current directory on MS-DOS and VMS systems, gsXXXXXX in the current
  401. directory on OS/2 systems, and gs_XXXXX in the /tmp directory on Unix
  402. systems.  You can change the directory in which Ghostscript will create
  403. these files by setting the TEMP environment variable to the name of the
  404. directory.
  405.  
  406. Ghostscript currently doesn't do a very good job of deleting temporary
  407. files when it exits; you may have to delete them manually from time to
  408. time.
  409.  
  410. Environment variable summary
  411. ----------------------------
  412.  
  413. GS_DEVICE
  414.     Defines the default output device.  Described above.
  415.  
  416. GS_FONTPATH
  417.     Specifies a list of directories that should be scanned for fonts
  418. at startup.  Described above.
  419.  
  420. GS_LIB
  421.     Provides a search path for initialization files and fonts.
  422. Described above.
  423.  
  424. GS_OPTIONS
  425.     Defines a list of command line arguments to be processed before
  426. the ones actually specified on the command line.  For example, setting
  427. GS_DEVICE to xxx is equivalent to setting GS_OPTIONS to -sDEVICE=xxx.  The
  428. contents of GS_OPTIONS are not limited to switches; they may include
  429. actual file names or even @file arguments.
  430.  
  431. TEMP
  432.     Defines a directory name for temporary files.  Described above.
  433.  
  434. ********
  435. ******** Notes on specific platforms ********
  436. ********
  437.  
  438. VMS
  439. ---
  440.  
  441. On VMS systems, the last character of each "directory" name indicates what
  442. sort of entity the "directory" references.  If the "directory" name ends
  443. with a colon, it is taken as referring to a logical device, e.g.:
  444.     $ DEFINE GHOSTSCRIPT_DEVICE DUA1:[GHOSTSCRIPT_14]
  445.     $ DEFINE GS_LIB GHOSTSCRIPT_DEVICE:
  446. If the "directory" name ends with a closing square bracket, it is taken as
  447. referring to a real directory, e.g.:
  448.     $ DEFINE GS_LIB DUA1:[GHOSTSCRIPT]
  449.  
  450. To run Ghostscript with switches, you must type a command like
  451.  
  452.     $ gs "-dNODISPLAY"
  453.  
  454. because the C run time library will convert the command
  455. parameters/arguments to lowercase unless you enclose them in double quotes
  456. which preserves the case.
  457.  
  458. If you are on an X Windows display (for which gs is built), you can do
  459.  
  460.     $ set display/create/node="domain-name"/transport=tcpip
  461.  
  462. For example,
  463.  
  464.     $ set display/create/node="doof.city.com"/transport=tcpip
  465.  
  466. and then run Ghostscript
  467.  
  468.     $ gs
  469.  
  470. If you write printer output to a file and then want to print the file
  471. later, use the "/PASSALL" qualifier to the PRINT command.
  472.  
  473. In order to get PDF files (or PostScript files that use the setfileposition
  474. operator) to work properly on VMS systems, you must ensure that they are
  475. "stream LF" type files.  If you transfer files by FTP, you probably need to
  476. do one of the following two things after the transfer:
  477.  
  478. 1. If FTP'd in text/ASCII mode then do:
  479.  
  480.      $ CONVERT/FDL=STREAMLF.FDL input-file output-file
  481.  
  482.    where the contents of the file STREAMLF.FDL are given below.
  483.  
  484. 2. Otherwise, if FTP'd in binary mode do
  485.  
  486.      $ SET FILE/ATTRIBUTE=(RFM:STMLF)
  487.  
  488. The contents of the STREAMLF.FDL file are shown between, and exclusive of, the
  489. dashed lines:
  490.  
  491. -------------------------------------------------
  492. FILE
  493.         ORGANIZATION            sequential
  494.  
  495. RECORD
  496.         BLOCK_SPAN              yes
  497.         CARRIAGE_CONTROL        carriage_return
  498.         FORMAT                  stream_lf
  499. -------------------------------------------------
  500.  
  501. MS-DOS
  502. ------
  503.  
  504. Ghostscript supports many SuperVGA displays directly, most of them with
  505. more than 16 colors.  The complete list is in the file devs.mak, which is
  506. part of the Ghostscript source code.  (If you got Ghostscript under the
  507. Aladdin Ghostscript Free Public License, the person or place from which you
  508. got it is also required to make the source code available to you; if you
  509. got it under the GNU License, see the GNU License for more information.)
  510.  
  511. If you have a SuperVGA display that supports a 16-color mode with 800x600
  512. pixels, and you know the display mode number for this mode, you can select
  513. it by using the command line switches
  514.     -sDEVICE=svga16 -dDisplayMode=NNN
  515. where NNN is the display mode number in decimal.  The modes for some
  516. popular display chipsets are as follows:
  517.  
  518.     Acumos AVGA2, AVGA3                         88    (0x58)
  519.     Advance Logic AL2101                        43    (0x2B)
  520.     Ahead V5000                                 113    (0x71)
  521.     ATI VGAWONDER, Graphics Ultra etc.          84    (0x54)
  522.     Chips and Technologies                      106    (0x6A)
  523.     Cirrus Logic CL-GD 500/600                  100    (0x64)
  524.     Cirrus Logic GD 5422                        88    (0x58)
  525.     Compaq VGA                                  89    (0x59)
  526.     CTI                                         106    (0x6A)
  527.   * Genoa 5xxx, Sigma VGA                       41    (0x29)
  528.     Genoa 6xxx                                  106    (0x6A)
  529.     MXIC MX 68010                               85    (0x55)
  530.     NCR 77C22                                   88    (0x58)
  531.     OAK Technologies OTI-067, OTI-077, OTI037C  82    (0x52)
  532.     OAK Technologies OTI037C w/ NEL BIOS        91    (0x5B)
  533.   * Orchid Prodesigner                          41    (0x29)
  534.     Paradise                                    88    (0x58)
  535.     Poach                                       106    (0x6A)
  536.     Primus                                      42    (0x2A)
  537.     Realtek RT 3106                             31    (0x1F)
  538.     Tecmar                                      22    (0x16)
  539.     Trident 8900                                91    (0x5B)
  540.   * Tseng ET-3000, ET-4000                      41    (0x29)
  541.   * VEGA                                        41    (0x29)
  542.     Video 7 SVGA                                98    (0x62)
  543.     WD90C11                                     92    (0x5C)
  544.     Western Digital                             88    (0x58)
  545.  
  546. The ones marked * are the default (they all use the same value.)  If your
  547. card's chipset doesn't appear on this list, or if you try the value here
  548. and it doesn't work, please e-mail the chipset and correct display mode to
  549. ghost@aladdin.com for inclusion in future releases.
  550.  
  551. If you are running Ghostscript on a MS-DOS machine with a display that is
  552. not EGA/VGA compatible, you must use the Borland compiler.  You must build
  553. Ghostscript with the BGI driver as the default, and you will need the
  554. appropriate .BGI file from the Borland Turbo C library.  (Ghostscript
  555. includes the EGA/VGA driver in the executable.)
  556.  
  557. If you are using the BGI driver, two additional environment variables
  558. become relevant:
  559.  
  560.     BGIPATH - defines the directory where Ghostscript will look for
  561. the appropriate BGI driver.  If BGIPATH is not defined, Ghostscript will
  562. look in the directory defined as BGIDIR in the makefile.  In either case,
  563. if no driver is found in the designated directory, Ghostscript will look
  564. in the current directory.
  565.  
  566.     BGIUSER - a string of the form nn.dname, where nn is a hexadecimal
  567. number giving a display mode and dname is the name of a file containing a
  568. user-supplied BGI driver.  If BGIUSER is defined and the BGI device is
  569. selected, Ghostscript will supply nn as the display mode and will obtain
  570. the driver from the file named dname.
  571.  
  572. Some applications, such as Microsoft Word, require a prologue in front of
  573. the PostScript files they output.  In the case of Word, this is one of the
  574. *.ini files included with the Word distribution.  Other applications may
  575. require other prologues.  These may be specified on the Ghostscript
  576. command line, e.g.,
  577.     gs prologue.ini myfile.ps
  578.  
  579. X Windows
  580. ---------
  581.  
  582. Ghostscript looks for the following resources under the program name
  583. "ghostscript" and class name "Ghostscript":
  584.  
  585.     Name            Class            Default
  586.     ----            -----            -------
  587.     background        Background        white
  588.     foreground        Foreground        black
  589.     borderColor        BorderColor        black
  590.     borderWidth        BorderWidth        1
  591.     geometry        Geometry        NULL
  592.     xResolution        Resolution        **
  593.     yResolution        Resolution        **
  594.     useExternalFonts    UseExternalFonts    true
  595.     useScalableFonts    UseScalableFonts    true
  596.     logExternalFonts    LogExternalFonts    false
  597.     externalFontTolerance    ExternalFontTolerance    10.0
  598.     palette            Palette            Color
  599.     maxGrayRamp        MaxGrayRamp        128
  600.     maxRGBRamp        MaxRGBRamp        5
  601.         maxDynamicColors    MaxDynamicColors    256
  602.     useBackingPixmap    UseBackingPixmap    true
  603.     useXPutImage        UseXPutImage        true
  604.     useXSetTile        UseXSetTile        true
  605.     regularFonts        RegularFonts        see below
  606.     symbolFonts        SymbolFonts        see below
  607.     dingbatFonts        DingbatFonts        see below
  608.  
  609. ** Calculated from display metrics.
  610.  
  611.     Notes on Resources:
  612.  
  613.     Ghostscript doesn't look at the default system background and
  614.     foreground colors; if you want to change the background or
  615.     foreground color, you must set them explicitly for Ghostscript.
  616.     (This is a deliberate choice, so that PostScript documents will
  617.     display correctly -- with white = white and black = black --
  618.     by default, even if text windows use other colors.)
  619.  
  620.     The geometry resource only affects window placement.
  621.  
  622.     Resolution is given in pixels per inch.
  623.  
  624.     The font tolerance gives largest acceptable difference in
  625.     height of the screen font.  The tolerance is expressed as
  626.     a percentage of the height of the desired font.
  627.  
  628.     The palette resource can be used to restrict ghostscript to
  629.     using a grayscale or monochrome palette.
  630.  
  631.     The maxRGBRamp and maxGrayRamp control the maximum number of
  632.     colors that ghostscript allocates ahead of time for the dither
  633.     cube/ramp.  Ghostscript will never preallocate more than half
  634.     of the cells in a colormap.  maxDynamicColors controls the
  635.     maximum number of colors that Ghostscript will allocate
  636.     dynamically in the colormap.
  637.  
  638. The use... resources exist primarily to work around bugs in X servers.  In
  639. particular, many versions of DEC's X server (DECwindows) have bugs that
  640. require setting useXPutImage or useXSetTile to false.
  641.  
  642.     Some servers do not implement backing pixmaps properly, or do not
  643.     have enough memory for them.  If you get strange behavior or "out
  644.     of memory" messages, try setting useBackingPixmap to false.
  645.  
  646.     Some servers do not implement tiling properly.  This will show up
  647.     as broad bands of color where dither patterns should appear.  If
  648.     this happens, try setting useXSetTile to false.
  649.  
  650.     Some servers do not implement bitmap/pixmap displaying properly.
  651.     This may show up as white or black rectangles where characters
  652.     should appear, or characters may appear in "inverse video" (e.g.,
  653.     white on a black rectangle).  If this happens, try setting
  654.     useXPutImage to false.
  655.  
  656. To use native X11 fonts, Ghostscript must map PostScript font names to
  657. the XLFD font names.  The regularFonts, symbolFonts, and dingbatFonts
  658. resources give the name mapping for different encodings.  The XLFD font 
  659. name in the mapping must contain seven dashes.  The X driver adds the
  660. additional size and encoding fields to bring the total number of dashes
  661. in the font name to 14.  Here are the default font mappings:
  662.  
  663.   Regular Fonts: (Fonts available in standard or ISO-Latin-1 encoding)
  664.  
  665.     AvantGarde-Book:-Adobe-ITC Avant Garde Gothic-Book-R-Normal--\n\
  666.     AvantGarde-BookOblique:-Adobe-ITC Avant Garde Gothic-Book-O-Normal--\n\
  667.     AvantGarde-Demi:-Adobe-ITC Avant Garde Gothic-Demi-R-Normal--\n\
  668.     AvantGarde-DemiOblique:-Adobe-ITC Avant Garde Gothic-Demi-O-Normal--\n\
  669.     Bookman-Demi:-Adobe-ITC Bookman-Demi-R-Normal--\n\
  670.     Bookman-DemiItalic:-Adobe-ITC Bookman-Demi-I-Normal--\n\
  671.     Bookman-Light:-Adobe-ITC Bookman-Light-R-Normal--\n\
  672.     Bookman-LightItalic:-Adobe-ITC Bookman-Light-I-Normal--\n\
  673.     Courier:-Adobe-Courier-Medium-R-Normal--\n\
  674.     Courier-Bold:-Adobe-Courier-Bold-R-Normal--\n\
  675.     Courier-BoldOblique:-Adobe-Courier-Bold-O-Normal--\n\
  676.     Courier-Oblique:-Adobe-Courier-Medium-O-Normal--\n\
  677.     Helvetica:-Adobe-Helvetica-Medium-R-Normal--\n\
  678.     Helvetica-Bold:-Adobe-Helvetica-Bold-R-Normal--\n\
  679.     Helvetica-BoldOblique:-Adobe-Helvetica-Bold-O-Normal--\n\
  680.     Helvetica-Narrow:-Adobe-Helvetica-Medium-R-Narrow--\n\
  681.     Helvetica-Narrow-Bold:-Adobe-Helvetica-Bold-R-Narrow--\n\
  682.     Helvetica-Narrow-BoldOblique:-Adobe-Helvetica-Bold-O-Narrow--\n\
  683.     Helvetica-Narrow-Oblique:-Adobe-Helvetica-Medium-O-Narrow--\n\
  684.     Helvetica-Oblique:-Adobe-Helvetica-Medium-O-Normal--\n\
  685.     NewCenturySchlbk-Bold:-Adobe-New Century Schoolbook-Bold-R-Normal--\n\
  686.     NewCenturySchlbk-BoldItalic:-Adobe-New Century Schoolbook-Bold-I-Normal--\n\
  687.     NewCenturySchlbk-Italic:-Adobe-New Century Schoolbook-Medium-I-Normal--\n\
  688.     NewCenturySchlbk-Roman:-Adobe-New Century Schoolbook-Medium-R-Normal--\n\
  689.     Palatino-Bold:-Adobe-Palatino-Bold-R-Normal--\n\
  690.     Palatino-BoldItalic:-Adobe-Palatino-Bold-I-Normal--\n\
  691.     Palatino-Italic:-Adobe-Palatino-Medium-I-Normal--\n\
  692.     Palatino-Roman:-Adobe-Palatino-Medium-R-Normal--\n\
  693.     Times-Bold:-Adobe-Times-Bold-R-Normal--\n\
  694.     Times-BoldItalic:-Adobe-Times-Bold-I-Normal--\n\
  695.     Times-Italic:-Adobe-Times-Medium-I-Normal--\n\
  696.     Times-Roman:-Adobe-Times-Medium-R-Normal--\n\
  697.     ZapfChancery-MediumItalic:-Adobe-ITC Zapf Chancery-Medium-I-Normal--
  698.  
  699.   Symbol Fonts:  (using Symbol encoding)
  700.  
  701.     Symbol: -Adobe-Symbol-Medium-R-Normal--
  702.  
  703.   Dingbat Fonts: (using Dingbat encoding)
  704.  
  705.     ZapfDingbats: -Adobe-ITC Zapf Dingbats-Medium-R-Normal--
  706.  
  707. For X11/NeWS, one can use the OpenWindows scalable fonts instead, which
  708. will give good quality output for any point size.  In this environment,
  709. the relevant section of the resource file should look like this:
  710.  
  711. Ghostscript.regularFonts: \
  712.     AvantGarde-Book:        -itc-avantgarde-book-r-normal-- \n\
  713.     AvantGarde-BookOblique:        -itc-avantgarde-book-o-normal-- \n\
  714.     AvantGarde-Demi:        -itc-avantgarde-demi-r-normal-- \n\
  715.     AvantGarde-DemiOblique:        -itc-avantgarde-demi-o-normal-- \n\
  716.     Bembo:                -monotype-bembo-medium-r-normal-- \n\
  717.     Bembo-Bold:            -monotype-bembo-bold-r-normal-- \n\
  718.     Bembo-BoldItalic:        -monotype-bembo-bold-i-normal-- \n\
  719.     Bembo-Italic:            -monotype-bembo-medium-i-normal-- \n\
  720.     Bookman-Demi:            -itc-bookman-demi-r-normal-- \n\
  721.     Bookman-DemiItalic:        -itc-bookman-demi-i-normal-- \n\
  722.     Bookman-Light:            -itc-bookman-light-r-normal-- \n\
  723.     Bookman-LightItalic:        -itc-bookman-light-i-normal-- \n\
  724.     Courier:            -itc-courier-medium-r-normal-- \n\
  725.     Courier-Bold:            -itc-courier-bold-r-normal-- \n\
  726.     Courier-BoldOblique:        -itc-courier-bold-o-normal-- \n\
  727.     Courier-Oblique:        -itc-courier-medium-o-normal-- \n\
  728.     GillSans:            -monotype-gill-medium-r-normal-sans- \n\
  729.     GillSans-Bold:            -monotype-gill-bold-r-normal-sans- \n\
  730.     GillSans-BoldItalic:        -monotype-gill-bold-i-normal-sans- \n\
  731.     GillSans-Italic:        -monotype-gill-normal-i-normal-sans- \n\
  732.     Helvetica:            -linotype-helvetica-medium-r-normal-- \n\
  733.     Helvetica-Bold:            -linotype-helvetica-bold-r-normal-- \n\
  734.     Helvetica-BoldOblique:        -linotype-helvetica-bold-o-normal-- \n\
  735.     Helvetica-Narrow:        -linotype-helvetica-medium-r-narrow-- \n\
  736.     Helvetica-Narrow-Bold:        -linotype-helvetica-bold-r-narrow-- \n\
  737.     Helvetica-Narrow-BoldOblique:    -linotype-helvetica-bold-o-narrow-- \n\
  738.     Helvetica-Narrow-Oblique:    -linotype-helvetica-medium-o-narrow-- \n\
  739.     Helvetica-Oblique:        -linotype-helvetica-medium-o-normal-- \n\
  740.     LucidaBright:            -b&h-lucidabright-medium-r-normal-- \n\
  741.     LucidaBright-Demi:        -b&h-lucidabright-demibold-r-normal-- \n\
  742.     LucidaBright-DemiItalic:    -b&h-lucidabright-demibold-i-normal-- \n\
  743.     LucidaBright-Italic:        -b&h-lucidabright-medium-i-normal-- \n\
  744.     LucidaSans:            -b&h-lucida-medium-r-normal-sans- \n\
  745.     LucidaSans-Bold:        -b&h-lucida-bold-r-normal-sans- \n\
  746.     LucidaSans-BoldItalic:        -b&h-lucida-bold-i-normal-sans- \n\
  747.     LucidaSans-Italic:        -b&h-lucida-medium-i-normal-sans- \n\
  748.     LucidaSans-Typewriter:        -b&h-lucidatypewriter-medium-r-normal-sans- \n\
  749.     LucidaSans-TypewriterBold:    -b&h-lucidatypewriter-bold-r-normal-sans- \n\
  750.     NewCenturySchlbk-BoldItalic:    -linotype-new century schoolbook-bold-i-normal-- \n\
  751.     NewCenturySchlbk-Bold:        -linotype-new century schoolbook-bold-r-normal-- \n\
  752.     NewCenturySchlbk-Italic:    -linotype-new century schoolbook-medium-i-normal-- \n\
  753.     NewCenturySchlbk-Roman:        -linotype-new century schoolbook-medium-r-normal-- \n\
  754.     Palatino-Bold:            -linotype-palatino-bold-r-normal-- \n\
  755.     Palatino-BoldItalic:        -linotype-palatino-bold-i-normal-- \n\
  756.     Palatino-Italic:        -linotype-palatino-medium-i-normal-- \n\
  757.     Palatino-Roman:            -linotype-palatino-medium-r-normal-- \n\
  758.     Rockwell:            -monotype-rockwell-medium-r-normal-- \n\
  759.     Rockwell-Bold:            -monotype-rockwell-bold-r-normal-- \n\
  760.     Rockwell-BoldItalic:        -monotype-rockwell-bold-i-normal-- \n\
  761.     Rockwell-Italic:        -monotype-rockwell-medium-i-normal-- \n\
  762.     Times-Bold:            -linotype-times-bold-r-normal-- \n\
  763.     Times-BoldItalic:        -linotype-times-bold-i-normal-- \n\
  764.     Times-Italic:            -linotype-times-medium-i-normal-- \n\
  765.     Times-Roman:            -linotype-times-medium-r-normal-- \n\
  766.     Utopia-Bold:            -adobe-utopia-bold-r-normal-- \n\
  767.     Utopia-BoldItalic:        -adobe-utopia-bold-i-normal-- \n\
  768.     Utopia-Italic:            -adobe-utopia-regular-i-normal-- \n\
  769.     Utopia-Regular:            -adobe-utopia-regular-r-normal-- \n\
  770.     ZapfChancery-MediumItalic:    -itc-zapfchancery-medium-i-normal-- \n
  771. Ghostscript.dingbatFonts: \
  772.     ZapfDingbats:            -itc-zapfdingbats-medium-r-normal--
  773. Ghostscript.symbolFonts: \
  774.     Symbol:                --symbol-medium-r-normal--
  775.  
  776. Users who switch regularly between different X servers may wish to use the
  777. '*' wild card in place of the foundry name (itc, monotype, linotype, b&h,
  778. or adobe); users who do not switch X servers should leave the explicit
  779. foundry in the name, since it speeds up font accessing.
  780.  
  781. To set these resources, put them in a file (such as ~/.Xdefaults) in the
  782. following form:
  783.  
  784. Ghostscript*geometry:    -0+0
  785. Ghostscript*xResolution: 72
  786. Ghostscript*yResolution: 72
  787.  
  788. Then load the defaults into the X server:
  789.  
  790. % xrdb -merge ~/.Xdefaults
  791.  
  792. Ghostscript will take advantage of the "HP XLFD Enhancements," if
  793. available, to use native X11 fonts for fonts that are anamorphically
  794. scaled, rotated, or mirrored.  If the user has installed these changes to
  795. their X or font server, they will automatically be used when appropriate.
  796.  
  797. SCO Unix
  798. --------
  799.  
  800. Because of bugs in the SCO Unix kernel, Ghostscript will not work if you
  801. select direct screen output (gdevsco.c) and also allow it to write messages
  802. on the console.  If you are using direct screen output, redirect
  803. Ghostscript's terminal output to a file.
  804.  
  805. ********
  806. ******** Switches
  807. ********
  808.  
  809. Unless otherwise noted, these apply to all platforms.
  810.  
  811. Normal switches
  812. ---------------
  813.  
  814.     @filename
  815.         Causes Ghostscript to read filename and treat its
  816.         contents the same as the command line.  (This is
  817.         intended primarily for getting around MS-DOS's
  818.         128-character limit on the length of a command line.)
  819.         Switches or file names in the file may be separated by
  820.         any amount of white space (space, tab, line break);
  821.         there is no limit on the size of the file.
  822.  
  823.     -- filename arg1 ...
  824.     -+ filename arg1 ...
  825.         Takes the next argument as a file name as usual, but takes
  826.         all remaining arguments (even if they have the syntactic
  827.         form of switches) and defines the name ARGUMENTS in
  828.         userdict (not systemdict) as an array of those strings,
  829.         *before* running the file.  When Ghostscript finishes
  830.         executing the file, it exits back to the shell.
  831.  
  832.     -@ filename arg1 ...
  833.         Does the same thing as -- and -+, but expands @filename
  834.         arguments.
  835.  
  836.     -c tokens ...
  837.         Interprets arguments, up to the next argument that begins
  838.         with - followed by a non-digit or with @, as PostScript
  839.         code.  For example, if the file quit.ps contains just
  840.         the word `quit', the following are equivalent:
  841.             quit.ps
  842.         and
  843.             -c quit
  844.         Each argument must be exactly one token, as defined by
  845.         the `token' operator.
  846.  
  847.     -Dname=token
  848.     -dname=token
  849.         Define a name in systemdict with the given definition.
  850.         The token must be exactly one token (as defined by the
  851.         'token' operator) and must not contain any whitespace.
  852.  
  853.     -Dname
  854.     -dname
  855.         Define a name in systemdict with value=true.
  856.  
  857.     -Sname=string
  858.     -sname=string
  859.         Define a name in systemdict with a given string as value.
  860.         This is different from -d.  For example,
  861.             -dname=35
  862.         is equivalent to the program fragment
  863.             /name 35 def
  864.         whereas
  865.             -sname=35
  866.         is equivalent to
  867.             /name (35) def
  868.  
  869.     -q
  870.         Quiet startup -- suppress normal startup messages,
  871.         and also do the equivalent of -dQUIET.
  872.  
  873.     -ffilename
  874.         Execute the given file, even if its name begins with a -
  875.         or an @.  -f alone does nothing, but it provides a
  876.         convenient way to terminate the list of tokens for the -c
  877.         switch.
  878.  
  879.     -gnumber1xnumber2
  880.         Equivalent to -dDEVICEWIDTH=number1 and
  881.         -dDEVICEHEIGHT=number2.  This is for the benefit of
  882.         devices (such as X11 windows and VESA displays) that require
  883.         (or allow) width and height to be specified.
  884.  
  885.     -rnumber
  886.     -rnumber1xnumber2
  887.         Equivalent to -dDEVICEXRESOLUTION=number1 and
  888.         -dDEVICEYRESOLUTION=number2.  This is for the benefit of
  889.         devices (such as printers) that support multiple
  890.         X and Y resolutions.
  891.  
  892.     -Idirectories
  893.         Adds the designated list of directories at the head of the
  894.         search path for library files.
  895.  
  896.     -
  897.         This is not really a switch.  It indicates to Ghostscript
  898.         that the standard input is coming from a file or a pipe.
  899.         Ghostscript reads from stdin until reaching end-of-file,
  900.         executing it like any other file, and then continues
  901.         processing the command line.  At the end of the command
  902.         line, Ghostscript exits rather than going into its
  903.         interactive mode.
  904.  
  905. Note that gs_init.ps makes systemdict read-only, so the values of names
  906. defined with -D/d/S/s cannot be changed (although, of course, they can be
  907. superseded by definitions in userdict or other dictionaries.)
  908.  
  909. Special names
  910. -------------
  911.  
  912. -dDISKFONTS
  913.     causes individual character outlines to be loaded from the disk
  914. the first time they are encountered.  (Normally Ghostscript loads all the
  915. character outlines when it loads a font.)  This may allow loading more
  916. fonts into RAM, at the expense of slower rendering.
  917.  
  918. -dNOBIND
  919.     disables the 'bind' operator.  Only useful for debugging.
  920.  
  921. -dNOCACHE
  922.     disables character caching.  Only useful for debugging.
  923.  
  924. -dNOCIE
  925.     substitutes DeviceGray and DeviceRGB for CIEBasedA and CIEBasedABC
  926. color spaces respectively.  Only useful on very slow systems where color
  927. accuracy is less important.
  928.  
  929. -dNODISPLAY
  930.     suppresses the normal initialization of the output device.  This
  931. may be useful when debugging.
  932.  
  933. -dNOGC
  934.     disables the garbage collector in Level 2 systems.  Only
  935. useful for debugging.
  936.  
  937. -dNOPAUSE
  938.     disables the prompt and pause at the end of each page.  This may
  939. be desirable for applications where another program is 'driving'
  940. Ghostscript.
  941.  
  942. -dNOPLATFONTS
  943.     disables the use of fonts supplied by the underlying platform
  944. (X Windows or Microsoft Windows).  This may be needed if the platform
  945. fonts look undesirably different from the scalable fonts.
  946.  
  947. -dORIENT1
  948.     indicates that the file uses a value of 1 to indicate portrait
  949. orientation to setpage[params] rather than the default orientation of 0.
  950. This is needed for some files produced by badly designed applications that
  951. 'know' that the output will be printed on certain roll-media printers.
  952.  
  953. -dSAFER
  954.     disables the deletefile and renamefile operators, and the
  955. ability to open files in any mode other than read-only.  This may be
  956. desirable for spoolers or other sensitive environments.
  957.  
  958. -dWRITESYSTEMDICT
  959.     leaves systemdict writable.  This is necessary when running
  960. special utility programs such as font2c and pcharstr, which must bypass
  961. normal PostScript access protection.
  962.  
  963. -sDEVICE=device
  964.     selects an alternate initial output device, as described above.
  965.  
  966. -sOutputFile=filename
  967.     selects an alternate output file (or pipe) for the initial output
  968. device, as described above.
  969.  
  970. Debugging switches
  971. ------------------
  972.  
  973. The -Z switch only applies if the interpreter was built for a
  974. debugging configuration (DEBUG=1 or -DDEBUG selected at compile
  975. time).
  976.  
  977.     -A    Fill empty storage with a distinctive bit pattern
  978.         for debugging.  Equivalent to -Z@.
  979.  
  980.     -E    Turn on tracing of error returns from operators.
  981.         Equivalent to -Z#.
  982.  
  983.     -Mn    Force the interpreter's allocator to acquire additional
  984.         memory in units of nK, rather than the default (currently
  985.         20K on MS-DOS systems, 50K on Unix).  n is a positive
  986.         decimal integer (not exceeding 63 on MS-DOS systems).
  987.  
  988.     -Zxxx    Turn on debugging printout.
  989.         Each of the xxx characters selects an option.
  990.         Case is significant.
  991.             0 = OS-related calls
  992.             1 = type 1 font interpreter (type1addpath)
  993.             2 = curve subdivider/rasterizer
  994.               3 = curve subdivider/rasterizer, detail
  995.             4 = garbage collector (strings)
  996.               5 = garbage collector (strings, detail)
  997.             6 = garbage collector (chunks, roots)
  998.               7 = garbage collector (objects)
  999.               8 = garbage collector (refs)
  1000.               9 = garbage collector (pointers)
  1001.             a = allocator (large blocks only)
  1002.               A = allocator (all calls)
  1003.             b = bitmap image processor
  1004.               B = bitmap images, detail
  1005.             c = color/halftone mapper
  1006.             d = dictionary put/undef
  1007.               D = dictionary lookups
  1008.             f = fill algorithm (summary)
  1009.               F = fill algorithm (detail)
  1010.             g = gsave/grestore[all]
  1011.             h = halftone renderer
  1012.               H = halftones, every pixel
  1013.             i = interpreter, just names
  1014.               I = interpreter, everything
  1015.             j = (Japanese) composite fonts
  1016.             k = character cache & xfonts
  1017.               K = character cache, every access
  1018.             l = command lists, bands
  1019.               L = command lists, everything
  1020.             m = makefont and font cache
  1021.             n = name lookup (new names only)
  1022.             o = outliner (stroke)
  1023.               O = stroke detail
  1024.             p = path tracer
  1025.             q = clipping
  1026.             r = arc renderer
  1027.             s = streams
  1028.               S = scanner
  1029.             t = tiling algorithm
  1030.             u = undo saver (for save/restore), finalization
  1031.               U = undo saver, more detail
  1032.             v = rectangle fill
  1033.               V = device-level output
  1034.             w = compression encoder/decoder
  1035.             x = transformations
  1036.             y = Type 1 hints
  1037.               Y = Type 1 hints, every access
  1038.             z = trapezoid fill
  1039.             # = operator error returns
  1040.             ~ = math functions
  1041.         The following switches select debugging options other than
  1042.         printout.
  1043.             $ = set unused parts of object references to
  1044.                 identifiable garbage values
  1045.             + = use minimum-size stack blocks
  1046.             . = use small-memory table sizes even on
  1047.                 large-memory machines
  1048.             ? = validate pointers before, during and after GC,
  1049.                 also before and after save and restore
  1050.             @ = clear storage when allocating or freeing
  1051.  
  1052. ********
  1053. ******** Frequently Asked Questions
  1054. ********
  1055.  
  1056. Q: The spacing of characters / words / margins on the display is
  1057. wrong, what can I do?
  1058.  
  1059. A: This is almost always caused by differences between the character
  1060. widths that were used to format the document and the character widths
  1061. of the fonts installed in your system.  (This only affects the
  1062. display, and only with window systems, not with MS-DOS.)  If this
  1063. happens, invoke Ghostscript with the -dNOPLATFONTS switch, or (on X
  1064. Windows) set
  1065.     Ghostscript*useExternalFonts: false
  1066. in your X resource file.
  1067.  
  1068. For more information about fonts on the display, please read the
  1069. first sections of fonts.doc.
  1070.  
  1071. Q: On my H-P LaserJet, why do I only get a partial page of output, or a
  1072. single page gets split across two sheets?
  1073.  
  1074. A: Printing on a Hewlett-Packard LaserJet at full resolution (300 DPI)
  1075. requires a printer with at least 1.5 Mb of memory.  150 DPI printing
  1076. requires only .5 Mb.  You can select 150 DPI printing with the command
  1077. line switch
  1078.     -r150
  1079. (This is not necessary on DeskJet printers.)
  1080.  
  1081. Q: On my MS-DOS system using GS.EXE (Borland compiler), why do I get a
  1082. `limitcheck in setdevice' or `VMerror in setdevice' error message?
  1083.  
  1084. A: On MS-DOS systems using the Borland compiler, if Ghostscript gives you
  1085. a 'limitcheck in setdevice' error, it may mean Ghostscript's standard
  1086. buffer size wasn't large enough.  Likewise, if Ghostscript gives you a
  1087. 'VMerror in setdevice' error, it means the buffer size was too large.  You
  1088. can use the -dBufferSpace= switch to set the buffer size to a different
  1089. value, e.g.,
  1090.     -dBufferSpace=50000
  1091. The default value is 25000; the smallest value Ghostscript accepts is
  1092. 10000; the largest valid value is 65000.
  1093.