Table of Contents

Name

gv - a PostScript and PDF previewer

Synopsis


gv [ filename 
]
   [-monochrom
e] [-grayscale] [-color]
   [-[no]safer
] [-[no]quiet] [-arguments <arguments>]
   [-page <lab
el>] [-[no]center]
   [-media <me
dia>]
   [-portrait]
 [-landscape] [-upsidedown] [-seascape]
   [-scale <n>
] [-scalebase <n>]
   [-swap] [-n
oswap]
   [-antialias
] [-noantialias]
   [-dsc] [-no
dsc]
   [-eof] [-no
eof]
   [-pixmap] [
-nopixmap]
   [-watch] [-
nowatch]
   [-?] [-h] [
-help] [-v]
   [-resize] [
-noresize]
   [-geometry 
[<width>][x<height>][{+-}<xoffset>{+-}<yoffset>]
   [-ad <resou
rce file>]
   [-style <re
source file>]
   [-spartan]
   [<other too
lkit options>]

Descriptio n

gv allows to v iew and navigate through PostScript and PDF documents on an X display by providing a user interface for the ghostscript interpreter. Please note th at gv is derived from Tim Theisen's ghostview 1.5.

Options

filena me
The name of th e file to be displayed. The file endin g ".ps" may be omitted. "filename" may point to a compressed file (gzipped, zipp ed or compressed). Viewing PDF fi les requires at least ghostscript version 4.x.
-ad <r esource file>
Read and use a dditional resources from the file <resource file >. These resource s have higher priority than those provided in the context of the -style <resource file> option.
-antia lias, -noantialias
Whether to use antialiasing.
-argum ents <arguments>
Start ghostscr ipt with additional options as specified by the string <argume nts>.
-cente r, -nocenter
Whether the pa ge should be centered automatically.
-dsc P, -nodsc
Determines if document structuring convention (DSC) comments should be resp ected or ignored. If -nodsc is u sed gv will not attempt to examine the structure of the document but will pass the file to the ghostsc ript interpreter as a whole. In this case no page numbers are shown and freely moving around in the document is not possible. This option ma y help when viewing files not conforming to the documen t structuring conventions.
-eof P, -noeof
Defines the be haviour of the postscript scanner used to examine the st ructure of the document. If -noeof is u sed the scanner will ignore end of file (EOF) comments. This may help when viewing documents which import other documents with out enclosing them within the proper "BeginDocument " and "EndDocument" comments. If -eof is use d, the scanner treats an EOF comment as marking the en d of the file.
-pixma p, -nopixmap
If -pixmap is used gv tries to maintain off-screen regions of the display ed page by allocating a sufficiently large pixmap. If -nopixmap i s used the X Server is responsible for maintaining ob scured portions of the displayed page (see also the "useBackingPixmap" resource).
-v
Print the vers ion number of gv to standard output and exit.
-h, -?
Display a shor t help message and exit.
-help\ fP
Display a more explicit help message and exit.
-scale <n>
Selects the sc ale entry <n> relative to the scale 1.0. <n> must be an integer.
-scale base <n>
Selects the sc ale base <n>.
-monoc hrome, -grayscale, -color
Sets the color palette to be used.
-media <media>
Selects the pa per size to be used. Valid values are names of paper sizes th at appear in the list of page medias as given by the medias resource.
-page <label>
Display the pa ge with label <label> first.
-portr ait, -landscape, -seascape, -upsidedown
Sets the orien tation.
-quiet , -noquiet
Whether to sta rt ghostscript with the -dQUIET option.
-resiz e, -noresize
Whether gv is allowed to automatically fit the size of its wi ndow to the size of the displayed page.
-safer , -nosafer
Whether to sta rt ghostscript with the -dSAFER option.
-spart an
This is a shor tcut for "-style gv_spartan.dat".
-style <resource file>
Read and use a dditional resources from the file <resource file>. These resource s have lower priority than those provided in the context of the -ad <resource file> option.
-swap\ fP, -noswap
Whether to int erchange the meaning of the orientations landscape and seascape.
-watch , -nowatch
The -watch opt ion causes gv to check the document periodically. If changes are detected gv will automatically display the newer version of the file. The document i s by default checked once every second. This can be ch anged via the watchFileFrequency resource. Note that send ing gv the SIGHUP signal also causes an update of t he displayed document. This method may be used by document creators to trigger gv remotely.

Resources

Resource fi les In general gv does not depend on any external resource files. However, when starting gv, preferences are read from a system sp ecific resource file. The name of th is file is as described by the "XFILESEARCHPATH" environment va riable, or, if this variable is not defined, implementation dependent. In most cases it is "/usr/X11/li b/X11/app-defaults/GV". Administrators may want to modify this file in order to set up gv a ccording to the local needs of their system. a user spec ific resource file. The name of th is file is either "~/.gv" or as described by the "XUSE RFILESEARCHPATH" environment variable. The files "g v_user.ad" and "gv_system.ad" (located in the library directory of gv, which i s most probably either "/usr/local/ lib/gv/" or "/usr/lib/gv/" may serve as a basis for constructi ng the user and system specific resource files. Note that the user and system specific resource files are not the only sources of pre ferences taken into account when gv is started. However, in pr actice these are the most important. Resources o f gv The following describes some of the resources of gv. The precise sy ntax of some of the resource values may be inferred from the appended default system specific resource file.

antialias
Whether antial iasing should be used. Valid values a re "True" and "False".
autoCente r
Whether the di splayed page should automatically be centered (for instance when opening a new file). Valid values a re "True" and "False".
autoResiz e
Whether gv is allowed to resize the main window according to t he size of the current page. Valid values a re "True" and "False".
confirmPr int
Whether printi ng requires an extra confirmation. Valid values a re "True" and "False".
confirmQu it
Whether leavin g gv requires extra confirmation. Valid values a re "0" (Never), "1" (When processi ng) and "2" (Always). The default va lue is "1", which causes a confirmation request when trying to leave gv in the presenc e of pending PDF to Postscript conversions.
scrolling EyeGuide
If this resour ce is "True" scrolling via the keyboard cause s a temporary border to be drawn around the previously vis ible area of the page. Allowed values are "True" and "False".
ignoreEOF
Defines the be haviour of the postscript scanner as described in the Options section. Valid values a re "True" and "False".
respectDS C
Determines whe ther gv should attempt to respect document structuring co mments. Valid values a re "True" and "False".
reverseSc rolling
Defines the in terpretation of directions when scrolling with the mouse. Valid values a re "True" and "False".
swapLands cape
Whether the me aning of "landscape" and "seacape" should be inte rchanged. Valid values a re "True" and "False".
scratchDi r
Specifies a di rectory used to store temporary data.
defaultSa veDir
Specifies the default destination directory for files to be saved.
useBackin gPixmap
If the value o f this resource is "False" the X Server is advised tha t saving off-screen pixels of the displayed page would be benef icial (maintaining backing store). In this case gv does not activ ely maintain the contents of the page but relies on the X Serve r. The server is, however, always free to stop maintaining ba cking backing store. If the value o f this resource is "True" the X Server is advised tha t maintaining backing store is not useful. In this case g v attempts to allocate a sufficiently large pixmap to store the c ontents of the displayed page.
watchFile
Whether the do cument should be checked periodically and updated automatically if changes are detected. Valid values a re "True" and "False".
watchFile Frequency
Defines the ti me in milliseconds elapsing between successive checks of the document when watchFile is set to "True". Allowed values must be larger than 500.
printComm and
The command us ed for printing a file. The command ma y contain multiple '%s' wildcards which will be replaced by the name of the file to be printed.
gsInterpr eter
The command us ed to start the ghostscript interpreter.
gsCmdScan PDF
The command us ed to extract document structuring comments from a PDF fil e.
gsCmdConv PDF
The command us ed to convert a PDF file to PostScript.
gsX11Devi ce
The ghostscrip t command line option which activates the "X11" devi ce.
gsX11Alph aDevice
The ghostscrip t command line option which activates the "X11" devi ce with antialiasing enabled.
gsSafer
Determines whe ther ghostscript should be started with the "-dSAFER" command line option.
gsQuiet
Determines whe ther ghostscript should be started with the "-dQUIET" command line option.
gsArgumen ts
May be used to provide additional command line options for the ghostscript in terpreter. Starting gv wi th the "-arguments <arguments>" option will ov erride this resource setting.
magMenu
Describes the menu that pops up when preparing to to zoom an are a of the displayed page.
dirs
Defines a list of directories accessible via the Directories menu in the fi le selection window. The special va lue "Home" corresponds to the users home directory, the value "T mp" corresponds to the scratch directory as defined by the scratch Dir resource.
filter
Defines the de fault filter to be used when displaying a directory contents in th e file selection window. A filter is sp ecified according to the syntax


   <filter>   
 := [<filespecs>] [no <filespecs>]
   <filespecs>
 := <filespec> [<filespecs>]
   <filespec> 
 := filename possibly including wildcards '*'
              
    which match any character.

Example: The f ilter


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

screens out al l files with names starting with a dot and keeps of t he remaining ones only those which end on ".ps" o r ".pdf".

filters
Defines a list of filters offered in the Filters menu of the fi le selection window. The filter " None" has a special meaning causing all fi les to be displayed when the corresponding menu entry is selected.
miscMenuE ntries
Describes the menu that pops up when clicking with the third mouse bu tton on the displayed page. The value of t his resource is a list of menu entries. Allowed entrie s are "update", "redisplay U, "toggle_curr ent", "toggle_even ", "toggle_odd\ *U, "unmark", "stop", "print_all U, "print_marke d", "save_all" , "save_marked " and "line".
showTitle
Whether the na me of the displayed document should be shown in the title bar of t he window. The name of gv's icon will also change accordingly if this resource is set to "True".
maximumWi dth, maximumHeight
When resizing gv will not attempt to exceed the size specified by these resou rces. These resource s may be specified as a positive integer or as "scree n", optionally combined with a positive or negative offset. The default va lues listed above provide examples for this syntax. "screen" w ill automatically be replaced by the size of the screen.
minimumWi dth, minimumHeight
Defines a mini mum size for the main window. Valid values f or both resources are positive integers larger than 200.
scale
Sets the initi al scale. The value of this resource is the offset of the scale t o be selected relative to the scale 1.0 in the the "Scale U menu.
scaleBase
Selects the in itial scale base. The value of this resource should be a positive integer.
scales
Defines the av ailable scales bases and scales in the "Scale" menu.
orientati on
Sets the initi al orientation. Valid values are "portrait" , "landscape","seascape", "upside-down " and "automatic U. "automatic U causes gv to attempt to derive the correct orientation from document structuring comments.
fallbackO rientation
Defines the pa per-size to be used when automatic orientation detection fail s. Valid values are "portrait" , "landscape","seascape" and "upside- down".
medias
A list describ ing the page medias known to gv. List entries s tarting with "!" or "#" will not appear in the "Media" me nu but will still be used for automatic paper size detection.
pagemedia
Sets the paper size. Allowed values are as given in the above list of paper-sizes. Specifying "automatic U causes gv to attempt to derive the correct paper-size from document structuring comments.
fallbackP ageMedia
Defines the pa per-size to be used when automatic paper-size detection fail s. Valid values are as given in the above list of paper- sizes. The default user and system specific resource file


GV.pageMedia: 
          automatic
GV.orientation
:         automatic
GV.fallbackOri
entation: portrait
GV.swapLandsca
pe:       False
GV.autoCenter:
          True
GV.antialias: 
          False
GV.respectDSC:
          True
GV.ignoreEOF: 
          True
GV.confirmPrin
t:        True
GV.reverseScro
lling:    False
GV.scrollingEy
eGuide:   True
GV.autoResize:
          True
GV.maximumWidt
h:        screen-20
GV.maximumHeig
ht:       screen-44
GV.minimumWidt
h:        400
GV.minimumHeig
ht:       430
GV.confirmQuit
:         1
GV.watchFile: 
          False
GV.watchFileFr
equency:  1000
GV.showTitle: 
          True
GV.miscMenuEnt
ries:     redisplay       \n\
              
          # update        \n\
              
          stop            \n\
              
          line            \n\
              
          toggle_current  \n\
              
          toggle_even     \n\
              
          toggle_odd      \n\
              
          unmark          \n\
              
          line            \n\
              
          print_all       \n\
              
          print_marked    \n\
              
          save_all        \n\
              
          save_marked
GV.scale:     
          0
GV.scaleBase: 
          1
GV.scales:    
          Natural size,   1.000,  screen  \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,          10.00
GV.medias:    
          Letter,         612     792     \n\
              
          # LetterSmall,  612     792     \n\
              
          Legal,          612     1008    \n\
              
          Statement,      396     612     \n\
              
          Tabloid,                792     1224    \n\
              
          Ledger,         1224    792     \n\
              
          Folio,          612     936     \n\
              
          Quarto,         610     780     \n\
              
          # 7x9,          504     648     \n\
              
          # 9x11,         648     792     \n\
              
          # 9x12,         648     864     \n\
              
          # 10x13,                720     936     \n\
              
          10x14,          720     1008    \n\
              
          Executive,      540     720     \n\
              
          # A0,           2384    3370    \n\
              
          # A1,           1684    2384    \n\
              
          # A2,           1191    1684    \n\
              
          A3,             842     1191    \n\
              
          A4,             595     842     \n\
              
          # A4Small,      595     842     \n\
              
          A5,             420     595     \n\
              
          # A6,           297     420     \n\
              
          # A7,           210     297     \n\
              
          # A8,           148     210     \n\
              
          # A9,           105     148     \n\
              
          # A10,          73      105     \n\
              
          # B0,           2920    4127    \n\
              
          # B1,           2064    2920    \n\
              
          # B2,           1460    2064    \n\
              
          # B3,           1032    1460    \n\
              
          B4,             729     1032    \n\
              
          B5,             516     729     \n\
              
          # B6,           363     516     \n\
              
          # B7,           258     363     \n\
              
          # B8,           181     258     \n\
              
          # B9,           127     181     \n\
              
          # B10,          91      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,       88      125     \n\
              
          # C0,           2599    3676    \n\
              
          # C1,           1837    2599    \n\
              
          # C2,           1298    1837    \n\
              
          # C3,           918     1296    \n\
              
          # C4,           649     918     \n\
              
          # C5,           459     649     \n\
              
          # C6,           323     459     \n\
              
          # C7,           230     323     \n\
              
          # DL,           312     624
GV.magMenu:   
          2,      2       \n\
              
          4,      4       \n\
              
          8,      8       \n\
              
          16,     16      \n\
              
          32,     32      \n\
              
          64,     64
GV*Ghostview.b
ackground:                white
GV*Ghostview.f
oreground:                black
GV.gsInterpret
er:       gs
GV.gsCmdScanPD
F:        gs -dNODISPLAY -dQUIET -sPDFname=%s -sDSCname=%s pdf2dsc.ps
-c quit
GV.gsCmdConvPD
F:        gs -dNODISPLAY -dQUIET  -dNOPAUSE -sPSFile=%s %s -c
quit
GV.gsX11Device
:         -sDEVICE=x11
GV.gsX11AlphaD
evice:    -dNOPLATFONTS -sDEVICE=x11alpha
GV.gsSafer:   
          True
GV.gsQuiet:   
          True
GV.gsArguments
:
GV.uncompressC
ommand:   gzip -d -c %s > %s
GV.printComman
d:        lpr
GV.scratchDir:
          ~/
GV.defaultSave
Dir:      ~/
GV.fallbackPag
eMedia:   a4
GV.useBackingP
ixmap:    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 the Zoom window
The following mouse events are defined when the mouse pointer is either on t he displayed page or on a zoomed area:
- p ress button 1, move mouse, release button 1
Scrolls the di splayed page 'proportionally'.
- p ress button 3, move mouse, release button 3
Scrolls the di splayed page 'absolutely'.
- d ouble-click with button 1
In the main wi ndow this displays the previous/next page if the double- click occured in the left/right half of the window. In a zoom wind ow it does nothing.
- p ress button 2, release button 2
Pops up a smal l menu which allows to choose a magnification for a certain area around the current mouse position. After selectin g a magnification a zoom window pops up displaying the area at the chosen scale.
- p ress button 2, move mouse, release button 2
This draws and thereby defines a rectangular region which can be display ed in a zoom window. The magnification for the area can be se lected by means of a popup menu which appears after releasing butt on 2.
- press button 1, press button 2
Redisplays the current page. This event sequence works only in the main wi ndow.
- p ress button 3, release button 3
Pops up a smal l menu which offers a few standard actions like 'Redispla y', 'Mark Page', etc.
Mouse bindings in the File Selection popup
The following mouse events are defined when the mouse pointer is in the window of either a file or a directory list:
- p ress button 1, move mouse, release button 1
Scrolls a file or directory list 'proportionally'.
- p ress button 2, move mouse, release button 2
Scrolls a file or directory list 'absolutely'.
- p ress button 2, release button 2
Scrolls a file or directory list one page up/down if the button was pressed in the upper/lower half of the list.
- d ouble-click with button 1 on a filename
Selects the fi le and closes the File Selection popup.
- c lick with button 1 on a directory name
Causes the con tents of this directory to be displayed.
Mouse bindings in the Table of Contents
The following mouse events are defined when the mouse pointer is in the window showing a list of page numbers of the current file ( table of contents):
- p ress button 1, move mouse, release button 1
Scrolls the ta ble of contents.
- p ress button 1 on a page number
Go to this pag e.
- p ress button 2 on a page number
Mark this page if it is unmarked, but unmark it if it is marked.
- p ress button 2, move mouse, release button 2
Marks/unmarks all unmarked/marked pages in the region crossed by the mouse pointer during the movement.
Mouse bindings in the Panner widget
The Panner wid get is the rectangular region located close to the left edge of t he main window. It indicates the size and the position of th e visible area of the current page relative to the total page. The following mouse events are defined when the mouse pointer is in this region :
- p ress button 1, move mouse
Scrolls the di splayed page.
- p ress button 2
Display the pr evious page.
- p ress button 3
Display the ne xt page.
Mouse bindings in the
The ">>" and " <<" buttons are used to move to another pag e. The following mouse events are defined:
- p ress button 1
Move 1 page fo rward/backwards.
- p ress button 2
Move 5 pages f orward/backwards.
- p ress button 3
Move 10 pages forward/backwards.
Key Bi ndings
The following key events are defined in the main window. Those bindings scrolling the page are also defined in zoom popups.


=== Notation:
s-X          m
eans press "Shift"           and key "X"
c-X          m
eans press "Ctrl"            and key "X"
sc-X         m
eans press "Shift" or "Ctrl" and key "X"
=== Miscellane
ous keys:
A            T
oggle antialiasing on and off
O            O
pen a new file
Q            Q
uit gv
R            T
oggle gv's resizing behaviour
I            R
espect/Ignore document structuring
W            W
atch file / Don't watch file
S            S
ave the marked pages
sc-S         S
ave the current file
P            P
rint the marked pages
sc-P         P
rint the current file
c-L          R
edisplay the current page
.           
 Redisplay the current page
sc-.         R
eopen the current file
M            M
ark the current page
N            U
nmark the current page
=== Orientatio
n:
7            O
rientation portrait
8            O
rientation landscape
9            O
rientation upside-down
0            O
rientation seascape
=== Magnificat
ion:
sc-6         S
elect the scale entry -6 relative to the scale 1.0
sc-5         S
elect the scale entry -5 relative to the scale 1.0
sc-4         S
elect the scale entry -4 relative to the scale 1.0
sc-3         S
elect the scale entry -3 relative to the scale 1.0
sc-2         S
elect the scale entry -2 relative to the scale 1.0
sc-1         S
elect the scale entry -1 relative to the scale 1.0
^            S
elect the scale 1.0 (for german keyboard layout)
`            S
elect the scale 1.0
1            S
elect the scale entry 1 relative to the scale 1.0
2            S
elect the scale entry 2 relative to the scale 1.0
3            S
elect the scale entry 3 relative to the scale 1.0
4            S
elect the scale entry 4 relative to the scale 1.0
5            S
elect the scale entry 5 relative to the scale 1.0
6            S
elect the scale entry 6 relative to the scale 1.0
+            S
elect the next scale entry
=            S
elect the next scale entry
-            S
elect the previous scale entry
=== Navigating
:
Arrow        S
croll in the direction of the arrow
s-Up         S
croll columns up   or jump -1 pages
s-Down       S
croll columns down or jump  1 pages
s-Left       S
croll rows left    or jump -1 pages
s-Right      S
croll rows right   or jump  1 pages
c-Up         J
ump -1 pages (to top/left corner)
c-Down       J
ump  1 pages (to top/left corner)
c-Left       J
ump -5 pages (to top/left corner)
c-Right      J
ump  5 pages (to top/left corner)
D,X,Z,Y,C    I
dentical to arrow up,down,left,left,right
V            C
enter the page
sc-Space     S
croll columns up   or jump -1 pages
Space        S
croll columns down or jump  1 pages
BackSpace    S
croll columns up   or jump -1 pages
Insert       J
ump  -5 pages
Delete       J
ump   5 pages
Home         G
o to the first page
End          G
o to the last page
Prior        J
ump  -1 pages
Next         J
ump   1 pages
Keypad 0-9   H
ighlight a page number
Keypad -     H
ighlight previous page number
Keypad +     H
ighlight next page number
Keypad Enter J
ump to the highlighted page
c-Enter      J
ump  -1 pages
s-Enter      J
ump  -1 pages
Enter        J
ump   1 pages
B            J
ump  -1 pages
F            J
ump   1 pages

Comments a bout the user interface

Scales
The "Scale U menu which allows to view the document at different s izes is divided into two parts. The first part shows a list o f available scale bases, the second part, separated by a line, lists the relative scales which are applied with respect t o the selected scale base. By default two scales bases are available, the "Natural size" and the "Pix el based" base. When choosing the "Pixel based" scale base a relative scale of 1.0 causes one postscript point to correspond to one pixel on the screen. When viewing a document at a relative scale of 1.0 using the "N atural size" base the page should appear in its real size, as if printed on paper. For the "Nat ural size" base to work properly gv has to know the correct si ze of the root window. Automatic detection of this size u nfortunately only provides approximate results, therefore it is best if it is provided by the user. To do so the resource


   GV.screenSi
ze:  <width> x <height>

should be adde d to the "SCREEN_RESOURCES" property of the screen the document i s viewed on, with <width> and <height> describing the width and height of the root window in units of millimeters. For instance b y using the command


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

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


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

may be added t o a resource file read by gv. Here <machine> ,<di sp> and ANGLED) describe the display on which gv displays the document. For instance, if the display is set to "tic.tac.toe.wo:0.1" the resource s hould be specified as


   GV.screenSi
ze_tic_0_1: 396 x 291

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


   GV.screenSi
ze:  <width> x <height>

may be added t o one of the resource files. However, for obvious reasons this method sh ould be used only on single user machines.

Scroll ing
It is probably a de facto standard for user interfaces that windows a re supposed to be scrolled by means of scrollbars att ached to their sides. However, for v arious reasons the use of scrollbars has been minim ized in gv. Instead, in al l windows with obscured data, scrolling may be perform ed by pressing butto n1, moving the mouse, then releasing button1 directly in th e window. This includes the displayed page, zoom popups, t he table of contents and the file and directory list s displayed in the file selection popup.
Displa ying new versions of a document
During documen t creation it is usually desirable to always display the newest version of the document in work. Instead of exp licitly loading it via the file selection popup the most recent version can be displayed by pressing the \ *QRedisplay" button in the main window (VMS users sho uld use the "Update File" entry in the "File" men u). Choosing the \ *QRedisplay" entry in the menu that pops up when clicki ng with the third mouse button anywhere on the displayed page certainly has the same effect. More comfortab le is the "Watch File" feature which may be switched on by selecting the corresponding entry in the "State" me nu. If activated gv will check every now and then if a new version of the displayed file exists. I f so it will be displayed automatically. By default the file is checked about once every second. Finally it may also be left to the document creating program to trigger gv to update its display. To do so the program should send the SIGHUP signal to gv. For instance a t the end of a shell script generating a postscript fil e from latex sources the line


   kill -SIGHU
P <gv_pid>

may be added ( here CR<gv_pid> is the process id of gv). Executing the script and thereby creating a new version of the document will then also cause the result to be d isplayed instantaneously. Please note th at this feature is available only on X11 R6 based systems.

Availabili ty

The source cod e of the most recent version of gv may be obtained from the following sources:

World Wid e Web:
http://wwwthep .physik.uni-mainz.de/~plass/gv/

Authors


Johannes Plass
             plass@thep.physik.uni-mainz.de
              
             Department of Physics
              
             Johannes Gutenberg University
              
             Mainz, Germany
gv is derived 
from GhostView 1.5, created by
          Tim 
Theisen      Systems Programmer
Internet: tim@
cs.wisc.edu  Department of Computer Sciences
    UUCP: uwva
x!tim        University of Wisconsin-Madison
   Phone: (608
)262-0438    1210 West Dayton Street
     FAX: (608
)262-9777    Madison, WI   53706

Suggestion s and bug reports

Please send su ggestions or bug reports to ckesselh@debian.org.


Table of Contents