Name

Synopsis

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

Descriptio n

gv allows to v iew and naviga te through PostScript and PDF documents on an X display by providing a user interfac e for the ghostscript interpreter. Please note th at gv is deriv ed from Tim Theisen's ghostview 1.5.

Options

filena me

The name of th e file to be d isplayed. The file endin g ".ps" ma y be omitted. "filename" may point to a compressed file (gzipped, zipp ed or compress ed). Viewing PDF fi les requires a t least ghostscript version 4.x.

-ad <r esource file>\ fP

Read and use a dditional reso urces from the file <resource file >. These resource s have higher priority than those provided in the context of the -style <resource file> option.

-antia lias, -n oantialias

Whether to use antialiasing.

-argum ents <arguments>

Start ghostscr ipt with addit ional options as specified by the string <argume nts>.

-cente r, -noce nter

Whether the pa ge should be c entered automatically.

-dsc P, -nodsc P

Determines if document struc turing convention (DSC) comments should be resp ected or ignor ed. If -nodsc is u sed gv will no t attempt to examine the structure of the documen t but will pass the file to the ghostsc ript interpret er as a whole. In this case no page numbers are shown and freely moving around in the document is not possible. This option ma y help when vi ewing files not conforming to the documen t structuring conventions.

-eof P, -noeof P

Defines the be haviour of the postscript scanner used to examine the st ructure of the document. If -noeof is u sed the scanne r will ignore end of file (EOF) comments. This may help when viewing documents which import other documents with out enclosing them within the proper "BeginDocument " and "EndDocu ment" comments. If -eof is use d, the scanner treats an EOF comment as marking the en d of the file.

-pixma p, -nopixmap

If -pixmap is used gv tries to maintain off-screen regions of the display ed page by all ocating a sufficiently large pixmap. If -nopixmap i s used the X S erver is responsible for maintaining ob scured portion s of the displayed page (see also the "useBackingP ixmap" resource).

-v

Print the vers ion number of gv to standard output and exit.

-h, -?

Display a shor t help message and exit.

-help\ fP

Display a more explicit help message and exit.

-scale <n>

Selects the sc ale entry <n> relative to the scale 1.0. <n> must be an integer.

-scale base <n>

Selects the sc ale base <n>.

-monoc hrome, - grayscale, -color

Sets the color palette to be used.

-media <media>

Selects the pa per size to be used. Valid values are names of paper sizes th at appear in t he list of page medias as given by the medias resource.

-page <label>

Display the pa ge with label <label> first.

-portr ait, -la ndscape, -seascape, -upsidedown

Sets the orien tation.

-quiet , -noqui et

Whether to sta rt ghostscript with the -dQUIET option.

-resiz e, -nore size

Whether gv is allowed to aut omatically fit the size of its wi ndow to the si ze of the displayed page.

-safer , -nosaf er

Whether to sta rt ghostscript with the -dSAFER option.

-spart an

This is a shor tcut for "-s tyle gv_spartan.dat".

-style <resource fil e>

Read and use a dditional reso urces from the file <resource file>. These resource s have lower priority than those provided in the context of the -ad <r esource file> option.

-swap\ fP, -noswap

Whether to int erchange the m eaning of the orientations landscape and seascape.

-watch , -nowat ch

The -watch opt ion causes gv to check the document periodically. If changes are detected gv will automatically display the ne wer version of the file. The document i s by default c hecked once every second. This can be ch anged via the watchFileFrequency resource. Note that send ing gv the SIG HUP signal also causes an update of t he displayed d ocument. This method may be used by document crea tors to trigger gv remotely.

Resources

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

antialias

Whether antial iasing should be used. Valid values a re "True" and "False".

autoCente r

Whether the di splayed page s hould automatically be centered (for instance when opening a new file). Valid values a re "True" and "False".

autoResiz e

Whether gv is allowed to res ize the main window according to t he size of the current page. Valid values a re "True" and "False".

confirmPr int

Whether printi ng requires an extra confirmation. Valid values a re "True" and "False".

confirmQu it

Whether leavin g gv requires extra confirmation. Valid values a re "0" (Ne ver), "1" (When processi ng) and "2 U (Always). The default va lue is "1" , which causes a confirmation request when trying to leave gv in the presenc e of pending P DF to Postscript conversions.

scrolling EyeGuide

