summaryrefslogtreecommitdiff
path: root/systems/msdos/dviware/xdvi-dos/xdvi.man
blob: a60ddbdc09c8e594df856b98729ae40b55ba49a5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396



XDVI(SIPB)        MISC. REFERENCE MANUAL PAGES         XDVI(SIPB)



NAME
     xdvi - DVI Previewer for the X Window System

SYNOPSIS
     xdvi  [+[page]]  [-s  shrink]  [-S  density]   [-p   pixels]
     [-altfont  font]  [-l]  [-rv]  [-fg  color] [-bg color] [-hl
     color] [-bd color] [-cr color] [-thorough] [-margins inches]
     [-sidemargin  inches]  [-topmargin  inches]  [-mgs[n]  size]
     [-geometry  geometry  |  =geometry]  [%geometry]   [-display
     display] file

DESCRIPTION
     Xdvi is a program which runs under the X window  system.  It
     is used to preview DVI files, such as are produced by TeX.

     This program has the capability of showing the file shrunken
     by  various  (integer)  factors, and also has a ``magnifying
     glass'' which allows one to see a small part of the unshrunk
     image momentarily.

     Also, before displaying any page or part thereof, it  checks
     to  see  if  the dvi file has changed since the last time it
     was displayed.  If this is the case, then xdvi  will  reini-
     tialize  itself  for the new dvi file.  For this reason, ex-
     posing parts of the xdvi window while TeX is running  should
     be  avoided.   This  feature allows you to preview many ver-
     sions of the same file while running xdvi only once.

OPTIONS
     In addition to specifying the .dvi file (with or without the
     .dvi), Xdvi supports the following command line options.  If
     the option begins with a `+' instead of a `-', the option is
     restored  to  its  default value.  By default, these options
     can be set via the resource names given  in  parentheses  in
     the description of each option.

     +page
          Specifies the first  page  to  show.   If  +  is  given
          without  a  number, the last page is assumed; the first
          page is the default.

     -s shrink
          (.shrinkFactor) Defines the initial shrink factor.  The
          default value is 3.

     -S density
          (.densityPercent)  Determines  the  density  used  when
          shrinking bitmaps for fonts.  A higher value produces a
          lighter font.  The default value is 40.

     -p pixels
          (.pixelsPerInch) Defines the size of the fonts to  use,



X Version 11         Last change: 8 May 1989                    1






XDVI(SIPB)        MISC. REFERENCE MANUAL PAGES         XDVI(SIPB)



          in pixels per inch.  The default value is 300.

     -altfont font
          (.altFont) Declares a default font to use when the font
          in  the  dvi file cannot be found.  This is useful, for
          example, with PostScript <tm> fonts.

     -l   (.listFonts) Causes the names of the fonts used  to  be
          listed.

     -rv  (.reverseVideo) Causes the page to  be  displayed  with
          white characters on a black background, instead of vice
          versa.

     -bw width
          (.borderWidth) Specifies the width of the border of the
          window.

     -borderwidth width
          Same as -bw, above.

     -fg color
          (.foreground) Determines the color of the  text  (fore-
          ground).

     -foreground color
          Same as -fg, above.

     -bg color
          (.background) Determines the color of the background.

     -background color
          Same as -bg, above.

     -hl color
          (.highlight) Determines the color of the page border.

     -bd color
          (.borderColor) Determines the color of the window bord-
          er.

     -cr color
          (.cursorColor) Determines the color of the cursor.  The
          default is the foreground color.

     -thorough
          (.thorough) Xdvi will usually try to ensure that  over-
          strike characters (e.g.  \notin) are printed correctly.
          On monochrome displays, this is  always  possible  with
          one  logical  operation,  either  and  or or.  On color
          displays, however, this may take two operations, one to
          set  the  appropriate bits and one to clear other bits.



X Version 11         Last change: 8 May 1989                    2






