Table of Contents

Name

gv - a PostScript and PDF previewer

Synopsis


gv [ filename ]
   [-monochrome] [-gra
yscale] [-colo
r]
   [-[no]safer] [-[no]
quiet] [-argum
ents <arguments>]
   [-page <label>] [-[
no]center]
   [-media <media>]
   [-portrait] [-lands
cape] [-upside
down] [-seascape]
   [-scale <n>] [-scal
ebase <n>]
   [-swap] [-noswap]
   [-antialias] [-noan
tialias]
   [-dsc] [-nodsc]
   [-eof] [-noeof]
   [-pixmap] [-nopixma
p]
   [-watch] [-nowatch]
   [-?] [-h] [-help] [-v]
   [-resize] [-noresize]
   [-geometry [<width>][x<height>][{+-
}<xoffset>{+-}<yoffset>]
   [-ad <resource file>]
   [-style <resource file>]
   [-spartan]
   [<other toolkit options>]

Description

gv allows to view and navigate throu gh PostScript and PDF doc uments on an X display by providing a user in terface for th e ghostscript interpreter. Please note that gv is derived from Tim Theisen's ghostview 1.5.

Options

filename
The name of the file t o be displayed . The file ending ".ps " may be omi tted. "filename" may poi nt to a compre ssed file (gzipped, zipped or co mpressed). Viewing PDF files requ ires at least ghostscript version 4.x.
-ad <resource file>
Read and use additiona l resources fr om the file <resource file>. These resources have h igher priority than those provided in the context of the -style <resour ce file> option.
-antialias, -noantiali as
Whether to use antiali asing.
-arguments <ar guments>
Start ghostscript with additional op tions as specified by the string <arguments>.
-center, B-nocenter
Whether the page shoul d be centered automatically.
-dsc, -n odsc
Determines if document structuring c onvention (DSC) comments should be respected or ignored. If -nodsc is used gv w ill not attemp t to examine the structure of the d ocument but wi ll pass the file to the ghostscript int erpreter as a whole. In this case no page numbers are shown and freely m oving around i n the document is not possible. This option may help w hen viewing fi les not conforming to the document struct uring conventi ons.
-eof, -n oeof
Defines the behaviour of the postscr ipt scanner used to examine the structure of the documen t. If -noeof is used the scanner will i gnore end of file (EOF) comments. This may hel p when viewing documents which import other documents without encl osing them wit hin the proper "BeginDocument" and "E ndDocument" co mments. If -eof is used, the s canner treats an EOF comment as marking the end of the file.
-pixmap, B-nopixmap
If -pixmap is used gv tries to maint ain off-screen regions of the displayed page by allocating a sufficiently large pixmap. If -nopixmap is used t he X Server is responsible for maintaining obscured p ortions of the displayed page (see also the "useBa ckingPixmap" resource).
-v
Print the version numb er of gv to st andard output and exit.
-h, -? P
Display a short help m essage and exi t.
-help
Display a more explici t help message and exit.
-scale <n>
Selects the scale entr y <n> relative to the scale 1.0. <n> must be an integer .
-scalebase <n>
Selects the scale base <n>.
-monochrome , -grayscal e, -color
Sets the color palette to be used.
-media <media>
Selects the paper size to be used. V alid values are names of paper sizes that appea r in the list of page medias as given by the medias resource .
-page <label>\ fP
Display the page with label <label> first.
-portrait, -landscape\ fP, -seascape, -upsidedown
Sets the orientation.
-quiet, -noquiet
Whether to start ghost script with th e -dQUIET option.
-resize, B-noresize
Whether gv is allowed to automatical ly fit the size of its window to the size of th e displayed page.
-safer, -nosafer
Whether to start ghost script with th e -dSAFER option.
-spartan
This is a shortcut for "-style gv_ spartan.dat".
-style <resour ce file>
Read and use additiona l resources fr om the file <resource file>. These resources have lower priority than those provided in the context of the -ad <resource file> option.
-swap, - noswap
Whether to interchange the meaning o f the orientations landscape and seascape .
-watch, -nowatch
The -watch option caus es gv to check the document periodically. If chang es are detecte d gv will automatically display the newer vers ion of the file. The document is by def ault checked o nce every second. This can be changed vi a the watchFil eFrequency resource. Note that sending gv t he SIGHUP sign al also causes an update of the displ ayed document. This method may be used by documen t creators to trigger gv remotely.

Resources

Resource files In general gv does not depend on any external resource files. However, when starting gv, preferenc es are read from a system specific r esource file P. The name of this file is as describe d by the "XFILESEARCHPATH" environment variable, or, if this va riable is not defined, implementation depende nt. In most ca ses it is "/usr/X11/lib/X11/ap p-defaults/GV\ *U. Administrators may wan t to modify th is file in order to set up gv according to the local needs of their system. a user specific res ource file. The name of this file is either "~/.gv" or as described by the "XUSERFILESEA RCHPATH" environment variable. The files "gv_user.a d" and "gv _system.ad" (located in the library directory of gv, which is most p robably either "/usr/local/lib/gv/\ *U or "/usr/ lib/gv/" may serve as a basis for constructing the u ser and system specific resource files. Note that the user and system specif ic resource files are not the only sources of preferences taken into ac count when gv is started. However, in practice t hese are the m ost important. Resources of gv The following describe s some of the resources of gv. The precise syntax of some of the re source values may be inferred from the appe nded default s ystem specific resource file.

antialias
Whether antialiasing s hould be used. Valid values are "Tr ue" and "False".
autoCenter
Whether the displayed page should au tomatically be centered (for instance when ope ning a new fil e). Valid values are "Tr ue" and "F alse".
autoResize
Whether gv is allowed to resize the main window according to the size of the current page. Valid values are "Tr ue" and "F alse".
confirmPrint
Whether printing requi res an extra c onfirmation. Valid values are "Tr ue" and "F alse".
confirmQuit
Whether leaving gv req uires extra co nfirmation. Valid values are "0\ *U (Never), Q1" (When processing) and "2" (Alway s). The default value is \ *Q1", which causes a confirmation request when trying t o leave gv in the presence of pen ding PDF to Po stscript conversions.
scrollingEyeGuide
If this resource is QTrue" scrol ling via the keyboard causes a temp orary border t o be drawn around the previously visible are a of the page. Allowed values are " True" and "False".
ignoreEOF
Defines the behaviour of the postscr ipt scanner as described in the Options section . Valid values are "Tr ue" and "F alse".
respectDSC
Determines whether gv should attempt to respect document structuring comments. Valid values are "Tr ue" and "F alse".
reverseScrolling
Defines the interpreta tion of direct ions when scrolling with the mou se. Valid values are "Tr ue" and "F alse".
swapLandscape
Whether the meaning of "landscape\ *U and "seacape" should be interchanged . Valid values are "Tr ue" and "F alse".
scratchDir
Specifies a directory used to store temporary data.
defaultSaveDir
Specifies the default destination di rectory for files to be saved.
useBackingPixmap
If the value of this r esource is " False" the X Server is advised that saving off-screen pi xels of the displayed page would be beneficial (m aintaining bac king store). In this case gv does not actively main tain the conte nts of the page but relies on the X Server. The s erver is, howe ver, always free to stop maintaining backing ba cking store. If the value of this r esource is " True" the X Server is advised that mainta ining backing store is not useful. In this case gv attemp ts to allocate a sufficiently large pixmap to store the contents of the display ed page.
watchFile
Whether the document s hould be check ed periodically and updated automatically if chan ges are detect ed. Valid values are "Tr ue" and "F alse".
watchFileFrequenc y
Defines the time in mi lliseconds ela psing between successive checks of the document when watchFil e is set to "True". Allowed values must be larger than 5 00.
printCommand
The command used for p rinting a file . The command may contai n multiple '%s ' wildcards which will be replaced by the name o f the file to be printed.
gsInterpreter
The command used to st art the ghosts cript interpreter.
gsCmdScanPDF
The command used to ex tract document structuring comments from a PDF file.
gsCmdConvPDF
The command used to co nvert a PDF fi le to PostScript.
gsX11Device
The ghostscript comman d line option which activates the "X11" device.
gsX11AlphaDevice
The ghostscript comman d line option which activates the "X11" device with antialiasing e nabled.
gsSafer
Determines whether gho stscript shoul d be started with the "-dSAFER" command line option.
gsQuiet
Determines whether gho stscript shoul d be started with the "-dQUIET" command line option.
gsArguments
May be used to provide additional co mmand line options for the ghostscript interprete r. Starting gv with the \ *Q-arguments < arguments>" option will override t his resource s etting.
magMenu
Describes the menu tha t pops up when preparing to to zoom an area of the displayed pag e.
dirs
Defines a list of dire ctories access ible via the Directories menu in the file selec tion window. The special value "H ome" corresp onds to the users home directory, the value "Tmp" co rresponds to t he scratch directory as defined by the scratchDir reso urce.
filter
Defines the default fi lter to be use d when displaying a directory contents in the file s election windo w. A filter is specified according to t he syntax 


   <filter>    := [<fi
lespecs>] [no 
<filespecs>]
   <filespecs> := <fil
espec> [<files
pecs>]
   <filespec>  := file
name possibly 
including wildcards '*'
                  whic
h match any ch
aracter.

Example: The filter 


   GV*filter: *.ps *.p
df no .*

screens out all files with names sta rting with a dot and keeps of the remai ning ones only those which end on ".ps" or ".pd f".

filters
Defines a list of filt ers offered in the Filters menu of the file selec tion window. The filter "None" has a special meaning causing all files to b e displayed wh en the corresponding menu entry is selected .
miscMenuEntries
Describes the menu tha t pops up when clicking with the third mouse button on the displayed page. The value of this reso urce is a list of menu 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 th e displayed do cument should be shown in the title bar of the windo w. The name of gv's icon will also change accordingly if this re source is set to "True".
maximumWidth, max imumHeight
When resizing gv will not attempt to exceed the size specified by these resources. These resources may be specified as a positive integer or as "screen", op tionally combi ned with a positive or negative offset. The default values lis ted above prov ide examples for this syntax. "screen" will auto matically be r eplaced by the size of the screen.
minimumWidth, min imumHeight
Defines a minimum size for the main window. Valid values for both resources are positive integers larger than 200.
scale
Sets the initial scale . The value of this resource is the offset of the scale to be sel ected relative to the scale 1.0 in the the "Scale" menu.
scaleBase
Selects the initial sc ale base. The value of this resource should be a positive integer.
scales
Defines the available scales bases a nd scales in the "Scale" menu.
orientation
Sets the initial orien tation. Valid values are "portrait", "lan dscape","s eascape", "upside-down" and "automatic". "automatic" causes gv to attempt to derive the correct orientation from document structuring comments.
fallbackOrientati on
Defines the paper-size to be used wh en automatic orientation detection fails. Vali d values are "portrait", "lan dscape","s eascape" and "upside-down".
medias
A list describing the page medias kn own to gv. List entries starting with "!" o r "#" will not appear in the "Media" menu but w ill still be u sed for automatic paper size detection.
pagemedia
Sets the paper size. Allowed values are as given in the a bove list of paper-sizes. Specifying "automatic" causes gv to attempt to derive the correct paper-size from document structuring comments.
fallbackPageMedia
Defines the paper-size to be used wh en automatic paper-size detection fails. Vali d values are a s given in the above list of paper-sizes. The default user an d system speci fic resource 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   
    \n\
                      
  # update    
    \n\
                      
  stop        
    \n\
                      
  line        
    \n\
                      
  toggle_curre
nt  \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\
                      
  # LetterSmal
l,  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.backgroun
d:            
    white
GV*Ghostview.foregroun
d:            
    black
GV.gsInterpreter:     
  gs
GV.gsCmdScanPDF:      
  gs -dNODISPL
AY -dQUIET -sPDFname=%s -sDSCname=%s pdf2dsc.ps
-c quit
GV.gsCmdConvPDF:      
  gs -dNODISPL
AY -dQUIET  -dNOPAUSE -sPSFile=%s %s -c
quit
GV.gsX11Device:       
  -sDEVICE=x11
GV.gsX11AlphaDevice:  
  -dNOPLATFONTS -sDEVICE=x11alpha
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 bind ings

Mouse bindings in the Main a nd the Zoom window
The following mouse ev ents are defin ed when the mouse pointer is either on the displ ayed page or o n a zoomed area:
- press but ton 1, move mo use, release button 1
Scrolls the displayed page 'proporti onally'.
- press but ton 3, move mo use, release button 3
Scrolls the displayed page 'absolute ly'.
- double-cl ick with butto n 1
In the main window thi s displays the previous/next page if the double-click oc cured in the l eft/right half of the window. In a zoom window it do es nothing.
- press but ton 2, release button 2
Pops up a small menu w hich allows to choose a magnification for a certain area aro und the curren t mouse position. After selecting a magn ification a zo om window pops up displaying the area at the chosen sc ale.
- press but ton 2, move mo use, release button 2
This draws and thereby defines a rec tangular region which can be displayed in a zoom window. T he magnification for the area can be selected b y means of a p opup menu which appears after releasing button 2.
- press bu tton 1, press button 2
Redisplays the current page. This ev ent sequence works only in the main window.
- press but ton 3, release button 3
Pops up a small menu w hich offers a few standard actions like 'Redisplay', 'Mar k Page', etc.
Mouse bindings in the File S election popup
The following mouse ev ents are defin ed when the mouse pointer is in the window of eithe r a file or a directory list:
- press but ton 1, move mo use, release button 1
Scrolls a file or dire ctory list 'pr oportionally'.
- press but ton 2, move mo use, release button 2
Scrolls a file or dire ctory list 'ab solutely'.
- press but ton 2, release button 2
Scrolls a file or dire ctory list one page up/down if the button was pres sed in the upp er/lower half of the list.
- double-cl ick with butto n 1 on a filename
Selects the file and c loses the File Selection popup.
- click wit h button 1 on a directory name
Causes the contents of this director y to be displayed.
Mouse bindings in the Table of Contents
The following mouse ev ents are defin ed when the mouse pointer is in the window showing a list of page numbers of the current file (table of contents):
- press but ton 1, move mo use, release button 1
Scrolls the table of c ontents.
- press but ton 1 on a pag e number
Go to this page.
- press but ton 2 on a pag e number
Mark this page if it i s unmarked, bu t unmark it if it is marked.
- press but ton 2, move mo use, release button 2
Marks/unmarks all unma rked/marked pa ges in the region crossed by the mouse p ointer during the movement.
Mouse bindings in the Panner widget
The Panner widget is t he rectangular region located close to the left edge of the main window. It ind icates the size and the position of the visibl e area of the current page relative to the total page. The following mouse ev ents are defin ed when the mouse pointer is in this region:
- press but ton 1, move mo use
Scrolls the displayed page.
- press but ton 2
Display the previous p age.
- press but ton 3
Display the next page.
Mouse bindings in the
The ">>" and "<<" butt ons are used t o move to another page. The f ollowing mouse events are defined:
- press but ton 1
Move 1 page forward/ba ckwards.
- press but ton 2
Move 5 pages forward/b ackwards.
- press but ton 3
Move 10 pages forward/ backwards.
Key Bindings P
The following key even ts are defined in the main window. Those bindings scrolling the page are also defined in zoom popups. 


=== Notation:
s-X          means pre
ss "Shift"    
       and key "X"
c-X          means pre
ss "Ctrl"     
       and key "X"
sc-X         means pre
ss "Shift" or 
"Ctrl" and key "X"
=== Miscellaneous keys
:
A            Toggle an
tialiasing on 
and off
O            Open a ne
w file
Q            Quit gv
R            Toggle gv
's resizing be
haviour
I            Respect/I
gnore document
 structuring
W            Watch fil
e / Don't watc
h file
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 p
age
.            Redispl
ay the current
 page
sc-.         Reopen th
e current file
M            Mark the 
current page
N            Unmark th
e current page
=== Orientation:
7            Orientati
on portrait
8            Orientati
on landscape
9            Orientati
on upside-down
0            Orientati
on seascape
=== Magnification:
sc-6         Select th
e scale entry -6 relative to the scale 1.0
sc-5         Select th
e scale entry -5 relative to the scale 1.0
sc-4         Select th
e scale entry -4 relative to the scale 1.0
sc-3         Select th
e scale entry -3 relative to the scale 1.0
sc-2         Select th
e scale entry -2 relative to the scale 1.0
sc-1         Select th
e scale entry -1 relative to the scale 1.0
^            Select th
e scale 1.0 (for german keyboard layout)
`            Select th
e scale 1.0
1            Select th
e scale entry 1 relative to the scale 1.0
2            Select th
e scale entry 2 relative to the scale 1.0
3            Select th
e scale entry 3 relative to the scale 1.0
4            Select th
e scale entry 4 relative to the scale 1.0
5            Select th
e scale entry 5 relative to the scale 1.0
6            Select th
e scale entry 6 relative to the scale 1.0
+            Select th
e next scale entry
=            Select th
e next scale entry
-            Select th
e previous scale entry
=== Navigating:
Arrow        Scroll in
 the direction of the arrow
s-Up         Scroll co
lumns up   or jump -1 pages
s-Down       Scroll co
lumns down or jump  1 pages
s-Left       Scroll ro
ws left    or jump -1 pages
s-Right      Scroll ro
ws right   or jump  1 pages
c-Up         Jump -1 p
ages (to top/left corner)
c-Down       Jump  1 p
ages (to top/left corner)
c-Left       Jump -5 p
ages (to top/left corner)
c-Right      Jump  5 p
ages (to top/left corner)
D,X,Z,Y,C    Identical
 to arrow up,down,left,left,right
V            Center th
e page
sc-Space     Scroll co
lumns up   or jump -1 pages
Space        Scroll co
lumns down or jump  1 pages
BackSpace    Scroll co
lumns 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 t
he 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 w hich allows to view the document at different sizes is divided into t wo parts. The first part shows a list of availa ble scale base s, the second part, separated by a line, l ists the relat ive scales which are applied with respect to the se lected scale b ase. By default two scales bases are avai lable, the "Natural size" and the "Pixel based " base. When choosing the "P ixel based" scale base a relative scale of 1.0 causes one post script point t o correspond to one pixel on the screen. When viewing a documen t at a relativ e scale of 1.0 using the "Natural s ize" base th e page should appear in its real size, as if print ed on paper. For the "Natural siz e" base to w ork properly gv has to know the correct size of th e root window. Automatic detection of this size unfortuna tely only prov ides approximate results, therefore it is best if it is pr ovided by the user. To do so the resource 


   GV.screenSize:  <wi
dth> x <height
>

should be added to the "SCREEN_RES OURCES" property of the screen the document is viewed on, with <wid th> and <height> describing the width a nd height of t he root 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 29 1 mm will be used for the "Natural size" sca le base. Alternatively the reso urce 


   GV.screenSize_<mach
ine>_<disp>_<s
cr>:  <width> x <height>

may be added to a reso urce file read by gv. Here <machine> ,<disp> and ANGLED) descri be the display on which g v displays the document. For instance, if the d isplay is set to "tic.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 o n VMS. As a last alternative the resource 


   GV.screenSize:  <wi
dth> x <height
>

may be added to one of the resource files. However, for obvious reasons this method should be used only on s ingle user machines.

Scrolling
It is probably a de fa cto standard f or user interfaces that windows are suppo sed to be scro lled by means of scrollbars attached to their sides. However, for various r easons the use of scrollbars has been minimized in gv. Instead, in all window s with obscure d data, scrolling may be performed by pressing button1, movi ng the mouse, then releasing button1 directly in the window . This include s the displayed page, zoom popups, the table of contents a nd the file and directory lists displa yed in the fil e selection popup.
Displaying new versions of a document
During document creati on it is usual ly desirable to always display the new est version of the document in work. Instead of explicitly loading it via the file selection popup the most recent version can be displayed by pressing the "Redisp lay" button in the main window (VMS users should use the "Update File" entry in the "File" menu). Choosing the "Redisp lay" entry i n the menu that pops up when clicking with the third mous e button anywhere on the displayed page certain ly has the sam e effect. More comfortable is th e "Watch File" feature which may be switched on by sele cting the corr esponding entry in the "State" menu. If a ctivated gv wi ll check every now and then if a new version of the displayed file exists. If so it will be displa yed automatically. By default the file is checked about once every second. Finally it may also be left to the d ocument creating program to trigger gv to updat e its display. To do so the program should send th e SIGHUP signa l to gv. For instance at the en d of a shell s cript generating a postscript file from l atex sources t he line 


   kill -SIGHUP <gv_pi
d>

may be added (here CR<gv_pid> is the process id of gv). Executing the scr ipt and thereb y creating a new version of the documen t will then al so cause the result to be displayed instantaneous ly. Please note that this feature is ava ilable only on X11 R6 based systems.

Availability

The source code of the most recent v ersion of gv may be obtained from the foll owing sources:

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

Authors


Johannes Plass        
     plass@the
p.physik.uni-mainz.de
                      
     Departmen
t of Physics
                      
     Johannes 
Gutenberg University
                      
     Mainz, Ge
rmany
gv is derived from Gho
stView 1.5, cr
eated by
          Tim Theisen 
     Systems P
rogrammer
Internet: tim@cs.wisc.
edu  Departmen
t of Computer Sciences
    UUCP: uwvax!tim   
     Universit
y of Wisconsin-Madison
   Phone: (608)262-043
8    1210 West
 Dayton Street
     FAX: (608)262-977
7    Madison, 
WI   53706

Suggestions and bu g reports

Please send suggestion s or bug repor ts to ckesselh@debian.org.

Table of Contents