GHOSTVIEW(1) manual page

NAME

ghostview - View PostScript documents using ghostscript

SYNOPSIS

ghostview [filename]
or
ghostview [-monochrome] [-grayscale] [-color] [-[no]title] [-[no]date] [-[no]locator] [-[no]labels] [-resolution dpi ] [-dpi dpi ] [-xdpi dpi ] [-ydpi dpi ] [-magstep n ] [-[no]safer] [-[no]quiet] [-arguments arguments ] [-[no]center] [-portrait] [-landscape] [-upsidedown] [-seascape] [-[no]swap] [-letter] [-tabloid] [-ledger] [-legal] [-statement] [-executive] [-a3] [-a4] [-a5] [-b4] [-b5] [-folio] [-quarto] [-10x14] [-force] [-forceorientation] [-forcemedia] [-[no]openwindows] [-[no]ncdwm] [-page label ] [-toolkitoption  ...] [filename]

DESCRIPTION

The ghostview program provides an X11 user interface for the ghostscript interpreter. Ghostview and ghostscript function as two cooperating programs. Ghostview creates the viewing window and ghostscript draws in it.

Don't be alarmed by the number of options. Generally, one invokes ghostview with just one parameter, the name of the file to be previewed. If the filename is ``-'', ghostview will read from ``stdin''. The options provide a way to set X resources from the command line for a single invocation of ghostview . For that reason, discussion of the options is delayed until after the X resources are discussed.

MAIN WINDOW

The main viewport is on the right side of the main window. If the page is larger than the viewport, there will be scroll bars along the bottom and right edges of the viewport. To the left of the viewport is the table of contents. If the PostScript file has document structuring convention (DSC) comments, the table of context will display the page labels (i.e. usually page numbers). To the left of the table of contents is the menu box. Each push button brings up a popup menu. Over the menu box and table of contents there are three optional labels that contain the title, date, and locator. The title label contains the document title found in the DSC comments. If no title can be found, the filename is used in its place. The date label contains the document date found in the DSC comments. If no date can be found, the last modified date of the file is used in its place. Since the title and date labels may be clipped by the main viewport, the date and title labels are push buttons that bring up a popup window with the title or date. These popup windows also show the ``document'' icon when the displayed string comes from the DSC comments. The locator shows the location of the cursor in the viewport. The location is expressed in the default user coordinate system. The locator is useful for measuring bounding boxes.

Within the main viewport the mouse cursor is a ``target'' when ghostscript is doing work. The cursor is a ``cross hair'' when ghostscript is idle. When moving to another page in a document, it is generally best to wait for ghostscript to become idle. Otherwise, the current ghostscript process must be killed and the overhead of reading the prologue is incurred again.

Ghostview will check to see if the file has been modified just before it displays a page or when the application is deiconified. If the file has changed, it will reopen the file.

Clicking anywhere within the viewport will popup a zoom window. The window is centered about the location that was clicked. Clicking with the first mouse button pops up a low resolution zoom window. Clicking with the second mouse button pops up a medium resolution zoom window. Clicking with the third mouse button pops up a high resolution zoom window. The cursor in the zoom window will display a ``target'' or ``cross hair'' depending on the state of ghostscript . The locator reports the position of the cursor in the zoom windows as well as the main viewport.

In the table of contents, the first and third mouse button function exactly as they do in a Text widget. That is the first mouse button selects text and the third mouse button extends selections. However, clicking on a page label with the second mouse button will cause that page to be shown. The page being displayed is marked with a '<' in the right margin of the table of contents.

POPUP WINDOWS

There are several additional windows that may appear. The copyright window will appear whenever copyright information is requested. The information window appears whenever the ghostscript process writes to ``stdout'' or ``stderr''. Whenever there is an error in the PostScript program, the stack trace will appear in this window. When ghostscript is invoked without the quiet option, informational message regarding the state of ghostscript will appear in the information window. The copyright and information windows can be dismissed by pushing the ``Dismiss'' button.

The Select File dialog widget will appear when you wish to open or save a file. The Select File dialog widget allows an X11 user to select a file by typing the path or by browsing in directory listings and selecting entries with the mouse.

The space bar can be pressed to complete filenames, and tilde is used for home directories. All the usual key bindings can be used in the text widget, except for Return and Control-M, which are equivalent to pressing the OK button. The path can be scrolled using the large horizontal scroll bar, or by moving the insertion cursor in the text widget. The directory entries can be scrolled using the vertical scroll bars, or by holding a mouse button down and moving out of the listing. The scrolling speed varies with the distance from the listing.

