NAME

xditview − display ditroff DVI files. 

SYNTAX

xditview [options] [filename]

DESCRIPTION

The xditview program displays ditroff output on an X display.  As of Release 5, it uses no special font metrics and automatically converts the printer coordinates into screen coordinates, using the user-specified screen resolution, rather than the actual resolution so that the appropriate fonts can be found.  If "−" is given as the filename, xditview reads from standard input.  If "|" is the first character of the filename, xditview forks sh to run the rest of the filename and uses the standard output of that command. 

OPTIONS

xditview accepts all of the standard X Toolkit command-line options, which are listed on the X reference page.  (We’ve included one of the more commonly used Toolkit options later in this section.)  In addition, xditview accepts the following application-specific options:

-backingStore backing_store_type
Redisplay of the DVI window can take up to a second or so.  This option causes 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. backing_store_type can be one of Always, WhenMapped, or NotUseful. 

-noPolyText
Some X servers incorrectly implement PolyText with multiple strings per request.  This option suppresses the use of this feature in xditview.  (Available as of Release 5.) 

-page page_number
Specifies the page number of the document to be displayed when the client is started.

-resolution dots_per_inch
Specifies the desired screen resolution to use.  Fonts will be opened by requesting this resolution field in the XLFD names.  (Available as of Release 5.)

The following standard X Toolkit option is commonly used with xditview:

-fn font
Specifies the font to be used for displaying widget text.  The default is fixed. 

RESOURCES

This program uses a Dvi widget.  It understands all of the core resource names and classes as well as the following:

font (class Font)
Specifies the font to be used for error messages.

fontMap (class FontMap)
To associate the ditroff fonts with appropriate X fonts, this string resource contains a set of newline-separated specifications, each of which consists of a ditroff name, some white space and an XLFD pattern with wildcard (∗) characters in appropriate places to allow all sizes to be listed.  This resource has been added in Release 5.  The default fontMap is:

R  −∗−times−medium−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
I  −∗−times−medium−i−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
B  −∗−times−bold−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
F  −∗−times−bold−i−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
BI −∗−times−bold−i−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
C  −∗−courier−medium−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
CO −∗−courier−medium−o−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
CB −∗−courier−bold−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
CF −∗−courier−bold−o−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
H  −∗−helvetica−medium−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
HO −∗−helvetica−medium−o−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
HB −∗−helvetica−bold−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
HF −∗−helvetica−bold−o−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
N  −∗−new century schoolbook−medium−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
NI −∗−new century schoolbook−medium−i−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
NB −∗−new century schoolbook−bold−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
NF −∗−new century schoolbook−bold−i−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
A  −∗−charter−medium−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
AI −∗−charter−medium−i−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
AB −∗−charter−bold−r−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
AF −∗−charter−bold−i−normal−−∗−∗−∗−∗−∗−∗−iso8859−1\n\
S  −∗−symbol−medium−r−normal−−∗−∗−∗−∗−∗−∗−adobe−fontspecific\n\
S2 −∗−symbol−medium−r−normal−−∗−∗−∗−∗−∗−∗−adobe−fontspecific\n

foreground (class Foreground)
Specifies the default foreground color.

pageNumber (class PageNumber)
Specifies the page number to be displayed at startup.

USING XDITVIEW WITH DITROFF

You can use any DVI file with xditview, although DVI files that use the fonts appropriate to the fontMap will look more accurate on the screen.  On servers that support scaled fonts, all requested font sizes will be accurately reflected on the screen; for servers that do not support scaled fonts, xditview will use the closest font from the same family. 

FILES

/usr/lib/X11/app-defaults/Xditview
Specifies required resources.

/usr/lib/X11/app-defaults/Xditview-chrtr
Specifies the default fontMap. 

SEE ALSO

X, xrdb, ditroff(1); the paper entitled "X Logical Font Description Conventions."

AUTHORS

Portions of this program originated in xtroff which was derived from suntroff. 

Keith Packard (MIT X Consortium);
Richard L. Hyde (Purdue);
David Slattengren (Berkeley);
Malcom Slaney (Schlumberger Palo Alto Research);
Mark Moraes (University of Toronto).