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
		 TeX.  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.

     0		 Bound to GhostviewMagstep(0) which is equivalent  to  pushing
		 the 0 menu button on the Magstep menu.

     1		 Bound to GhostviewMagstep(1) which is equivalent  to  pushing
		 the 1 menu button on the Magstep menu.

     2		 Bound to GhostviewMagstep(2) which is equivalent  to  pushing
		 the 2 menu button on the Magstep menu.

     3		 Bound to GhostviewMagstep(3) which is equivalent  to  pushing
		 the 3 menu button on the Magstep menu.

     4		 Bound to GhostviewMagstep(4) which is equivalent  to  pushing
		 the 4 menu button on the Magstep menu.

     5		 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
		 GhostviewSetOrientation(upside-down)  which  is equivalent to
		 pushing Upside-down  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