| 1 |
.\" |
| 2 |
.TH XDITVIEW 1 "xditview 1.0.6" "X Version 11" |
| 3 |
.SH NAME |
| 4 |
xditview \- display ditroff output |
| 5 |
.SH SYNOPSIS |
| 6 |
.B xditview |
| 7 |
[ \-\fItoolkitoption\fP .\|.\|. ] [ \-\fIoption\fP .\|.\|. ] [ \fIfilename\fP ] |
| 8 |
.SH DESCRIPTION |
| 9 |
The |
| 10 |
.I xditview |
| 11 |
program displays |
| 12 |
.I ditroff |
| 13 |
output on an X display. It uses no special |
| 14 |
metrics and automatically converts the printer coordinates into screen |
| 15 |
coordinates; using the user-specified screen resolution, rather than the |
| 16 |
actual resolution so that the appropriate fonts can be found. If |
| 17 |
``\fB\-\fP'' is given as the |
| 18 |
.I filename, |
| 19 |
.I xditview |
| 20 |
reads from standard input. |
| 21 |
If ``\fB|\fP'' is the first character of |
| 22 |
.I filename, |
| 23 |
.I xditview |
| 24 |
forks |
| 25 |
.I sh |
| 26 |
to run the rest of the ``file name'' and uses the |
| 27 |
standard output of that command. |
| 28 |
.SH OPTIONS |
| 29 |
.I Xditview |
| 30 |
accepts all of the standard X Toolkit command line options along with the |
| 31 |
additional options listed below: |
| 32 |
.TP 8 |
| 33 |
.B \-page \fIpage-number\fP |
| 34 |
This option specifies the page number of the document to be displayed at |
| 35 |
start up time. |
| 36 |
.TP 8 |
| 37 |
.B \-resolution \fIscreen-resolution\fP |
| 38 |
This specifies the desired screen resolution to use; fonts will be opened by |
| 39 |
requesting this resolution field in the XLFD names. |
| 40 |
.TP 8 |
| 41 |
.B \-noPolyText |
| 42 |
Some X servers incorrectly implement PolyText with multiple strings |
| 43 |
per request. This option suppresses the use of this feature in |
| 44 |
.I xditview. |
| 45 |
.TP 8 |
| 46 |
.B \-backingStore \fIbacking-store-type\fP |
| 47 |
Redisplay can take up to a second or so; this option causes |
| 48 |
the server to save the window contents so that when it is scrolled around the |
| 49 |
viewport, the window is painted from contents saved in backing store. |
| 50 |
\fIbacking-store-type\fP can be one of \fBAlways\fP, \fPWhenMapped\fP or |
| 51 |
\fPNotUseful\fP. |
| 52 |
.PP |
| 53 |
The following standard X Toolkit command line arguments are commonly used with |
| 54 |
.I xditview: |
| 55 |
.TP 8 |
| 56 |
.B \-bg \fIcolor\fP |
| 57 |
This option specifies the color to use for the background of the window. |
| 58 |
The default is \fIwhite\fP. |
| 59 |
.TP 8 |
| 60 |
.B \-bd \fIcolor\fP |
| 61 |
This option specifies the color to use for the border of the window. |
| 62 |
The default is \fIblack\fP. |
| 63 |
.TP 8 |
| 64 |
.B \-bw \fInumber\fP |
| 65 |
This option specifies the width in pixels of the border surrounding the window. |
| 66 |
.TP 8 |
| 67 |
.B \-fg \fIcolor\fP |
| 68 |
This option specifies the color to use for displaying text. The default is |
| 69 |
\fIblack\fP. |
| 70 |
.TP 8 |
| 71 |
.B \-fn \fIfont\fP |
| 72 |
This option specifies the font to be used for displaying widget text. The |
| 73 |
default is \fIfixed\fP. |
| 74 |
.TP 8 |
| 75 |
.B \-rv |
| 76 |
This option indicates that reverse video should be simulated by swapping |
| 77 |
the foreground and background colors. |
| 78 |
.TP 8 |
| 79 |
.B \-geometry \fIgeometry\fP |
| 80 |
This option specifies the preferred size and position of the window. |
| 81 |
.TP 8 |
| 82 |
.B \-display \fIhost\fP:\fIdisplay\fP |
| 83 |
This option specifies the X server to contact. |
| 84 |
.TP 8 |
| 85 |
.B \-xrm \fIresourcestring\fP |
| 86 |
This option specifies a resource string to be used. |
| 87 |
.SH X DEFAULTS |
| 88 |
This program uses a |
| 89 |
.I Dvi |
| 90 |
widget. It understands all of the core resource names and |
| 91 |
classes as well as: |
| 92 |
.PP |
| 93 |
.TP 8 |
| 94 |
.B width (\fPclass\fB Width) |
| 95 |
Specifies the width of the window. |
| 96 |
.TP 8 |
| 97 |
.B height (\fPclass\fB Height) |
| 98 |
Specifies the height of the window. |
| 99 |
.TP 8 |
| 100 |
.B foreground (\fPclass\fB Foreground) |
| 101 |
Specifies the default foreground color. |
| 102 |
.TP 8 |
| 103 |
.B font (\fPclass\fB Font) |
| 104 |
Specifies the font to be used for error messages. |
| 105 |
.TP 8 |
| 106 |
.B FontMap (\fBclass\fB FontMap) |
| 107 |
To associate the |
| 108 |
.I ditroff |
| 109 |
fonts with appropriate X fonts, this string |
| 110 |
resource contains a set of new-line separated specifications, each of which |
| 111 |
consists of a ditroff name, some white space and an XLFD pattern with * |
| 112 |
characters in appropriate places to allow all sizes to be listed. The |
| 113 |
default fontMap is: |
| 114 |
.nf |
| 115 |
.sp |
| 116 |
R \-*\-times\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 117 |
I \-*\-times\-medium\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 118 |
B \-*\-times\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 119 |
F \-*\-times\-bold\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 120 |
BI \-*\-times\-bold\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 121 |
C \-*\-courier\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 122 |
CO \-*\-courier\-medium\-o\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 123 |
CB \-*\-courier\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 124 |
CF \-*\-courier\-bold\-o\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 125 |
H \-*\-helvetica\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 126 |
HO \-*\-helvetica\-medium\-o\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 127 |
HB \-*\-helvetica\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 128 |
HF \-*\-helvetica\-bold\-o\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 129 |
N \-*\-new century schoolbook\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 130 |
NI \-*\-new century schoolbook\-medium\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 131 |
NB \-*\-new century schoolbook\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 132 |
NF \-*\-new century schoolbook\-bold\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 133 |
A \-*\-charter\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 134 |
AI \-*\-charter\-medium\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 135 |
AB \-*\-charter\-bold\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 136 |
AF \-*\-charter\-bold\-i\-normal\-\^\-*\-*\-*\-*\-*\-*\-iso8859\-1\en\e |
| 137 |
S \-*\-symbol\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-adobe\-fontspecific\en\e |
| 138 |
S2 \-*\-symbol\-medium\-r\-normal\-\^\-*\-*\-*\-*\-*\-*\-adobe\-fontspecific\en |
| 139 |
.sp |
| 140 |
.fi |
| 141 |
.SH "USING XDITVIEW WITH DITROFF" |
| 142 |
.PP |
| 143 |
You can use any ditroff output file with |
| 144 |
.I xditview, |
| 145 |
although files which use |
| 146 |
the fonts appropriate to the fontMap will look more accurate on the screen. |
| 147 |
On servers which support scaled fonts, all requested font sizes will be |
| 148 |
accurately reflected on the screen; for servers which do not support scaled |
| 149 |
.I xditview |
| 150 |
will use the closest font from the same family. |
| 151 |
.SH "SEE ALSO" |
| 152 |
.IR X (7), |
| 153 |
.IR xrdb (1), |
| 154 |
.IR ditroff (1), |
| 155 |
.I "X Logical Font Description Conventions" |
| 156 |
.SH ORIGIN |
| 157 |
Portions of this program originated in |
| 158 |
.I xtroff which was derived |
| 159 |
from |
| 160 |
.I suntroff. |
| 161 |
.SH AUTHORS |
| 162 |
Keith Packard (MIT X Consortium) |
| 163 |
.br |
| 164 |
Richard L. Hyde (Purdue) |
| 165 |
.br |
| 166 |
David Slattengren (Berkeley) |
| 167 |
.br |
| 168 |
Malcom Slaney (Schlumberger Palo Alto Research) |
| 169 |
.br |
| 170 |
Mark Moraes (University of Toronto) |