If this resour ce is "True\ *U scrolling via the keyboard cause s a temporary border to be drawn around the previously vis ible area of t he page. Allowed values are "True U and "False".

ignoreEOF

Defines the be haviour of the postscript scanner as described in the Options section. Valid values a re "True" and "False".

respectDS C

Determines whe ther gv should attempt to respect document structuring co mments. Valid values a re "True" and "False".

reverseSc rolling

Defines the in terpretation o f directions when scrolling with the mouse. Valid values a re "True" and "False".

swapLands cape

Whether the me aning of "la ndscape" and "seacape" should be inte rchanged. Valid values a re "True" and "False".

scratchDi r

Specifies a di rectory used t o store temporary data.

defaultSa veDir

Specifies the default destin ation directory for files to be saved.

useBackin gPixmap

If the value o f this resourc e is "False" the X Server is advised tha t saving off-s creen pixels of the displayed page would be benef icial (maintai ning backing store). In this case gv does not activ ely maintain t he contents of the page but relies on the X Serve r. The server is, however, always free to stop maintaining ba cking backing store. If the value o f this resourc e is "True" the X Server is advised tha t maintaining backing store is not useful. In this case g v attempts to allocate a sufficiently large pixmap to store the c ontents of the displayed page.

watchFile

Whether the do cument should be checked periodically and updated automatically if changes ar e detected. Valid values a re "True" and "False".

watchFile Frequency

Defines the ti me in millisec onds elapsing between successive checks of the document when watchFile is set to "True". Allowed values must be large r than 500.

printComm and

The command us ed for printin g a file. The command ma y contain mult iple '%s' wildcards which will be replaced by th e name of the file to be printed.

gsInterpr eter

The command us ed to start th e ghostscript interpreter.

gsCmdScan PDF

The command us ed to extract document structuring comments from a PDF fil e.

gsCmdConv PDF

The command us ed to convert a PDF file to PostScript.

gsX11Devi ce

The ghostscrip t command line option which activates the "X11" devi ce.

gsX11Alph aDevice

The ghostscrip t command line option which activates the "X11" devi ce with antial iasing enabled.

gsSafer

Determines whe ther ghostscri pt should be started with the "-dSAFER" command line o ption.

gsQuiet

Determines whe ther ghostscri pt should be started with the "-dQUIET" command line o ption.

gsArgumen ts

May be used to provide addit ional command line options for the ghostscript in terpreter. Starting gv wi th the "-arg uments <arguments>" option will ov erride this re source setting.

magMenu

Describes the menu that pops up when preparing to to zoom an are a of the displ ayed page.

dirs

Defines a list of directorie s accessible via the Directories menu in the fi le selection w indow. The special va lue "Home" corresponds to the users home directory, the value "T mp" correspo nds to the scratch directory as defined by the scratch Dir resource.

filter

Defines the de fault filter t o be used when displaying a directory contents in th e file selecti on window. A filter is sp ecified accord ing to the syntax

   <filter>   
 := [<filespec
s>] [no <filespecs>]
   <filespecs>
 := <filespec>
 [<filespecs>]
   <filespec> 
 := filename p
ossibly including wildcards '*'
              
    which matc
h any character.

Example: The f ilter

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

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

filters

Defines a list of filters of fered in the Filters menu of the fi le selection w indow. The filter " None" has a special meaning causing all fi les to be disp layed when the corresponding menu entry is selected.

miscMenuE ntries

Describes the menu that pops up when clicking with the third mouse bu tton on the di splayed page. The value of t his resource i s a list of menu entries. Allowed entrie s are "update", "redisplay U, "toggle_curr ent", "toggle_even ", "toggle_odd\ *U, "unmark", "stop", "print_all U, "print_marke d", "save_all" , "save_marked " and "line".

showTitle

Whether the na me of the disp layed document should be shown in the title bar of t he window. The name of gv's icon will also change accordingly if this resource is set to "True".

maximumWi dth, maximumHe ight

When resizing gv will not at tempt to exceed the size specified by these resou rces. These resource s may be speci fied as a positive integer or as "scree n", optional ly combined with a positive or negative offse t. The default va lues listed ab ove provide examples for this syntax. "screen" w ill automatica lly be replaced by the size of the screen.

minimumWi dth, minimumHe ight

Defines a mini mum size for t he main window. Valid values f or both resour ces are positive integers larger than 200.

