$OpenBSD: patch-source_gv_man,v 1.1 2001/04/14 14:43:05 espie Exp $
--- source/gv.man.orig	Sat Apr 14 04:57:36 2001
+++ source/gv.man	Sat Apr 14 04:57:36 2001
@@ -0,0 +1,1214 @@
+.if n .ds Q \&"
+.if t .ds Q ``
+.if n .ds U \&"
+.if t .ds U ''
+.TH "gv" 1 
+.tr \&
+.nr bi 0
+.nr ll 0
+.nr el 0
+.de DS
+..
+.de DE
+..
+.de Pp
+.ie \\n(ll>0 \{\
+.ie \\n(bi=1 \{\
+.nr bi 0
+.if \\n(t\\n(ll=0 \{.IP \\(bu\}
+.if \\n(t\\n(ll=1 \{.IP \\n+(e\\n(el.\}
+.\}
+.el .sp 
+.\}
+.el \{\
+.ie \\nh=1 \{\
+.LP
+.nr h 0
+.\}
+.el .PP 
+.\}
+..
+.SH Name
+gv - a PostScript and PDF previewer
+
+
+.SH Synopsis 
+
+.Pp
+.DS
+.sp 
+.ft RR
+.nf
+gv [ filename ]
+   [-monochrome] [-grayscale] [-color]
+   [-[no]safer] [-[no]quiet] [-arguments <arguments>]
+   [-page <label>] [-[no]center]
+   [-media <media>]
+   [-portrait] [-landscape] [-upsidedown] [-seascape]
+   [-scale <n>] [-scalebase <n>]
+   [-swap] [-noswap]
+   [-antialias] [-noantialias]
+   [-dsc] [-nodsc]
+   [-eof] [-noeof]
+   [-pixmap] [-nopixmap]
+   [-watch] [-nowatch]
+   [-?] [-h] [-help] [-v]
+   [-resize] [-noresize]
+   [-geometry [<width>][x<height>][{+-}<xoffset>{+-}<yoffset>]
+   [-ad <resource file>]
+   [-style <resource file>]
+   [-spartan]
+   [<other toolkit options>]
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+.SH Description 
+
+.Pp
+.Pp
+gv allows to view and navigate through
+PostScript and PDF documents on an X display
+by providing a user interface for the ghostscript interpreter.
+.Pp
+Please note that gv is derived from Tim Theisen's
+ghostview 1.5.
+.Pp
+.SH Options 
+
+.Pp
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.IP "\fBfilename\fP"
+.nr bi 1
+.Pp
+The name of the file to be displayed.
+The file ending \*Q.ps\*U may be omitted.
+\*Qfilename\*U may point to a compressed file 
+(gzipped, zipped or compressed).
+Viewing PDF files requires at least ghostscript version 4.x.
+.IP "\fB-ad <resource file>\fP"
+.nr bi 1
+.Pp
+Read and use additional resources from the file
+<resource file>.
+These resources have higher priority than those provided
+in the context of the -style <resource file> option.
+.IP "\fB-antialias\fP, \fB-noantialias\fP"
+.nr bi 1
+.Pp
+Whether to use antialiasing.
+.IP "\fB-arguments <arguments>\fP"
+.nr bi 1
+.Pp
+Start ghostscript with additional options as specified by the
+string <arguments>.
+.IP "\fB-center\fP, \fB-nocenter\fP"
+.nr bi 1
+.Pp
+Whether the page should be centered automatically.
+.IP "\fB-dsc\fP, \fB-nodsc\fP"
+.nr bi 1
+.Pp
+Determines if document structuring convention (DSC) comments
+should be respected or ignored.
+If -nodsc is used gv will not attempt to examine
+the structure of the document but will pass the file
+to the ghostscript interpreter as a whole. In this case no page numbers
+are shown and freely moving around in the document is not possible.
+This option may help when viewing files not conforming
+to the document structuring conventions.
+.IP "\fB-eof\fP, \fB-noeof\fP"
+.nr bi 1
+.Pp
+Defines the behaviour of the postscript scanner used to
+examine the structure of the document.
+If -noeof is used the scanner will ignore end of file (EOF)
+comments. This may help when viewing documents which import other
+documents without enclosing them within the proper
+"BeginDocument" and "EndDocument" comments.
+If -eof is used, the scanner treats an EOF comment as
+marking the end of the file.
+.IP "\fB-pixmap\fP, \fB-nopixmap\fP"
+.nr bi 1
+.Pp
+If -pixmap is used gv tries to maintain off-screen regions
+of the displayed page by allocating a sufficiently large pixmap.
+If -nopixmap is used the X Server is responsible for
+maintaining obscured portions of the displayed page
+(see also the \*QuseBackingPixmap\*U resource).
+.IP "\fB-v\fP "
+.nr bi 1
+.Pp
+Print the version number of gv to standard output and exit.
+.IP "\fB-h\fP, \fB-?\fP "
+.nr bi 1
+.Pp
+Display a short help message and exit.
+.IP "\fB-help\fP"
+.nr bi 1
+.Pp
+Display a more explicit help message and exit.
+.IP "\fB-scale <n>\fP"
+.nr bi 1
+.Pp
+Selects the scale entry <n> relative to the scale 1.0.
+<n> must be an integer.
+.IP "\fB-scalebase <n>\fP"
+.nr bi 1
+.Pp
+Selects the scale base <n>.
+.IP "\fB-monochrome\fP, \fB-grayscale\fP, \fB-color\fP"
+.nr bi 1
+.Pp
+Sets the color palette to be used.
+.IP "\fB-media <media>\fP"
+.nr bi 1
+.Pp
+Selects the paper size to be used. Valid values are names of
+paper sizes that appear in the list of page medias as given
+by the medias resource.
+.IP "\fB-page <label>\fP"
+.nr bi 1
+.Pp
+Display the page with label <label> first.
+.IP "\fB-portrait\fP, \fB-landscape\fP, \fB-seascape\fP, \fB-upsidedown\fP"
+.nr bi 1
+.Pp
+Sets the orientation.
+.IP "\fB-quiet\fP, \fB-noquiet\fP"
+.nr bi 1
+.Pp
+Whether to start ghostscript with the -dQUIET option.
+.IP "\fB-resize\fP, \fB-noresize\fP"
+.nr bi 1
+.Pp
+Whether gv is allowed to automatically fit the
+size of its window to the size of the displayed page.
+.IP "\fB-safer\fP, \fB-nosafer\fP"
+.nr bi 1
+.Pp
+Whether to start ghostscript with the -dSAFER option.
+.IP "\fB-spartan\fP"
+.nr bi 1
+.Pp
+This is a shortcut for \*Q-style gv_spartan.dat\*U.
+.IP "\fB-style <resource file>\fP"
+.nr bi 1
+.Pp
+Read and use additional resources from the file <resource file>.
+These resources have  lower priority than those provided
+in the context of the -ad <resource file> option.
+.IP "\fB-swap\fP, \fB-noswap\fP"
+.nr bi 1
+.Pp
+Whether to interchange the meaning of the orientations
+landscape and seascape.
+.IP "\fB-watch\fP, \fB-nowatch\fP"
+.nr bi 1
+.Pp
+The -watch option causes gv to check the document
+periodically. If changes are detected gv will
+automatically display the newer version of the file.
+The document is by default checked once every second. 
+This can be changed via the watchFileFrequency resource.
+Note that sending gv the SIGHUP signal also causes
+an update of the displayed document. This method
+may be used by document creators to trigger gv
+remotely.
+.if \n(ll>1 .RE
+.nr ll -1
+
+.SH Resources 
+
+.Pp
+\fBResource files\fP
+.Pp
+In general gv does not depend on any external resource files.
+However, when starting gv, preferences are read from
+.Pp
+.nr ll +1
+.nr t\n(ll 0
+.if \n(ll>1 .RS
+.nr bi 1
+.Pp
+\fBa system specific resource file\fP.
+The name of this file is as described by the \*QXFILESEARCHPATH\*U
+environment variable, or, if this variable is not defined,
+implementation dependant. In most cases it is  
+\*Q/usr/X11/lib/X11/app-defaults/GV\*U.
+Administrators may want to modify this file in order
+to set up gv according to the local needs of their system.
+.nr bi 1
+.Pp
+\fBa user specific resource file\fP.
+The name of this file is either \*Q~/.gv\*U or as described
+by the \*QXUSERFILESEARCHPATH\*U environment variable.
+.if \n(ll>1 .RE
+.nr ll -1
+.Pp
+The files \*Qgv_user.ad\*U and \*Qgv_system.ad\*U (located in the library directory
+of gv, which is most probably either 
+\*Q/usr/local/lib/gv/\*U or \*Q/usr/lib/gv/\*U may serve as a basis
+for constructing the user and system specific resource files.
+.Pp
+Note that the user and system specific resource files are not the only
+sources of preferences taken into account when gv is started.
+However, in practice these are the most important.
+.Pp
+\fBResources of gv\fP
+.Pp
+The following describes some of the resources of gv.
+The precise syntax of some of the resource values may be 
+inferred from the appended default system specific resource file.
+.Pp
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.IP "antialias"
+.nr bi 1
+.Pp
+Whether antialiasing should be used.
+Valid values are \*QTrue\*U and \*QFalse\*U.
+.IP "autoCenter"
+.nr bi 1
+.Pp
+Whether the displayed page should automatically be centered 
+(for instance when opening a new file).
+Valid values are \*QTrue\*U and \*QFalse\*U.
+.IP "autoResize"
+.nr bi 1
+.Pp
+Whether gv is allowed to resize the main window
+according to the size of the current page.
+Valid values are \*QTrue\*U and \*QFalse\*U.
+.IP "confirmPrint"
+.nr bi 1
+.Pp
+Whether printing requires an extra confirmation.
+Valid values are \*QTrue\*U and \*QFalse\*U.
+.IP "confirmQuit"
+.nr bi 1
+.Pp
+Whether leaving gv requires extra confirmation.
+Valid values are \*Q0\*U (Never), \*Q1\*U
+(When processing) and \*Q2\*U (Always).
+The default value is \*Q1\*U, which causes
+a confirmation request when trying to leave gv
+in the presence of pending PDF to Postscript conversions.
+.IP "scrollingEyeGuide"
+.nr bi 1
+.Pp
+If this resource is \*QTrue\*U scrolling via the
+keyboard causes a temporary border to be drawn around the
+previously visible area of the page.
+Allowed values are \*QTrue\*U and \*QFalse\*U.   
+.IP "ignoreEOF"
+.nr bi 1
+.Pp
+Defines the behaviour of the postscript scanner as described
+in the Options section.
+Valid values are \*QTrue\*U and \*QFalse\*U.   
+.IP "respectDSC"
+.nr bi 1
+.Pp
+Determines whether gv should attempt to respect document 
+structuring comments.
+Valid values are \*QTrue\*U and \*QFalse\*U.
+.IP "reverseScrolling"
+.nr bi 1
+.Pp
+Defines the interpretation of directions when
+scrolling with the mouse.
+Valid values are \*QTrue\*U and \*QFalse\*U.
+.IP "swapLandscape"
+.nr bi 1
+.Pp
+Whether the meaning of \*Qlandscape\*U and \*Qseacape\*U
+should be interchanged.
+Valid values are \*QTrue\*U and \*QFalse\*U.
+.IP "scratchDir"
+.nr bi 1
+.Pp
+Specifies a directory used to store temporary data.
+.IP "defaultSaveDir"
+.nr bi 1
+.Pp
+Specifies the default destination directory for files to be saved.
+.IP "useBackingPixmap"
+.nr bi 1
+.Pp
+If the value of this resource is \*QFalse\*U the X Server
+is advised that saving off-screen pixels of the displayed page
+would be beneficial (maintaining backing store). In this case gv 
+does not actively maintain the contents of the page but relies
+on the X Server. The server is, however, always free to stop 
+maintaining backing backing store.
+If the value of this resource is \*QTrue\*U the X Server
+is advised that maintaining backing store is not useful.
+In this case gv attempts to allocate a sufficiently large pixmap
+to store the contents of the displayed page.
+.IP "watchFile"
+.nr bi 1
+.Pp
+Whether the document should be checked periodically and updated
+automatically if  changes are detected.
+Valid values are \*QTrue\*U and \*QFalse\*U.
+.IP "watchFileFrequency"
+.nr bi 1
+.Pp
+Defines the time in milliseconds elapsing between successive
+checks of the document when watchFile is set to \*QTrue\*U.
+Allowed values must be larger than 500.
+.IP "printCommand"
+.nr bi 1
+.Pp
+The command used for printing a file.
+The command may contain multiple '%s' wildcards
+which will be replaced by the name of the file to be 
+printed.
+.IP "gsInterpreter"
+.nr bi 1
+.Pp
+The command used to start the ghostscript interpreter.
+.IP "gsCmdScanPDF"
+.nr bi 1
+.Pp
+The command used to extract document structuring comments
+from a PDF file.
+.IP "gsCmdConvPDF"
+.nr bi 1
+.Pp
+The command used to convert a PDF file to PostScript.
+.IP "gsX11Device"
+.nr bi 1
+.Pp
+The ghostscript command line option which activates the
+\*QX11\*U device. 
+.IP "gsX11AlphaDevice"
+.nr bi 1
+.Pp
+The ghostscript command line option which activates the
+\*QX11\*U device with antialiasing enabled. 
+.IP "gsSafer"
+.nr bi 1
+.Pp
+Determines whether ghostscript should be started with the
+\*Q-dSAFER\*U command line option.
+.IP "gsQuiet"
+.nr bi 1
+.Pp
+Determines whether ghostscript should be started with the
+\*Q-dQUIET\*U command line option.
+.IP "gsArguments"
+.nr bi 1
+.Pp
+May be used to provide additional command line options for the
+ghostscript interpreter.
+Starting gv with the \*Q-arguments <arguments>\*U
+option will override this resource setting.
+.IP "magMenu"
+.nr bi 1
+.Pp
+Describes the menu that pops up when preparing to
+to zoom an area of the displayed page.
+.IP "dirs"
+.nr bi 1
+.Pp
+Defines a list of directories accessible via the Directories
+menu in the file selection window.
+The special value \*QHome\*U corresponds to the users home directory,
+the value \*QTmp\*U corresponds to the scratch directory as defined
+by the scratchDir resource.
+.IP "filter"
+.nr bi 1
+.Pp
+Defines the default filter to be used when displaying a directory
+contents in the file selection window.
+A filter is specified according to the syntax
+.DS
+.sp 
+.ft RR
+.nf
+   <filter>    := [<filespecs>] [no <filespecs>]
+   <filespecs> := <filespec> [<filespecs>]
+   <filespec>  := filename possibly including wildcards '*'
+                  which match any character.
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+Example: The filter
+.DS
+.sp 
+.ft RR
+.nf
+   GV*filter: *.ps *.pdf no .*
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+screens out all files with names starting with a dot
+and keeps of the remaining ones only those which end
+on \*Q.ps\*U or \*Q.pdf\*U.
+.IP "filters"
+.nr bi 1
+.Pp
+Defines a list of filters offered in the Filters
+menu of the file selection window.
+The filter \*QNone\*U has a special meaning
+causing all files to be displayed when the corresponding
+menu entry is selected.
+.IP "miscMenuEntries"
+.nr bi 1
+.Pp
+Describes the menu that pops up when clicking with the 
+third mouse button on the displayed page. 
+The value of this resource is a list of menu entries.
+Allowed entries are
+\*Qupdate\*U,
+\*Qredisplay\*U,    
+\*Qtoggle_current\*U,    
+\*Qtoggle_even\*U,    
+\*Qtoggle_odd\*U,    
+\*Qunmark\*U,    
+\*Qstop\*U,    
+\*Qprint_all\*U,    
+\*Qprint_marked\*U,    
+\*Qsave_all\*U,    
+\*Qsave_marked\*U and
+\*Qline\*U.
+.IP "showTitle"
+.nr bi 1
+.Pp
+Whether the name of the displayed document should be shown in the
+title bar of the window. The name of gv's icon will also change
+accordingly if this resource is set to \*QTrue\*U.
+.IP "maximumWidth, maximumHeight"
+.nr bi 1
+.Pp
+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 \*Qscreen\*U, optionally combined with
+a positive or negative offset.
+The default values listed above provide examples for this syntax.
+\*Qscreen\*U will automatically be replaced by the size of the
+screen.
+.IP "minimumWidth, minimumHeight"
+.nr bi 1
+.Pp
+Defines a minimum size for the main window.
+Valid values for both resources are positive integers larger
+than 200.
+.IP "scale"
+.nr bi 1
+.Pp
+Sets the initial scale. The value of this resource is the offset
+of the scale to be selected relative to the scale 1.0 in the
+the \*QScale\*U menu.
+.IP "scaleBase"
+.nr bi 1
+.Pp
+Selects the initial scale base. The value of this resource should 
+be a positive integer.
+.IP "scales"
+.nr bi 1
+.Pp
+Defines the available scales bases and scales in the \*QScale\*U
+menu.   
+.IP "orientation"
+.nr bi 1
+.Pp
+Sets the initial orientation. Valid values are 
+\*Qportrait\*U, \*Qlandscape\*U,\*Qseascape\*U,
+\*Qupside-down\*U and
+\*Qautomatic\*U.
+\*Qautomatic\*U causes gv to attempt
+to derive the correct orientation from document structuring
+comments.
+.IP "fallbackOrientation"
+.nr bi 1
+.Pp
+Defines the paper-size to be used when automatic orientation
+detetction fails.  Valid values are 
+\*Qportrait\*U, \*Qlandscape\*U,\*Qseascape\*U 
+and \*Qupside-down\*U.
+.IP "medias"
+.nr bi 1
+.Pp
+A list describing the page medias known to gv.
+List entries starting with \*Q!\*U or \*Q#\*U will not appear in the
+\*QMedia\*U menu but will still be used for automatic paper size 
+detection.
+.IP "pagemedia"
+.nr bi 1
+.Pp
+Sets the paper size. 
+Allowd values are as given in the above list of paper-sizes.
+Specifying
+\*Qautomatic\*U causes gv to attempt
+to derive the correct paper-size from document structuring
+comments.
+.IP "fallbackPageMedia"
+.nr bi 1
+.Pp
+Defines the paper-size to be used when automatic paper-size 
+detetction fails.  Valid values are as given in the  above
+list of paper-sizes.
+.if \n(ll>1 .RE
+.nr ll -1
+.Pp
+\fBThe default user and system specific resource file\fP
+.DS
+.sp 
+.ft RR
+.nf
+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_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.background:                white
+GV*Ghostview.foreground:                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.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  .*
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+.SH Mouse and key bindings 
+
+.Pp
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.IP "\fBMouse bindings in the Main and the Zoom window\fP"
+.nr bi 1
+.Pp
+The following mouse events are defined when the mouse pointer
+is either on the displayed page or on a zoomed area:
+.Pp
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.IP "\fB-\fP press button 1, move mouse, release button 1"
+.nr bi 1
+.Pp
+Scrolls the displayed page 'proportionally'.
+.IP "\fB-\fP press button 3, move mouse, release button 3"
+.nr bi 1
+.Pp
+Scrolls the displayed page 'absolutely'.
+.IP "\fB-\fP double-click with button 1"
+.nr bi 1
+.Pp
+In the main window this displays the previous/next page
+if the double-click occured in the left/right half of the
+window.
+In a zoom window it does nothing.
+.IP "\fB-\fP press button 2, release button 2"
+.nr bi 1
+.Pp
+Pops up a small menu which allows to choose a magnification
+for a certain area around the current mouse position.
+After selecting a magnification a zoom window pops up
+displaying the area at the chosen scale.
+.IP "\fB-\fP press button 2, move mouse, release button 2"
+.nr bi 1
+.Pp
+This draws and thereby defines a rectangular region which
+can be displayed in a zoom window. The magnification for the
+area can be selected by means of a popup menu which appears after
+releasing button 2.
+.IP " \fB-\fP press button 1, press button 2"
+.nr bi 1
+.Pp
+Redisplays the current page. This event sequence works only
+in the main window.
+.IP "\fB-\fP press button 3, release button 3"
+.nr bi 1
+.Pp
+Pops up a small menu which offers a few standard actions
+like 'Redisplay', 'Mark Page', etc.
+.if \n(ll>1 .RE
+.nr ll -1
+.IP "\fBMouse bindings in the File Selection popup\fP"
+.nr bi 1
+.Pp
+The following mouse events are defined when the mouse pointer is
+in the window of either a file or a directory list:
+.Pp
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.IP "\fB-\fP press button 1, move mouse, release button 1"
+.nr bi 1
+.Pp
+Scrolls a file or directory list 'proportionally'.
+.IP "\fB-\fP press button 2, move mouse, release button 2"
+.nr bi 1
+.Pp
+Scrolls a file or directory list 'absolutely'.
+.IP "\fB-\fP press button 2, release button 2"
+.nr bi 1
+.Pp
+Scrolls a file or directory list one page up/down
+if the button was pressed in the upper/lower half of the list.
+.IP "\fB-\fP double-click with button 1 on a filename"
+.nr bi 1
+.Pp
+Selects the file and closes the File Selection popup.
+.IP "\fB-\fP click with button 1 on a directory name"
+.nr bi 1
+.Pp
+Causes the contents of this directory to be displayed.
+.if \n(ll>1 .RE
+.nr ll -1
+.IP "\fBMouse bindings in the Table of Contents\fP"
+.nr bi 1
+.Pp
+The following mouse events are defined when the mouse pointer is
+in the window showing a list of page numbers of the
+current file (table of contents):
+.Pp
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.IP "\fB-\fP press button 1, move mouse, release button 1"
+.nr bi 1
+.Pp
+Scrolls the table of contents.
+.IP "\fB-\fP press button 1 on a page number"
+.nr bi 1
+.Pp
+Go to this page.
+.IP "\fB-\fP press button 2 on a page number"
+.nr bi 1
+.Pp
+Mark this page if it is unmarked, but unmark it if it is marked.
+.IP "\fB-\fP press button 2, move mouse, release button 2"
+.nr bi 1
+.Pp
+Marks/unmarks all unmarked/marked pages in the region
+crossed by the mouse pointer during the movement.
+.if \n(ll>1 .RE
+.nr ll -1
+.IP "\fBMouse bindings in the Panner widget\fP"
+.nr bi 1
+.Pp
+The Panner widget is the rectangular region located close to the
+left edge of the main window. It indicates the size and the
+position of the visible area of the current page relative to the
+total page.
+.Pp
+The following mouse events are defined when the mouse pointer is
+in this region:
+.Pp
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.IP "\fB-\fP press button 1, move mouse"
+.nr bi 1
+.Pp
+Scrolls the displayed page.
+.IP "\fB-\fP press button 2"
+.nr bi 1
+.Pp
+Display the previous page.
+.IP "\fB-\fP press button 3"
+.nr bi 1
+.Pp
+Display the next page.
+.if \n(ll>1 .RE
+.nr ll -1
+.IP "\fBMouse bindings in the ">>" and "<<" button windows\fP"
+.nr bi 1
+.Pp
+The ">>" and "<<" buttons are used to move 
+to another page. The following mouse events are defined:
+.Pp
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.IP "\fB-\fP press button 1"
+.nr bi 1
+.Pp
+Move 1 page forward/backwards.
+.IP "\fB-\fP press button 2"
+.nr bi 1
+.Pp
+Move 5 pages forward/backwards.
+.IP "\fB-\fP press button 3"
+.nr bi 1
+.Pp
+Move 10 pages forward/backwards.
+.if \n(ll>1 .RE
+.nr ll -1
+.IP "\fBKey Bindings\fP"
+.nr bi 1
+.Pp
+The following key events are defined in the main window. Those bindings
+scrolling the page are also defined in zoom popups.
+.DS
+.sp 
+.ft RR
+.nf
+=== Notation:
+
+s-X          means press "Shift"           and key "X"
+c-X          means press "Ctrl"            and key "X"
+sc-X         means press "Shift" or "Ctrl" and key "X"
+
+=== Miscellaneous keys:
+
+A            Toggle antialiasing on and off
+O            Open a new file
+Q            Quit gv
+R            Toggle gv's resizing behaviour
+I            Respect/Ignore document structuring
+W            Watch file / Don't watch 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 page
+\&.            Redisplay the current page
+sc-.         Reopen the current file
+M            Mark the current page
+N            Unmark the current page
+
+=== Orientation:
+
+7            Orientation portrait
+8            Orientation landscape
+9            Orientation upside-down
+0            Orientation seascape
+
+=== Magnification:
+
+sc-6         Select the scale entry -6 relative to the scale 1.0
+sc-5         Select the scale entry -5 relative to the scale 1.0
+sc-4         Select the scale entry -4 relative to the scale 1.0
+sc-3         Select the scale entry -3 relative to the scale 1.0
+sc-2         Select the scale entry -2 relative to the scale 1.0
+sc-1         Select the scale entry -1 relative to the scale 1.0
+^            Select the scale 1.0 (for german keyboard layout)
+`            Select the scale 1.0
+1            Select the scale entry 1 relative to the scale 1.0
+2            Select the scale entry 2 relative to the scale 1.0
+3            Select the scale entry 3 relative to the scale 1.0
+4            Select the scale entry 4 relative to the scale 1.0
+5            Select the scale entry 5 relative to the scale 1.0
+6            Select the scale entry 6 relative to the scale 1.0
++            Select the next scale entry
+=            Select the next scale entry
+-            Select the previous scale entry
+
+=== Navigating:
+
+Arrow        Scroll in the direction of the arrow
+s-Up         Scroll columns up   or jump -1 pages
+s-Down       Scroll columns down or jump  1 pages
+s-Left       Scroll rows left    or jump -1 pages
+s-Right      Scroll rows right   or jump  1 pages
+c-Up         Jump -1 pages (to top/left corner)
+c-Down       Jump  1 pages (to top/left corner)
+c-Left       Jump -5 pages (to top/left corner)
+c-Right      Jump  5 pages (to top/left corner)
+
+D,X,Z,Y,C    Identical to arrow up,down,left,left,right
+V            Center the page
+sc-Space     Scroll columns up   or jump -1 pages
+Space        Scroll columns down or jump  1 pages
+
+BackSpace    Scroll columns up   or jump -1 pages
+Insert       Jump  -5 pages
+Delete       Jump   5 pages
+Home         Go to the first page
+End          Go to the last page
+Prior        Jump  -1 pages
+Next         Jump   1 pages
+
+Keypad 0-9   Highlight a page number
+Keypad -     Highlight previous page number
+Keypad +     Highlight next page number
+Keypad Enter Jump to the highlighted page
+
+c-Enter      Jump  -1 pages
+s-Enter      Jump  -1 pages
+Enter        Jump   1 pages
+B            Jump  -1 pages
+F            Jump   1 pages
+
+
+
+
+
+
+
+
+
+.DE
+.fi 
+.ec
+.ft P
+.sp
+.if \n(ll>1 .RE
+.nr ll -1
+
+.SH Comments about the user interface 
+
+.Pp
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.Pp
+.IP "\fBScales\fP"
+.nr bi 1
+.Pp
+The \*QScale\*U menu which allows to view the document
+at different sizes is divided into two parts. The first part
+shows a list of available scale bases, the second part,
+separated by a line, lists the relative scales which are applied
+with respect to the selected scale base.
+.Pp
+By default two scales bases are available, the \*QNatural size\*U
+and the \*QPixel based\*U base.
+When choosing the \*QPixel based\*U scale base a relative scale 
+of 1.0 causes one postscript point to correspond to one pixel on the 
+screen.
+.Pp
+When viewing a document at a relative scale of 1.0
+using the \*QNatural size\*U base the page should appear in its
+real size, as if printed on paper.
+For the \*QNatural size\*U base to work properly gv has to know
+the correct size of the root window. Automatic detection
+of this size unfortunately only provides approximate results, therefore
+it is best if it is provided by the user. To do so the resource
+.DS
+.sp 
+.ft RR
+.nf
+   GV.screenSize:  <width> x <height>
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+should be added to the \*QSCREEN_RESOURCES\*U property of the screen
+the document is viewed on, with <width> and <height>
+describing the width and height of the root window in units of millimeters.
+For instance by using the command
+.DS
+.sp 
+.ft RR
+.nf
+   echo "GV.screenSize: 396 x 291" | xrdb -override -screen
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+a width of 346 mm and a height of 291 mm will be used for the
+\*QNatural size\*U scale base.
+Alternatively the resource
+.DS
+.sp 
+.ft RR
+.nf
+   GV.screenSize_<machine>_<disp>_<scr>:  <width> x <height>
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+may be added to a resource file read by gv. Here
+<machine> ,<disp> and ANGLED) describe
+the display on which gv displays the document.
+For instance, if the display is set to \*Qtic.tac.toe.wo:0.1\*U
+the resource should be specified as
+.DS
+.sp 
+.ft RR
+.nf
+   GV.screenSize_tic_0_1: 396 x 291
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+Note that this method doesn't work on VMS.
+As a last alternative the resource
+.DS
+.sp 
+.ft RR
+.nf
+   GV.screenSize:  <width> x <height>
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+may be added to one of the resource files. However, for obvious reasons
+this method should be used only on single user machines.
+.Pp
+.IP "\fBScrolling\fP"
+.nr bi 1
+.Pp
+It is probably a de facto standard for user interfaces
+that windows are supposed to be scrolled by means of
+scrollbars attached to their sides.
+However, for various reasons the use of scrollbars
+has been minimized in gv.
+.Pp
+Instead, in all windows with obscured data, scrolling
+may be performed by
+pressing button1, moving the mouse, then releasing button1
+directly in the window. This includes the displayed page,
+zoom popups, the table of contents and the file and 
+directory lists displayed in the file selection popup.
+.Pp
+.IP "\fBDisplaying new versions of a document\fP"
+.nr bi 1
+.Pp
+During document creation it is usually desirable to
+always display the newest version of the document in work.
+.Pp
+Instead of explicitly loading it via the file selection
+popup the most recent version can be displayed by
+pressing the \*QRedisplay\*U button in the main window
+(VMS users should use the \*QUpdate File\*U entry in the
+\*QFile\*U menu).
+Choosing the \*QRedisplay\*U entry in the menu that pops
+up when clicking with the third mouse button anywhere on the
+displayed page certainly has the same effect.
+.Pp
+More comfortable is the "Watch File" feature which may
+be switched on by selecting the corresponding entry in the
+\*QState\*U menu. If activated gv will check
+every now and then if a new version of the displayed
+file exists. If so it will be displayed automatically.
+By default the file is checked about once every
+second.
+.Pp
+Finally it may also be left to the document creating program
+to trigger gv to update its display. To do so the
+program should send the SIGHUP signal to gv.
+For instance at the end of a shell script generating a
+postscript file from latex sources the line
+.DS
+.sp 
+.ft RR
+.nf
+   kill -SIGHUP <gv_pid>
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+may be added (here \f(CR<gv_pid>\fP is the process id of
+gv). Executing the script and thereby creating a new
+version of the document will then also cause the
+result to be displayed instantaneously.
+Please note that this feature is available only on X11 R6
+based systems. 
+.if \n(ll>1 .RE
+.nr ll -1
+
+.Pp
+.SH Availability 
+
+.Pp
+The source code of the most recent version of gv may be
+obtained from the following sources:
+.nr ll +1
+.nr t\n(ll 2
+.if \n(ll>1 .RS
+.IP "World Wide Web:"
+.nr bi 1
+.Pp
+http://wwwthep.physik.uni-mainz.de/~plass/gv/
+.IP "Anonymous ftp:"
+.nr bi 1
+.Pp
+ftp://thep.physik.uni-mainz.de/pub/gv/
+.if \n(ll>1 .RE
+.nr ll -1
+
+.SH Authors 
+
+.Pp
+.DS
+.sp 
+.ft RR
+.nf
+Johannes Plass             plass@thep.physik.uni-mainz.de
+                           Department of Physics
+                           Johannes Gutenberg University
+                           Mainz, Germany
+
+gv is derived from GhostView 1.5, created by
+          Tim Theisen      Systems Programmer
+Internet: tim@cs.wisc.edu  Department of Computer Sciences
+    UUCP: uwvax!tim        University of Wisconsin-Madison
+   Phone: (608)262-0438    1210 West Dayton Street
+     FAX: (608)262-9777    Madison, WI   53706
+.DE
+.fi 
+.ec
+.ft P
+.sp
+
+.Pp
+.SH Suggestions and bug reports 
+
+.Pp
+Please send suggestions or bug reports to plass@thep.physik.uni-mainz.de.
+.Pp
+.Pp
+.Pp
+.Pp
