DataMuseum.dk

top - metrics - download

    Length: 4642 (0x1222)
    Types: TextFile
    Names: »interp.doc«

└─⟦a05ed705a⟧ Bits:30007078 DKUUG GNU 2/12/89
    └─⟦ff23ba0e6⟧ »./ghostscript-1.3.tar.Z« 
        └─⟦a24a58cd3⟧ 
            └─⟦this⟧ »interp.doc« 

TextFile

   Copyright (C) 1989 Aladdin Enterprises.  All rights reserved.
   Distributed by Free Software Foundation, Inc.

This file is part of Ghostscript.

Ghostscript is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
to anyone for the consequences of using it or for whether it serves any
particular purpose or works at all, unless he says so in writing.  Refer
to the Ghostscript General Public License for full details.

Everyone is granted permission to copy, modify and redistribute
Ghostscript, but only under the conditions described in the Ghostscript
General Public License.  A copy of this license is supposed to have been
given to you along with Ghostscript so you can know your rights and
responsibilities.  It should be in a file named COPYING.  Among other
things, the copyright notice and this notice must be preserved on all
copies.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

This file, interp.doc, describes how to use the Ghostscript language
interpreter.

This file applies to version 1.3 of Ghostscript.  For an overview of
Ghostscript and a list of the documentation files, see README.

********
******** How to use the Ghostscript interpreter ********
********

The file name of the Ghostscript interpreter is gs.exe (MS-DOS) or gs
(Unix).  To run it, you also need the initialization files ghost.ps,
gfonts.ps, and ugly10.cp.

To invoke the interpreter, give the command
	gs <filename1> ... <filenameN>
The interpreter will read in the files in sequence and execute them.
After doing this, it reads further input from the primary input stream
(normally the keyboard).  Each line (i.e. characters up to a <return>) is
interpreted separately.  To exit from the interpreter, type quit<return>.
The interpreter also exits gracefully if it encounters end-of-file.
Control-C is also safe.

The interpreter recognizes the following switches, which may appear
anywhere in the command line and apply to all files thereafter.

Note that ghost.ps makes systemdict read-only, so the values of names
defined with -D/d/S/s cannot be changed (although, of course, they can be
superseded by definitions in userdict or other dictionaries.)

Normal switches
---------------

	-Dname=token
	-dname=token
		Define a name in systemdict with the given definition.
		The token must be exactly one token (as defined by the
		'token' operator) and must not contain any whitespace.

	-Dname
	-dname
		Define a name in systemdict with value=null.

	-Sname=string
	-sname=string
		Define a name in systemdict with a given string as value.
		This is different from -d.  For example,
			-dname=35
		is equivalent to the program fragment
			/name 35 def
		whereas
			-sname=35
		is equivalent to
			/name (35) def

Special names
-------------

Including -dNODISPLAY in the command line will suppress the normal
initialization of the output device.  This may be useful when debugging.

Including -sLIB=some_prefix_ in the command line will cause the 'run'
operator to look for some_prefix_filename if it can't find a file named
filename.  E.g.,
	-sLIB=/usr/scrooge/gslib/
Note that the final / is necessary, unless you are doing something very
unusual.

Debugging switches
------------------

The -T and -Z switches only apply if the interpreter was built for a
debugging configuration.  The -T switch is not currently available under
Unix.

	-E	Disable the normal PostScript handling of errors;
		instead, errors will produce a hex dump of the stacks
		and abort the interpreter.

	-Mn	Force the interpreter's allocator to acquire additional
		memory in units of nK, rather than the default (currently
		20K on MS-DOS systems, 50K on Unix).  n is a positive
		decimal integer (not exceeding 63 on MS-DOS systems).

	-Tname:rsize
		Trace a procedure within the interpreter.  rsize is the
		size of the value returned by the procedure, in bytes.
		Any number of procedures may be traced.  If rsize is
		omitted, the value returned by the procedure is not
		printed.

	-Zxxx	Turn on debugging printout.
		Each of the xxx characters selects an option:
		if the string is empty, all options are selected.
		Case is significant.
			a = allocator
			b = bitmap image processor
			c = color/halftone mapper
			d = dictionary lookup
			e = error returns
			f = fill algorithm
			h = halftone renderer
			i = interpreter
			j = interpreter, just names
			o = outliner (stroke operator)
			p = path tracer
			q = rectangle fill
			r = arc renderer
			s = scanner
			t = tiling algorithm
			u = curve flattener
			v = device-level output
			x = transformations