scale

Sets the initi al scale. The value of this resource is the offset of the scale t o be selected relative to the scale 1.0 in the the "Scale U menu.

scaleBase

Selects the in itial scale ba se. The value of this resource should be a positive integer.

scales

Defines the av ailable scales bases and scales in the "Scale" menu.

orientati on

Sets the initi al orientation . Valid values are "portrait" , "landscape ","seascape", "upside-down " and "automatic U. "automatic U causes gv to attempt to derive the correct orient ation from document structuring comments.

fallbackO rientation

Defines the pa per-size to be used when automatic orientation detection fail s. Valid valu es are "portrait" , "landscape ","seascape" and "upside- down".

medias

A list describ ing the page m edias known to gv. List entries s tarting with \ *Q!" or "#" will not appear in the "Media" me nu but will st ill be used for automatic paper size detection.

pagemedia

Sets the paper size. Allowed values are as given in the above list of paper-sizes. Specifying "automatic U causes gv to attempt to derive the correct paper- size from document structuring comments.

fallbackP ageMedia

Defines the pa per-size to be used when automatic paper-size detection fail s. Valid valu es are as given in the above list of paper- sizes. The default user and syst em specific resource file

GV.pageMedia: 
          auto
matic
GV.orientation
:         auto
matic
GV.fallbackOri
entation: port
rait
GV.swapLandsca
pe:       Fals
e
GV.autoCenter:
          True
GV.antialias: 
          False
GV.respectDSC:
          True
GV.ignoreEOF: 
          True
GV.confirmPrin
t:        True
GV.reverseScro
lling:    False
GV.scrollingEy
eGuide:   True
GV.autoResize:
          True
GV.maximumWidt
h:        screen-20
GV.maximumHeig
ht:       screen-44
GV.minimumWidt
h:        400
GV.minimumHeig
ht:       430
GV.confirmQuit
:         1
GV.watchFile: 
          False
GV.watchFileFr
equency:  1000
GV.showTitle: 
          True
GV.miscMenuEnt
ries:     redisplay       \n\
              
          # update        \n\
              
          stop            \n\
              
          line            \n\
              
          toggle_current  \n\
              
          toggle_even     \n\
              
          toggle_odd      \n\
              
          unmark          \n\
              
          line            \n\
              
          print_all       \n\
              
          print_marked    \n\
              
          save_all        \n\
              
          save_marked
GV.scale:     
          0
GV.scaleBase: 
          1
GV.scales:    
          Natural size,   1.000,  screen  \n\
              
          Pixel based,    1.000,  pixel   \n\
              
          0.100,          0.100           \n\
              
          0.125,          0.125           \n\
              
          0.250,          0.250           \n\
              
          0.500,          0.500           \n\
              
          0.707,          0.707           \n\
              
          1.000,          1.000           \n\
              
          1.414,          1.414           \n\
              
          2.000,          2.000           \n\
              
          4.000,          4.000           \n\
              
          8.000,          8.000           \n\
              
          10.00,          10.00
GV.medias:    
          Letter,         612     792     \n\
              
          # LetterSmall,  612     792     \n\
              
          Legal,          612     1008    \n\
              
          Statement,      396     612     \n\
              
          Tabloid,                792     1224    \n\
              
          Ledger,         1224    792     \n\
              
          Folio,          612     936     \n\
              
          Quarto,         610     780     \n\
              
          # 7x9,          504     648     \n\
              
          # 9x11,         648     792     \n\
              
          # 9x12,         648     864     \n\
              
          # 10x13,                720     936     \n\
              
          10x14,          720     1008    \n\
              
          Executive,      540     720     \n\
              
          # A0,           2384    3370    \n\
              
          # A1,           1684    2384    \n\
              
          # A2,           1191    1684    \n\
              
          A3,             842     1191    \n\
              
          A4,             595     842     \n\
              
          # A4Small,      595     842     \n\
              
          A5,             420     595     \n\
              
          # A6,           297     420     \n\
              
          # A7,           210     297     \n\
              
          # A8,           148     210     \n\
              
          # A9,           105     148     \n\
              
          # A10,          73      105     \n\
              
          # B0,           2920    4127    \n\
              
          # B1,           2064    2920    \n\
              
          # B2,           1460    2064    \n\
              
          # B3,           1032    1460    \n\
              
          B4,             729     1032    \n\
              
          B5,             516     729     \n\
              
          # B6,           363     516     \n\
              
          # B7,           258     363     \n\
              
          # B8,           181     258     \n\
              
          # B9,           127     181     \n\
              
          # B10,          91      127     \n\
              
          # ISOB0,                2835    4008    \n\
              
          # ISOB1,                2004    2835    \n\
              
          # ISOB2,                1417    2004    \n\
              
          # ISOB3,                1001    1417    \n\
              
          # ISOB4,                709     1001    \n\
              
          # ISOB5,                499     709     \n\
              
          # ISOB6,                354     499     \n\
              
          # ISOB7,                249     354     \n\
              
          # ISOB8,                176     249     \n\
              
          # ISOB9,                125     176     \n\
              
          # ISOB10,       88      125     \n\
              
          # C0,           2599    3676    \n\
              
          # C1,           1837    2599    \n\
              
          # C2,           1298    1837    \n\
              
          # C3,           918     1296    \n\
              
          # C4,           649     918     \n\
              
          # C5,           459     649     \n\
              
          # C6,           323     459     \n\
              
          # C7,           230     323     \n\
              
          # DL,           312     624
