Penguin
Recent Changes
Annotated edit history of gv(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 JohnMcPherson 1 !!Name
2 gv - a !PostScript and PDF previewer
3
4
5 !!Synopsis
6
7 gv [[ filename ]
8 [[-monochrome] [[-grayscale] [[-color]
9 [[-[[no]safer] [[-[[no]quiet] [[-arguments <arguments>]
10 [[-page <label>] [[-[[no]center]
11 [[-media <media>]
12 [[-portrait] [[-landscape] [[-upsidedown] [[-seascape]
13 [[-scale <n>] [[-scalebase <n>]
14 [[-swap] [[-noswap]
15 [[-antialias] [[-noantialias]
16 [[-dsc] [[-nodsc]
17 [[-eof] [[-noeof]
18 [[-pixmap] [[-nopixmap]
19 [[-watch] [[-nowatch]
20 [[-?] [[-h] [[-help] [[-v]
21 [[-resize] [[-noresize]
22 [[-geometry [[<width>][[x<height>][[{+-}<xoffset>{+-}<yoffset>]
23 [[-ad <resource file>]
24 [[-style <resource file>]
25 [[-spartan]
26 [[<other toolkit options>]
27
28 !!Description
2 StuartYeates 29 gv allows to view and navigate through [PostScript] and [PDF] documents on an X display by providing a user interface for the ghostscript interpreter.
1 JohnMcPherson 30
31 Please note that gv is derived from Tim Theisen's ghostview 1.5.
32
33
34 !!Options
35 ;__filename__: The name of the file to be displayed. The file ending ".ps" may be omitted. "filename" may point to a compressed file (gzipped, zipped or compressed). Viewing PDF files requires at least ghostscript version 4.x.
36
37 ;__-ad <resource file>__: 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.
38
39 ;__-antialias__, __-noantialias__: Whether to use antialiasing.
40
41 ;__-arguments <arguments>__: Start ghostscript with additional options as specified by the string <arguments>.
42
43 ;__-center__, __-nocenter__: Whether the page should be centered automatically.
44
45 ;__-dsc__, __-nodsc__: 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.
46
47 ;__-eof__, __-noeof__: 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.
48
49 ;__-pixmap__, __-nopixmap__: 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 "useBackingPixmap" resource).
50
51 ;__-v__ : Print the version number of gv to standard output and exit.
52
53 ;__-h__, __-?__ : Display a short help message and exit.
54
55 ;__-help__: Display a more explicit help message and exit.
56
57 ;__-scale <n>__: Selects the scale entry <n> relative to the scale 1.0. <n> must be an integer.
58
59 ;__-scalebase <n>__: Selects the scale base <n>.
60
61 ;__-monochrome__, __-grayscale__, __-color__: Sets the color palette to be used.
62
63 ;__-media <media>__: 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.
64
65 ;__-page <label>__: Display the page with label <label> first.
66
67 ;__-portrait__, __-landscape__, __-seascape__, __-upsidedown__: Sets the orientation.
68
69 ;__-quiet__, __-noquiet__: Whether to start ghostscript with the -dQUIET option.
70
71 ;__-resize__, __-noresize__: Whether gv is allowed to automatically fit the size of its window to the size of the displayed page.
72
73 ;__-safer__, __-nosafer__: Whether to start ghostscript with the -dSAFER option.
74
75 ;__-spartan__: This is a shortcut for "-style gv_spartan.dat".
76
77 ;__-style <resource file>__: 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.
78
79 ;__-swap__, __-noswap__: Whether to interchange the meaning of the orientations landscape and seascape.
80
81 ;__-watch__, __-nowatch__: 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.
82
83 !!Resources
84
85 !Resource files
86 In general gv does not depend on any external resource files. However, when starting gv, preferences are read from
87
88 * __a system specific resource file__. The name of this file is as described by the "XFILESEARCHPATH" environment variable, or, if this variable is not defined, implementation dependent. In most cases it is "/usr/X11/lib/X11/app-defaults/GV". Administrators may want to modify this file in order to set up gv according to the local needs of their system.
89 * __a user specific resource file__. The name of this file is either "~/.gv" or as described by the "XUSERFILESEARCHPATH" environment variable.
90
91
92 The files "gv_user.ad" and "gv_system.ad" (located in the library directory of gv, which is most probably either "/usr/local/lib/gv/" or "/usr/lib/gv/" may serve as a basis for constructing the user and system specific resource files.
93
94 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.
95
96 !Resources of gv
97
98 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.
99
100 ;antialias: Whether antialiasing should be used. Valid values are "True" and "False".
101 ;autoCenter: Whether the displayed page should automatically be centered (for instance when opening a new file). Valid values are "True" and "False".
102 ;autoResize: Whether gv is allowed to resize the main window according to the size of the current page. Valid values are "True" and "False".
103 ;confirmPrint: Whether printing requires an extra confirmation. Valid values are "True" and "False".
104 ;confirmQuit: Whether leaving gv requires extra confirmation. Valid values are "0" (Never), "1" (When processing) and "2" (Always). The default value is "1", which causes a confirmation request when trying to leave gv in the presence of pending PDF to Postscript conversions.
105 ;scrollingEyeGuide: If this resource is "True" scrolling via the keyboard causes a temporary border to be drawn around the previously visible area of the page. Allowed values are "True" and "False".
106 ;ignoreEOF: Defines the behaviour of the postscript scanner as described in the Options section. Valid values are "True" and "False".
107 ;respectDSC: Determines whether gv should attempt to respect document structuring comments. Valid values are "True" and "False".
108 ;reverseScrolling: Defines the interpretation of directions when scrolling with the mouse. Valid values are "True" and "False".
109 ;swapLandscape: Whether the meaning of "landscape" and "seacape" should be interchanged. Valid values are "True" and "False".
110 ;scratchDir: Specifies a directory used to store temporary data.
111 ;defaultSaveDir: Specifies the default destination directory for files to be saved.
112 ;useBackingPixmap: If the value of this resource is "False" 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 "True" 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.
113 ;watchFile: Whether the document should be checked periodically and updated automatically if changes are detected. Valid values are "True" and "False".
114 ;watchFileFrequency: Defines the time in milliseconds elapsing between successive checks of the document when watchFile is set to "True". Allowed values must be larger than 500.
115 ;printCommand: 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.
116 ;gsInterpreter: The command used to start the ghostscript interpreter.
117 ;gsCmdScanPDF: The command used to extract document structuring comments from a PDF file.
118 ;gsCmdConvPDF: The command used to convert a PDF file to !PostScript.
119 ;gsX11Device: The ghostscript command line option which activates the "X11" device.
120 ;gsX11AlphaDevice: The ghostscript command line option which activates the "X11" device with antialiasing enabled.
121 ;gsSafer: Determines whether ghostscript should be started with the "-dSAFER" command line option.
122 ;gsQuiet: Determines whether ghostscript should be started with the "-dQUIET" command line option.
123 ;gsArguments: May be used to provide additional command line options for the ghostscript interpreter. Starting gv with the "-arguments <arguments>" option will override this resource setting.
124 ;magMenu: Describes the menu that pops up when preparing to to zoom an area of the displayed page.
125 ;dirs: Defines a list of directories accessible via the Directories menu in the file selection window. The special value "Home" corresponds to the users home directory, the value "Tmp" corresponds to the scratch directory as defined by the scratchDir resource.
126 ;filter: 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
127 <filter> := [[<filespecs>] [[no <filespecs>]
128 <filespecs> := <filespec> [[<filespecs>]
129 <filespec> := filename possibly including wildcards '*'
130 which match any character.
131 Example: The filter
132 GV*filter: *.ps *.pdf no .*
133 screens out all files with names starting with a dot and keeps of the remaining ones only those which end on ".ps" or ".pdf".
134 ;filters: Defines a list of filters offered in the Filters menu of the file selection window. The filter "None" has a special meaning causing all files to be displayed when the corresponding menu entry is selected.
135 ;miscMenuEntries: 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 "update", "redisplay", "toggle_current", "toggle_even", "toggle_odd", "unmark", "stop", "print_all", "print_marked", "save_all", "save_marked" and "line".
136 ;showTitle: 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 "True".
137 ;maximumWidth, maximumHeight: When resizing gv will not attempt to exceed the size specified by these resources. These resources may be specified as a positive integer or as "screen", optionally combined with a positive or negative offset. The default values listed above provide examples for this syntax. "screen" will automatically be replaced by the size of the screen.
138 ;minimumWidth, minimumHeight: Defines a minimum size for the main window. Valid values for both resources are positive integers larger than 200.
139 ;scale: 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 "Scale" menu.
140 ;scaleBase: Selects the initial scale base. The value of this resource should be a positive integer.
141 ;scales: Defines the available scales bases and scales in the "Scale" menu.
142 ;orientation: Sets the initial orientation. Valid values are "portrait", "landscape","seascape", "upside-down" and "automatic". "automatic" causes gv to attempt to derive the correct orientation from document structuring comments.
143 ;fallbackOrientation: Defines the paper-size to be used when automatic orientation detection fails. Valid values are "portrait", "landscape","seascape" and "upside-down".
144 ;medias: A list describing the page medias known to gv. List entries starting with "!" or "#" will not appear in the "Media" menu but will still be used for automatic paper size detection.
145 ;pagemedia: Sets the paper size. Allowed values are as given in the above list of paper-sizes. Specifying "automatic" causes gv to attempt to derive the correct paper-size from document structuring comments.
146 ;fallbackPageMedia: Defines the paper-size to be used when automatic paper-size detection fails. Valid values are as given in the above list of paper-sizes.
147
148 !The default user and system specific resource file
149 GV.pageMedia: automatic
150 GV.orientation: automatic
151 GV.fallbackOrientation: portrait
152 GV.swapLandscape: False
153 GV.autoCenter: True
154 GV.antialias: False
155 GV.respectDSC: True
156 GV.ignoreEOF: True
157 GV.confirmPrint: True
158 GV.reverseScrolling: False
159 GV.scrollingEyeGuide: True
160 GV.autoResize: True
161 GV.maximumWidth: screen-20
162 GV.maximumHeight: screen-44
163 GV.minimumWidth: 400
164 GV.minimumHeight: 430
165 GV.confirmQuit: 1
166 GV.watchFile: False
167 GV.watchFileFrequency: 1000
168 GV.showTitle: True
169 GV.miscMenuEntries: redisplay \n\
170 # update \n\
171 stop \n\
172 line \n\
173 toggle_current \n\
174 toggle_even \n\
175 toggle_odd \n\
176 unmark \n\
177 line \n\
178 print_all \n\
179 print_marked \n\
180 save_all \n\
181 save_marked
182 GV.scale: 0
183 GV.scaleBase: 1
184 GV.scales: Natural size, 1.000, screen \n\
185 Pixel based, 1.000, pixel \n\
186 0.100, 0.100 \n\
187 0.125, 0.125 \n\
188 0.250, 0.250 \n\
189 0.500, 0.500 \n\
190 0.707, 0.707 \n\
191 1.000, 1.000 \n\
192 1.414, 1.414 \n\
193 2.000, 2.000 \n\
194 4.000, 4.000 \n\
195 8.000, 8.000 \n\
196 10.00, 10.00
197 GV.medias: Letter, 612 792 \n\
198 # !LetterSmall, 612 792 \n\
199 Legal, 612 1008 \n\
200 Statement, 396 612 \n\
201 Tabloid, 792 1224 \n\
202 Ledger, 1224 792 \n\
203 Folio, 612 936 \n\
204 Quarto, 610 780 \n\
205 # 7x9, 504 648 \n\
206 # 9x11, 648 792 \n\
207 # 9x12, 648 864 \n\
208 # 10x13, 720 936 \n\
209 10x14, 720 1008 \n\
210 Executive, 540 720 \n\
211 # A0, 2384 3370 \n\
212 # A1, 1684 2384 \n\
213 # A2, 1191 1684 \n\
214 A3, 842 1191 \n\
215 A4, 595 842 \n\
216 # A4Small, 595 842 \n\
217 A5, 420 595 \n\
218 # A6, 297 420 \n\
219 # A7, 210 297 \n\
220 # A8, 148 210 \n\
221 # A9, 105 148 \n\
222 # A10, 73 105 \n\
223 # B0, 2920 4127 \n\
224 # B1, 2064 2920 \n\
225 # B2, 1460 2064 \n\
226 # B3, 1032 1460 \n\
227 B4, 729 1032 \n\
228 B5, 516 729 \n\
229 # B6, 363 516 \n\
230 # B7, 258 363 \n\
231 # B8, 181 258 \n\
232 # B9, 127 181 \n\
233 # B10, 91 127 \n\
234 # ISOB0, 2835 4008 \n\
235 # ISOB1, 2004 2835 \n\
236 # ISOB2, 1417 2004 \n\
237 # ISOB3, 1001 1417 \n\
238 # ISOB4, 709 1001 \n\
239 # ISOB5, 499 709 \n\
240 # ISOB6, 354 499 \n\
241 # ISOB7, 249 354 \n\
242 # ISOB8, 176 249 \n\
243 # ISOB9, 125 176 \n\
244 # ISOB10, 88 125 \n\
245 # C0, 2599 3676 \n\
246 # C1, 1837 2599 \n\
247 # C2, 1298 1837 \n\
248 # C3, 918 1296 \n\
249 # C4, 649 918 \n\
250 # C5, 459 649 \n\
251 # C6, 323 459 \n\
252 # C7, 230 323 \n\
253 # DL, 312 624
254 GV.magMenu: 2, 2 \n\
255 4, 4 \n\
256 8, 8 \n\
257 16, 16 \n\
258 32, 32 \n\
259 64, 64
260 GV*Ghostview.background: white
261 GV*Ghostview.foreground: black
262 GV.gsInterpreter: gs
263 GV.gsCmdScanPDF: gs -dNODISPLAY -dQUIET -sPDFname=%s -sDSCname=%s pdf2dsc.ps -c quit
264 GV.gsCmdConvPDF: gs -dNODISPLAY -dQUIET -dNOPAUSE -sPSFile=%s %s -c quit
265 GV.gsX11Device: -sDEVICE=x11
266 GV.gsX11AlphaDevice: -dNOPLATFONTS -sDEVICE=x11alpha
267 GV.gsSafer: True
268 GV.gsQuiet: True
269 GV.gsArguments:
270 GV.uncompressCommand: gzip -d -c %s > %s
271 GV.printCommand: lpr
272 GV.scratchDir: /tmp/
273 GV.defaultSaveDir: ~/
274 GV.fallbackPageMedia: a4
275 GV.useBackingPixmap: True
276 GV*dirs: Home\n\
277 Tmp\n\
278 /usr/share/doc\n\
279 /usr/local/doc
280 GV*filter: no .*
281 GV*filters: None\n\
282 *.*ps* *.pdf* no .*\n\
283 *.*ps* no .*\n\
284 *.pdf* no .*\n\
285 no .*
286 !!Mouse and key bindings
287 __Mouse bindings in the Main and the Zoom window__: The following mouse events are defined when the mouse pointer is either on the displayed page or on a zoomed area:
288 * __-__ press button 1, move mouse, release button 1: Scrolls the displayed page 'proportionally'.
289 * __-__ press button 3, move mouse, release button 3: Scrolls the displayed page 'absolutely'.
290 * __-__ double-click with button 1: 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.
291 * __-__ press button 2, release button 2: 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.
292 * __-__ press button 2, move mouse, release button 2: 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.
293 * __-__ press button 1, press button 2: Redisplays the current page. This event sequence works only in the main window.
294 * __-__ press button 3, release button 3: Pops up a small menu which offers a few standard actions like 'Redisplay', 'Mark Page', etc.
295
296
297 ;__Mouse bindings in the File Selection popup__: The following mouse events are defined when the mouse pointer is in the window of either a file or a directory list:
298
299 * __-__ press button 1, move mouse, release button 1: Scrolls a file or directory list 'proportionally'.
300 * __-__ press button 2, move mouse, release button 2: Scrolls a file or directory list 'absolutely'.
301 * __-__ press 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.
302 * __-__ double-click with button 1 on a filename: Selects the file and closes the File Selection popup.
303 * __-__ click with button 1 on a directory name: Causes the contents of this directory to be displayed.
304
305 ;__Mouse bindings in the Table of Contents__: 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):
306
307 * __-__ press button 1, move mouse, release button 1: Scrolls the table of contents.
308 * __-__ press button 1 on a page number: Go to this page.
309 * __-__ press button 2 on a page number: Mark this page if it is unmarked, but unmark it if it is marked.
310 * __-__ press button 2, move mouse, release button 2: Marks/unmarks all unmarked/marked pages in the region crossed by the mouse pointer during the movement.
311
312 ;__Mouse bindings in the Panner widget__: 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.
313
314 The following mouse events are defined when the mouse pointer is in this region:
315 * __-__ press button 1, move mouse: Scrolls the displayed page.
316 * __-__ press button 2: Display the previous page.
317 * __-__ press button 3: Display the next page.
318
319 ;__Mouse bindings in the ">>" and "<<" button windows__: The ">>" and "<<" buttons are used to move to another page. The following mouse events are defined:
320 * __-__ press button 1: Move 1 page forward/backwards.
321 * __-__ press button 2: Move 5 pages forward/backwards.
322 * __-__ press button 3: Move 10 pages forward/backwards.
323
324
325 ;__Key Bindings__: The following key events are defined in the main window. Those bindings scrolling the page are also defined in zoom popups.
326
327 === Notation:
328
329
330
331 s-X means press "Shift" and key "X"
332 c-X means press "Ctrl" and key "X"
333 sc-X means press "Shift" or "Ctrl" and key "X"
334
335
336
337 === Miscellaneous keys:
338
339
340
341 A Toggle antialiasing on and off
342 O Open a new file
343 Q Quit gv
344 R Toggle gv's resizing behaviour
345 I Respect/Ignore document structuring
346 W Watch file / Don't watch file
347 S Save the marked pages
348 sc-S Save the current file
349 P Print the marked pages
350 sc-P Print the current file
351 c-L Redisplay the current page
352 . Redisplay the current page
353 sc-. Reopen the current file
354 M Mark the current page
355 N Unmark the current page
356
357
358
359 === Orientation:
360
361
362
363 7 Orientation portrait
364 8 Orientation landscape
365 9 Orientation upside-down
366 0 Orientation seascape
367
368
369
370 === Magnification:
371
372
373
374 sc-6 Select the scale entry -6 relative to the scale 1.0
375 sc-5 Select the scale entry -5 relative to the scale 1.0
376 sc-4 Select the scale entry -4 relative to the scale 1.0
377 sc-3 Select the scale entry -3 relative to the scale 1.0
378 sc-2 Select the scale entry -2 relative to the scale 1.0
379 sc-1 Select the scale entry -1 relative to the scale 1.0
380 ^ Select the scale 1.0 (for german keyboard layout)
381 ` Select the scale 1.0
382 1 Select the scale entry 1 relative to the scale 1.0
383 2 Select the scale entry 2 relative to the scale 1.0
384 3 Select the scale entry 3 relative to the scale 1.0
385 4 Select the scale entry 4 relative to the scale 1.0
386 5 Select the scale entry 5 relative to the scale 1.0
387 6 Select the scale entry 6 relative to the scale 1.0
388 + Select the next scale entry
389 = Select the next scale entry
390 - Select the previous scale entry
391
392
393
394 === Navigating:
395
396
397
398 Arrow Scroll in the direction of the arrow
399 s-Up Scroll columns up or jump -1 pages
400 s-Down Scroll columns down or jump 1 pages
401 s-Left Scroll rows left or jump -1 pages
402 s-Right Scroll rows right or jump 1 pages
403 c-Up Jump -1 pages (to top/left corner)
404 c-Down Jump 1 pages (to top/left corner)
405 c-Left Jump -5 pages (to top/left corner)
406 c-Right Jump 5 pages (to top/left corner)
407
408
409
410 D,X,Z,Y,C Identical to arrow up,down,left,left,right
411 V Center the page
412 sc-Space Scroll columns up or jump -1 pages
413 Space Scroll columns down or jump 1 pages
414
415
416 !BackSpace Scroll columns up or jump -1 pages
417 Insert Jump -5 pages
418 Delete Jump 5 pages
419 Home Go to the first page
420 End Go to the last page
421 Prior Jump -1 pages
422 Next Jump 1 pages
423
424
425
426 Keypad 0-9 Highlight a page number
427 Keypad - Highlight previous page number
428 Keypad + Highlight next page number
429 Keypad Enter Jump to the highlighted page
430
431
432
433 c-Enter Jump -1 pages
434 s-Enter Jump -1 pages
435 Enter Jump 1 pages
436 B Jump -1 pages
437 F Jump 1 pages
438
439
440 !!Comments about the user interface
441
442 ;__Scales__: The "Scale" 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.
443
444 By default two scales bases are available, the "Natural size" and the "Pixel based" base. When choosing the "Pixel based" scale base a relative scale of 1.0 causes one postscript point to correspond to one pixel on the screen.
445
446 When viewing a document at a relative scale of 1.0 using the "Natural size" base the page should appear in its real size, as if printed on paper. For the "Natural size" 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
447 GV.screenSize: <width> x <height>
448 should be added to the "SCREEN_RESOURCES" 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
449 echo "GV.screenSize: 396 x 291" | xrdb -override -screen
450 a width of 346 mm and a height of 291 mm will be used for the "Natural size" scale base. Alternatively the resource
451 GV.screenSize_<machine>_<disp>_<scr>: <width> x <height>
452 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 "tic.tac.toe.wo:0.1" the resource should be specified as
453 GV.screenSize_tic_0_1: 396 x 291
2 StuartYeates 454 Note that this method doesn't work on [VMS]. As a last alternative the resource
1 JohnMcPherson 455 GV.screenSize: <width> x <height>
456 may be added to one of the resource files. However, for obvious reasons this method should be used only on single user machines.
457 ;__Scrolling__: 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.
458
459 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.
460
461
462 ;__Displaying new versions of a document__: During document creation it is usually desirable to always display the newest version of the document in work.
463
464 Instead of explicitly loading it via the file selection popup the most recent version can be displayed by pressing the "Redisplay" button in the main window (VMS users should use the "Update File" entry in the "File" menu). Choosing the "Redisplay" entry in the menu that pops up when clicking with the third mouse button anywhere on the displayed page certainly has the same effect.
465
466 More comfortable is the "Watch File" feature which may be switched on by selecting the corresponding entry in the "State" 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.
467
468 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
469 kill -SIGHUP <gv_pid>
470 may be added (here <gv_pid> 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.
471
472 !!Availability
473
474
475 The source code of the most recent version of gv may be obtained from the following sources:
476
477 ;World Wide Web: http://wwwthep.physik.uni-mainz.de/~plass/gv/
478
479
480 !!Authors
481 Johannes Plass plass @ thep. physik.uni-mainz.de
482 Department of Physics
483 Johannes Gutenberg University
484 Mainz, Germany
485 gv is derived from GhostView 1.5, created by
486 Tim Theisen Systems Programmer
487 Internet: tim@ cs. wisc.edu Department of Computer Sciences
488 UUCP: uwvax!tim University of Wisconsin-Madison
489 Phone: (608)262-0438 1210 West Dayton Street
490 FAX: (608)262-9777 Madison, WI 53706
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.