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]cent
er]
   [-media <media
>]
   [-portrait] [-
landscape] [
-upsidedown] [-seascape]
   [-scale <n>] [
-scalebase <
n>]
   [-swap] [-nosw
ap]
   [-antialias] [
-noantialias
]
   [-dsc] [-nodsc
]
   [-eof] [-noeof
]
   [-pixmap] [-no
pixmap]
   [-watch] [-now
atch]
   [-?] [-h] [-he
lp] [-v]
   [-resize] [-no
resize]
   [-geometry [<w
idth>][x<hei
ght>][{+-}<xoffset>{+-}<yoffset>]
   [-ad <resource
 file>]
   [-style <resou
rce file>]
   [-spartan]
   [<other toolki
t options>]

Description

gv allows to view and navigat e through PostScript and PD F documents on an X display by providing a us er interface for the ghostscript interpreter. Please note that gv is derive d from Tim Theisen's ghostview 1.5.

Options

filename\ fP
The name of the f ile to be di splayed. The file ending \ *Q.ps" may be omitted. "filename" ma y point to a compressed file (gzipped, zipped or compresse d). Viewing PDF files requires at least ghostscript version 4.x.
-ad <reso urce file> P
Read and use addi tional resou rces from the file <resource file>. These resources h ave higher p riority than those provided in the context of the -style <resource file> option.
-antialia s, -no antialias
Whether to use an tialiasing.
-argument s <arguments >
Start ghostscript with additi onal options as specified by the string <arguments >.
-center P, -nocen ter
Whether the page should be ce ntered automatically.
-dsc, -nodsc
Determines if doc ument struct uring convention (DSC) comments should be respect ed or ignore d. If -nodsc is used gv will not attempt to examine the structure of the document but will pass the file to the ghostscrip t interprete r as a whole. In this case no page numbers are shown and fre ely moving a round in the document is not possible. This option may h elp when vie wing files not conforming to the document s tructuring c onventions.
-eof, -noeof
Defines the behav iour of the postscript scanner used to examine the struc ture of the document. If -noeof is used the scanner will ignore end of file (EOF) comments. This ma y help when viewing documents which import other documents without enclosing t hem within the proper "BeginDocument" a nd "EndDocum ent" comments. If -eof is used, the scanner treats an EOF comment as marking the end o f the file.
-pixmap P, -nopix map
If -pixmap is use d gv tries t o maintain off-screen regions of the displayed page by allo cating a sufficiently large pixmap. If -nopixmap is u sed the X Se rver is responsible for maintaining obscu red portions of the displayed page (see also the " useBackingPi xmap" resource).
-v
Print the version number of g v to standard output and exit.
-h, B-?
Display a short h elp message and exit.
-help
Display a more ex plicit help message and exit.
-scale <n >
Selects the scale entry <n> r elative to the scale 1.0. <n> must be an in teger.
-scalebas e <n>
Selects the scale base <n>.
-monochro me, -g rayscale, -color
Sets the color pa lette to be used.
-media <m edia>
Selects the paper size to be used. Valid values are names of paper sizes that appear in th e list of page medias as given by the medias res ource.
-page <la bel>
Display the page with label < label> first.
-portrait , -lan dscape, -seascape, -upsidedown
Sets the orientat ion.
-quiet , -noquie t
Whether to start ghostscript with the -dQUIET option.
-resize P, -nores ize
Whether gv is all owed to auto matically fit the size of its windo w to the siz e of the displayed page.
-safer , -nosafe r
Whether to start ghostscript with the -dSAFER option.
-spartan\ fP
This is a shortcu t for "-st yle gv_spartan.dat".
-style <r esource file >
Read and use addi tional resou rces from the file <resource file>. These resources h ave lower p riority than those provided in the context of the -ad <re source file> option.
-swap, -noswap\ fP
Whether to interc hange the me aning of the orientations landscape and sea scape.
-watch , -nowatc h
The -watch option causes gv t o check the document periodically. If changes are detected gv will automatically dis play the new er version of the file. The document is b y default ch ecked once every second. This can be chang ed via the w atchFileFrequency resource. Note that sending gv the SIGH UP signal also causes an update of the displayed do cument. This method may be used by do cument creat ors to trigger gv remotely.

Resources

Resource files In general gv doe s not depend on any external resource files. However, when sta rting gv, pr eferences are read from a system speci fic resource file. The name of this file is as d escribed by the "XFILESEARCHPATH" environment varia ble, or, if this variable is not defined, implementation de pendant. In most cases it is "/usr/X11/lib/X 11/app-defau lts/GV". Administrators ma y want to mo dify this file in order to set up gv acco rding to the local needs of their system. a user specifi c resource f ile. The name of this file is eith er "~/.gv" or as described by the "XUSERFI LESEARCHPATH " environment variable. The files "gv_u ser.ad" an d "gv_system.ad" (located in the library directory of gv, which is m ost probably either "/usr/local/lib /gv/" or \ *Q/usr/lib/gv/" may serve as a basis for constructing the user and system specific resource files. Note that the use r and system specific resource files are not the only sources of prefer ences taken into account when gv is started. However, in pract ice these ar e the most important. Resources of g v The following des cribes some of the resources of gv. The precise synta x of some of the resource values may be inferred from the appended de fault system specific resource file.

antialias
Whether antialias ing should b e used. Valid values are "True" a nd "False".
autoCenter
Whether the displ ayed page sh ould automatically be centered (for instance whe n opening a new file). Valid values are "True" a nd "False".
autoResize
Whether gv is all owed to resi ze the main window according to the size of the current page. Valid values are "True" a nd "False".
confirmPrint
Whether printing requires an extra confirmation. Valid values are "True" a nd "False".
confirmQuit
Whether leaving g v requires e xtra confirmation. Valid values are "0" (Nev er), "1" (When processing) and "2" (Always). The default value is "1", which causes a confirmation re quest when t rying to leave gv in the presence o f pending PD F to Postscript conversions.
scrollingEye Guide
If this resource is "True U scrolling via the keyboard causes a temporary b order to be drawn around the previously visibl e area of th e page. Allowed values ar e "True" and "False".
ignoreEOF
Defines the behav iour of the postscript scanner as described in the Options se ction. Valid values are "True" a nd "False".
respectDSC
Determines whethe r gv should attempt to respect document structuring comme nts. Valid values are "True" a nd "False".
reverseScrol ling
Defines the inter pretation of directions when scrolling with th e mouse. Valid values are "True" a nd "False".
swapLandscap e
Whether the meani ng of "lan dscape" and "seacape" should be interch anged. Valid values are "True" a nd "False".
scratchDir
Specifies a direc tory used to store temporary data.
defaultSaveD ir
Specifies the def ault destina tion directory for files to be saved.
useBackingPi xmap
If the value of t his resource is "False" the X Server is advised that s aving off-sc reen pixels of the displayed page would be benefici al (maintain ing backing store). In this case gv does not actively maintain th e contents of the page but relies on the X Server. The server i s, however, always free to stop maintaining backi ng backing s tore. If the value of t his resource is "True" the X Server is advised that m aintaining b acking store is not useful. In this case gv a ttempts to a llocate a sufficiently large pixmap to store the cont ents of the displayed page.
watchFile
Whether the docum ent should b e checked periodically and updated automatically if changes are detected. Valid values are "True" a nd "False".
watchFileFre quency
Defines the time in milliseco nds elapsing between successive checks of the doc ument when w atchFile is set to "True". Allowed values mu st be larger than 500.
printCommand
The command used for printing a file. The command may c ontain multi ple '%s' wildcards which will be rep laced by the name of the file to be printed.
gsInterprete r
The command used to start the ghostscript interpreter.
gsCmdScanPDF
The command used to extract d ocument structuring comments from a PDF file.
gsCmdConvPDF
The command used to convert a PDF file to PostScript.
gsX11Device
The ghostscript c ommand line option which activates the "X11" device.
gsX11AlphaDe vice
The ghostscript c ommand line option which activates the "X11" device with antiali asing enabled.
gsSafer
Determines whethe r ghostscrip t should be started with the "-dSAFER" com mand line op tion.
gsQuiet
Determines whethe r ghostscrip t should be started with the "-dQUIET" com mand line op tion.
gsArguments
May be used to pr ovide additi onal command line options for the ghostscript inter preter. Starting gv with the "-argu ments <arguments>" option will overr ide this res ource setting.
magMenu
Describes the men u that pops up when preparing to to zoom an area o f the displa yed page.
dirs
Defines a list of directories accessible via the Directories menu in the file selection wi ndow. The special value "Home" corresponds to the users home directory, the value "Tmp\ *U correspon ds to the scratch directory as defined by the scratchDir resource.
filter
Defines the defau lt filter to be used when displaying a directory contents in the f ile selectio n window. A filter is speci fied accordi ng to the syntax


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

Example: The filt er


   GV*filter: *.p
s *.pdf no .
*

screens out all f iles with na mes starting with a dot and keeps of the remaining on es only those which end on ".ps" or \ *Q.pdf".

filters
Defines a list of filters off ered in the Filters menu of the file selection wi ndow. The filter "Non e" has a s pecial meaning causing all files to be displ ayed when the corresponding menu entry is sel ected.
miscMenuEntr ies
Describes the men u that pops up when clicking with the third mouse butto n on the dis played page. The value of this resource is a list of menu entries. Allowed entries a re "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 displ ayed document should be shown in the title bar of the window. The name of gv's icon will also change accordingly if th is resource is set to "True".
maximumWidth , maximumHei ght
When resizing gv will not att empt to exceed the size specified by these resource s. These resources m ay be specif ied as a positive integer or as "screen U, optionall y combined with a positive or neg ative offset . The default value s listed abo ve provide examples for this syntax. "screen" will automatical ly be replaced by the size of the screen.
minimumWidth , minimumHei ght
Defines a minimum size for th e main window. Valid values for both resourc es are positive integers larger than 200.
scale
Sets the initial scale. The v alue of this resource is the offset of the scale to b e selected r elative to the scale 1.0 in the the "Scale" m enu.
scaleBase
Selects the initi al scale bas e. The value of this resource should be a positive int eger.
scales
Defines the avail able scales bases and scales in the "Scale" menu.
orientation
Sets the initial orientation. Valid values are "portrait", \ *Qlandscape\ *U,"seascape", "upside-down" and "automatic". "automatic" c auses gv to attempt to derive the cor rect orienta tion from document structuring comments.
fallbackOrie ntation
Defines the paper -size to be used when automatic orientation detetction fails. Valid valu es are "portrait", \ *Qlandscape\ *U,"seascape" and "upside-dow n".
medias
A list describing the page me dias known to gv. List entries star ting with Q!" or "#" will not appear in the "Media" menu but will sti ll be used for automatic paper size detection.
pagemedia
Sets the paper si ze. Allowd values are as given in the above list of paper-sizes. Specifying "automatic" c auses gv to attempt to derive the cor rect paper-s ize from document structuring comments.
fallbackPage Media
Defines the paper -size to be used when automatic paper-size detetction fails. Valid valu es are as given in the above list of paper-siz es. The default us er and syste m specific resource file


GV.pageMedia:    
       autom
atic
GV.orientation:  
       autom
atic
GV.fallbackOrient
ation: portr
ait
GV.swapLandscape:
       False
GV.autoCenter:   
       True
GV.antialias:    
       False
GV.respectDSC:   
       True
GV.ignoreEOF:    
       True
GV.confirmPrint: 
       True
GV.reverseScrolli
ng:    False
GV.scrollingEyeGu
ide:   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.watchFileFrequ
ency:  1000
GV.showTitle:    
       True
GV.miscMenuEntrie
s:     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.back
ground:                white
GV*Ghostview.fore
ground:                black
GV.gsInterpreter:
       gs
GV.gsCmdScanPDF: 
       gs -dNODISPLAY -dQUIET -sPDFname=%s -sDSCname=%s pdf2dsc.ps
-c quit
GV.gsCmdConvPDF: 
       gs -dNODISPLAY -dQUIET  -dNOPAUSE -sPSFile=%s %s -c
quit
GV.gsX11Device:  
       -sDEVICE=x11
GV.gsX11AlphaDevi
ce:    -dNOPLATFONTS -sDEVICE=x11alpha
GV.gsSafer:      
       True
GV.gsQuiet:      
       True
GV.gsArguments:
GV.uncompressComm
and:   gzip -d -c %s > %s
GV.printCommand: 
       lpr
GV.scratchDir:   
       ~/
GV.defaultSaveDir
:      ~/
GV.fallbackPageMe
dia:   a4
GV.useBackingPixm
ap:    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 bin dings in the Main and the Zoom window
The following mou se events ar e defined when the mouse pointer is either on the displayed pa ge or on a zoomed area:
- pres s button 1, move mouse, release button 1
Scrolls the displ ayed page 'p roportionally'.
- pres s button 3, move mouse, release button 3
Scrolls the displ ayed page 'a bsolutely'.
- doub le-click wit h button 1
In the main windo w this displ ays the previous/next page if the double-cli ck occured i n the left/right half of the window. In a zoom window it does noth ing.
- pres s button 2, release button 2
Pops up a small m enu which al lows to choose a magnification for a certain are a around the current mouse position. After selecting a magnificati on a zoom window pops up displaying the ar ea at the ch osen scale.
- pres s button 2, move mouse, release button 2
This draws and th ereby define s a rectangular region which can be displayed in a zoom wi ndow. The magnification for the area can be selec ted by means of a popup menu which appears after releasing button 2.
- pre ss button 1, press button 2
Redisplays the cu rrent page. This event sequence works only in the main windo w.
- pres s button 3, release button 3
Pops up a small m enu which of fers a few standard actions like 'Redisplay', 'Mark Page' , etc.
Mouse bin dings in the File Selection popup
The following mou se events ar e defined when the mouse pointer is in the window of either a fil e or a directory list:
- pres s button 1, move mouse, release button 1
Scrolls a file or directory l ist 'proportionally'.
- pres s button 2, move mouse, release button 2
Scrolls a file or directory l ist 'absolutely'.
- pres s button 2, release button 2
Scrolls a file or directory l ist one page up/down if the button was pressed in the upper/lower half of the list.
- doub le-click wit h button 1 on a filename
Selects the file and closes t he File Selection popup.
- clic k with butto n 1 on a directory name
Causes the conten ts of this d irectory to be displayed.
Mouse bin dings in the Table of Contents
The following mou se events ar e defined when the mouse pointer is in the window sho wing a list of page numbers of the current file (tab le of conten ts):
- pres s button 1, move mouse, release button 1
Scrolls the table of contents .
- pres s button 1 o n a page number
Go to this page.
- pres s button 2 o n a page number
Mark this page if it is unmar ked, but unmark it if it is marked.
- pres s button 2, move mouse, release button 2
Marks/unmarks all unmarked/ma rked pages in the region crossed by the mo use pointer during the movement.
Mouse bin dings in the Panner widget
The Panner widget is the rect angular region located close to the left edge of the main window. It indicates the size and the position of the v isible area of the current page relative to the total page. The following mou se events ar e defined when the mouse pointer is in this region:
- pres s button 1, move mouse
Scrolls the displ ayed page.
- pres s button 2
Display the previ ous page.
- pres s button 3
Display the next page.
Mouse bin dings in the
The ">>" and "<<" buttons are used to move to another page. The followin g mouse events are defined:
- pres s button 1
Move 1 page forwa rd/backwards .
- pres s button 2
Move 5 pages forw ard/backward s.
- pres s button 3
Move 10 pages for ward/backwar ds.
Key Bindi ngs
The following key events are defined in the main window. Those bindings scrolling the pag e are also d efined in zoom popups.


=== Notation:
s-X          mean
s press "Shi
ft"           and key "X"
c-X          mean
s press "Ctr
l"            and key "X"
sc-X         mean
s press "Shi
ft" or "Ctrl" and key "X"
=== Miscellaneous
 keys:
A            Togg
le antialias
ing on and off
O            Open
 a new file
Q            Quit
 gv
R            Togg
le gv's resi
zing behaviour
I            Resp
ect/Ignore d
ocument structuring
W            Watc
h file / Don
't watch file
S            Save
 the marked 
pages
sc-S         Save
 the current
 file
P            Prin
t the marked
 pages
sc-P         Prin
t the curren
t file
c-L          Redi
splay the cu
rrent page
.            Re
display the 
current page
sc-.         Reop
en the curre
nt file
M            Mark
 the current
 page
N            Unma
rk the curre
nt page
=== Orientation:
7            Orie
ntation port
rait
8            Orie
ntation land
scape
9            Orie
ntation upsi
de-down
0            Orie
ntation seas
cape
=== Magnification
:
sc-6         Sele
ct the scale
 entry -6 relative to the scale 1.0
sc-5         Sele
ct the scale
 entry -5 relative to the scale 1.0
sc-4         Sele
ct the scale
 entry -4 relative to the scale 1.0
sc-3         Sele
ct the scale
 entry -3 relative to the scale 1.0
sc-2         Sele
ct the scale
 entry -2 relative to the scale 1.0
sc-1         Sele
ct the scale
 entry -1 relative to the scale 1.0
^            Sele
ct the scale
 1.0 (for german keyboard layout)
`            Sele
ct the scale
 1.0
1            Sele
ct the scale
 entry 1 relative to the scale 1.0
2            Sele
ct the scale
 entry 2 relative to the scale 1.0
3            Sele
ct the scale
 entry 3 relative to the scale 1.0
4            Sele
ct the scale
 entry 4 relative to the scale 1.0
5            Sele
ct the scale
 entry 5 relative to the scale 1.0
6            Sele
ct the scale
 entry 6 relative to the scale 1.0
+            Sele
ct the next 
scale entry
=            Sele
ct the next 
scale entry
-            Sele
ct the previ
ous scale entry
=== Navigating:
Arrow        Scro
ll in the di
rection of the arrow
s-Up         Scro
ll columns u
p   or jump -1 pages
s-Down       Scro
ll columns d
own or jump  1 pages
s-Left       Scro
ll rows left
    or jump -1 pages
s-Right      Scro
ll rows righ
t   or jump  1 pages
c-Up         Jump
 -1 pages (t
o top/left corner)
c-Down       Jump
  1 pages (t
o top/left corner)
c-Left       Jump
 -5 pages (t
o top/left corner)
c-Right      Jump
  5 pages (t
o top/left corner)
D,X,Z,Y,C    Iden
tical to arr
ow up,down,left,left,right
V            Cent
er the page
sc-Space     Scro
ll columns u
p   or jump -1 pages
Space        Scro
ll columns d
own or jump  1 pages
BackSpace    Scro
ll columns u
p   or jump -1 pages
Insert       Jump
  -5 pages
Delete       Jump
   5 pages
Home         Go t
o the first 
page
End          Go t
o the last p
age
Prior        Jump
  -1 pages
Next         Jump
   1 pages
Keypad 0-9   High
light a page
 number
Keypad -     High
light previo
us page number
Keypad +     High
light next p
age number
Keypad Enter Jump
 to the high
lighted page
c-Enter      Jump
  -1 pages
s-Enter      Jump
  -1 pages
Enter        Jump
   1 pages
B            Jump
  -1 pages
F            Jump
   1 pages

Comments abou t the user i nterface

Scales
The "Scale" m enu which al lows to view the document at different size s is divided into two parts. The first part shows a list of a vailable sca le bases, the second part, separated by a li ne, lists th e relative scales which are applied with respect to t he selected scale base. By default two sc ales bases a re available, the "Natural size" and the "Pixel based" bas e. When choosing the "Pixel ba sed" scale base a relative scale of 1.0 causes one postscript point to correspond to one pixel on the screen. When viewing a do cument at a relative scale of 1.0 using the "Natu ral size" base the page should appear in its real size, as if printed on p aper. For the "Natura l size" ba se to work properly gv has to know the correct size of the root window. Automatic detection of this size unfo rtunately on ly provides approximate results, therefore it is best if it is provided by the user. To do so the resource


   GV.screenSize:
  <width> x 
<height>

should be added t o the "SCR EEN_RESOURCES" property of the screen the document is v iewed on, wi th <width> and <height> describing the wi dth and heig ht of the root window in units of millimeters. For instance by u sing the com mand


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

a width of 346 mm and a heigh t of 291 mm will be used for the "Natural size U scale base . Alternatively the resource


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

may be added to a resource fi le read by gv. Here <machine> ,<disp> and ANGLED) describe the display on wh ich gv displ ays the document. For instance, if the display is set to "tic.tac.toe.wo:0.1" the resource shou ld be specif ied as


   GV.screenSize_
tic_0_1: 396
 x 291

Note that this me thod doesn't work on VMS. As a last alterna tive the res ource


   GV.screenSize:
  <width> x 
<height>

may be added to o ne of the re source files. However, for obvious reasons this method shoul d be used on ly on single user machines.

Scrolling
It is probably a de facto sta ndard for user interfaces that windows are supposed to be scrolled by means of scrollbars attach ed to their sides. However, for vari ous reasons the use of scrollbars has been minimize d in gv. Instead, in all w indows with obscured data, scrolling may be performed by pressing button1, moving the mouse, then releasing button1 directly in the w indow. This includes the displayed page, zoom popups, the table of con tents and the file and directory lists d isplayed in the file selection popup.
Displayin g new versio ns of a document
During document c reation it i s usually desirable to always display th e newest ver sion of the document in work. Instead of explic itly loading it via the file selection popup the most re cent version can be displayed by pressing the "R edisplay" button in the main window (VMS users should use the " Update File" entry in the "File" menu). Choosing the "Redisplay" en try in the menu that pops up when clicking with the third mouse button anywhere on the displayed page certainly has th e same effect. More comfortable is the "Watc h File" feature which may be switched on by selecting t he corresponding entry in the "State" menu. If activate d gv will check every now and the n if a new v ersion of the displayed file exists. If s o it will be displayed automatically. By default the fi le is checke d about once every second. Finally it may al so be left t o the document creating program to trigger gv to update its d isplay. To do so the program should se nd the SIGHU P signal to gv. For instance at t he end of a shell script generating a postscript file f rom latex so urces the line


   kill -SIGHUP <
gv_pid>

may be added (her e CR<gv_p id> is the process id of gv). Executing th e script and thereby creating a new version of the do cument will then also cause the result to be disp layed instan taneously. Please note that this feature is available only on X11 R6 based systems.

Availability

The source code o f the most r ecent version of gv may be obtained from the following s ources:

World Wide W eb:
http://wwwthep.ph ysik.uni-mai nz.de/~plass/gv/
Anonymous ft p:
ftp://thep.physik .uni-mainz.d e/pub/gv/

Authors


Johannes Plass   
          pl
ass@thep.physik.uni-mainz.de
                 
          De
partment of Physics
                 
          Jo
hannes Gutenberg University
                 
          Ma
inz, Germany
gv is derived fro
m GhostView 
1.5, created by
          Tim The
isen      Sy
stems Programmer
Internet: tim@cs.
wisc.edu  De
partment of Computer Sciences
    UUCP: uwvax!t
im        Un
iversity of Wisconsin-Madison
   Phone: (608)26
2-0438    12
10 West Dayton Street
     FAX: (608)26
2-9777    Ma
dison, WI   53706

Suggestions a nd bug repor ts

Please send sugge stions or bu g reports to plass@thep.physik.uni-mainz.de.


Table of Contents