.TH xditview "" "" "X Client"
.PC "Display ditroff output"
\fBxditview [\-\fItoolkitoption ... \fB] [\-\fIoption ... \fB] [\fIfilename\^\fB]\fR
.PP
.HS
.SH Options:
.IC "\fB\-backingStore \fIbacking-store-type\fR"
Tell the server to save the window contents.
.I backing-store-type
can be one of \fBAlways\fR, \fPWhenMapped\fR, or \fPNotUseful\fR.
.IC "\fB\-bd \fIcolor\fR"
Set the color of the border to \fIcolor\fR
.IC "\fB\-bg \fIcolor\fR"
Set the color of the background to \fIcolor\fR
.IC "\fB\-bw \fIpixels\fR"
Set the width of the border to \fIpixels\fR
.IC "\fB\-display \fIhost\^\fB[:\fIserver\^\fB][.\fIscreen\^\fB]\fR"
Display the client's window on screen number \fIscreen\fR
of \fIserver\fR on host system \fIhost\fR
.IC "\fB\-fg \fIcolor\fR"
Set the color of the foreground to \fIcolor\fR
.IC "\fB\-fn \fIfont\fR"
Use \fIfont\fR in the display
.IC "\fB\-geometry \fIgeometry\fR"
Set the geometry of the program's window to \fIgeometry\fR
.IC \fB\-noPolyText\fR
Suppess the use of the
.B PolyText
in
.B xditview
.IC "\fB\-page \fIpage-number\fR"
Begin displaying the document at page number
.I page-number
.IC "\fB\-resolution \fIscreen-resolution\fR"
Use
.I screen-resolution
.IC \fB\-rv\fR
Simulate reverse video by exchanging the foreground and background colors
.IC "\fB\-xrm \fIresourcestring\fR"
Use \fIresourcestring\fR to define a resource
.HE
.B xditview 
displays
.B ditroff
output on an X display.
It uses no special metrics and automatically converts
the printer coordinates into screen coordinates;
it uses the user-specified screen resolution, rather than the
actual resolution so that the appropriate fonts can be found.
.PP
.I filename
names the file that holds the
.B ditroff
output; the file name `-' represents the standard input.
If the first character of
.I filename
is `|',
.B xditview
assumes that
.I filename
names a shell script; it forks
.B sh
to run the rest of the and uses the
standard output of that command.
.PP
.B xditview
recognizes the following command-line options:
.IP "\fB\-backingStore \fIbacking-store-type\fR"
Redisplay can take up to a second or so.
This option tells the server to save the window contents
so that when it is scrolled around the viewport,
the window is painted from contents saved in backing store.
.I backing-store-type
can be one of \fBAlways\fR, \fPWhenMapped\fR, or \fPNotUseful\fR.
.IP "\fB\-bd \fIcolor\fR"
Set the color of the border to
.IR color .
The default is \fBblack\fR.
.IP "\fB\-bg \fIcolor\fR"
Set the color of the background to
.IR color .
The default is \fBwhite\fR.
.IP "\fB\-bw \fIpixels\fR"
Set the width of the border to
.IR pixels .
.IP "\fB\-display \fIhost\^\fB[:\fIserver\^\fB][.\fIscreen\^\fB]\fR"
Display the client's window on screen number
.I screen
of
.I server
on host system
.IR host .
.IP "\fB\-fg \fIcolor\fR"
Set the color of the foreground to
.IR color .
The default is \fBblack\fR.
.IP "\fB\-fn \fIfont\fR"
Use
.I font
in the display.
The default is \fBfixed\fR.
.IP "\fB\-geometry \fIgeometry\fR"
Set the geometry of the program's window to
.IR geometry .
The term ``geometry'' means the dimensions of the window and its location
on the screen.
.I geometry
has the form \fIwidth\(miheight\(+-xoffset\(+-yoffset\fR.
.IP \fB\-noPolyText\fR
Some X servers incorrectly implement
.B PolyText
with multiple strings per request.
This option suppesses the use of this feature in
.BR xditview .
.IP "\fB\-page \fIpage-number\fR"
Begin displaying the document at page number
.IR page-number .
.IP "\fB\-resolution \fIscreen-resolution\fR"
Use
.IR screen-resolution .
Fonts will be opened by requesting this resolution field in the XLFD names.
.IP \fB\-rv\fR
Simulate reverse video by exchanging the foreground and background colors.
.IP "\fB\-xrm \fIresourcestring\fR"
Use
.I resourcestring
to define a resource.
.SH "X Defaults"
This program uses the
.B Dvi
widget.
It understands all of the core resource names and classes as well as:
.IP "\fBwidth (\fRclass\fB Width)\fR"
Set the width of the window.
.IP "\fBheight (\fRclass\fB Height)\fR"
Set the height of the window.
.IP "\fBforeground (\fRclass\fB Foreground)\fR"
Set the default foreground color.
.IP "\fBfont (\fRclass\fB Font)\fR"
Set the font to be used for error messages.
.IP "\fBFontMap (\fRclass\fB FontMap)\fR"
This resource links
.B ditroff
fonts with appropriate X fonts.
It consists of a set of specifications, each of which
consists of a
.B ditroff
font name, some white space, and an XLFD pattern with asterisks
in appropriate places to allow all sizes to be listed.
The following gives the default font map:
.DM
R	\-*\-times\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
I	\-*\-times\-medium\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
B	\-*\-times\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
F	\-*\-times\-bold\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
BI	\-*\-times\-bold\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
C	\-*\-courier\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
CO	\-*\-courier\-medium\-o\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
CB	\-*\-courier\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
CF	\-*\-courier\-bold\-o\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
H	\-*\-helvetica\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
HO	\-*\-helvetica\-medium\-o\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
HB	\-*\-helvetica\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
HF	\-*\-helvetica\-bold\-o\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
N	\-*\-new century schoolbook\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
NI	\-*\-new century schoolbook\-medium\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
NB	\-*\-new century schoolbook\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
NF	\-*\-new century schoolbook\-bold\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
A	\-*\-charter\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
AI	\-*\-charter\-medium\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
AB	\-*\-charter\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
AF	\-*\-charter\-bold\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e
S	\-*\-symbol\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-adobe\-fontspecific\en\e
S2	\-*\-symbol\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-adobe\-fontspecific\en
.DE
.SH "Using xditview With ditroff"
You can use any
.B ditroff
output file with
.BR xditview ,
although files that use the fonts appropriate to the font map
look more accurate on the screen.
On servers that support scaled fonts, all requested font sizes are reflected
accurately on the screen; on servers that do not support scaled fonts,
.B xditview
uses the closest font from the same family.
.SH "See Also"
.B
X clients,
xrdb
.R
.SH Notes
Portions of this program originated in
.B xtroff
that was derived from
.BR suntroff . 
.PP
Copyright \(co 1989, Massachusetts Institute of Technology.
.PP
.II "Packard, Keith"
.II "Hyde, Richard L."
.II "Slattengren, David"
.II "Slaney, Malcolm
.II "Moraes, Mark"
.B xditroff
was written by Keith Packard of the MIT X Consortium,
Richard L. Hyde of Purdue University,
David Slattengren of the University of California, Berkeley,
Malcom Slaney of Schlumberger Palo Alto Research, and
Mark Moraes of the University of Toronto.
