116 lines
2.9 KiB
Groff
116 lines
2.9 KiB
Groff
.\" Id: dpsexec.man,v 6.1 1994/05/18 23:21:36 asente Exp $
|
|
.\" $XFree86: xc/programs/dpsexec/dpsexec.man,v 1.1 2001/03/01 01:23:58 dawes Exp $
|
|
.TH DPSEXEC 1 __vendorversion__
|
|
.SH NAME
|
|
dpsexec \- Display PostScript Executive
|
|
|
|
.SH SYNOPSIS
|
|
.B dpsexec
|
|
[
|
|
.B \-display \fIname\fR
|
|
][
|
|
.B \-sync
|
|
][
|
|
.B \-backup
|
|
][
|
|
.B \-noexec
|
|
][
|
|
.B \-root
|
|
][
|
|
.B \-drawable \fIwindowId\fR
|
|
][
|
|
.B \-height \fIn\fR
|
|
][
|
|
.B \-width \fIn\fR
|
|
]
|
|
|
|
.SH DESCRIPTION
|
|
.LP
|
|
.B dpsexec
|
|
is a Display PostScript program that
|
|
allows the user to interact directly with the PostScript
|
|
interpreter through a command interface.
|
|
.B dpsexec
|
|
reads lines of text from standard input and passes each line to
|
|
the PostScript interpreter for execution.
|
|
It creates a window that displays the results of graphics operations as
|
|
they are executed.
|
|
.B dpsexec
|
|
exits when end of file is reached on standard input, or when
|
|
the user types "quit<return>", which executes
|
|
the PostScript
|
|
.B quit
|
|
operator.
|
|
.LP
|
|
By default,
|
|
.B dpsexec
|
|
executes the PostScript
|
|
.B executive
|
|
operator before it accepts any user input.
|
|
This operator puts the PostScript interpreter in "interactive
|
|
executive" mode so that the user can control the interpreter
|
|
directly.
|
|
In this mode, the PostScript interpreter supports certain line-editing
|
|
functions and prompts the user when it is ready to execute more input.
|
|
See section 2.4.4, "Using the Interpreter Interactively,"
|
|
of the \fIPostScript Language Reference Manual, Second Edition,\fR
|
|
for detailed information on this mode of operation.
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI \-display " name"
|
|
specifies the display on which to open a connection to the Display
|
|
PostScript system. If no display is specified, the
|
|
DISPLAY environment variable is used.
|
|
.TP
|
|
.B \-sync
|
|
establishes a synchronous connection with the specified X display.
|
|
.TP
|
|
.B \-backup
|
|
uses backing store for the window in which graphics are
|
|
displayed, if possible. This is generally only effective with
|
|
the DPS NX system.
|
|
.TP
|
|
.B \-noexec
|
|
prevents
|
|
.B dpsexec
|
|
from entering "interactive executive" mode. The primary effect
|
|
of this option is to
|
|
inhibit printing the
|
|
.B PS>
|
|
prompt before each line of input is accepted.
|
|
This option is useful when
|
|
.B dpsexec
|
|
is run with standard input redirected from a file or a pipe.
|
|
.TP
|
|
.B \-root
|
|
tells
|
|
.B dpsexec
|
|
to draw into the root window instead of into a window that it creates.
|
|
.TP
|
|
.BI \-drawable " windowId"
|
|
tells
|
|
.B dpsexec
|
|
to draw into the specified window instead of into a window that it creates.
|
|
.TP
|
|
.BI \-height " n"
|
|
sets the height of the created window.
|
|
.TP
|
|
.BI \-width " n"
|
|
sets the width of the created window.
|
|
|
|
.SH DIAGNOSTICS
|
|
PostScript language error messages are printed to standard output.
|
|
|
|
.SH AUTHOR
|
|
Adobe Systems Incorporated
|
|
|
|
.SH NOTES
|
|
PostScript and Display PostScript are trademarks
|
|
of Adobe Systems Incorporated which may be registered
|
|
in certain jurisdictions.
|
|
|
|
.LP
|
|
Copyright (c) 1990-1994 Adobe Systems Incorporated. All rights reserved.
|
|
|