"gv"(1) manual page

Table of Contents

## Name

gv - a PostScript and PDF previewer

## Synopsis

    gv [ filename ]
       [-monochrome] [-grayscale] [-color]
       [-[no]safer] [-[no]quiet] [-arguments
    <arguments>]
       [-page <label>] [-[no]center]
       [-media <media>]
       [-portrait] [-landscape] [-upsidedown]
     [-seascape]
       [-scale <n>] [-scalebase <n>]
       [-swap] [-noswap]
       [-antialias] [-noantialias]
       [-dsc] [-nodsc]
       [-eof] [-noeof]
       [-pixmap] [-nopixmap]
       [-watch] [-nowatch]
       [-?] [-h] [-help] [-v]
       [-resize] [-noresize]
       [-geometry [<width>][x<height>][{+-}<x
    offset>{+-}<yoffset>]
       [-ad <resource file>]
       [-style <resource file>]
       [-spartan]
       [<other toolkit options>]

## Description

gv allows to view and navigate through PostScript and PDF documents on an X disp lay by providing a user interface for the gho stscript int erpreter. Please note that gv is derived from Tim T heisen's ghostview 1.5.

## Options

filename
  The name of the file to be displayed. The file ending .ps may be omitted. filename may point to a compressed file (gzipped, zipped or compressed). Viewing PDF files requires at least ghostscript version 4.x.
-ad <resource file>
  Read and use additional resources from th e file <resource file>. These resources have higher priority than those provi ded in the context of the -style <resource fi le> option.
-antialias, -noantialias
  Whether to use antialiasing.
-arguments <arguments>
  Start ghostscript with additional options as specifie d by the string <arguments>.
-center, -nocenter
  Whether the page should be centered autom atically.
-dsc, -nodsc
  Determines if document structuring conven tion (DSC) c omments should be respected or ignored. If -nodsc is used gv will not attempt to examine the structure of the document but will pa ss the file to the ghostscript interpreter as a whole . In this ca se no page numbers are shown and freely moving around in the document is not possible. This option may help when viewing files n ot conformin g to the document structuring conventions.
-eof, -noeof
  Defines the behaviour of the postscript s canner used to examine the structure of the document. If -noeof is used the scanner will ignore end of file (EOF) comments. This may help when viewing docu ments which import other documents without enclosing them within t he proper "BeginDocument" and "EndDocument" comment s. If -eof is used, the scanner treats an EO F comment as marking the end of the file.
-pixmap, -nopixmap
  If -pixmap is used gv tries to maintain o ff-screen re gions of the displayed page by allocating a suf ficiently la rge pixmap. If -nopixmap is used the X Server is resp onsible for maintaining obscured portions of the disp layed page (see also the useBackingPixmap reso urce).
-v
  Print the version number of gv to standar d output and exit.
-h, -?
  Display a short help message and exit.
-help
  Display a more explicit help message and exit.
-scale <n>
  Selects the scale entry <n> relative to t he scale 1.0 . <n> must be an integer.
-scalebase <n>
  Selects the scale base <n>.
-monochrome, -grayscale, -color P
  Sets the color palette to be used.
-media <media>
  Selects the paper size to be used. Valid values are n ames of paper sizes that appear in the list of pa ge medias as given by the medias resource.
-page <label>
  Display the page with label <label> first .
-portrait, -landscape, \ fB-seascape\ fP, -upsidedown
  Sets the orientation.
-quiet, -noquiet
  Whether to start ghostscript with the -dQ UIET option.
-resize, -noresize
  Whether gv is allowed to automatically fi t the size of its window to the size of the dis played page.
-safer, -nosafer
  Whether to start ghostscript with the -dS AFER option.
-spartan
  This is a shortcut for -style gv_spart an.dat.
-style <resource file>
  Read and use additional resources from th e file <reso urce file>. These resources have lower priority than those provi ded in the context of the -ad <resource file> option.
-swap, -noswap
  Whether to interchange the meaning of the orientation s landscape and seascape.
-watch, -nowatch
  The -watch option causes gv to check the document periodically. If changes are detected gv will automatically display the newer version o f the file. The document is by default checked once e very second. This can be changed via the watchFileFreq uency resour ce. Note that sending gv the SIGHUP signal al so causes an update of the displayed document. This method may be used by document creators to trigg er gv remotely.

## Resources

Resource files In general gv does not depend on any exte rnal resourc e files. However, when starting gv, preferences ar e read from a system specific resource file. The name of this file is as described by the XFILE SEARCHPATH environment variable, or, if this variabl e is not def ined, implementation dependant. In most cases i t is /usr/X11/lib/X11/app-defaults/GV. Administrators may want to modify this fi le in order to set up gv according to the local needs of their sy stem. a user specific resource file. The name of this file is either ~/.gv\ *U or as des cribed by the XUSERFILESEARCHPATH environm ent variable . The files gv_user.ad and gv_syst em.ad (lo cated in the library directory of gv, which is most probably either /usr/local/lib/gv/ or /usr/lib/g v/ may se rve as a basis for constructing the user and system spec ific resourc e files. Note that the user and system specific re source files are not the only sources of preferences taken into account when gv is started. However, in practice these are the most i mportant. Resources of gv The following describes some of the resou rces of gv. The precise syntax of some of the resourc e values may be inferred from the appended default system specific re source file.

antialias
  Whether antialiasing should be used. Valid values are True and False\ *U.
autoCenter
  Whether the displayed page should automat ically be ce ntered (for instance when opening a new file). Valid values are True and False\ *U.
autoResize
  Whether gv is allowed to resize the main window according to the size of the current page . Valid values are True and False\ *U.
confirmPrint
  Whether printing requires an extra confir mation. Valid values are True and False\ *U.
confirmQuit
  Whether leaving gv requires extra confirm ation. Valid values are 0 (Never), 1 (When processing) and 2 (Always). The default value is 1, which causes a confirmation request when trying to leave gv in the presence of pending PDF to Postscript conversion s.
scrollingEyeGuide
  If this resource is True scrolling via the keyboard causes a temporary border to be drawn around the previously visible area of the page. Allowed values are True and Fals e.
ignoreEOF
  Defines the behaviour of the postscript s canner as de scribed in the Options section. Valid values are True and False\ *U.
respectDSC
  Determines whether gv should attempt to r espect docum ent structuring comments. Valid values are True and False\ *U.
reverseScrolling
  Defines the interpretation of directions when scrolling with the mouse. Valid values are True and False\ *U.
swapLandscape
  Whether the meaning of landscape an d seacape should be interchanged. Valid values are True and False\ *U.
scratchDir
  Specifies a directory used to store tempo rary data.
defaultSaveDir
  Specifies the default destination directo ry for files to be saved.
useBackingPixmap
  If the value of this resource is False the X Se rver is advised that saving off-screen pixels of the displ ayed page would be beneficial (maintaining backing store). In t his case gv does not actively maintain the contents o f the page b ut relies on the X Server. The server is, however, always free to stop maintaining backing backing store. If the value of this resource is True\ *U the X Ser ver is advised that maintaining backing store is not usef ul. In this case gv attempts to allocate a su fficiently l arge pixmap to store the contents of the displayed pa ge.
watchFile
  Whether the document should be checked pe riodically a nd updated automatically if changes are detected. Valid values are True and False\ *U.
watchFileFrequency
  Defines the time in milliseconds elapsing between suc cessive checks of the document when watchFile is set to Tr ue. Allowed values must be larger than 500.
printCommand
  The command used for printing a file. The command may contain multiple '%s' wil dcards which will be replaced by the name of the file to be printed.
gsInterpreter
  The command used to start the ghostscript interpreter .
gsCmdScanPDF
  The command used to extract document stru cturing comm ents from a PDF file.
gsCmdConvPDF
  The command used to convert a PDF file to PostScript.
gsX11Device
  The ghostscript command line option which activates t he X11 device.
gsX11AlphaDevice
  The ghostscript command line option which activates t he X11 device with antialiasing enable d.
gsSafer
  Determines whether ghostscript should be started with the -dSAFER command line option.
gsQuiet
  Determines whether ghostscript should be started with the -dQUIET command line option.
gsArguments
  May be used to provide additional command line option s for the ghostscript interpreter. Starting gv with the -arguments <argum ents> option will override this resource settin g.
magMenu
  Describes the menu that pops up when prep aring to to zoom an area of the displayed page.
dirs
  Defines a list of directories accessible via the Dire ctories menu in the file selection window. The special value Home corresponds to the users home directory, the value Tmp corresponds to the sc ratch direct ory as defined by the scratchDir resource.
filter
  Defines the default filter to be used whe n displaying a directory contents in the file selection window. A filter is specified according to the sy ntax

         <filter>    := [<filespecs>] [no <file
      specs>]
         <filespecs> := <filespec> [<filespecs>
      ]
         <filespec>  := filename possibly inclu
      ding wildcar
      ds '*'
                        which match any charact
      er.

  Example: The filter

         GV*filter: *.ps *.pdf no .*

  screens out all files with names starting with a dot and keeps of the remaining ones only thos e which end on .ps or .pdf.

filters
  Defines a list of filters offered in the Filters menu of the file selection window. The filter None has a special meani ng causing all files to be displayed when th e correspond ing menu entry is selected.
miscMenuEntries
  Describes the menu that pops up when clic king with th e third mouse button on the displayed page. The value of this resource is a list of m enu entries. Allowed entries are update, redisplay, toggle_current, toggle_even, toggle_odd, unmark, stop, print_all, print_marked, save_all, save_marked and line.
showTitle
  Whether the name of the displayed documen t should be shown in the title bar of the window. The name of gv's icon will a lso change accordingly if this resource is set to QTrue.
maximumWidth, maximumHeight
  When resizing gv will not attempt to exce ed the size specified by these resources. These resources may be specified as a pos itive intege r or as screen, optionally combined w ith a positive or negative offset. The default values listed above provide e xamples for this syntax. screen will automatically be replac ed by the si ze of the screen.
minimumWidth, minimumHeight
  Defines a minimum size for the main windo w. Valid values for both resources are posit ive integers larger than 200.
scale
  Sets the initial scale. The value of this resource is the offset of the scale to be selected relative to t he scale 1.0 in the the Scale menu.
scaleBase
  Selects the initial scale base. The value of this res ource should be a positive integer.
scales
  Defines the available scales bases and sc ales in the Scale menu.
orientation
  Sets the initial orientation. Valid value s are portrait, landscape,seasca pe, upside-down and automatic. automatic causes gv to attempt to derive the correct orientation from do cument struc turing comments.
fallbackOrientation
  Defines the paper-size to be used when au tomatic orie ntation detetction fails. Valid values are portrait, landscape,seasca pe and upside-down.
medias
  A list describing the page medias known t o gv. List entries starting with ! or # will no t appear in the Media menu but will still be used f or automatic paper size detection.
pagemedia
  Sets the paper size. Allowd values are as given in the above l ist of paper -sizes. Specifying automatic causes gv to attempt to derive the correct paper-size from doc ument struct uring comments.
fallbackPageMedia
  Defines the paper-size to be used when au tomatic pape r-size detetction fails. Valid values are as gi ven in the above list of paper-sizes. The default user and system specific r esource file

      GV.pageMedia:           automatic
      GV.orientation:         automatic
      GV.fallbackOrientation: portrait
      GV.swapLandscape:       False
      GV.autoCenter:          True
      GV.antialias:           False
      GV.respectDSC:          True
      GV.ignoreEOF:           True
      GV.confirmPrint:        True
      GV.reverseScrolling:    False
      GV.scrollingEyeGuide:   True
      GV.autoResize:          True
      GV.maximumWidth:        screen-20
      GV.maximumHeight:       screen-44
      GV.minimumWidth:        400
      GV.minimumHeight:       430
      GV.confirmQuit:         1
      GV.watchFile:           False
      GV.watchFileFrequency:  1000
      GV.showTitle:           True
      GV.miscMenuEntries:     redisplay       \
      0
                              # update        \
      0
                              stop            \
      0
                              line            \
      0
                              toggle_current  \
      0
                              toggle_even     \
      0
                              toggle_odd      \
      0
                              unmark          \
      0
                              line            \
      0
                              print_all       \
      0
                              print_marked    \
      0
                              save_all        \
      0
                              save_marked
      GV.scale:               0
      GV.scaleBase:           1
      GV.scales:              Natural size,   1
      .000,  scree
      n  \n\
                              Pixel based,    1
      .000,  pixel
         \n\
                              0.100,          0
      .100
         \n\
                              0.125,          0
      .125
         \n\
                              0.250,          0
      .250
         \n\
                              0.500,          0
      .500
         \n\
                              0.707,          0
      .707
         \n\
                              1.000,          1
      .000
         \n\
                              1.414,          1
      .414
         \n\
                              2.000,          2
      .000
         \n\
                              4.000,          4
      .000
         \n\
                              8.000,          8
      .000
         \n\
                              10.00,          1
      0.00
      GV.medias:              Letter,         6
      12     792
         \n\
                              # LetterSmall,  6
      12     792
         \n\
                              Legal,          6
      12     1008
         \n\
                              Statement,      3
      96     612
         \n\
                              Tabloid,
             792
         1224    \n\
                              Ledger,         1
      224    792
         \n\
                              Folio,          6
      12     936
         \n\
                              Quarto,         6
      10     780
         \n\
                              # 7x9,          5
      04     648
         \n\
                              # 9x11,         6
      48     792
         \n\
                              # 9x12,         6
      48     864
         \n\
                              # 10x13,
             720
         936     \n\
                              10x14,          7
      20     1008
         \n\
                              Executive,      5
      40     720
         \n\
                              # A0,           2
      384    3370
         \n\
                              # A1,           1
      684    2384
         \n\
                              # A2,           1
      191    1684
         \n\
                              A3,             8
      42     1191
         \n\
                              A4,             5
      95     842
         \n\
                              # A4Small,      5
      95     842
         \n\
                              A5,             4
      20     595
         \n\
                              # A6,           2
      97     420
         \n\
                              # A7,           2
      10     297
         \n\
                              # A8,           1
      48     210
         \n\
                              # A9,           1
      05     148
         \n\
                              # A10,          7
      3      105
         \n\
                              # B0,           2
      920    4127
         \n\
                              # B1,           2
      064    2920
         \n\
                              # B2,           1
      460    2064
         \n\
                              # B3,           1
      032    1460
         \n\
                              B4,             7
      29     1032
         \n\
                              B5,             5
      16     729
         \n\
                              # B6,           3
      63     516
         \n\
                              # B7,           2
      58     363
         \n\
                              # B8,           1
      81     258
         \n\
                              # B9,           1
      27     181
         \n\
                              # B10,          9
      1      127
         \n\
                              # ISOB0,
             2835
         4008    \n\
                              # ISOB1,
             2004
         2835    \n\
                              # ISOB2,
             1417
         2004    \n\
                              # ISOB3,
             1001
         1417    \n\
                              # ISOB4,
             709
         1001    \n\
                              # ISOB5,
             499
         709     \n\
                              # ISOB6,
             354
         499     \n\
                              # ISOB7,
             249
         354     \n\
                              # ISOB8,
             176
         249     \n\
                              # ISOB9,
             125
         176     \n\
                              # ISOB10,       8
      8      125
         \n\
                              # C0,           2
      599    3676
         \n\
                              # C1,           1
      837    2599
         \n\
                              # C2,           1
      298    1837
         \n\
                              # C3,           9
      18     1296
         \n\
                              # C4,           6
      49     918
         \n\
                              # C5,           4
      59     649
         \n\
                              # C6,           3
      23     459
         \n\
                              # C7,           2
      30     323
         \n\
                              # DL,           3
      12     624
      GV.magMenu:             2,      2       \
      0 624
                              4,      4       \
      0 624
                              8,      8       \
      0 624
                              16,     16      \
      0 624
                              32,     32      \
      0 624
                              64,     64
      GV*Ghostview.background:                w
      hite
      GV*Ghostview.foreground:                b
      lack
      GV.gsInterpreter:       gs
      GV.gsCmdScanPDF:        gs -dNODISPLAY -d
      QUIET -sPDFn
      ame=%s -sDSCname=%s pdf2dsc.ps
      -c quit
      GV.gsCmdConvPDF:        gs -dNODISPLAY -d
      QUIET  -dNOP
      AUSE -sPSFile=%s %s -c
      quit
      GV.gsX11Device:         -sDEVICE=x11
      GV.gsX11AlphaDevice:    -dNOPLATFONTS -sD
      EVICE=x11alp
      ha
      GV.gsSafer:             True
      GV.gsQuiet:             True
      GV.gsArguments:
      GV.uncompressCommand:   gzip -d -c %s > %
      s
      GV.printCommand:        lpr
      GV.scratchDir:          ~/
      GV.defaultSaveDir:      ~/
      GV.fallbackPageMedia:   a4
      GV.useBackingPixmap:    True
      GV*dirs:                Home\n\
                              Tmp\n\
                              /usr/doc\n\
                              /usr/local/doc
      GV*filter:              no .*
      GV*filters:             None\n\
                              *.*ps* *.pdf*  no
        .*\n\
                              *.*ps*   no  .*\
      n\
                              *.pdf*  no  .*\n
      \
                              no  .*

## Mouse and key bindings

Mouse bindings in the Main and th e Zoom windo w
  The following mouse events are defined wh en the mouse pointer is either on the displayed page or on a z oomed area:
- press button 1, move mouse, release butt on 1
  Scrolls the displayed page 'proportionall y'.
- press button 3, move mouse, release butt on 3
  Scrolls the displayed page 'absolutely'.
- double-click with button 1
  In the main window this displays the prev ious/next pa ge if the double-click occured in the left/r ight half of the window. In a zoom window it does nothing.
- press button 2, release butt on 2
  Pops up a small menu which allows to choo se a magnifi cation for a certain area around the current mou se position. After selecting a magnification a zoom wi ndow pops up displaying the area at the chosen scale.
- press button 2, move mouse, release button 2
  This draws and thereby defines a rectangu lar region w hich can be displayed in a zoom window. The ma gnification for the area can be selected by means of a popup menu which a ppears after releasing button 2.
- press button 1, press butto n 2
  Redisplays the current page. This event s equence work s only in the main window.
- press button 3, release butt on 3
  Pops up a small menu which offers a few s tandard acti ons like 'Redisplay', 'Mark Page', etc.
Mouse bindings in the File Select ion popup
  The following mouse events are defined wh en the mouse pointer is in the window of either a file or a direc tory list:
- press button 1, move mouse, release butt on 1
  Scrolls a file or directory list 'proport ionally'.
- press button 2, move mouse, release butt on 2
  Scrolls a file or directory list 'absolut ely'.
- press button 2, release butt on 2
  Scrolls a file or directory list one page up/down if the button was pressed in the upper/lo wer half of the list.
- double-click with button 1 o n a filename
  Selects the file and closes the File Sele ction popup.
- click with button 1 on a dir ectory name
  Causes the contents of this directory to be displayed .
Mouse bindings in the Table of Co ntents
  The following mouse events are defined wh en the mouse pointer is in the window showing a list of page numb ers of the current file (table of contents):
- press button 1, move mouse, release butt on 1
  Scrolls the table of contents.
- press button 1 on a page num ber
  Go to this page.
- press button 2 on a page num ber
  Mark this page if it is unmarked, but unm ark it if it is marked.
- press button 2, move mouse, release butt on 2
  Marks/unmarks all unmarked/marked pages i n the region crossed by the mouse pointer during the m ovement.
Mouse bindings in the Panner widg et
  The Panner widget is the rectangular regi on located c lose to the left edge of the main window. It indicate s the size a nd the position of the visible area of the curre nt page rela tive to the total page. The following mouse events are defined wh en the mouse pointer is in this region:
- press button 1, move mouse
  Scrolls the displayed page.
- press button 2
  Display the previous page.
- press button 3
  Display the next page.
Mouse bindings in the
  The ">>" and "<<" buttons are used to mov e to another page. The following mouse even ts are defin ed:
- press button 1
  Move 1 page forward/backwards.
- press button 2
  Move 5 pages forward/backwards.
- press button 3
  Move 10 pages forward/backwards.
Key Bindings
  The following key events are defined in t he main wind ow. Those bindings scrolling the page are also defined in zo om popups.

      === Notation:
      s-X          means press "Shift"
        and key "X
      "
      c-X          means press "Ctrl"
        and key "X
      "
      sc-X         means press "Shift" or "Ctrl
      " and key "X
      "
      === Miscellaneous keys:
      A            Toggle antialiasing on and o
      ff
      O            Open a new file
      Q            Quit gv
      R            Toggle gv's resizing behavio
      ur
      I            Respect/Ignore document stru
      cturing
      W            Watch file / Don't watch fil
      e
      S            Save the marked pages
      sc-S         Save the current file
      P            Print the marked pages
      sc-P         Print the current file
      c-L          Redisplay the current page
      .            Redisplay the current page
      sc-.         Reopen the current file
      M            Mark the current page
      N            Unmark the current page
      === Orientation:
      7            Orientation portrait
      8            Orientation landscape
      9            Orientation upside-down
      0            Orientation seascape
      === Magnification:
      sc-6         Select the scale entry -6 relative to the
      scale 1.0
      sc-5         Select the scale entry -5 relative to the
      scale 1.0
      sc-4         Select the scale entry -4 relative to the
      scale 1.0
      sc-3         Select the scale entry -3 relative to the
      scale 1.0
      sc-2         Select the scale entry -2 relative to the
      scale 1.0
      sc-1         Select the scale entry -1 relative to the
      scale 1.0
      ^            Select the scale 1.0 (for german keyboard
      layout)
      `            Select the scale 1.0
      1            Select the scale entry 1 relative to the s
      cale 1.0
      2            Select the scale entry 2 relative to the s
      cale 1.0
      3            Select the scale entry 3 relative to the s
      cale 1.0
      4            Select the scale entry 4 relative to the s
      cale 1.0
      5            Select the scale entry 5 relative to the s
      cale 1.0
      6            Select the scale entry 6 relative to the s
      cale 1.0
      +            Select the next scale entry
      =            Select the next scale entry
      -            Select the previous scale entry
      === Navigating:
      Arrow        Scroll in the direction of the arrow
      s-Up         Scroll columns up   or jump -1 pages
      s-Down       Scroll columns down or jump  1 pages
      s-Left       Scroll rows left    or jump -1 pages
      s-Right      Scroll rows right   or jump  1 pages
      c-Up         Jump -1 pages (to top/left corner)
      c-Down       Jump  1 pages (to top/left corner)
      c-Left       Jump -5 pages (to top/left corner)
      c-Right      Jump  5 pages (to top/left corner)
      D,X,Z,Y,C    Identical to arrow up,down,left,left,right
      V            Center the page
      sc-Space     Scroll columns up   or jump -1 pages
      Space        Scroll columns down or jump  1 pages
      BackSpace    Scroll columns up   or jump -1 pages
      Insert       Jump  -5 pages
      Delete       Jump   5 pages
      Home         Go to the first page
      End          Go to the last page
      Prior        Jump  -1 pages
      Next         Jump   1 pages
      Keypad 0-9   Highlight a page number
      Keypad -     Highlight previous page number
      Keypad +     Highlight next page number
      Keypad Enter Jump to the highlighted page
      c-Enter      Jump  -1 pages
      s-Enter      Jump  -1 pages
      Enter        Jump   1 pages
      B            Jump  -1 pages
      F            Jump   1 pages

## Comments about the user interface

Scales
  The Scale menu which allows to view the documen t at different sizes is divided into two pa rts. The fir st part shows a list of available scale bases, th e second par t, separated by a line, lists the relative s cales which are applied with respect to the selected scale base. By default two scales bases are available , the Nat ural size and the Pixel based base. When choosing the Pixel based scale base a rela tive scale of 1.0 causes one postscript point to cor respond to o ne pixel on the screen. When viewing a document at a relative sca le of 1.0 using the Natural size base the pag e should app ear in its real size, as if printed on paper. For the Natural size base to work p roperly gv h as to know the correct size of the root window. Auto matic detect ion of this size unfortunately only provides approximate results, therefore it is best if it is provided by the user. To do so th e resource

         GV.screenSize:  <width> x <height>

  should be added to the SCREEN_RESOURCE S propert y of the screen the document is viewed on, with <width> a nd <height> describing the width and height of the ro ot window in units of millimeters. For instance by using the command

         echo "GV.screenSize: 396 x 291" | xrdb
       -override -
      screen

  a width of 346 mm and a height of 291 mm will be used for the Natural size scale base. Alternatively the resource

         GV.screenSize_<machine>_<disp>_<scr>:
       <width> x <
      height>

  may be added to a resource file read by g v. Here <machine> ,<disp> and ANGLED) describe the display on which gv displays the docu ment. For instance, if the display is set to Qtic.tac.toe .wo:0.1 the resource should be specified as

         GV.screenSize_tic_0_1: 396 x 291

  Note that this method doesn't work on VMS . As a last alternative the resource

         GV.screenSize:  <width> x <height>

  may be added to one of the resource files . However, f or obvious reasons this method should be used only on single user machin es.

Scrolling
  It is probably a de facto standard for us er interface s that windows are supposed to be scrolled by means of scrollbars attached to their sides. However, for various reasons the use of s crollbars has been minimized in gv. Instead, in all windows with obscured dat a, scrolling may be performed by pressing button1, moving the mouse, then releasing button1 directly in the window. This includes the displayed page, zoom popups, the table of contents and th e file and directory lists displayed in the file sel ection popup.
Displaying new versions of a docu ment
  During document creation it is usually de sirable to always display the newest version of the document in work. Instead of explicitly loading it via the file selecti on popup the most recent version can be disp layed by pressing the Redisplay button in th e main windo w (VMS users should use the Update File\ *U entry in the File menu). Choosing the Redisplay entry in the menu that p ops up when clicking with the third mouse but ton anywhere on the displayed page certainly has the same eff ect. More comfortable is the "Watch File" feat ure which ma y be switched on by selecting the correspon ding entry i n the State menu. If activated gv will ch eck every now and then if a new version of th e displayed file exists. If so it will be displayed a utomatically . By default the file is checked about once every second. Finally it may also be left to the docume nt creating program to trigger gv to update its display. To d o so the program should send the SIGHUP signal to gv. For instance at the end of a shell script generating a postscript file from latex sources the li ne

         kill -SIGHUP <gv_pid>

  may be added (here CR<gv_pid> is th e process id of gv). Executing the script and thereby cre ating a new version of the document will then also ca use the result to be displayed instantaneously. Please note that this feature is availabl e only on X1 1 R6 based systems.

## Availability

The source code of the most recent versio n of gv may be obtained from the following sources:

World Wide Web:
  http://wwwthep.physik.uni-mainz.de/~plass /gv/
Anonymous ftp:
  ftp://thep.physik.uni-mainz.de/pub/gv/

## Authors

    Johannes Plass             plass@thep.phy
    sik.uni-main
    z.de
                               Department of
    Physics
                               Johannes Guten
    berg Univers
    ity
                               Mainz, Germany
    gv is derived from GhostView 1.5, created by
              Tim Theisen      Systems Programmer
    Internet: tim@cs.wisc.edu  Department of Computer Scien
    ces
        UUCP: uwvax!tim        University of Wisconsin-Madi
    son
       Phone: (608)262-0438    1210 West Dayton Street
         FAX: (608)262-9777    Madison, WI   53706

## Suggestions and bug reports

Please send suggestions or bug reports to plass@thep. physik.uni-mainz.de.

Table of Contents

- Name
- Synopsis
- Description
- Options
- Resources
- Mouse and key bindings
- Comments about the user interface
- Availability
- Authors
- Suggestions and bug reports