GV.magMenu:   
          2,      2       \n\
              
          4,      4       \n\
              
          8,      8       \n\
              
          16,     16      \n\
              
          32,     32      \n\
              
          64,     64
GV*Ghostview.b
ackground:                white
GV*Ghostview.f
oreground:                black
GV.gsInterpret
er:       gs
GV.gsCmdScanPD
F:        gs -dNODISPLAY -dQUIET -sPDFname=%s -sDSCname=%s pdf2dsc.ps
-c quit
GV.gsCmdConvPD
F:        gs -dNODISPLAY -dQUIET  -dNOPAUSE -sPSFile=%s %s -c
quit
GV.gsX11Device
:         -sDEVICE=x11
GV.gsX11AlphaD
evice:    -dNOPLATFONTS -sDEVICE=x11alpha
GV.gsSafer:   
          True
GV.gsQuiet:   
          True
GV.gsArguments
:
GV.uncompressC
ommand:   gzip -d -c %s > %s
GV.printComman
d:        lpr
GV.scratchDir:
          ~/
GV.defaultSave
Dir:      ~/
GV.fallbackPag
eMedia:   a4
GV.useBackingP
ixmap:    True
GV*dirs:      
          Home\n\
              
          Tmp\n\
              
          /usr/doc\n\
              
          /usr/local/doc
GV*filter:    
          no .*
GV*filters:   
          None\n\
              
          *.*ps* *.pdf*  no  .*\n\
              
          *.*ps*   no  .*\n\
              
          *.pdf*  no  .*\n\
              
          no  .*

Mouse and key bindings

Mouse bindings in th e Main and the Zoom window

The following mouse events a re defined when the mouse pointer is either on t he displayed p age or on a zoomed area:

- p ress button 1, move mouse, release button 1

Scrolls the di splayed page ' proportionally'.

- p ress button 3, move mouse, release button 3

Scrolls the di splayed page ' absolutely'.

- d ouble-click wi th button 1

In the main wi ndow this disp lays the previous/next page if the double- click occured in the left/right half of the window. In a zoom wind ow it does not hing.

- p ress button 2, release button 2

Pops up a smal l menu which a llows to choose a magnification for a certain area around th e current mouse position. After selectin g a magnificat ion a zoom window pops up displaying the area at the c hosen scale.

- p ress button 2, move mouse, release button 2

This draws and thereby defin es a rectangular region which can be display ed in a zoom w indow. The magnification for the area can be se lected by mean s of a popup menu which appears after releasing butt on 2.

- press button 1 , press button 2

Redisplays the current page. This event sequence works only in the main wi ndow.

- p ress button 3, release button 3

Pops up a smal l menu which o ffers a few standard actions like 'Redispla y', 'Mark Page ', etc.

Mouse bindings in th e File Selection popup

The following mouse events a re defined when the mouse pointer is in the window of either a fi le or a directory list:

- p ress button 1, move mouse, release button 1

Scrolls a file or directory list 'proportionally'.

- p ress button 2, move mouse, release button 2

Scrolls a file or directory list 'absolutely'.

- p ress button 2, release button 2