The directory entries are terminated with special characters that show the type of entry, similar to the -F option of ls(1) .

The Select File dialog widget is in total control until is pops down. No other controls in ghostview will be active during this time.

MENUS

There are five buttons in the menu box. They are the File , Page , Magstep , Orientation , and Media buttons. There are keyboard accelerators for most of the popup menus. Be sure to read the keyboard accelerator section.
File
This popup menu controls file access:
Open...
Pops up the Select File window in preparation to open a file. The Select File widget is in total control until it pops down. Opens the file for viewing.
Reopen
Reopens the current file.
Print...
Pops up a dialog widget to ask for the printer name. Sends the whole document to the printer.
Print marked pages...
Pops up a dialog widget to ask for the printer name. Sends the marked pages to the printer. If no pages have been marked, the mark procedure is called before printing and then the unmark procedure is called after printing.
Save marked pages...
Pops up the Select File window in preparation to save a file. The Select File widget is in total control until it pops down. Saves the marked pages in the selected file. If no pages have been marked, the mark procedure is called before saving and then the unmark procedure is called after saving.
Copyright...
Pops up the copyright window.
Quit
Causes ghostview to exit.
Page
This popup menu controls page access:
Next
Display the next page.
Redisplay
Display the current page.
Previous
Display the previous page.
Center
Center the page in the viewport.
Mark
Mark the pages that have been selected in the table of contents. If no pages have been selected, mark the current page.
Unmark
Unmark the pages that have been selected in the table of contents. If no pages have been selected, unmark the current page.
Magstep
The Magstep menu controls the magnification at which the document is viewed. The default magstep of 0 implies no magnification (i.e. the size on the screen should match the size on paper). Ghostview borrows the notion of magstep from . The magnification is defined to be 1.2**magstep. At magstep 1, the document is magnified by 1.2. At magstep -1, the document is reduced by 1.2. The Magstep menu lists values from -5 to 5.
Orientation
The Orientation menu controls the display orientation. A ``dot'' appears in front of the current orientation. The first mouse button sets the default orientation. The DSC comments may specify an orientation of Portrait or Landscape that overrides the default. In this case, a "document" appears in front of the current orientation. The second mouse button can be used to ``force'' the orientation on a document to override the DSC comments. If an orientation is being forced, then a ``tie fighter'' will appear in front of the current orientation.
Portrait
Set the orientation to Portrait. This implies no rotation. A portrait orientation indicates that the longest edge of the paper is parallel to the vertical (y) axis.
Landscape
Set the orientation to Landscape. This implies a clockwise rotation of the paper by 90 degrees. A landscape orientation indicates that the longest edge of the paper is parallel to the horizontal (x) axis.
Upside-down
Set the orientation to Upside-Down.
Seascape
Set the orientation to Seascape. This implies a counterclockwise rotation of the paper by 90 degrees.
Swap Landscape
Swap the meaning of Landscape and Seascape. Most of the Landscape documents that I have encountered require a 90 clockwise rotation of the paper to view. However, there is no standard and some documents need to be rotated the other way. The swap landscape button allows ghostview to automatically rotate the document the right way in response to the %%Orientation comment in the PostScript file.
Media
The entries on the Media menu set the page media. Media defined in the document appear at the beginning of the menu separated by a line from the standard media. A ``dot'' appears in front of the current media. The first mouse button sets the default media. The DSC comments may specify the page media that overrides the default. In this case, a "document" appears in front of the current media. The second mouse button can be used to ``force'' the media on a document to override the DSC comments. Forcing the media on an EPSF figure will override the Bounding Box. This makes is easy to view a figure with an incorrect %%BoundingBox comment. If a media is being forced, then a ``tie fighter'' will appear in front of the current media.

Here are the standard media names and their sizes. The size is given as the width and height in PostScript points.

Letter     612 x 792    (8.5 x 11 in.)
Tabloid     792 x 1224    (11 x 17 in.)
Ledger    1224 x 792    (17 x 11 in.)
Legal     612 x 1008    (8.5 x 14 in.)
Statement     396 x 612    (5.5 x 8.5 in.)
Executive     540 x 720    (7.5 x 10 in.)
A3     842 x 1190
A4     595 x 842
A5     420 x 595
B4     729 x 1032
B5     516 x 729
Folio     612 x 936    (8.5 x 13 in.)
Quarto     610 x 780
10x14     720 x 1008    (10 x 14 in.)