XDVI(SIPB)        MISC. REFERENCE MANUAL PAGES         XDVI(SIPB)



          If this is the case, then by default xdvi will  instead
          use  the  copy  operation,  which does not handle over-
          striking correctly.  The  ``thorough''  option  chooses
          the slower but more correct choice.

     -margins inches
          (.margins) Specifies the size of both  the  top  margin
          and  side  margin.  This can be a decimal number, e.g.,
          1.5.  It determines the ``home'' position of  the  page
          within  the window as follows.  If the entire page fits
          in the window, then the margin  settings  are  ignored.
          If,  even  after  removing  the  margins from the left,
          right, top, and bottom, the page still  cannot  fit  in
          the  window,  then  the  page is put in the window such
          that the top and left margins are hidden,  and  presum-
          ably the upper left-hand corner of the text on the page
          will be in the upper left-hand corner  of  the  window.
          Otherwise,  the  text  is  centered in the window.  See
          also `H' under the KEYSTROKES section.

     -sidemargin inches
          (.sideMargin) Specifies the side margin (see above).

     -topmargin inches
          (.topMargin) Specifies the top and bottom margins  (see
          above).

     -mgs[n] size
          (.magnifierSize[n]) Specifies the size of the window to
          be used for the ``magnifying glass'' for Button n.  See
          the MOUSE ACTIONS section.  Defaults are 200, 350, 600,
          900, and 1200.

     -mgs size
          Same as -mgs1, above.

     =geometry
          (*geometry) Specifies the initial geometry of the  win-
          dow.

     -geometry geometry
          Same as above.

     #geometry
          (.iconGeometry) Specifies the initial position for  the
          icon.

     -display host:display
          Specifies the host and screen to be used for displaying
          the  dvi  file.  This is normally obtained from the en-
          vironment variable ``DISPLAY.''




X Version 11         Last change: 8 May 1989                    3






XDVI(SIPB)        MISC. REFERENCE MANUAL PAGES         XDVI(SIPB)



KEYSTROKES
     Xdvi recognizes the following keystrokes when typed  in  its
     window.   Each  may optionally be preceded by a (positive or
     negative) number, whose interpretation will  depend  on  the
     particular keystroke.

     q    Quits the program.  Control-C  and  control-D  will  do
          this, too.

     n    Moves to the next page (or to the nth next  page  if  a
          number is given).  Synonyms are `f', Space, Return, and
          Line Feed.

     p    Moves to the previous page (or back n pages).  Synonyms
          are `b', control-H, and Delete.

     g    Moves to the page with the  given  number.   Initially,
          the first page is assumed to be page number 1, but this
          can be changed with the `P' keystroke,  below.   If  no
          page number is given, then it goes to the last page.

     P    ``This is page number n.''  This can be  used  to  make
          the  `g' keystroke refer to actual page numbers instead
          of absolute page numbers.

     Control-L
          Redisplays the current page.

     ^    Move to the ``home'' position of  the  page.   This  is
          normally  the  upper  left-hand  corner  of  the  page,
          depending on the margins as described in  the  -margins
          option, above.

     u    Moves up a window-full.

     d    Moves down a window-full.

     l    Moves left a window-full.

     r    Moves right a window-full.

     c    Moves the page so that the point currently beneath  the
          cursor  is  moved to the middle of the window.  It also
          (gasp!) warps the cursor to the same place.

     M    Sets the margins so that the point currently under  the
          cursor is the upper left-hand corner of the text in the
          page.

     s    Changes the shrink factor to the given number.   If  no
          number is given, the smallest factor that makes the en-
          tire page fit in the window will be used.  (Margins are



X Version 11         Last change: 8 May 1989                    4






XDVI(SIPB)        MISC. REFERENCE MANUAL PAGES         XDVI(SIPB)



          ignored in this computation.)

     S    Sets the density factor to be used when shrinking  bit-
          maps.   This  should  be  a  number  between 0 and 100;
          higher numbers produce lighter characters.

     R    Forces the dvi file to be reread.  This allows  you  to
          preview  many  versions  of the same file while running
          xdvi only once.

MOUSE ACTIONS
     If the shrink factor is set to any number  other  than  one,
     then  clicking  any  mouse button will pop up a ``magnifying
     glass'' which shows the unshrunk image in  the  vicinity  of
     the  mouse  click.  This subwindow disappears when the mouse
     button is released.  Different mouse  buttons  produce  dif-
     ferent  sized  windows,  as  indicated  by  the -mgs option,
     above.

     Also, the scrollbars (if present)  behave  in  the  standard
     way:   pushing Button 2 in a scrollbar moves the top or left
     edge of the scrollbar to that point; pushing Button 1  moves
     the  image  up  or  right by an amount equal to the distance
     from the button press to the upper left-hand corner  of  the
     window; pushing Button 3 moves the image down or left by the
     same amount.

ENVIRONMENT
     Uses the environment variable ``DISPLAY'' to  specify  which
     bit map display terminal to use.

     The environment variable ``TEXPKS'' determines  the  path(s)
     searched for fonts in the following manner.  The string con-
     sists of one or more strings separated by colons.   In  each
     such  string,  the  substring  ``%f'' is changed to the font
     name; ``%d'' is changed to the magnification; and ``%p''  is
     changed to the font family (``gf'', ``pk'', or ``pxl'').  If
     no  ``%f''  appears  in  the   string,   then   the   string
     ``/%f.%d%p''  is  added  on  the  end.   For example, if the
     string is ``/usr/local/tex/fonts'' and the font is cmr10  at
     300dpi,         then         it         searches         for
     /usr/local/tex/fonts/cmr10.300gf,
     /usr/local/tex/fonts/cmr10.300pk,                        and
     /usr/local/tex/fonts/cmr10.1500pxl, in that order.   If  the
     first  character of the ``TEXPKS'' variable is a colon, then
     the system default paths are tried first.

FILES
     /usr/local/lib/tex/fonts/pk   Font pixel files.

SEE ALSO
     X(1).



X Version 11         Last change: 8 May 1989                    5






XDVI(SIPB)        MISC. REFERENCE MANUAL PAGES         XDVI(SIPB)



AUTHORS
     Eric Cooper, CMU, did a version for direct output to a QVSS.
     Modified for X by Bob Scheifler, MIT Laboratory for Computer
     Science.  Modified for X11 by Mark Eichin, MIT SIPB.   Addi-
     tional enhancements by many others.


















































X Version 11         Last change: 8 May 1989                    6