EditPageHistoryDiffInfoLikePages

Annotated edit history of xdvi(1) version 4 showing authors affecting page license. View with all changes included.

Rev	Author	#	Line
1	perry	1	XDVI
		2	!!!XDVI
		3	NAME
		4	SYNOPSIS
		5	DESCRIPTION
		6	OPTIONS
		7	KEYSTROKES
		8	MOUSE ACTIONS
		9	UNBOUND ACTIONS
		10	CUSTOMIZATION
		11	SIGNALS
		12	GREYSCALING AND COLORMAPS
		13	ENVIRONMENT
		14	HANDLING OF POSTSCRIPT FIGURES
		15	SOURCE SPECIALS
		16	ENVIRONMENT
		17	LIMITATIONS
		18	FILES
		19	SEE ALSO
		20	AUTHORS
		21	----
		22	!!NAME
		23
		24
		25	xdvi - DVI Previewer for the X Window System
		26	!!SYNOPSIS
		27
		28
		29	__xdvi__ [[__+__[[''page'']] [[__-s__
		30	''shrink''] [[__-S__ ''density''] [[__-nogrey__]
		31	[[__-gamma__ ''g''] [[__-install__]
		32	[[__-noinstall__] [[__-p__ ''pixels'']
		33	[[__-margins__ ''dimen''] [[__-sidemargin__
		34	''dimen''] [[__-topmargin__ ''dimen'']
		35	[[__-offsets__ ''dimen''] [[__-xoffset__
		36	''dimen''] [[__-yoffset__ ''dimen''] [[__-paper__
		37	''papertype''] [[__-altfont__ ''font'']
		38	[[__-nomakepk__] __-mfmode__
		39	''mode-def''[[__:__''dpi''] [[__-editor__
		40	''command''] [[__-sourceposition__
		41	''line''[[__:__''col''][[ ]''filename'']
		42	[[__-l__] [[__-rv__] [[__-expert__]
		43	[[__-__[[__no__]__statusline__]
		44	[[__-shrinkbutton__''n shrink''] [[__-mgs__[[''n'']
		45	''size''] [[__-warnspecials__] [[__-hush__]
		46	[[__-hushchars__] [[__-hushchecksums__]
		47	[[__-hushspecials__] [[__-hushstdout__] [[__-safer__]
		48	[[__-fg__ ''color''] [[__-bg__ ''color'']
		49	[[__-hl__ ''color''] [[__-bd__ ''color'']
		50	[[__-cr__ ''color''] [[__-bw__ ''width'']
		51	[[__-grid1__ ''color''] [[__-grid2__ ''color'']
		52	[[__-grid3__ ''color''] [[__-bw__ ''width'']
		53	[[__-display__ ''host:display''] [[__-geometry__
		54	''geometry''] [[__-icongeometry__ ''geometry'']
		55	[[__-iconic__] [[__-font__ ''font''] [[__-keep__]
		56	[[__-copy__] [[__-thorough__] [[__-wheelunit__
		57	''pixels''] [[__-nopostscript__] [[__-noscan__]
		58	[[__-allowshell__] [[__-noghostscript__]
		59	[[__-nogssafer__] [[__-gsalpha__] [[__-interpreter__
		60	''path''] [[__-gspalette__ ''palette'']
		61	[[__-not1lib__] [[__-underlink__] [[__-browser__
		62	''WWWbrowser''] [[__-base__ ''base URL'']
		63	[[__-debug__ ''bitmask''] [[__-version__]
		64	[[''dvi_file'']
		65	!!DESCRIPTION
		66
		67
		68	__xdvi__ is a program which runs under the X window
		69	system. It is used to preview ''dvi'' files, such as are
		70	produced by tex(1).
		71
		72
		73	This program has the capability of showing the file shrunken
		74	by various (integer) factors, and also has a ``magnifying
		75	glass'' which allows one to see a small part of the unshrunk
		76	image momentarily. Other new features are: it can display
		77	Postscript
		78
		79
		80	Before displaying any page or part thereof, it checks to see
		81	if the ''dvi'' file has changed since the last time it
		82	was displayed. If this is the case, then __xdvi__ will
		83	reinitial- ize itself for the new ''dvi'' file. For this
		84	reason, expos- ing parts of the __xdvi__ window while TEX
		85	is running should be avoided. This feature allows you to
		86	preview many ver- sions of the same file while running
		87	__xdvi__ only once.
		88
		89
		90	In addition to using keystrokes to move within the file,
		91	__xdvi__ provides buttons on the right side of the
		92	window, which are synonymous with various sequences of
		93	keystrokes.
		94
		95
		96	__xdvi__ can show !PostScript
		97	__xdvi__.
		98
		99
		100	For performance reasons, __xdvi__ does not render
		101	!PostScript specials in the magnifying glass.
		102
		103
		104	If ''dvi_file'' is not specified, a file-selection widget
		105	is popped up for you to choose the ''dvi''
		106	file.
		107	!!OPTIONS
		108
		109
		110	In addition to specifying the ''dvi'' file (with or
		111	without the __.dvi__ extension), __xdvi__ supports the
		112	following command line options. If the option begins with a
		113	`__+__' instead of a `__-__', the option is restored
		114	to its default value. By default, these options can be set
		115	via the resource names given in parentheses in the
		116	description of each option.
		117
		118
		119	__+__''page''
		120
		121
		122	Specifies the first page to show. If __+__ is given
		123	without a number, the last page is assumed; the first page
		124	is the default.
		125
		126
		127	__-allowshell__
		128
		129
		130	(__.allowShell__) This option enables the shell escape in
		131	!PostScript specials. (For security reasons, shell escapes
		132	are disabled by default.) This op- tion should be rarely
		133	used; in particular it should not be used just to uncompress
		134	files: that function is done automatically if the file name
		135	ends in __.Z__, __.gz__, or __.bz2__. Shell escapes
		136	are always turned off if the __-safer__ option is
		137	used.
		138
		139
		140	__-altfont__ ''font''
		141
		142
		143	(__.altFont__) Declares a default font to use when the
		144	font in the ''dvi'' file cannot be found. This is use-
		145	ful, for example, with !PostScript
		146	''
		147
		148
		149	__-background__ ''color''
		150
		151
		152	(__.background__) Determines the color of the back-
		153	ground. Same as __-bg__.
		154
		155
		156	__-base__ ''base URL''
		157
		158
		159	(__.urlBase__) Sets the base URL value that external
		160	links given in the ''dvi'' file are assumed relative to -
		161	normally this should be the URL of the document itself
		162	(?).
		163
		164
		165	__-bd__ ''color''
		166
		167
		168	(__.borderColor__) Determines the color of the window
		169	border.
		170
		171
		172	__-bg__ ''color''
		173
		174
		175	(__.background__) Determines the color of the back-
		176	ground.
		177
		178
		179	__-bordercolor__ ''color''
		180
		181
		182	Same as __-bd__.
		183
		184
		185	__-borderwidth__ ''width''
		186
		187
		188	(__.borderWidth__) Specifies the width of the border of
		189	the window. Same as __-bw__.
		190
		191
		192	__-browser__ ''WWWbrowser''
		193
		194
		195	(__.wwwBrowser__) Defines the World Wide Web browser to
		196	be used to handle external URL's, for example mosa- ic. If
		197	neither the command-line option nor the X resource are set,
		198	uses the environment variable WWWBROWSER.
		199
		200
		201	__-bw__ ''width''
		202
		203
		204	(__.borderWidth__) Specifies the width of the border of
		205	the window.
		206
		207
		208	__-copy__
		209
		210
		211	(__.copy__) Always use the ''copy'' operation when
		212	writing characters to the display. This option may be nec-
		213	essary for correct operation on a color display, but
		214	overstrike characters will be incorrect. If greyscale
		215	anti-aliasing is in use, the __-copy__ opera- tion will
		216	disable the use of colorplanes and make overstrikes come out
		217	incorrectly. See also __-thor- ough__.
		218
		219
		220	__-cr__ ''color''
		221
		222
		223	(__.cursorColor__) Determines the color of the cursor.
		224	The default is the color of the page border.
		225
		226
		227	__-debug__ ''bitmask''
		228
		229
		230	(__.debugLevel__) If nonzero, prints additional infor-
		231	mation on standard output. The number is taken as a set of
		232	independent bits. The meaning of each bit follows.
		233	1=bitmaps; 2=dvi translation; 4=pk read- ing; 8=batch
		234	operation; 16=events; 32=file opening; 64=!PostScript
		235	communication; 128=Kpathsea stat(2) calls; 256=Kpathsea hash
		236	table lookups; 512=Kpath- sea path definitions;
		237	1024=Kpathsea path expansion; 2048=Kpathsea searches. To
		238	trace everything having to do with file searching and
		239	opening, use 4000. Some of these debugging options are
		240	actually pro- vided by Kpathsea. See the Debugging section
		241	in the Kpathsea manual.
		242
		243
		244	__-density__ ''density''
		245
		246
		247	(__.densityPercent__) Determines the density used when
		248	shrinking bitmaps for fonts. A higher value pro- duces a
		249	lighter font. The default value is 40. If greyscaling is in
		250	use, this argument does not ap- ply; use __-gamma__
		251	instead. See also the `__S__' keystroke. Same as
		252	__-S__.
		253
		254
		255	__-display__
		256	''host''__:__''display''
		257
		258
		259	Specifies the host and screen to be used for dis- playing
		260	the ''dvi'' file. By default this is obtained from the
		261	environment variable
		262	__DISPLAY.__
		263
		264
		265	__-editor__ ''editor''
		266
		267
		268	(__.editor__) Specifies the editor that will be invoked
		269	when the ''source-special()'' action is triggered (by
		270	default via CTRL-Mouse 1). The argument to this option is a
		271	format string in which occurrences of ``__%f__'' are
		272	replaced by the file name, occurrences of ``__%l__'' are
		273	replaced by the line number within the file, and optional
		274	occurrences of ``__%c__'' are replaced by the column
		275	number within the line. If no ``__%f__'' or ``__%l__''
		276	occurs in the string, a warning is given and the missing
		277	designators are appended.
		278
		279
		280	If neither the option nor the X resource ''.editor'' is
		281	specified, the following environment variables are checked
		282	to determine the editor command: __XEDITOR__,
		283	__VISUAL__, and __EDITOR__ (in this sequence). If the
		284	string is found as the value of the
		285	__VISUAL__ or __EDI-
		286	TOR__ environment variables, then ``''xterm
		287	-e'' '' is prepended to the string; if the editor is
		288	specified by other means, then it must be in the form of a
		289	shell command to pop up an X window with an editor in it. If
		290	none of these variables is set, the com- mand ``''xterm -e
		291	vi %s +%d'''' is used and a warning message is
		292	given.
		293
		294
		295	A new instance of the editor is started each time this
		296	command is used; therefore it is preferrable to use an
		297	editor that can be invoked in `client' mode to load new
		298	files into the same instance. Ex- ample settings
		299	are:
		300
		301
		302	''emacsclient --no-wait +%l %f'' (older
		303	Emacsen),
		304
		305
		306	''gnuclient -q +%l %f'' (XEmacs and newer
		307	Emacsen)
		308
		309
		310	''nc +%l %f'' (nedit)
		311
		312
		313	Note that those strings need to be enclosed into quotes when
		314	using them on the command-line to pro- tect them from the
		315	shell; when using them as argu- ment for the ''.editor''
		316	resource in an X resource file, no quotes should be
		317	used.
		318
		319
		320	__NOTE ON SECURITY:__ The argument of this option isn't
		321	executed as a shell command, but via ''exec()'' to pre-
		322	vent evil tricks with the contents of source spe- cials.
		323	Execution of the ''-editor'' command is dis- abled when
		324	the ''-safer'' option is used.
		325
		326
		327	__-expert__
		328
		329
		330	(__.expert__) Prevent the buttons from appearing. See
		331	also the `__x__' keystroke.
		332
		333
		334	__-fg__ ''color''
		335
		336
		337	(__.foreground__) Determines the color of the text
		338	(foreground).
		339
		340
		341	__-foreground__ ''color''
		342
		343
		344	Same as __-fg__.
		345
		346
		347	__-font__ ''font''
		348
		349
		350	(__*font__) Sets the font for use in the
		351	buttons.
		352
		353
		354	__-gamma__ ''gamma''
		355
		356
		357	(__.gamma__) Controls the interpolation of colors in the
		358	greyscale anti-aliasing color palette. Default value is 1.0.
		359	For 0 __gamma''
		360	''gamma''
		361	''-density__. See also the `__S__'
		362	keystroke
		363
		364
		365	__-grid1__ ''color''
		366
		367
		368	(__.grid1Color__) Determines the color of level 1 grid
		369	(default as foreground)
		370
		371
		372	__-grid2__ ''color''
		373
		374
		375	(__.grid2Color__) Determines the color of level 2 grid
		376	(default as foreground)
		377
		378
		379	__-grid3__ ''color''
		380
		381
		382	(__.grid3Color__) Determines the color of level 3 grid
		383	(default as foreground)
		384
		385
		386	__-geometry__ ''geometry''
		387
		388
		389	(__*geometry__) Specifies the initial geometry of the
		390	window.
		391
		392
		393	__-gspalette__ ''palette''
		394
		395
		396	(__.palette__) Specifies the palette to be used when
		397	using Ghostscript for rendering !PostScript spe- cials.
		398	Possible values are __Color__, __Greyscale__, and
		399	__Monochrome__. The default is __Color__.
		400
		401
		402	__-gsalpha__
		403
		404
		405	(__.gsAlpha__) Causes __Ghostscript__ to be called
		406	with the __x11alpha__ driver instead of the __x11__
		407	driver. The __x11alpha__ driver enables anti-aliasing in
		408	!PostScript figures, for a nicer appearance. It is available
		409	on newer versions of __Ghostscript__. This option can
		410	also be toggled with the `__V__' keystroke.
		411
		412
		413	__-sourceposition__ ''line''[[__:__''col''][[
		414	]''filename''
		415
		416
		417	This option makes xdvi start in `client mode' to perform a
		418	`forward search'. The main dvi file ''dvi_file'' is
		419	specified on the command line as usual. `Forward search'
		420	means that xdvi will try to open the page in ''dvi_file''
		421	corresponding to the ''line'' (op- tionally also the
		422	''column'') and ''filename'' of the .tex source, and
		423	highlight the place found by drawing a rectangle in
		424	''highlight'' colour (see the ''-hl'' option) around
		425	the corresponding text. (This only works when the
		426	''dvi_file'' has been prepared with source special
		427	information; see the section SOURCE SPE- CIALS for more
		428	information on this.)
		429
		430
		431	`Client mode' means that if there is already anoth- er
		432	instance of xdvi running on this X display and displaying
		433	the same ''dvi_file'', a new instance start- ed with the
		434	''-sourceposition'' option will only notify that running
		435	instance to perform the forward search, and exit after that.
		436	This way, other pro- grams such such as text editors may
		437	invoke xdvi in `client mode' to jump to a specific place in
		438	the .dvi file corresponding to the current cursor posi- tion
		439	in the .tex file.
		440
		441
		442	The argument for ''filename'' should be a string with the
		443	same extension as the file name used for the source specials
		444	in the ''dvi'' file. The space before ''filename'' is
		445	only needed if the filename starts with a digit. When the
		446	space is used, the argument needs to be encosed in quotes to
		447	prevent the shell from misinterpreting the space as argument
		448	separa- tor.
		449
		450
		451	__-hl__ ''color''
		452
		453
		454	(__.highlight__) Determines the color of the page bor-
		455	der. The default is the foreground color.
		456
		457
		458	__-hush__
		459
		460
		461	(__.Hush__) Causes __xdvi__ to suppress all
		462	suppressible warnings.
		463
		464
		465	__-hushchars__
		466
		467
		468	(__.hushLostChars__) Causes __xdvi__ to suppress
		469	warnings about references to characters which are not de-
		470	fined in the font.
		471
		472
		473	__-hushchecksums__
		474
		475
		476	(__.hushChecksums__) Causes __xdvi__ to suppress
		477	warnings about checksum mismatches between the ''dvi''
		478	file and the font file.
		479
		480
		481	__-hushspecials__
		482
		483
		484	(__.hushSpecials__) Causes __xdvi__ to suppress
		485	warnings about __special__ strings that it cannot
		486	process.
		487
		488
		489	__-hushstdout__
		490
		491
		492	(__.hushStdout__) Causes __xdvi__ to suppress all
		493	status informations it would normally print to stdout if the
		494	statusline is disabled.
		495
		496
		497	__-icongeometry__ ''geometry''
		498
		499
		500	(__.iconGeometry__) Specifies the initial position for
		501	the icon.
		502
		503
		504	__-iconic__
		505
		506
		507	(__.iconic__) Causes the __xdvi__ window to start in
		508	the iconic state. The default is to start with the window
		509	open.
		510
		511
		512	__-install__
		513
		514
		515	(__.install__) If __xdvi__ is running under a
		516	__!PseudoColor__ visual, then (by default) it will check
		517	for __True- Color__ visuals with more bits per pixel, and
		518	switch to such a visual if one exists. If no such visual
		519	exists, it will use the current visual and col- ormap. If
		520	__-install__ is selected, however, it will still use a
		521	__!TrueColor__ visual with a greater depth, if one is
		522	available; otherwise, it will install its own colormap on
		523	the current visual. If the current visual is not
		524	__!PseudoColor__, then __xdvi__ will not switch the
		525	visual or colormap, regardless of its options. The default
		526	value of the __install__ resource is the special value,
		527	__maybe__. There is no __+install__ option. See also
		528	__-noinstall__, and the GREYSCALING AND COLORMAPS
		529	section.
		530
		531
		532	__-interpreter__ ''filename''
		533
		534
		535	(__.interpreter__) Use ''filename'' as the Ghostscript
		536	in- terpreter. By default it uses __gs__.
		537
		538
		539	__-keep__
		540
		541
		542	(__.keepPosition__) Sets a flag to indicate that
		543	__xdvi__ should not move to the home position when moving
		544	to a new page. See also the `__k__'
		545	keystroke.
		546
		547
		548	__-l__
		549
		550
		551	(__.listFonts__) Causes the names of the fonts used to be
		552	listed.
		553
		554
		555	__-margins__ ''dimen''
		556
		557
		558	(__.Margin__) Specifies the size of both the top margin
		559	and side margin. This determines the ``home'' po- sition of
		560	the page within the window as follows. If the entire page
		561	fits in the window, then the margin settings are ignored.
		562	If, even after remov- ing the margins from the left, right,
		563	top, and bot- tom, the page still cannot fit in the window,
		564	then the page is put in the window such that the top and
		565	left margins are hidden, and presumably the upper left-hand
		566	corner of the text on the page will be in the upper
		567	left-hand corner of the window. Other- wise, the text is
		568	centered in the window. The di- mension should be a decimal
		569	number optionally fol- lowed by any of the two-letter
		570	abbreviations for units accepted by TEX (__pt__,
		571	__pc__, __in__, __bp__, __cm__, __mm__,
		572	__dd__, __cc__, or __sp__). By default, the unit
		573	will be __cm__ (cen- timeters)__.__ See also
		574	__-sidemargin__, __-topmargin__, and the keystroke
		575	`__M__.'
		576
		577
		578	__-mfmode__ ''mode-def''
		579
		580
		581	(__.mfMode__) Specifies a ''mode-def'' string, which
		582	can be used in searching for fonts (see ENVIRONMENT, be-
		583	low). Generally, when changing the ''mode-def'', it is
		584	also necessary to change the font size to the ap- propriate
		585	value for that mode. This is done by adding a colon and the
		586	value in dots per inch; for example, __-mfmode
		587	ljfour:600__. This method overrides any value given by the
		588	__pixelsPerInch__ resource or the __-p__ command-line
		589	argument. The metafont mode is also passed to
		590	__metafont__ during automatic creation of fonts. By
		591	default, it is __unspecified__.
		592
		593
		594	__-mgs__ ''size''
		595
		596
		597	Same as __-mgs1__.
		598
		599
		600	__-mgs__[[''n''] ''size''
		601
		602
		603	(__.magnifierSize__[[''n'']) Specifies the size of the
		604	win- dow to be used for the ``magnifying glass'' for Button
		605	''n''. The size may be given as an integer (in- dicating
		606	that the magnifying glass is to be square), or it may be
		607	given in the form ''width''x- ''height''. See the
		608	MOUSE ACTIONS section. Defaults are 200x150, 400x250,
		609	700x500, 1000x800, and 1200x1200.
		610
		611
		612	__-noghostscript__
		613
		614
		615	(__.ghostscript__) Inhibits the use of Ghostscript for
		616	displaying !PostScript
		617	__-noghostscript__ corresponds to __ghostscript:off__;
		618	__+noghostscript__ to
		619	__ghostscript:on__.)
		620
		621
		622	__-nogrey__
		623
		624
		625	(__.grey__) Turns off the use of greyscale anti-alias-
		626	ing when printing shrunken bitmaps. (For this op- tion, the
		627	logic of the corresponding resource is reversed:
		628	__-nogrey__ corresponds to __grey:off__;
		629	__+nogrey__ to __grey:on__.) See also the `__G__'
		630	keystroke.
		631
		632
		633	__-nogssafer__
		634
		635
		636	(__.gsSafer__) Normally, if Ghostscript is used to ren-
		637	der !PostScript specials, the Ghostscript inter- preter is
		638	run with the option __-dSAFER__. The __-nogssafer__
		639	option runs Ghostscript without __-dSAFER__. The
		640	__-dSAFER__ option in Ghostscript disables !PostScript
		641	operators such as __deletefile__, to prevent possibly
		642	malicious !PostScript programs from having any effect. If the
		643	__-safer__ option is specified, then this option has no
		644	effect; in that case Ghostscript is always run with
		645	__-dSAFER__. (For the __-nogssafer__ option, the logic
		646	of the corresponding resource is reversed: __-nogssafer__
		647	corresponds to __gsSafer:off__; __+nogssafer__ to
		648	__gsSafer:on__.)
		649
		650
		651	__-noinstall__
		652
		653
		654	(__.install__) Inhibit the default behavior of switch-
		655	ing to a __!TrueColor__ visual if one is available with
		656	more bits per pixel than the current visual. This option
		657	corresponds to a resource of __install:off__. There is no
		658	__+noinstall__ option. See also __-install__, and the
		659	GREYSCALING AND COLORMAPS section.
		660
		661
		662	__-nomakepk__
		663
		664
		665	(__.makePk__) Turns off automatic generation of font
		666	files that cannot be found by other means. (For this option,
		667	the logic of the corresponding re- source is reversed:
		668	__-nomakepk__ corresponds to __makePk:off__;
		669	__+nomakepk__ to __makePK:on__.)
		670
		671
		672	__-nopostscript__
		673
		674
		675	(__.postscript__) Turns off rendering of
		676	!PostScript
		677	__v__' keystroke. (For this option, the log- ic
		678	of the corresponding resource is reversed: __-no-
		679	postscript__ corresponds to __postscript:off__;
		680	__+postscript__ to __postscript:on__.)
		681
		682
		683	__-noscan__
		684
		685
		686	(__.prescan__) Normally, when !PostScript
		687	__xdvi__ will do a preliminary scan of the
		688	''dvi'' file, in order to send any necessary header files
		689	before sending the !PostScript code that requires them. This
		690	option turns off such prescanning. (It will be automatically
		691	be turned back on if __xdvi__ de- tects any specials that
		692	require headers.) (For the __-noscan__ option, the logic
		693	of the corresponding re- source is reversed: __-noscan__
		694	corresponds to __pres- can:off__; __+noscan__ to
		695	__prescan:on__.)
		696
		697
		698	__-offsets__ ''dimen''
		699
		700
		701	(__.Offset__) Specifies the size of both the horizontal
		702	and vertical offsets of the output on the page. By decree of
		703	the Stanford TEX Project, the default TEX page origin is
		704	always 1 inch over and down from the top-left page corner,
		705	even when non-American paper sizes are used. Therefore, the
		706	default offsets are 1.0 inch. The argument ''dimen''
		707	should be a decimal number optionally followed by any of the
		708	two-letter abbreviations for units accepted by TEX
		709	(__pt__, __pc__, __in__, __bp__, __cm__,
		710	__mm__, __dd__, __cc__, or __sp__). By default,
		711	the unit will be __cm__ (centimeters)__.__ See also
		712	__-xoffset__ and __-yoffset__.
		713
		714
		715	__-p__ ''pixels''
		716
		717
		718	(__.pixelsPerInch__) Defines the size of the fonts to
		719	use, in pixels per inch. The default value is 600. This
		720	option is provided only for backwards compati- bility; the
		721	preferred way of setting the font size is by setting the
		722	Metafont mode at the same time; see the __-mfmode__
		723	option.
		724
		725
		726	__-paper__ ''papertype''
		727
		728
		729	(__.paper__) Specifies the size of the printed page. This
		730	may be of the form ''width''__x__''height''
		731	optionally followed by a unit, where ''width'' and
		732	''height'' are dec- imal numbers giving the width and
		733	height of the pa- per, respectively, and the unit is any of
		734	the two-letter abbreviations for units accepted by TEX
		735	(__pt__, __pc__, __in__, __bp__, __cm__,
		736	__mm__, __dd__, __cc__, or __sp__). By de-
		737	fault, the unit will be __cm__ (centimeters)__.__
		738	There are also synonyms which may be used: __us__
		739	(8.5x11in), __usr__ (11x8.5in), __legal__ (8.5x14in),
		740	__foolscap__ (13.5x17in), as well as the ISO sizes
		741	__a1__-__a7__, __b1__-__b7__,
		742	__c1__-__c7__, __a1r__-__a7r__
		743	(__a1__-__a7__ rotated), etc. The default size is 21 x
		744	29.7 cm (A4 size).
		745
		746
		747	__-rv__
		748
		749
		750	(__.reverseVideo__) Causes the page to be displayed with
		751	white characters on a black background, in- stead of vice
		752	versa.
		753
		754
		755	__-s__ ''shrink''
		756
		757
		758	(__.shrinkFactor__) Defines the initial shrink factor.
		759	The default value is 8. If ''shrink'' is given as 0, then
		760	the initial shrink factor is computed so that the page fits
		761	within the window (as if the `s' keystroke were given
		762	without a number).
		763
		764
		765	__-S__ ''density''
		766
		767
		768	(__.densityPercent__) Same as __-density__,
		769	''q.v.''
		770
		771
		772	__-safer__
		773
		774
		775	(__.safer__) This option turns on all available securi-
		776	ty options; it is designed for use when __xdvi__ is
		777	called by a browser that obtains a ''dvi'' or TEX file
		778	from another site. This option turns off evaluta- tion of
		779	source specials (see SOURCE SPECIALS for details).
		780	Furthermore, it selects __+nogssafer__ and
		781	__+allowshell__.
		782
		783
		784	__-shrinkbutton__''n shrink''
		785
		786
		787	(__.shrinkButton__''n'') Specifies that the ''n''th
		788	button changing shrink factors shall change to shrink fac-
		789	tor ''factor''. This is useful, e.g., when using 600 dpi
		790	fonts, since in that case shrinking by a factor of 4 is
		791	still not enough. Here ''n'' may be a number from 1 to 3
		792	(in the default button layout, the ``Full Size'' button is
		793	unaffected by these op- tions). If the buttons are
		794	customized, higher val- ues of ''n'' (up to 9) may be
		795	used.
		796
		797
		798	__-sidemargin__ ''dimen''
		799
		800
		801	(__.sideMargin__) Specifies the side margin (see __-mar-
		802	gins__).
		803
		804
		805	__-statusline__, __-nostatusline__
		806
		807
		808	(__.statusline__) Display/do not display the statusline
		809	at the bottom of the window. This can also be tog- gled with
		810	the `__1x__' keystroke. If displaying the statusline is
		811	disabled, the messages that would normally be printed to the
		812	statusline will be printed to ''stdout''. To suppress
		813	printing these mes- sages as well, use the
		814	__-hushstdout__ option.
		815
		816
		817	__-thorough__
		818
		819
		820	(__.thorough__) __xdvi__ will usually try to ensure
		821	that overstrike characters (''e.g.'', __notin__) are
		822	printed correctly. On monochrome displays, this is always
		823	possible with one logical operation, either ''and'' or
		824	''or''. On color displays, however, this may take two
		825	operations, one to set the appropriate bits and one to clear
		826	other bits. If this is the case, then by default __xdvi__
		827	will instead use the ''copy'' operation, which does not
		828	handle overstriking correctly. The __-thorough__ option
		829	chooses the slower but more cor- rect choice. See also
		830	__-copy__.
		831
		832
		833	__-topmargin__ ''dimen''
		834
		835
		836	(__.topMargin__) Specifies the top and bottom margins
		837	(see __-margins__).
		838
		839
		840	__-not1lib__
		841
		842
		843	(__.not1lib__) This will disable the use of T1Lib to
		844	display !PostScript
		845	__
		846
		847
		848	__-underlink__
		849
		850
		851	(__.underLink__) Underline links. Default is
		852	true.
		853
		854
		855	__-version__
		856
		857
		858	Print information on the version of
		859	__xdvi__.
		860
		861
		862	__-warnspecials__
		863
		864
		865	(__.warnSpecials__) Causes __xdvi__ to issue warnings
		866	about __special__ strings that it cannot
		867	process.
		868
		869
		870	__-wheelunit__ ''pixels''
		871
		872
		873	(__.wheelUnit__) Sets the number of pixels that a mo-
		874	tion of a wheel mouse will move the image up or down. If set
		875	to zero, the wheel mouse functionali- ty is disabled. The
		876	default value is 80.
		877
		878
		879	__-xoffset__ ''dimen''
		880
		881
		882	(__.xOffset__) Specifies the size of the horizontal
		883	offset of the output on the page. See
		884	__-offsets__.
		885
		886
		887	__-yoffset__ ''dimen''
		888
		889
		890	(__.yOffset__) Specifies the size of the vertical off-
		891	set of the output on the page. See
		892	__-offsets__.
		893	!!KEYSTROKES
		894
		895
		896	__xdvi__ recognizes the following keystrokes when typed
		897	in its window. Each may optionally be preceded by a
		898	(positive or negative) number, whose interpretation will
		899	depend on the particular keystroke. Also, the ``Help'',
		900	``Home'', ``Prior'' and ``Next'' keys are synonyms for
		901	`__?__', `__^__', `__b__', and `__f__' keys,
		902	respectively.
		903
		904
		905	The key assignments given here are those that __xdvi__
		906	assigns by default. They can be changed--see CUSTOMIZATION,
		907	be- low. The names appearing in brackets at the beginning of
		908	each of the following keystroke definitions is the name
		909	assigned to the action associated with that key, for use
		910	when customizing. Users who do not customize their
		911	keystrokes may ignore these labels.
		912
		913
		914	__q__
		915
		916
		917	[[__quit()__] Quits the program. Control-C and con- trol-D
		918	will do this, too.
		919
		920
		921	__n__
		922
		923
		924	[[__forward-page()__] Moves to the next page (or to the
		925	''n''th next page if a number is given). Synonyms are
		926	`__f__', Return, and Line Feed.
		927
		928
		929	__Space__
		930
		931
		932	[[__down-or-next()__] Moves down two-thirds of a win-
		933	dow-full, or to the next page if already at the bottom of
		934	the page.
		935
		936
		937	__p__
		938
		939
		940	[[__back-page()__] Moves to the previous page (or back
		941	''n'' pages). Synonyms are `__b__' and
		942	control-H.
		943
		944
		945	Delete
		946
		947
		948	[[__up-or-previous()__] Moves up two-thirds of a win-
		949	dow-full, or to the bottom of the previous page if already
		950	at the top of the page. The !BackSpace key will also do
		951	this.
		952
		953
		954	__g__
		955
		956
		957	[[__goto-page()__] Moves to the page with the given num-
		958	ber. Initially, the first page is assumed to be page number
		959	1, but this can be changed with the `__P__' keystroke,
		960	below. If no page number is given, then it goes to the last
		961	page.
		962
		963
		964	__P__
		965
		966
		967	[[__declare-page-number()__] ``This is page number
		968	''n''.'' This can be used to make the `__g__'
		969	keystroke refer to actual page numbers instead of absolute
		970	page num- bers.
		971
		972
		973	__Control-L__
		974
		975
		976	[[__forward-page(0)__] Redisplays the current
		977	page.
		978
		979
		980	__^__
		981
		982
		983	[[__home()__] Move to the ``home'' position of the page.
		984	This is normally the upper left-hand corner of the page,
		985	depending on the margins as described in the __-margins__
		986	option, above.
		987
		988
		989	__Up arrow__
		990
		991
		992	[[__up(0.015)__] Scrolls page up.
		993
		994
		995	__Down arrow__
		996
		997
		998	[[__down(0.015)__] Scrolls page down.
		999
		1000
		1001	__u__
		1002
		1003
		1004	[[__up()__] Moves page up two thirds of a window-full.
		1005	With a float argument to ``up'', moves up the cor-
		1006	responding fraction of a window-full.
		1007
		1008
		1009	__d__
		1010
		1011
		1012	[[__down()__] Moves page down two thirds of a win-
		1013	dow-full. With a float argument to ``down, moves down the
		1014	corresponding fraction of a window-full.
		1015
		1016
		1017	__Left arrow__
		1018
		1019
		1020	[[__left(0.015)__] Scrolls page left.
		1021
		1022
		1023	__Right arrow__
		1024
		1025
		1026	[[__right(0.015)__] Scrolls page right.
		1027
		1028
		1029	__l__
		1030
		1031
		1032	[[__left()__] Moves page left two thirds of a win-
		1033	dow-full.
		1034
		1035
		1036	__r__
		1037
		1038
		1039	[[__right()__] Moves page right two thirds of a win-
		1040	dow-full.
		1041
		1042
		1043	__c__
		1044
		1045
		1046	[[__center()__] Moves the page so that the point cur-
		1047	rently beneath the cursor is moved to the middle of the
		1048	window. It also (gasp!) warps the cursor to the same
		1049	place.
		1050
		1051
		1052	__M__
		1053
		1054
		1055	[[__set-margins()__] Sets the margins so that the point
		1056	currently under the cursor is the upper left-hand corner of
		1057	the text in the page. Note that this command itself does not
		1058	move the image at all. For details on how the margins are
		1059	used, see the __-mar- gins__ option.
		1060
		1061
		1062	__s__
		1063
		1064
		1065	[[__set-shrink-factor()__] Changes the shrink factor to
		1066	the given number. If no number is given, the smallest factor
		1067	that makes the entire page fit in the window will be used.
		1068	(Margins are ignored in this computation.)
		1069
		1070
		1071	__S__
		1072
		1073
		1074	[[__set-density()__] Sets the density factor to be used
		1075	when shrinking bitmaps. This should be a number between 0
		1076	and 100; higher numbers produce lighter characters. If
		1077	greyscaling mode is in effect, this changes the value of
		1078	gamma instead. The new value of gamma is the given number
		1079	divided by 100; nega- tive values are allowed.
		1080
		1081
		1082	__R__
		1083
		1084
		1085	[[__reread-dvi-file()__] Forces the ''dvi'' file to be
		1086	reread. This allows you to preview many versions of the same
		1087	file while running __xdvi__ only once.
		1088
		1089
		1090	__k__
		1091
		1092
		1093	[[__set-keep-flag()__] Normally when __xdvi__ switches
		1094	pages, it moves to the home position as well. The `__k__'
		1095	keystroke toggles a `keep-position' flag which, when set,
		1096	will keep the same position when moving between pages. Also
		1097	`__0k__' and `__1k__' clear and set this flag,
		1098	respectively. See also the __-keep__ op-
		1099	tion.
		1100
		1101
		1102	__x__
		1103
		1104
		1105	[[__set-expert-mode()__] Toggles expert mode (in which the
		1106	buttons do not appear). Typing `__1x__' toggles the
		1107	display of the statusline at the bottom of the window. See
		1108	also the options __-expert__ and __-__[[__no__]sta-
		1109	tusline.
		1110
		1111
		1112	__Control-v__
		1113
		1114
		1115	[[__show-source-specials()__] Show bounding boxes for
		1116	every source special on the current page, and print the
		1117	strings contained in these specials to stderr. With prefix
		1118	1, show every bounding box on the page. This is for
		1119	debugging purposes mainly.
		1120
		1121
		1122	__Control-x__
		1123
		1124
		1125	[[__source-what-special()__] Display information about the
		1126	source special next to the cursor in the sta- tusline. This
		1127	is the same special that would be found by
		1128	''source-special() ,'' but without invoking the editor.
		1129	For debugging purposes.
		1130
		1131
		1132	__G__
		1133
		1134
		1135	[[__set-greyscaling()__] This key toggles the use of
		1136	greyscale anti-aliasing for displaying shrunken bitmaps. In
		1137	addition, the key sequences `__0G__' and `__1G__'
		1138	clear and set this flag, respectively. See also the
		1139	__-nogrey__ option.
		1140
		1141
		1142	If given a numeric argument that is not 0 or 1, greyscale
		1143	anti-aliasing is turned on, and the gamma resource is set to
		1144	the value divided by 100. E.g., `__150G__' turns on
		1145	greyscale and sets gamma to 1.5.
		1146
		1147
		1148	__D__
		1149
		1150
		1151	[[__toggle-grid-mode()__] This key toggles the use of grid
		1152	over the document. If no number is given, the grid mode
		1153	toggles. By prepending number, 3 grid levels can be set. The
		1154	grid in each level is drawn in the colour specified. See
		1155	also the __-grid1, -grid2,__ and __-grid3__
		1156	options.
		1157
		1158
		1159	__v__
		1160
		1161
		1162	[[__set-ps()__] This key toggles the rendering of
		1163	!PostScript
		1164	__0v__' and `__1v__' clear
		1165	and set this flag, respectively. See also the
		1166	__-nopostscript__ option.
		1167
		1168
		1169	__Control-F__
		1170
		1171
		1172	[[__select-dvi-file()__] Read a new ''dvi'' file. A
		1173	file-se- lection widget is popped up for you to choose the
		1174	dvi file from.
		1175
		1176
		1177	__V__
		1178
		1179
		1180	[[__set-gs-alpha()__] This key toggles the anti-aliasing
		1181	of !PostScript__Ghostscript__ is
		1182	used as renderer. In addition the key sequences `__0V__'
		1183	and `__1V__' clear and set this flag, respectively. See
		1184	also the __-gsalpha__ option.
		1185
		1186
		1187	__?__
		1188
		1189
		1190	[[__help()__] Pops up a help window with a short expla-
		1191	nation of the most important key bindings and con- cepts.
		1192	The help texts and menu entries are fully configurable via
		1193	the following X resources (the de- faults strings are given
		1194	in parentheses, or as '''' if they contain a
		1195	longer text):
		1196
		1197
		1198	__helpTopicsButtonLabel__ ''(Topic)''
		1199
		1200
		1201	__helpQuitButtonLabel__ ''(Close)''
		1202
		1203
		1204	__helpIntro__ ''''
		1205
		1206
		1207	__helpGeneralMenulabel__ ''(General)''
		1208
		1209
		1210	__helpGeneral__ ''''
		1211
		1212
		1213	__helpHypertexMenulabel__ ''(HyperTeX
		1214	commands)''
		1215
		1216
		1217	__helpHypertex__ ''''
		1218
		1219
		1220	__helpOthercommandsMenulabel__ ''(Other
		1221	Commands)''
		1222
		1223
		1224	__helpOthercommands__ ''''
		1225
		1226
		1227	__helpPagemotionMenulabel__ ''(Page
		1228	Motion)''
		1229
		1230
		1231	__helpPagemotion__ ''''
		1232
		1233
		1234	__helpSourcespecialsMenulabel__ ''(Source
		1235	Specials)''
		1236
		1237
		1238	__helpSourcespecials__ ''''.
		1239	!!MOUSE ACTIONS
		1240
		1241
		1242	If the shrink factor is set to any number other than one,
		1243	then clicking mouse button 3 will pop up a ``magnifying
		1244	glass'' which shows the unshrunk image in the vicinity of
		1245	the mouse click. This subwindow disappears when the mouse
		1246	button is released. Different mouse buttons produce dif-
		1247	ferent sized windows, as indicated by the __-mgs__
		1248	option. Moving the cursor while holding the button down will
		1249	move the magnifying glass. To access this feature via cus-
		1250	tomization, use the __magnifier__ action. Its argument is
		1251	ei- ther a string of the form ''width''x''height'', as
		1252	in the __-mgs__''n'' command-line option, or one of
		1253	the strings __*1__ through __*5__, referring to the
		1254	value specified by the corresponding __-mgs__''n''
		1255	option.
		1256
		1257
		1258	Holding down the ''CTRL'' key and clicking on mouse
		1259	button 1 starts a ``reverse search'' (action
		1260	__source-special()__; see the section on SOURCE SPECIALS
		1261	for details).
		1262
		1263
		1264	If the cursor is on a hypertext link (underlined by de-
		1265	fault), then that link overrides the magnifying glass for
		1266	Buttons 1 and 2. If Button 1 is clicked over a link, then
		1267	__xdvi__ jumps to the target in the current window. If
		1268	Button 2 is clicked over a link, then __xdvi__ opens a
		1269	new window on the target.
		1270
		1271
		1272	More precisely, for internal links, Button 1 jumps in the
		1273	same window to the link, while Button 2 starts up a new
		1274	__xdvi__ on the link. For external links to ''dvi''
		1275	files, Button 1 changes the current __xdvi__ to be
		1276	reading that file, while Button 2 starts a new __xdvi__
		1277	on that file. For other file types, __mime.types__ and
		1278	__mailcap__ are parsed to determine the viewer; finally,
		1279	if no suitable __mailcap__ entry was found, if the
		1280	__WWWBROWSER__ environment variable is
		1281	set, or __-browser__ was specified on the command line,
		1282	it is started up on the file.
		1283
		1284
		1285	The scrollbars (if present) behave in the standard way:
		1286	pushing Button 2 in a scrollbar moves the top or left edge
		1287	of the scrollbar to that point and optionally drags it;
		1288	pushing Button 1 moves the image up or right by an amount
		1289	equal to the distance from the button press to the upper
		1290	left-hand corner of the window; pushing Button 3 moves the
		1291	image down or left by the same amount.
		1292
		1293
		1294	The image can also be dragged around, by holding down the
		1295	shift key and a mouse button. Shift-button 1 will allow
		1296	vertical dragging only; Shift-button 3, horizontal drag-
		1297	ging; and Shift-button 2 allows dragging in either direc-
		1298	tion. To access these actions via customization, use the
		1299	__drag__ action. This action should have one parameter,
		1300	the character ``__|__'', ``__-__'', or ``__+__'',
		1301	indicating vertical dragging, horizontal dragging, or
		1302	dragging in both direc- tions.
		1303
		1304
		1305	Wheel mice are supported: motion of the wheel on such a
		1306	mouse moves the image up or down by the number of pixels
		1307	indicated by the __-wheelunit__ option. To access this
		1308	option via customization, use the __wheel__ action. This
		1309	action takes one parameter, giving the distance to scroll
		1310	the im- age. If the parameter contains a decimal point, the
		1311	dis- tance is given in wheel units; otherwise,
		1312	pixels.
		1313	!!UNBOUND ACTIONS
		1314
		1315
		1316	The following actions have not been assigned any keystroke,
		1317	but are available if customization is used.
		1318
		1319
		1320	__shrink-to-dpi()__
		1321
		1322
		1323	This action takes one (required) argument. It sets the
		1324	shrink factor to an integer so as to approxi- mate the use
		1325	of fonts with the corresponding number of dots per inch. If
		1326	__xdvi__ is using fonts scaled for ''p'' dots per
		1327	inch, and the argument to __shrink-to-dpi__ is ''n'',
		1328	then the corresponding shrink factor is the ratio
		1329	''p''/''n'', rounded to the nearest in-
		1330	teger.
		1331	!!CUSTOMIZATION
		1332
		1333
		1334	Key and mouse button assignments can be changed by setting
		1335	the __mainTranslations__ resource to a string of
		1336	translations as defined in the documentation for the X
		1337	toolkit. The actions should take the form of action names as
		1338	given in the KEYSTROKES and MOUSE ACTIONS
		1339	sections.
		1340
		1341
		1342	Key actions will usually be without arguments, or they may
		1343	give an argument to replace an optional number typed imme-
		1344	diately prior to the action. The keys __0__-__9__ and
		1345	hyphen can- not be reassigned, since they are used for
		1346	inputting num- bers.
		1347
		1348
		1349	Some key actions may take special arguments, as follows. The
		1350	argument of __goto-page__ may be the letter `__e__',
		1351	indicat- ing the action of going to the end of the document.
		1352	The argument of __set-shrink-factor__ may be the letter
		1353	`__a__', indi- cating that the shrink factor should be
		1354	set to the small- est value such that the page will fit in
		1355	the window. Fi- nally, actions that would perform a toggle,
		1356	such as __set-keep-flag__, may be the letter `__t__',
		1357	indicating that the action should toggle regardless of what
		1358	number may have been typed recently.
		1359
		1360
		1361	Mouse actions should refer only to __!ButtonPress__ events
		1362	(e.g., ____). The
		1363	corresponding mo- tion and release events will then be
		1364	handled internally. A key action may be bound to a mouse
		1365	event, but not vice versa.
		1366
		1367
		1368	Usually the string of translations should begin with
		1369	``__#override__'', indicating that the default key and
		1370	mouse button assignments should not be
		1371	discarded.
		1372
		1373
		1374	When keys or mouse buttons involving modifiers (such as Ctrl
		1375	or Shift) are customized together with their non-mod- ified
		1376	equivalents, the modified keys should come first, for
		1377	example:
		1378
		1379
		1380	__Ctrl
		1381	__
		1382
		1383
		1384	Because __xdvi__ needs to capture pointer motion events,
		1385	and because the X Toolkit translations mechanism cannot
		1386	accom- modate both motion events and double-click events at
		1387	the same time, it is not possible to specify double-click
		1388	ac- tions in __xdvi__ customizations. For information on
		1389	this and other aspects of translations, see the X Toolkit
		1390	Intrin- sics documentation.
		1391
		1392
		1393	There is no command-line option to set the __mainTransla-
		1394	tions__ resource, since changing this resource on the com-
		1395	mand line would be cumbersome. To set the resource for
		1396	testing purposes, use the __-xrm__ command-line option
		1397	provid- ed by the X toolkit. For example, __xdvi -xrm
		1398	'XDvi.main- Translations: #override
		1399	__ or __xdvi -xrm 'XD- vi.mainTranslations: #override
		1400	__ will cause the key `__z__'
		1401	to quit __xdvi__.
		1402
		1403
		1404	Support of wheel mice is controlled by the __wheelTransla-
		1405	tions__ resource. Generally the only action routine called
		1406	by this resource should be __wheel__. The default value
		1407	is
		1408	``____''.
		1409	Because this resource is implemented differently from the
		1410	others, it should not begin with ``#override__'';__ when
		1411	specifying a value for this resource, all wheel actions
		1412	should be in- cluded.
		1413
		1414
		1415	The button labels and actions may also be customized, in a
		1416	similar manner. In this case the resource __buttonTransla-
		1417	tions__ should consist of a string describing the button
		1418	la- bels and the associated actions. The string consists of
		1419	substrings, separated by the newline character (`__n__'),
		1420	each describing one button. Each substring consists of a
		1421	string (to be used as the button's label), a colon, and a
		1422	sequence of actions to be performed when the button is
		1423	pushed. Unlike the situation with key actions, an action
		1424	associated to a button should provide an argument (if ap-
		1425	plicable).
		1426
		1427
		1428	The label string may contain a colon if it is escaped by a
		1429	backslash (`__\__'). It also may contain some special se-
		1430	quences tied to the __-shrinkbutton__''n''
		1431	command-line options. If the characters `__$#__' occur,
		1432	then they are replaced by the argument of the corresponding
		1433	__-shrinkbutton__ com- mand-line option (if present). If
		1434	no corresponding __-shrinkbutton__ option was given, then
		1435	the value is taken from the list of actions, which is
		1436	expected to contain at least one __set-shrink-factor__ or
		1437	__shrink-to-dpi__ action. Likewise, the character
		1438	sequence `__$%__' will be replaced by the percentage
		1439	corresponding to the shrink factor, deter- mined as above.
		1440	In order for the __-shrinkbutton__ option to affect a
		1441	given button, the label string must contain one of the
		1442	character sequences `__$#__', `__$%__', or
		1443	'__$___'. This last string flags a button to be affected
		1444	by a __-shrinkbutton__ option, without making any numbers
		1445	appear in the label text (the `__$___' will not appear in
		1446	the label text).
		1447
		1448
		1449	Some resources are provided to allow customization of the
		1450	geometry of the command buttons. Again, they are not
		1451	changeable via command-line options, other than via the
		1452	__-xrm__ option. All of these resources take integer
		1453	values.
		1454
		1455
		1456	__buttonSideSpacing__
		1457
		1458
		1459	The number of pixels to be placed on either side of the
		1460	buttons. The default value is 6.
		1461
		1462
		1463	__buttonTopSpacing__
		1464
		1465
		1466	The number of pixels between the top button and the top of
		1467	the window. The default value is 50.
		1468
		1469
		1470	__buttonBetweenSpacing__
		1471
		1472
		1473	The number of pixels between most buttons. The de- fault
		1474	value is 20.
		1475
		1476
		1477	__buttonBetweenExtra__
		1478
		1479
		1480	The number of pixels of additional space to be in- serted if
		1481	the __buttonTranslations__ resource string contains an
		1482	extra newline character. The default value is
		1483	50.
		1484
		1485
		1486	__buttonBorderWidth__
		1487
		1488
		1489	The border width of the button windows. The de- fault value
		1490	is 1.
		1491	!!SIGNALS
		1492
		1493
		1494	When __xdvi__ receives a __SIGUSR1__
		1495	signal, it rereads the ''dvi'' file.
		1496	!!GREYSCALING AND COLORMAPS
		1497
		1498
		1499	The greyscale anti-aliasing feature in __xdvi__ will not
		1500	work at its best if the display does not have enough colors
		1501	available. This can happen if other applications are us- ing
		1502	most of the colormap (even if they are iconified). If this
		1503	occurs, then __xdvi__ will print an error message and
		1504	turn on the __-copy__ option. This will result in
		1505	overstrike characters appearing wrong; it may also result in
		1506	poor display quality if the number of available colors is
		1507	very small.
		1508
		1509
		1510	Typically this problem occurs on displays that allocate
		1511	eight bits of video memory per pixel. To see how many bits
		1512	per pixel your display uses, type __xwininfo__ in an
		1513	__xterm__ window, and then click the mouse on the root
		1514	window when asked. The ``Depth:'' entry will tell you how
		1515	many bits are allocated per pixel.
		1516
		1517
		1518	Displays using at least 15 bits per pixel are typically
		1519	__!TrueColor__ visuals, which do not have this problem,
		1520	since their colormap is permanently allocated and available
		1521	to all applications. (The visual class is also displayed by
		1522	__xwininfo__.) For more information on visual classes see
		1523	the documentation for the X Window System.
		1524
		1525
		1526	To alleviate this problem, therefore, one may (a) run with
		1527	more bits per pixel (this may require adding more video
		1528	memory or replacing the video card), (b) shut down other
		1529	applications that may be using much of the colormap and then
		1530	restart __xdvi__, or (c) run __xdvi__ with the
		1531	__-install__ op- tion.
		1532
		1533
		1534	One application which is often the cause of this problem is
		1535	__Netscape__. In this case there are two more
		1536	alternatives to remedying the situation. One can run
		1537	``__netscape -in- stall__'' to cause __Netscape__ to
		1538	install a private colormap. This can cause colors to change
		1539	in bizarre ways when the mouse is moved to a different
		1540	window. Or, one can run ``__netscape -ncols 220__'' to
		1541	limit __Netscape__ to a smaller number of colors. A
		1542	smaller number will ensure that other applications have more
		1543	colors available, but will degrade the color quality in the
		1544	__Netscape__ window.
		1545	!!ENVIRONMENT
		1546
		1547
		1548	Please see the __kpathsea__ documentation.
		1549	!!HANDLING OF POSTSCRIPT FIGURES
		1550
		1551
		1552	__xdvi__ can display !PostScript files included in the
		1553	''dvi'' file. Such files are first searched for in the
		1554	directory where the ''dvi'' file is, and then using
		1555	normal __Kpathsea__ rules. There is an exception to this,
		1556	however: if the file name begins with a backtick (__`__),
		1557	then the remaining characters in the file name give a shell
		1558	command (often __zcat__) which is executed; its standard
		1559	output is then sent to be interpreted as !PostScript. Note
		1560	that there is some potential for security problems here; see
		1561	the __-allowshell__ command-line option. It is better to
		1562	use compressed files directly (see below).
		1563
		1564
		1565	If a file name is given (as opposed to a shell command), if
		1566	that file name ends in ``__.Z__'' or ``__.gz__'', and
		1567	if the first two bytes of the file indicate that it was com-
		1568	pressed with compress(1) or gzip(1),
		1569	respectively, then the file is first uncompressed with
		1570	__uncompress -c__ or __gun- zip -c__, respectively.
		1571	This is preferred over using a backtick to call the command
		1572	directly, since you do not have to specify
		1573	__-allowshell__ and since it allows for path
		1574	searching.
		1575	!!SOURCE SPECIALS
		1576
		1577
		1578	Some TEX implementations or macro packages provide the fa-
		1579	cility to automatically include so-called `source spe-
		1580	cials' into a .dvi file. These contain the line number,
		1581	eventually a column number, and the filename of the .tex
		1582	source. This makes it possible to jump from a .dvi file to
		1583	the corresponding place in the .tex source and back (also
		1584	called `reverse search' and `forward search').
		1585
		1586
		1587	To be usable with __xdvi__, source specials in the
		1588	''dvi'' file must have one of the following
		1589	formats:
		1590
		1591
		1592	__ src:__''line''[[ ]''filename
		1593	''__ src:__''line''__:__''col''[[ ]''filename
		1594	''__ src:__''line
		1595	''__ src:__''line''__:__''col
		1596	''__ src::__''col
		1597	''
		1598
		1599
		1600	If ''filename'' or ''line'' are omitted, the most
		1601	recent values are used. The first source special on each
		1602	page must be in one of the first two forms, since defaults
		1603	are not in- herited across pages.
		1604
		1605
		1606	You will need a TEX implementation or a macro package (such
		1607	as ''srcltx.sty'' or ''srctex.sty'' , available from
		1608	CTAN) to insert such source specials into the dvi
		1609	file.
		1610
		1611
		1612	For reverse search, you can use the combination
		1613	''CTRL-Mouse 1'' to make xdvi open an editor (the value
		1614	of the ''-editor'' command line option) with the file and
		1615	the line number of the .tex source. (See the description of
		1616	the ''-editor'' op- tion for more information and
		1617	examples.)
		1618
		1619
		1620	For forward search, __xdvi__ has a ''-sourceposition''
		1621	option that makes __xdvi__ jump jump to the page in the
		1622	.dvi file corre- sponding to the line number and the file
		1623	name and high- light the line found. See the description of
		1624	the ''-source- position'' for more details.
		1625
		1626
		1627	The evaluation of source specials is disabled when the
		1628	__-safer__ option is used.
		1629	!!ENVIRONMENT
		1630
		1631
		1632	__xdvik__ uses the same environment variables and
		1633	algorithms for finding font files as TEX and friends. See
		1634	the docu- mentation for the __Kpathsea__ library for
		1635	details (repeating it here is too cumbersome). In addition,
		1636	__xdvik__ accepts the following variables:
		1637
		1638
		1639	__DISPLAY__
		1640
		1641
		1642	Specifies which graphics display terminal to
		1643	use.
		1644
		1645
		1646	__KPATHSEA_DEBUG__
		1647
		1648
		1649	Trace __Kpathsea__ lookups; set it to __-1__ for
		1650	complete tracing.
		1651
		1652
		1653	__MIMELIBDIR__
		1654
		1655
		1656	Directory containing the __mime.types__ file, if
		1657	__~/.mime-types__ does not exist.
		1658
		1659
		1660	__MAILCAPDIR__
		1661
		1662
		1663	Directory containing the __.mailcap__ file, if
		1664	__~/.mail- cap__ does not exist.
		1665
		1666
		1667	__WWWBROWSER__
		1668
		1669
		1670	The browser used to open URL's, if neither the
		1671	__-browser__ option nor the __.wwwBrowser__ resource
		1672	are set. For more information on hyper-TEX support, see the
		1673	`Hypertext' node in the __dvipsk__ manual.
		1674
		1675
		1676	__TMPDIR__
		1677
		1678
		1679	The directory to use for storing temporary files created
		1680	when uncompressing !PostScript files.
		1681
		1682
		1683	__XEDITOR__
		1684
		1685
		1686	Determines the editor command used for source spe- cial
		1687	`reverse search', if neither the ''-editor'' com-
		1688	mand-line option nor the ''.editor'' resource are
		1689	specified. See the description of the ''-editor'' command
		1690	line option for details on the format.
		1691
		1692
		1693	__VISUAL__
		1694
		1695
		1696	Determines an editor to be opened in an xterm win- dow if
		1697	neither of ''-editor'', ''.editor'', or ''XEDITOR''
		1698	is specified.
		1699
		1700
		1701	__EDITOR__
		1702
		1703
		1704	Determines an editor to be opened in an xterm win- dow if
		1705	neither of ''-editor'', ''.editor'', ''XEDITOR'' or
		1706	''VI- SUAL'' is specified.
		1707	!!LIMITATIONS
		1708
		1709
		1710	__xdvi__ accepts many but not all types of !PostScript
		1711	specials accepted by __dvips__. For example, it accepts
		1712	most specials generated by __epsf__ and __psfig__. It
		1713	does not, however, sup- port __bop-hook__ or
		1714	__eop-hook__, nor does it allow !PostScript commands to
		1715	affect the rendering of things that are not !PostScript (for
		1716	example, the ``NEAT'' and rotated ``A'' examples in the
		1717	__dvips__ manual). These restrictions are due to the
		1718	design of __xdvi__; in all likelihood they will always
		1719	remain.
		1720
		1721
		1722	LaTEX2e color and rotation specials are not currently sup-
		1723	ported.
		1724
		1725
		1726	__!MetaPost__ files containing included text are not
		1727	supported.
		1728	!!FILES
		1729
		1730
		1731	__xdvi.cfg__ needs to be supplied in the directory named
		1732	by the __XDVIINPUTS kpathsea__ variable. Please see the
		1733	file __README.t1fonts__ in the source distribution if
		1734	__xdvi.cfg__ is missing. __xdvik__ also relies on the
		1735	whole __kpathsea__ infras- tructure. Please see the
		1736	kpathsea documentation for fur- ther
		1737	information.
		1738	!!SEE ALSO
		1739
		1740
		1741	X(1), dvips(1), __Kpathsea__
		1742	documentation
		1743	!!AUTHORS
		1744
		1745
		1746	Eric Cooper, CMU, did a version for direct output to a QVSS.
		1747	Modified for X by Bob Scheifler, MIT Laboratory for Computer
		1748	Science. Modified for X11 by Mark Eichin, MIT SIPB.
		1749	+Additional enhancements by many others. The cur- rent
		1750	maintainer of the original __xdvi__ is Paul Vojta, U.C.
		1751	Berkeley; the maintainer of the __xdvik__ variant is the
		1752	xdvik project at sourceforge, please see __http://source-
		1753	forge.net/projects/xdvi/__
		1754	----