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