KEYBOARD ACCELERATORS

Most of the popup menu commands have an equivalent action that can be invoked from the keyboard. The popup menu entry must be sensitive (i.e. not grayed out) for the action to have effect. Here is the default keyboard binding:
Q
Bound to GhostviewQuit() which is equivalent to pushing the Quit menu button on the Ghostview menu.
O
Bound to GhostviewOpen() which is equivalent to pushing the Open... menu button on the File menu.
R
Bound to GhostviewReopen() which is equivalent to pushing the Reopen menu button on the File menu.
S
Bound to GhostviewSave() which is equivalent to pushing the Save marked pages... menu button on the File menu.
P
Bound to GhostviewPrintMarked() which is equivalent to pushing the Print marked pages... menu button on the File menu.
Shift-P
Bound to GhostviewPrintWhole() which is equivalent to pushing the Print... menu button on the File menu.
BackSpace , Delete , Prior , B
Bound to GhostviewPrevious() which is equivalent to pushing the Previous menu button on the Page menu.
space , Return , Next , F
Bound to GhostviewNext() which is equivalent to pushing the Next menu button on the Page menu.
period , Ctrl-L
Bound to GhostviewShow() which is equivalent to pushing the Redisplay menu button on the Page menu.
M
Bound to GhostviewMark() which is equivalent to pushing the Mark menu button on the Page menu.
N
Bound to GhostviewUnMark() which is equivalent to pushing the Unmark menu button on the Page menu.
  • Bound to GhostviewMagstep(0) which is equivalent to pushing the 0 menu button on the Magstep menu.
  • Bound to GhostviewMagstep(1) which is equivalent to pushing the 1 menu button on the Magstep menu.
  • Bound to GhostviewMagstep(2) which is equivalent to pushing the 2 menu button on the Magstep menu.
  • Bound to GhostviewMagstep(3) which is equivalent to pushing the 3 menu button on the Magstep menu.
  • Bound to GhostviewMagstep(4) which is equivalent to pushing the 4 menu button on the Magstep menu.
  • Bound to GhostviewMagstep(5) which is equivalent to pushing the 5 menu button on the Magstep menu.
    • +
    Bound to GhostviewIncreaseMagstep() which increases the magstep by 1.
    -
    Bound to GhostviewDecreaseMagstep() which decreases the magstep by 1.
    U
    Bound to GhostviewUp() which scrolls the main viewport up.
    D
    Bound to GhostviewDown() which scrolls the main viewport down.
    H
    Bound to GhostviewLeft() which scrolls the main viewport left.
    J
    Bound to GhostviewDown() which scrolls the main viewport down.
    K
    Bound to GhostviewUp() which scrolls the main viewport up.
    L
    Bound to GhostviewRight() which scrolls the main viewport right.
    Up (arrow)
    Bound to GhostviewDefault() GhostviewSetOrientation(portrait) which is equivalent to pushing Portrait with the first mouse button on the Orientation menu.
    Right (arrow)
    Bound to GhostviewDefault() GhostviewSetOrientation(landscape) which is equivalent to pushing Landscape with the first mouse button on the Orientation menu.
    Down (arrow)
    Bound to GhostviewDefault() GhostviewSetOrientation(upside-down) which is equivalent to pushing Upside-down with the first mouse button on the Orientation menu.
    Left (arrow)
    Bound to GhostviewDefault() GhostviewSetOrientation(seascape) which is equivalent to pushing Seascape with the first mouse button on the Orientation menu.
    Shift-Up (arrow)
    Bound to GhostviewForce() GhostviewSetOrientation(portrait) which is equivalent to pushing Portrait with the second mouse button on the Orientation menu.
    Shift-Right (arrow)
    Bound to GhostviewForce() GhostviewSetOrientation(landscape) which is equivalent to pushing Landscape with the second mouse button on the Orientation menu.
    Shift-Down (arrow)
    Bound to GhostviewForce() GhostviewSetOrientation(upside-down) which is equivalent to pushing Upside-down with the second mouse button on the Orientation menu.
    Shift-Left (arrow)
    Bound to GhostviewForce() GhostviewSetOrientation(seascape) which is equivalent to pushing Seascape with the second mouse button on the Orientation menu.

    ACTIONS

    Most of the popup menu commands have an equivalent action that can be used in a translation. The popup menu entry must be sensitive (i.e. not grayed out) for the action to have effect. Here is the list of actions:
    GhostviewCopyright()
    Equivalent to pushing the Copyright... menu button on the Ghostview menu.
    GhostviewQuit()
    Equivalent to pushing the Quit menu button on the Ghostview menu.
    GhostviewOpen()
    Equivalent to pushing the Open... menu button on the File menu.
    GhostviewReopen()
    Equivalent to pushing the Reopen menu button on the File menu.
    GhostviewSave()
    Equivalent to pushing the Save marked pages... menu button on the File menu.
    GhostviewPrintWhole()
    Equivalent to pushing the Print... menu button on the File menu.
    GhostviewPrintMarked()
    Equivalent to pushing the Print marked pages... menu button on the File menu.
    GhostviewPrevious()
    Equivalent to pushing the Previous menu button on the Page menu.
    GhostviewShow()
    Equivalent to pushing the Redisplay menu button on the Page menu.
    GhostviewNext()
    Equivalent to pushing the Next menu button on the Page menu.
    GhostviewCenter()
    Equivalent to pushing the Center menu button on the Page menu.
    GhostviewMark()
    Equivalent to pushing the Mark menu button on the Page menu.
    GhostviewUnmark()
    Equivalent to pushing the Unmark menu button on the Page menu.
    GhostviewSetMagstep(magstep)
    Sets the magstep. The parameter must be an integer.
    GhostviewIncreaseMagstep()
    Increases magstep by one.
    GhostviewDecreaseMagstep()
    Decreases magstep by one.
    GhostviewSetOrientation(orientation)
    Set the orientation to the passed parameter. The parameter must be portrait , landscape , upside-down , or seascape .
    GhostviewSwapLandscape()
    Equivalent to pushing the Swap Landscape menu button on the Orientation menu.
    GhostviewSetPageMedia(media-name)
    Sets the media. The parameter should be either a media defined in the document or a standard media.
    GhostviewDefault()
    The orientation or media being set is not forced on the document. This action is called before the action that sets the orientation or media.
    GhostviewForce()
    The orientation or media being set is forced on the document. This action is called before the action that sets the orientation or media.
    GhostviewDeleteWindow()
    Destroy the current window. This provides a way to implement the Delete Window protocol for window managers.
    GhostviewDismiss()
    Pop down the current window. This provides a way to implement the Delete Window protocol for window managers.
    GhostviewScrollUp()
    Scroll the main viewport up.
    GhostviewScrollDown()
    Scroll the main viewport down.
    GhostviewScrollLeft()
    Scroll the main viewport left.
    GhostviewScrollRight()
    Scroll the main viewport right.
    GhostviewEraseLocator()
    Used to erase the locator when leaving a Ghostview widget.
    GhostviewCheckFile()
    Checks to see if the file changed and refreshes the screen if necessary.

    APPLICATION RESOURCES

    The following application resources may be set to control the default behavior of ghostview .
    showTitle ( class Labels)
    Tells whether to display the %%Title comment. The default is ``true''.
    showDate ( class Labels)
    Tells whether to display the %%Data comment. The default is ``true''.
    showLocator ( class Labels)
    Tells whether to display the locator. The default is ``true''.
    autoCenter ( class AutoCenter)
    Tells whether to center the page within the viewport whenever the page size changes. The default is ``true''.
    horizonalMargin ( class Margin)
    Tells how many pixels ghostview should reserve for window decorations in the horizontal direction. The default value is ``20''.
    verticalMargin ( class Margin)
    Tells how many pixels ghostview should reserve for window decorations in the vertical direction. The default value is ``44''.
    minimumMagstep ( class Magstep)
    Tells the smallest magstep to display. The default is ``-5''.
    maximumMagstep ( class Magstep)
    Tells the largest magstep to display. The default is ``5''.
    magstep ( class Magstep)
    Sets the default magstep. The default is ``0''.
    orientation ( class Orientation)
    Sets the default orientation. The default is ``Portrait''.
    page ( class Page)
    Gives the initial page to display. This resource only affects the display of the file listed on the command line. The default is NULL.
    pageMedia ( class PageMedia)
    Sets the default page media. The default is ``Letter''.
    forceOrientation ( class Force)
    Tells whether to force the orientation on the document. The default is ``false''.
    forcePageMedia ( class Force)
    Tells whether to force the page media on the document. The default is ``false''.
    swapLandscape ( class SwapLandscape)
    Tells whether to swap the meaning of Landscape and Seascape. The default is ``false''.
    printCommand ( class PrintCommand)
    Sets the command used for printing. The printer environment variable is set to the desired printer and then this command is executed using popen. This command should read from ``stdin'' and send the file to the appropriate printer. The default value is ``lpr'' for BSD and ``lp'' for System V.
    printerVariable ( class PrinterVariable)
    Gives the name of the printer environment variable. The default value is ``PRINTER'' for BSD and ``LPDEST'' for System V.
    defaultPrinter ( class DefaultPrinter)
    Gives the printer name to use when the printer environment variable is not set. The default value is NULL.
    printPrompt ( class PrintPrompt)
    Sets the prompt used to ask for the printer name. The default value is ``Printer Name: ''.
    printFail ( class printFail)
    Sets the string used to inform the user that the printer command failed. The default is ``"lpr" command failed.''.
    openPrompt ( class OpenPrompt)
    Sets the prompt used to ask for a file name to open. The default value is ``Open File: ''.
    openFail ( class OpenFail)
    Sets the string used to inform the user that the open failed. The default value is ``Cannot open file: ''.
    savePrompt ( class SavePrompt)
    Sets the prompt used to ask for a file name to save. The default value is ``Save File: ''.
    saveFail ( class SaveFail)
    Sets the string used to inform the user that the save failed. The default value is ``Cannot save file: ''.
    openWindows ( class OpenWindows)
    OpenWindows servers sometimes cause error messages about bitmaps not being 1 bit deep. Turning on this resource avoids the problem by not using any bitmaps. You lose the functionality of having the current magstep, orientation and media marked on the popup menus. The default value is ``false''.
    ncdwm ( class Ncdwm)
    The Xt Intrinsics has a bug that causes bogus information in the window manager size hints. Ncdwm and possibly other window managers get confused by the bogus information and make the window extremely small. Twm and mwm ignore the bogus information. Turning on the resource avoids the problem with ncdwm by doing things slightly differently. However, this can confuse other window managers such as mwm . This bug is fixed in X11R5 fix-10. You should only set this resource if you have the problem. The default value is ``false''.

    GHOSTVIEW WIDGET RESOURCES

    Certain resources in the Ghostview widget may be set by the user. These selected resources are presented below.
    arguments ( class Arguments)
    Additional arguments passed to the interpreter. It is convenient to name files that preload fonts here for PostScript programs that continually reload fonts while rendering a page. The default is no additional arguments.
    busyCursor ( class Cursor)
    The cursor shown when ghostscript is rendering to the window. The busy cursor is set to the ``target'' by the application defaults.
    cursor ( class Cursor)
    The cursor shown when ghostscript is idle. The default cursor is the ``crosshair''.
    interpreter ( class Interpreter)
    The name of the executable to call to render the PostScript. It is convenient to set this resource to the path of an alternate version of ghostscript for testing. The default value is ``gs''.
    palette ( class Palette)
    Tells ghostscript how to restrict the palette used when rendering. The possible values are ``color'', ``grayscale'', and ``monochrome''. The default value is ``color''.
    quiet ( class Quiet)
    Tells ghostscript whether to supress informational messages. The default value is ``true''.
    safer ( class Safer)
    Tells ghostscript whether to run in ``safer'' mode. The default value is ``true''.
    useBackingPixmap ( class UseBackingPixmap)
    Tells whether to use a backing pixmap. If this resource is false, backing store is requested on the Ghostview window. Some X servers have limited resources for large pixmaps. Also, some X servers' backing store is much faster than using a backing pixmap. You should reset this resource if your X server is one of the server types mentioned. The default value is ``true''.
    xdpi ( class Resolution)
    Sets the X resolution of the window in dots per inch. You can use this resource to affect the main window. Zoom windows have their X dpi set explicitly in the program. The default value is calculated from the screen metrics.
    ydpi ( class Resolution)
    Sets the Y resolution of the window in dots per inch. You can use this resource to affect the main window. Zoom windows have their Y dpi set explicitly in the program. The default value is calculated from the screen metrics.

    GHOSTVIEW WIDGET ACTIONS

    notify(width height xdpi ydpi)
    The notify event is used by the ghostview application for the locator and popup zoom windows. If the width and height are 0, the event is user for the locator. Otherwise, it triggers a popup zoom window. The default width and height are 72. The default xdpi and ydpi are 300. The height will default to the width if the height is omitted. The xdpi will default to the xdpi if the ydpi is omitted.

    OPTIONS

    -monochrome
    Equivalent to setting ``*Ghostview.palette: Monochrome''.
    -grayscale
    Equivalent to setting ``*Ghostview.palette: GrayScale''.
    -color
    Equivalent to setting ``*Ghostview.palette: Color''.
    -title
    Equivalent to setting ``Ghostview.showTitle: True''.
    -notitle
    Equivalent to setting ``Ghostview.showTitle: False''.
    -date
    Equivalent to setting ``Ghostview.showDate: True''.
    -nodate
    Equivalent to setting ``Ghostview.showDate: False''.
    -locator
    Equivalent to setting ``Ghostview.showLocator: True''.
    -nolocator
    Equivalent to setting ``Ghostview.showLocator: False''.
    -labels
    Equivalent to setting ``Ghostview.Labels: True''.
    -nolabels
    Equivalent to setting ``Ghostview.Labels: False''.
    -resolution dpi
    Equivalent to setting ``*Ghostview.Resolution: dpi ''.
    -dpi dpi
    Equivalent to setting ``*Ghostview.Resolution: dpi ''.
    -xdpi dpi
    Equivalent to setting ``*Ghostview.xdpi: dpi ''.
    -ydpi dpi
    Equivalent to setting ``*Ghostview.ydpi: dpi ''.
    -magstep magstep
    Equivalent to setting ``Ghostview.magstep: magstep ''.
    -safer
    Equivalent to setting ``*Ghostview.safer: True''.
    -nosafer
    Equivalent to setting ``*Ghostview.safer: False''.
    -quiet
    Equivalent to setting ``*Ghostview.quiet: True''.
    -noquiet
    Equivalent to setting ``*Ghostview.quiet: False''.
    -arguments arguments
    Equivalent to setting ``*Ghostview.arguments: arguments ''.
    -center
    Equivalent to setting ``Ghostview.autoCenter: True''.
    -nocenter
    Equivalent to setting ``Ghostview.autoCenter: False''.
    -portrait
    Equivalent to setting ``Ghostview.orientation: Portrait''.
    -landscape
    Equivalent to setting ``Ghostview.orientation: Landscape''.
    -upsidedown
    Equivalent to setting ``Ghostview.orientation: Upside-down''.
    -seascape
    Equivalent to setting ``Ghostview.orientation: Seascape''.
    -swap
    Equivalent to setting ``Ghostview.swapLandscape: True''.
    -noswap
    Equivalent to setting ``Ghostview.swapLandscape: False''.
    -letter
    Equivalent to setting ``Ghostview.pageMedia: Letter''.
    -tabloid
    Equivalent to setting ``Ghostview.pageMedia: Tabloid''.
    -ledger
    Equivalent to setting ``Ghostview.pageMedia: Ledger''.
    -legal
    Equivalent to setting ``Ghostview.pageMedia: Legal''.
    -statement
    Equivalent to setting ``Ghostview.pageMedia: Statement''.
    -executive
    Equivalent to setting ``Ghostview.pageMedia: Executive''.
    -a3
    Equivalent to setting ``Ghostview.pageMedia: A3''.
    -a4
    Equivalent to setting ``Ghostview.pageMedia: A4''.
    -a5
    Equivalent to setting ``Ghostview.pageMedia: A5''.
    -b4
    Equivalent to setting ``Ghostview.pageMedia: B4''.
    -b5
    Equivalent to setting ``Ghostview.pageMedia: B5''.
    -folio
    Equivalent to setting ``Ghostview.pageMedia: Folio''.
    -quarto
    Equivalent to setting ``Ghostview.pageMedia: Quarto''.
    -10x14
    Equivalent to setting ``Ghostview.pageMedia: 10x14''.
    -force
    Equivalent to setting ``Ghostview.Force: True''.
    -forceorientation
    Equivalent to setting ``Ghostview.forceOrientation: True''.
    -forcemedia
    Equivalent to setting ``Ghostview.forcePageMedia: True''.
    -openwindows
    Equivalent to setting ``Ghostview.openWindows: True''.
    -noopenwindows
    Equivalent to setting ``Ghostview.openWindows: False''.
    -ncdwm
    Equivalent to setting ``Ghostview.ncdwm: True''.
    -noncdwm
    Equivalent to setting ``Ghostview.ncdwm: False''.
    -page label
    Equivalent to setting ``Ghostview.page: label ''.

    WIDGET HIERARCHY

    The hierarchy of the ghostview application:

    Ghostview ghostview
       Form form
           MenuButton titleButton
               SimpleMenu menu
                   SmeBSB title
           MenuButton dateButton
               SimpleMenu menu
                   SmeBSB date
           Label locator
           Box box
               MenuButton fileButton
                   SimpleMenu menu
                       SmeBSB open
                       SmeBSB reopen
                       SmeBSB printwhole
                       SmeBSB printmarked
                       SmeBSB save
                       SmeLine line
                       SmeBSB copyright
                       SmeBSB quit
               MenuButton pageButton
                   SimpleMenu menu
                       SmeBSB next
                       SmeBSB show
                       SmeBSB prev
                       SmeLine line
                       SmeBSB center
                       SmeLine line
                       SmeBSB mark
                       SmeBSB unmark
               MenuButton magstepButton
                   SimpleMenu menu
                       SmeBSB -5
                       SmeBSB -4
                       SmeBSB -3
                       SmeBSB -2
                       SmeBSB -1
                       SmeBSB 0
                       SmeBSB 1
                       SmeBSB 2
                       SmeBSB 3
                       SmeBSB 4
                       SmeBSB 5
               MenuButton orientationButton
                   SimpleMenu menu
                       SmeBSB portrait
                       SmeBSB landscape
                       SmeBSB upsidedown
                       SmeBSB seascape
                       SmeLine line
                       SmeBSB swap
               MenuButton pagemediaButton
                   SimpleMenu menu
                       SmeBSB Letter
                       SmeBSB Tabloid
                       SmeBSB Ledger
                       SmeBSB Legal
                       SmeBSB Statement
                       SmeBSB Executive
                       SmeBSB A3
                       SmeBSB A4
                       SmeBSB A5
                       SmeBSB B4
                       SmeBSB B5
                       SmeBSB Folio
                       SmeBSB Quarto
                       SmeBSB 10x14
           Text toc
           Viewport pageview
               Core clip
               Ghostview page
               Scrollbar horizontal
               Scrollbar vertical
       TopLevelShell information
           Form form
               Text text
               Command dismiss
       TopLevelShell copyright
           Form form
               Text text
               Command dismiss
       TransientShell popup
           Form dialog
               Label prompt
               Text response
               Command okay
               Command cancel
       TopLevelShell zoom
           Form form
               Ghostview page
               Command dismiss

    The hierarchy of the Select File dialog box:

    TransientShell selFile
       Form selFileForm
           Label selFilePrompt
           Text selFileField
           Scrollbar selFileHScroll
           Composite selFileList1
               Scrollbar selFileVScroll
               Scrollbar selFileHScroll
           Composite selFileList2
               Scrollbar selFileVScroll
               Scrollbar selFileHScroll
           Composite selFileList3
               Scrollbar selFileVScroll
               Scrollbar selFileHScroll
           Command selFileOK
           Command selFileCancel

    ENVIRONMENT

    LPDEST
    The LPDEST environment variable gives the default printer destination on System V.
    PRINTER
    The PRINTER environment variable gives the default printer destination on BSD.

    LIMITATIONS

    If the document does not begin with ``%!PS-Adobe-'', it does not claim conformance to the document structuring convention. When these documents are encountered, the functionality of ghostview is limited to giving you scroll bars and a next page capability. Because there is no table of contents, skipping around the document and marking pages is impossible.

    If there is no table of contents for the document, the popup zoom window will always show the first page.

    BUGS

    If you find a bug, please send a bug report to ghostview@cs.wisc.edu.

    AUTHOR

    Copyright (C) 1992 Timothy O. Theisen

    This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

    You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

    Author:    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

    ACKNOWLEDGEMENTS

    The Select File widget contains the following copyright notice:

    Copyright 1989 Software Research Associates, Inc., Tokyo, Japan

    Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of Software Research Associates not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. Software Research Associates makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

    SOFTWARE RESEARCH ASSOCIATES DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL SOFTWARE RESEARCH ASSOCIATES BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

    Author:    Erik M. van der Poel
       Software Research Associates, Inc., Tokyo, Japan
       erik@sra.co.jp