xdvi man page on BSDOS

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDOS logo
[printable version]

XDVI(1)								       XDVI(1)

NAME
       xdvi - DVI Previewer for the X Window System

SYNOPSIS
       xdvi [+[page]] [-s shrink] [-S density] [-nogrey] [-gamma g] [-install]
       [-noinstall]  [-p  pixels]   [-margins	dimen]	 [-sidemargin	dimen]
       [-topmargin  dimen]  [-offsets dimen] [-xoffset dimen] [-yoffset dimen]
       [-paper papertype] [-altfont font] [-nomakepk]  -mfmode	mode-def[:dpi]
       [-l]   [-rv]   [-expert]	  [-shrinkbuttonn   shrink]   [-mgs[n]	 size]
       [-warnspecials] [-hush] [-hushchars]  [-hushchecksums]  [-hushspecials]
       [-safer]	 [-fg  color]  [-bg color] [-hl color] [-bd color] [-cr color]
       [-bw width] [-grid1 color] [-grid2 color] [-grid3  color]  [-bw	width]
       [-display  host:display]	 [-geometry geometry] [-icongeometry geometry]
       [-iconic] [-font	 font]	[-keep]	 [-copy]  [-thorough]  [-nopostscript]
       [-noscan]   [-allowshell]   [-noghostscript]   [-nogssafer]  [-gsalpha]
       [-interpreter  path]  [-gspalette   palette]   [-underlink]   [-browser
       WWWbrowser] [-base base URL] [-debug bitmask] [-version] [dvi_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(1).

       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.

       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 reinitialize itself for the	 new  dvi  file.   For
       this  reason,  exposing	parts  of the xdvi window while TeX is running
       should be avoided.  This feature allows you to preview many versions of
       the same file while running xdvi only once.

       In  addition to using keystrokes to move within the file, xdvi provides
       buttons on the right side of the window, which are synonymous with var‐
       ious sequences of keystrokes.

       xdvi can show PostScript<tm> specials by any of three methods.  It will
       try first to use Display PostScript<tm>, then NeWS, then it will try to
       use  Ghostscript	 to render the images.	All of these options depend on
       additional software to work properly; moreover, some of them may not be
       compiled into this copy of xdvi.

       For  performance	 reasons,  xdvi does not render PostScript specials in
       the magnifying glass.

       If dvi_file is not specified, a file-selection widget is popped up  for
       you to choose the dvi file.

OPTIONS
       In addition to specifying the dvi file (with or without the .dvi exten‐
       sion), xdvi supports the following command line options.	 If the option
       begins  with  a `+' instead of a `-', the option is restored to its de‐
       fault 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 num‐
	      ber, the last page is assumed; the first page is the default.

       -allowshell
	      (.allowShell) This option enables the shell escape in PostScript
	      specials.	  (For security reasons, shell escapes are disabled by
	      default.)	 This option should be rarely used; in	particular  it
	      should  not  be  used just to uncompress files: that function is
	      done automatically if the file name ends in  .Z,	.gz,  or  .bz2
	      Shell  escapes  are  always  turned  off if the -safer option is
	      used.

       -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.

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

       -base base URL
	      (.urlBase)  Sets the base URL value that external links given in
	      the dvi file are assumed relative to - normally this  should  be
	      the URL of the document itself (?).

       -bd color
	      (.borderColor) Determines the color of the window border.

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

       -bordercolor color
	      Same as -bd.

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

       -browser WWWbrowser
	      (.wwwBrowser) Defines the World Wide Web browser to be  used  to
	      handle  external URL's, for example mosaic.  If neither the com‐
	      mand-line option nor the X resource are set, uses	 the  environ‐
	      ment variable WWWBROWSER.

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

       -copy  (.copy) Always use the copy operation when writing characters to
	      the display.  This option may be necessary for correct operation
	      on a color display, but overstrike characters will be incorrect.
	      If greyscale anti-aliasing is in use, the -copy  operation  will
	      disable the use of colorplanes and make overstrikes come out in‐
	      correctly.  See also -thorough.

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

       -debug bitmask
	      (.debugLevel) If nonzero, prints additional information on stan‐
	      dard output.  The number is taken as a set of independent	 bits.
	      The  meaning  of each bit follows. 1=bitmaps; 2=dvi translation;
	      4=pk reading; 8=batch  operation;	 16=events;  32=file  opening;
	      64=PostScript   communication;   128=Kpathsea   stat(2)	calls;
	      256=Kpathsea hash table lookups; 512=Kpathsea path  definitions;
	      1024=Kpathsea  path expansion; 2048=Kpathsea searches.  To trace
	      everything having to do with file	 searching  and	 opening,  use
	      4000.   Some of these debugging options are actually provided by
	      Kpathsea.	 See the Debugging section in the Kpathsea manual.

       -density density
	      (.densityPercent) Determines the	density	 used  when  shrinking
	      bitmaps for fonts.  A higher value produces a lighter font.  The
	      default value is 40.  If greyscaling is  in  use	this  argument
	      does  not	 apply;	 use  -gamma instead.  See also the `S'.  key‐
	      stroke.  Same as -S

       -display host:display
	      Specifies the host and screen to be used for displaying the  dvi
	      file.  By default this is obtained from the environment variable
	      DISPLAY.

       -expert
	      (.expert) Prevent the buttons from appearing.  See also the  `x'
	      keystroke.

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

       -foreground color
	      Same as -fg.

       -font font
	      (*font) Sets the font for use in the buttons.

       -gamma gamma
	      (.gamma)	Controls  the interpolation of colors in the greyscale
	      anti-aliasing color palette.  Default value is  1.0.   For  0  <
	      gamma < 1, the fonts will be lighter (more like the background),
	      and for gamma > 1, the fonts will be darker (more like the fore‐
	      ground).	Negative values behave the same way, but use a slight‐
	      ly different algorithm.  For color and greyscale	displays;  for
	      monochrome, see -density.	 See also the `S' keystroke

       -grid1 color
	      (.grid1Color)  Determines	 the color of level 1 grid (default as
	      foreground)

       -grid2 color
	      (.grid2Color) Determines the color of level 2 grid  (default  as
	      foreground)

       -grid3 color
	      (.grid3Color)  Determines	 the color of level 3 grid (default as
	      foreground)

       -geometry geometry
	      (*geometry) Specifies the initial geometry of the window.

       -gspalette palette
	      (.palette) Specifies the palette to be used  when	 using	Ghost‐
	      script  for  rendering PostScript specials.  Possible values are
	      Color, Greyscale, and Monochrome.	 The default is Color.

       -gsalpha
	      (.gsAlpha) Causes Ghostscript to be  called  with	 the  x11alpha
	      driver  instead  of the x11 driver.  The x11alpha driver enables
	      anti-aliasing in PostScript figures, for a nicer appearance.  It
	      is  available on newer versions of Ghostscript.  This option can
	      also be toggled with the `V' keystroke.

       -hl color
	      (.highlight) Determines the color of the page border.   The  de‐
	      fault is the foreground color.

       -hush  (.Hush) Causes xdvi to suppress all suppressible warnings.

       -hushchars
	      (.hushLostChars)	Causes	xdvi to suppress warnings about refer‐
	      ences to characters which are not defined in the font.

       -hushchecksums
	      (.hushChecksums) Causes xdvi to suppress warnings about checksum
	      mismatches between the dvi file and the font file.

       -hushspecials
	      (.hushSpecials)  Causes xdvi to suppress warnings about \special
	      strings that it cannot process.

       -icongeometry geometry
	      (.iconGeometry) Specifies the initial position for the icon.

       -iconic
	      (.iconic) Causes the xdvi window to start in the	iconic	state.
	      The default is to start with the window open.

       -install
	      (.install)  If  xdvi is running under a PseudoColor visual, then
	      (by default) it will check for TrueColor visuals with more  bits
	      per  pixel,  and	switch	to such a visual if one exists.	 If no
	      such visual exists, it will use the current visual and colormap.
	      If  -install is selected, however, it will still use a TrueColor
	      visual with a greater depth, if one is available; otherwise,  it
	      will  install  its  own  colormap on the current visual.	If the
	      current visual is not PseudoColor, then xdvi will not switch the
	      visual or colormap, regardless of its options.  The default val‐
	      ue of the install resource is the special value,	maybe.	 There
	      is no +install option.  See also -noinstall, and the GREYSCALING
	      AND COLORMAPS section.

       -interpreter filename
	      (.interpreter) Use filename as the Ghostscript interpreter.   By
	      default it uses gs.

       -keep  (.keepPosition)  Sets  a	flag  to indicate that xdvi should not
	      move to the home position when moving to a new page.   See  also
	      the `k' keystroke.

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

       -margins dimen
	      (.Margin)	 Specifies  the	 size  of both the top margin and side
	      margin.  This determines the ``home'' position of the page with‐
	      in  the  window as follows.  If the entire page fits in the win‐
	      dow, then the margin settings are ignored.  If, even  after  re‐
	      moving  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 pre‐
	      sumably 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.  The dimension should be a deci‐
	      mal number optionally followed by any of the two-letter abbrevi‐
	      ations for units accepted by TeX (pt, pc, in, bp,	 cm,  mm,  dd,
	      cc, or sp).  By default, the unit will be cm (centimeters).  See
	      also -sidemargin, -topmargin, and the keystroke `M.'

       -mfmode mode-def
	      (.mfMode) Specifies a mode-def string,  which  can  be  used  in
	      searching	 for  fonts (see ENVIRONMENT, below).  Generally, when
	      changing the mode-def, it is also necessary to change  the  font
	      size  to	the  appropriate value for that mode.  This is done by
	      adding a colon and the value in dots per inch; for example, -mf‐
	      mode  ljfour:600.	  This method overrides any value given by the
	      pixelsPerInch resource or the  -p	 command-line  argument.   The
	      metafont	mode  is also passed to metafont during automatic cre‐
	      ation of fonts.  By default, it is unspecified.

       -mgs size
	      Same as -mgs1.

       -mgs[n] size
	      (.magnifierSize[n]) Specifies the size of the window to be  used
	      for the ``magnifying glass'' for Button n.  The size may be giv‐
	      en as an integer (indicating that the magnifying glass is to  be
	      square),	or  it may be given in the form widthxheight.  See the
	      MOUSE ACTIONS section.  Defaults are 200x150, 400x250,  700x500,
	      1000x800, and 1200x1200.

       -noghostscript
	      (.ghostscript)  Inhibits	the  use of Ghostscript for displaying
	      PostScript<tm> specials.	(For this option,  the	logic  of  the
	      corresponding  resource  is reversed: -noghostscript corresponds
	      to ghostscript:off; +noghostscript to ghostscript:on.)

       -nogrey
	      (.grey) Turns off the use of greyscale anti-aliasing when print‐
	      ing shrunken bitmaps.  (For this option, the logic of the corre‐
	      sponding resource is reversed: -nogrey corresponds to  grey:off;
	      +nogrey to grey:on.)  See also the `G' keystroke.

       -nogssafer
	      (.gsSafer) Normally, if Ghostscript is used to render PostScript
	      specials, the Ghostscript interpreter is	run  with  the	option
	      -dSAFER.	  The	-nogssafer  option  runs  Ghostscript  without
	      -dSAFER.	The -dSAFER option in Ghostscript disables  PostScript
	      operators	 such  as  deletefile,	to  prevent possibly malicious
	      PostScript programs from having any effect.  If the  -safer  op‐
	      tion  is specified, then this option has no effect; in that case
	      Ghostscript is always run with -dSAFER.  (For the -nogssafer op‐
	      tion,  the  logic	 of  the  corresponding	 resource is reversed:
	      -nogssafer   corresponds	 to   gsSafer:off;    +nogssafer    to
	      gsSafer:on.)

       -noinstall
	      (.install)  Inhibit the default behavior of switching to a True‐
	      Color visual if one is available with more bits per  pixel  than
	      the  current  visual.   This option corresponds to a resource of
	      install:off.  There is no +noinstall option.  See also -install,
	      and the GREYSCALING AND COLORMAPS section.

       -nomakepk
	      (.makePk) Turns off automatic generation of font files that can‐
	      not be found by other means.  (For this option, the logic of the
	      corresponding  resource  is  reversed:  -nomakepk corresponds to
	      makePk:off; +nomakepk to makePK:on.)

       -nopostscript
	      (.postscript) Turns off rendering	 of  PostScript<tm>  specials.
	      Bounding	boxes,	if known, will be displayed instead.  This op‐
	      tion can also be toggled with the `v' keystroke.	(For this  op‐
	      tion,  the logic of the corresponding resource is reversed: -no‐
	      postscript corresponds to postscript:off; +postscript  to	 post‐
	      script:on.)

       -noscan
	      (.prescan) Normally, when PostScript<tm> is turned on, xdvi will
	      do a preliminary scan of the dvi file, in order to send any nec‐
	      essary  header files before sending the PostScript code that re‐
	      quires them.  This option turns off such prescanning.  (It  will
	      be  automatically be turned back on if xdvi detects any specials
	      that require headers.)  (For the -noscan option,	the  logic  of
	      the  corresponding  resource is reversed: -noscan corresponds to
	      prescan:off; +noscan to prescan:on.)

       -offsets dimen
	      (.Offset) Specifies the size of both the horizontal and vertical
	      offsets  of  the	output on the page.  By decree of the Stanford
	      TeX Project, the default TeX page origin is always 1  inch  over
	      and  down	 from the top-left page corner, even when non-American
	      paper sizes are used.  Therefore, the default  offsets  are  1.0
	      inch.   The argument dimen should be a decimal number optionally
	      followed by any of the two-letter abbreviations  for  units  ac‐
	      cepted  by  TeX (pt, pc, in, bp, cm, mm, dd, cc, or sp).	By de‐
	      fault, the unit will be cm (centimeters).	 See also -xoffset and
	      -yoffset.

       -p pixels
	      (.pixelsPerInch) Defines the size of the fonts to use, in pixels
	      per inch.	 The default value is 600.  This  option  is  provided
	      only  for	 backwards compatibility; the preferred way of setting
	      the font size is by setting the Metafont mode at the same	 time;
	      see the -mfmode option.

       -paper papertype
	      (.paper) Specifies the size of the printed page.	This may be of
	      the form widthxheight optionally followed by a unit, where width
	      and  height  are	decimal numbers giving the width and height of
	      the paper, respectively, and the unit is any of  the  two-letter
	      abbreviations for units accepted by TeX (pt, pc, in, bp, cm, mm,
	      dd, cc, or sp).  By default, the unit will be cm	(centimeters).
	      There  are  also	synonyms which may be used: us (8.5x11in), usr
	      (11x8.5in), legal (8.5x14in), foolscap (13.5x17in), as  well  as
	      the ISO sizes a1-a7, b1-b7, c1-c7, a1r-a7r (a1-a7 rotated), etc.
	      The default size is 21 x 29.7 cm (A4 size).

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

       -s shrink
	      (.shrinkFactor)  Defines the initial shrink factor.  The default
	      value is 8.  If shrink is given as 0, then  the  initial	shrink
	      factor  is  computed so that the page fits within the window (as
	      if the `s' keystroke were given without a number).

       -S density
	      (.densityPercent) Same as -density, q.v.

       -safer (.safer) This option turns on all available security options; it
	      is  designed  for	 use when xdvi is called by a browser that ob‐
	      tains a dvi or TeX file from another site.  In the present case,
	      this option selects +nogssafer and +allowshell.

       -shrinkbuttonn shrink
	      (.shrinkButtonn)	Specifies  that the nth button changing shrink
	      factors shall change to shrink factor factor.  This is not  very
	      usefull  in  the normal run of things.  xdvik scales the scaling
	      factors according to resolution (currently 300dpi	 and  600dpi).
	      Here  n may be a number from 1 to 4.  Typical factors are powers
	      of 2.

       -sidemargin dimen
	      (.sideMargin) Specifies the side margin (see -margins).

       -thorough
	      (.thorough) xdvi will usually  try  to  ensure  that  overstrike
	      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.  If this is the case, then by default xdvi will in‐
	      stead use the copy operation, which does not handle overstriking
	      correctly.   The	-thorough  option  chooses the slower but more
	      correct choice.  See also -copy.

       -topmargin dimen
	      (.topMargin) Specifies the top and  bottom  margins  (see	 -mar‐
	      gins).

       -underlink
	      (.underLink) Underline links.  Default is true.

       -version
	      Print information on the version of xdvi.

       -warnspecials
	      (.warnSpecials)  Causes  xdvi  to	 issue warnings about \special
	      strings that it cannot process.

       -xoffset dimen
	      (.xOffset) Specifies the size of the horizontal  offset  of  the
	      output on the page.  See -offsets.

       -yoffset dimen
	      (.yOffset) Specifies the size of the vertical offset of the out‐
	      put on the page.	See -offsets.

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.	 Also,
       the  ``Help'', ``Home'', ``Prior'', ``Next'', and arrow cursor keys are
       synonyms for `?', `^', `b', `f', `l', `r', `u', and `d'	keys,  respec‐
       tively.

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

       Q      Quits the program with exit status 2.

       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 two thirds of a window-full.

       d      Moves down two thirds of a window-full.

       l      Moves left two thirds of a window-full.

       r      Moves right two thirds of 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.  Note that
	      this command itself does not move the image at all.  For details
	      on how the margins are used, see the -margins option.

       s      Changes  the shrink factor to the given number.  If no number is
	      given, the smallest factor that makes the entire page fit in the
	      window will be used.  (Margins are ignored in this computation.)

       S      Sets the density factor to be used when shrinking bitmaps.  This
	      should be a number between 0 and	100;  higher  numbers  produce
	      lighter  characters.   If	 greyscaling  mode  is in effect, this
	      changes the value of gamma instead.  The new value of  gamma  is
	      the given number divided by 100; negative values are allowed.

       t      Toggles to the next unit in a sorted list of TeX dimension units
	      for the popup magnifier ruler.

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

       k      Normally when xdvi switches pages, it moves to the home position
	      as well.	The  `k'  keystroke  toggles  a	 `keep-position'  flag
	      which, when set, will keep the same position when moving between
	      pages.  Also `0k' and `1k' clear and set this flag,  respective‐
	      ly.  See also the -keep option.

       x      Toggles  expert mode (in which the buttons do not appear).  Also
	      `0x' and `1x' clear and reset this mode, respectively.  See also
	      the -expert option.

       G      This key toggles the use of greyscale anti-aliasing for display‐
	      ing shrunken bitmaps.  In addition, the key sequences  `0G'  and
	      `1G'  clear  and set this flag, respectively.  See also the -no‐
	      grey option.

       If given a numeric argument that is not 0 or 1, greyscale anti-aliasing
       is  turned  on,	and  the gamma resource is set to the value divided by
       100. E.g., `150G' turns on greyscale and sets gamma to 1.5.

       D      This key toggles the use of grid over the document.  If no  num‐
	      ber  is  given,  the grid mode toggles.  By prepending number, 3
	      grid levels can be set.  The grid in each level is drawn in  the
	      colour  specified.   See also the -grid1, -grid2, and -grid3 op‐
	      tions.

       v      This key toggles the rendering of PostScript<tm>	specials.   If
	      rendering	 is turned off, then bounding boxes are displayed when
	      available.  In addition the key sequences `0v'  and  `1v'	 clear
	      and set this flag, respectively.	See also the -nopostscript op‐
	      tion.

       V      This key toggles tha anti-aliasing  of  PostScript<tm>  specials
	      when  Ghostscript	 is used as renderer.  In addition the key se‐
	      quences `0V' and `1V' clear and set this flag, See also the  +.B
	      -gsalpha option.

       F      Read  a  new  dvi file. A file-selection widget is popped up for
	      you to choose the dvi file from.

MOUSE ACTIONS
       If the shrink factor is set to any number other than one, then clicking
       mouse  button  3 will pop up a ``magnifying glass'' which shows the un‐
       shrunk image in the vicinity of the mouse click.	 This subwindow disap‐
       pears  when the mouse button is released.  Different mouse buttons pro‐
       duce different sized windows, as indicated by the -mgs option.	Moving
       the  cursor  while  holding  the	 button	 down will move the magnifying
       glass.

       If the cursor is on a hypertext link (underlined by default), then that
       link  overrides	the magnifying glass for Buttons 1 and 2.  If Button 1
       is clicked over a link, then xdvi jumps to the target  in  the  current
       window.	If Button 2 is clicked over a link, then xdvi opens a new win‐
       dow on the target.

       More precisely, for internal links, Button 1 jumps in the  same	window
       to  the link, while Button 2 starts up a new xdvi on the link.  For ex‐
       ternal links to dvi files, Button 1 changes  the	 current  xdvi	to  be
       reading	that file, while Button 2 starts a new xdvi on that file.  For
       other file types, mime.types and mailcap are parsed  to	determine  the
       viewer;	finally,  if  no suitable mailcap entry was found, if the WWW‐
       BROWSER environment variable is set, or -browser was specified  on  the
       command line, it is started up on the file.

       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  and  optionally drags it; 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.

SIGNALS
       When xdvi receives a SIGUSR1 signal, it rereads the dvi file.

GREYSCALING AND COLORMAPS
       The greyscale anti-aliasing feature in xdvi will not work at  its  best
       if  the display does not have enough colors available.  This can happen
       if other applications are using most of the colormap (even if they  are
       iconified).   If this occurs, then xdvi will print an error message and
       turn on the -copy option.  This will result  in	overstrike  characters
       appearing wrong; it may also result in poor display quality if the num‐
       ber of available colors is very small.

       Typically this problem occurs on displays that allocate eight  bits  of
       video  memory  per  pixel.  To see how many bits per pixel your display
       uses, type xwininfo in an xterm window, and then click the mouse on the
       root  window  when  asked.  The ``Depth:'' entry will tell you how many
       bits are allocated per pixel.

       Displays using at least 15 bits per pixel are typically TrueColor visu‐
       als, which do not have this problem, since their colormap is permanent‐
       ly allocated and available to all applications.	(The visual  class  is
       also  displayed	by  xwininfo.)	For more information on visual classes
       see the documentation for the X Window System.

       To alleviate this problem, therefore, one may (a) run  with  more  bits
       per  pixel  (this may require adding more video memory or replacing the
       video card), (b) shut down other applications that may be using much of
       the  colormap  and then restart xdvi, or (c) run xdvi with the -install
       option.

       One application which is often the cause of this problem	 is  Netscape.
       In  this	 case  there are two more alternatives to remedying the situa‐
       tion.  One can run ``netscape -install'' to cause Netscape to install a
       private colormap.  This can cause colors to change in bizarre ways when
       the mouse is moved to a different window.  Or, one can  run  ``netscape
       -ncols 220'' to limit Netscape to a smaller number of colors.  A small‐
       er number will ensure that other applications have more	colors	avail‐
       able, but will degrade the color quality in the Netscape window.

ENVIRONMENT
       Please see the kpathsea documentation.

HANDLING OF POSTSCRIPT FIGURES
       xdvi can display PostScript files included in the dvi file.  Such files
       are first searched for in the directory where the dvi file is, and then
       using  normal  Kpathsea rules.  There is an exception to this, however:
       if the file name begins with a backtick (`), then the remaining charac‐
       ters  in	 the file name give a shell command (often zcat) which is exe‐
       cuted; its standard output is then sent	to  be	interpreted  as	 Post‐
       Script.	 Note that there is some potential for security problems here;
       see the -allowshell command-line option.	 It  is	 better	 to  use  com‐
       pressed files directly (see below).

       If  a  file name is given (as opposed to a shell command), if that file
       name ends in ``.Z'', ``.gz'', or ``.bz2'' and if the first two bytes of
       the  file indicate that it was compressed with compress(1), gzip(1), or
       bzip2(1) respectively, then the file is first uncompressed with	uncom‐
       press  -c,  gunzip  -c, or bunzip2 -c, respectively.  This is preferred
       over using a backtick to call the command directly, since  you  do  not
       have to specify -allowshell and since it allows for path searching.

ENVIRONMENT
       xdvik  uses  the	 same environment variables and algorithms for finding
       font files as TeX and friends.  See the documentation for the  Kpathsea
       library	for  details  (repeating it here is too cumbersome).  In addi‐
       tion, xdvik accepts the following variables:

       DISPLAY
	      Specifies which graphics display terminal to use.

       KPATHSEA_DEBUG
	      Trace Kpathsea lookups; set it to -1 for complete tracing.

       MIMELIBDIR
	      Directory containing the mime.types file, if ~/.mime-types  does
	      not exist.

       MAILCAPDIR
	      Directory	 containing  the .mailcap file, if ~/.mailcap does not
	      exist.

       WWWBROWSER
	      The browser used to open URL's, if neither the  -browser	option
	      nor  the	.wwwBrowser resource are set.  For more information on
	      hyper-TeX support, see the `Hypertext' node in the dvipsk	 manu‐
	      al.

       TMPDIR The  directory  to  use for storing temporary files created when
	      uncompressing PostScript files.

LIMITATIONS
       xdvi accepts many but not all types of PostScript specials accepted  by
       dvips.  For example, it accepts most specials generated by epsf and ps‐
       fig, It does not, however, support bop-hook or eop-hook,	 nor  does  it
       allow  PostScript  commands  to affect the rendering of things that are
       not PostScript (for example, the ``NEAT'' and rotated ``A'' examples in
       the  dvips  manual).  These restrictions are due to the design of xdvi;
       in all likelihood they will always remain.

       LaTeX2e color and rotation specials are not currently supported.

FILES
       Please see the kpathsea documentation.

COPYRIGHTS
       xdvi itself is Copyrighted by Paul Vojta and distributed under  the  X-
       Consortium license.  xdvi uses the libwww library of the World Wide Web
       Consortium, which includes computer software creaded and made available
       by  CERN.  It also uses the kpathsea library which is distributed under
       the GNU LIBRARY General Public License.

       THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF  ANY  KIND,  EX‐
       PRESS  OR  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MER‐
       CHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN
       NO  EVENT  SHALL PAUL VOJTA OR ANY OTHERS BE LIABLE FOR ANY CLAIM, DAM‐
       AGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTH‐
       ERWISE,	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
       USE OR OTHER DEALINGS IN THE SOFTWARE.

SEE ALSO
       X(1), dvips(1), Kpathseadocumentation

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. +Additional enhancements by many oth‐
       ers.   The  current maintainer of the original xdvi is Paul Vojta, U.C.
       Berkeley; the maintainer of the xdvik  variant  is  Nicolai  Langfeldt,
       Dept. of Math, UiO, Norway, with the help of many others.

X Version 11		       15 February 1999			       XDVI(1)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net