Scrolls a file or directory list one page up/down if the button was pressed in the upper/lower half of the list.

- d ouble-click wi th button 1 on a filename

Selects the fi le and closes the File Selection popup.

- c lick with butt on 1 on a directory name

Causes the con tents of this directory to be displayed.

Mouse bindings in th e Table of Contents

The following mouse events a re defined when the mouse pointer is in the window showing a list of page numbers of the current file ( table of conte nts):

- p ress button 1, move mouse, release button 1

Scrolls the ta ble of content s.

- p ress button 1 on a page number

Go to this pag e.

- p ress button 2 on a page number

Mark this page if it is unma rked, but unmark it if it is marked.

- p ress button 2, move mouse, release button 2

Marks/unmarks all unmarked/m arked pages in the region crossed by the mouse pointer during the movement.

Mouse bindings in th e Panner widget

The Panner wid get is the rec tangular region located close to the left edge of t he main window . It indicates the size and the position of th e visible area of the current page relative to the total page. The following mouse events a re defined when the mouse pointer is in this region :

- p ress button 1, move mouse

Scrolls the di splayed page.

- p ress button 2

Display the pr evious page.

- p ress button 3

Display the ne xt page.

Mouse bindings in th e

The ">>" and " <<" buttons ar e used to move to another pag e. The followi ng mouse events are defined:

- p ress button 1

Move 1 page fo rward/backward s.

- p ress button 2

Move 5 pages f orward/backwar ds.

- p ress button 3

Move 10 pages forward/backwa rds.

Key Bi ndings

The following key events are defined in the main window. Those bindings scrolling the page are also defined in zoom popups.

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

Comments a bout the user interface

Scales

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

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

should be adde d to the "SC REEN_RESOURCES" property of the screen the document i s viewed on, w ith <width> and <height> describing the width and hei ght of the root window in units of millimeters. For instance b y using the co mmand

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

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

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

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

   GV.screenSi
ze_tic_0_1: 39
6 x 291

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

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

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

Scroll ing

It is probably a de facto st andard for user interfaces that windows a re supposed to be scrolled by means of scrollbars att ached to their sides. However, for v arious reasons the use of scrollbars has been minim ized in gv. Instead, in al l windows with obscured data, scrolling may be perform ed by pressing butto n1, moving the mouse, then releasing button1 directly in th e window. This includes the displayed page, zoom popups, t he table of co ntents and the file and directory list s displayed in the file selection popup.

Displa ying new versi ons of a document

During documen t creation it is usually desirable to always display the newest ve rsion of the document in work. Instead of exp licitly loadin g it via the file selection popup the most recent versio n can be displayed by pressing the \ *QRedisplay" button in the main window (VMS users sho uld use the QUpdate File" entry in the "File" men u). Choosing the \ *QRedisplay" entry in the menu that pops up when clicki ng with the th ird mouse button anywhere on the displayed page certainly has the same effect. More comfortab le is the "Wat ch File" feature which may be switched on by selecting the corresponding entry in the "State" me nu. If activat ed gv will check every now and then if a new version of the displayed file exists. I f so it will b e displayed automatically. By default the file is check ed about once every second. Finally it may also be left to the document creating program to trigger gv to update its display. To do so the program should send the SIGH UP signal to gv. For instance a t the end of a shell script generating a postscript fil e from latex s ources the line

   kill -SIGHU
P <gv_pid>

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

Availabili ty

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

World Wid e Web:

http://wwwthep .physik.uni-ma inz.de/~plass/gv/

Authors

Johannes Plass
             p
lass@thep.physik.uni-mainz.de
              
             D
epartment of Physics
              
             J
ohannes Gutenberg University
              
             M
ainz, Germany
gv is derived 
from GhostView
 1.5, created by
          Tim 
Theisen      S
ystems Programmer
Internet: tim@
cs.wisc.edu  D
epartment of Computer Sciences
    UUCP: uwva
x!tim        U
niversity of Wisconsin-Madison
   Phone: (608
)262-0438    1
210 West Dayton Street
     FAX: (608
)262-9777    M
adison, WI   53706

Suggestion s and bug repo rts

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

Table of Contents

• Name
• Synopsis
• Descriptio n
• Options
• Resources
• Mouse and key bindings
• Comments a bout the user interface
• Availabili ty
• Authors
• Suggestion s and bug repo rts