man pages section 1: User Commands

Exit Print View

Updated: July 2014

gxditview (1)


gxditview - display groff intermediate output files


gxditview [-toolkitoption ...] [-option ...] [filename]


User Commands                                        GXDITVIEW(1)

     gxditview - display groff intermediate output files

     gxditview [-toolkitoption ...] [-option ...] [filename]

     The  gxditview  program displays the groff intermediate out-
     put, see groff_out(5), on an X display.  It uses  the  stan-
     dard  X11 fonts, so it does not require access to the server
     machine for font loading.  There are  several  ways  to  use

     The  groff intermediate output can be generated by groff -Z.
     This can be viewed by explicity calling gxditview  filename.
     If  filename  is  -, gxditview will read the standard input;
     filename cannot be omitted.  The groff  intermediate  output
     is different for all devices.  gxditview can view it for all
     devices, but the quality is not always good.

     The best result is achieved with the X* devices for  groff's
     option  -T.   There  are  four  X* devices: -TX75, -TX75-12,
     -TX100, -TX100-12.  They differ by the X  resolution  (75dpi
     or 100dpi) and the used base font size (10pt or 12pt).  They
     are especially built for gxditview.  When using one of  them
     groff  generates the intermediate output for this device and
     calls gxditview automatically for viewing.

     groff's option -X should be considered  obsolete  today;  it
     produces   intermediate   output  for  Postscript  and  uses
     gxditview as a viewer for it, but with a bad quality.   Sim-
     ply don't use it.

     During the run of gxditview, the left mouse button brings up
     a menu with the following entries:

     Next Page
             Display the next page.

     Previous Page
             Display the previous page.

     Select Page
             Select a particular numbered  page  specified  by  a
             dialog box.

     Print   Print  the groff intermediate output using a command
             specified by a dialog box.  The default command ini-
             tially  displayed  is controlled by the printCommand
             application  resource,  and  by  the   -printCommand

Groff Version 1.19.2 Last change: 3 July 2005                   1

User Commands                                        GXDITVIEW(1)

     Open    Open  for  display  a new file specified by a dialog
             box.  The file should contain some groff  intermedi-
             ate  output.   If the filename starts with | it will
             be taken to be a command to read from.

     Quit    Exit from gxditview.

     The n, Space and Return keys  are  bound  to  the  Next Page
     action.   The  p, BackSpace and Delete keys are bound to the
     Previous Page action.  The  q  key  is  bound  to  the  Quit
     action.   The r key is bound to the Rerasterize action which
     rereads the current file, and redisplays the  current  page;
     if the current file is a command, the command will be reexe-

     The paperlength and paperwidth commands  in  the  DESC  file
     specify the length and width in machine units of the virtual
     page displayed by gxditview.

     The gxditview program accepts all of the standard X  Toolkit
     command  line  options  along  with  the  additional options
     listed below:

     -help   This option indicates that a brief  summary  of  the
             allowed options should be printed.

     -page   This  option  specifies the page number of the docu-
             ment to be displayed.

     -backingStore backing-store-type
             Redisplay of the groff  intermediate  output  window
             can  take  up  to a second or so, this option causes
             the server to save the window contents so that  when
             it  is  scrolled  around the viewport, the window is
             painted from contents saved in backing store.  back-
             ing-store-type  can  be one of Always, WhenMapped or

     -printCommand command
             The default command displayed in the dialog box  for
             the Print menu entry will be command.

     -resolution res
             The groff intermediate output file will be displayed
             at a resolution of res dpi,  unless  the  DESC  file
             contains  the  X11 command, in which case the device
             resolution will be used.  This  corresponds  to  the
             Dvi  widget's  resolution  resource.  The default is

     -filename string

Groff Version 1.19.2 Last change: 3 July 2005                   2

User Commands                                        GXDITVIEW(1)

             The default filename displayed in the dialog box for
             the  Open  menu  entry  will be string.  This can be
             either a filename, or a command starting with |.

     The following standard X Toolkit command line arguments  are
     commonly used with gxditview:

     -bg color
             This option specifies the color to use for the back-
             ground of the window.  The default is white.

     -bd color
             This option specifies the color to use for the  bor-
             der of the window.  The default is black.

     -bw number
             This  option  specifies  the  width in pixels of the
             border surrounding the window.

     -fg color
             This option specifies the color to use for  display-
             ing text.  The default is black.

     -fn font
             This  option  specifies the font to be used for dis-
             playing widget text.  The default is fixed.

     -rv     This option indicates that reverse video  should  be
             simulated  by swapping the foreground and background

     -geometry geometry
             This option specifies the preferred size  and  posi-
             tion of the window.

     -display host:display
             This option specifies the X server to contact.

     -xrm resourcestring
             This  option specifies a resource string to be used.

     This program uses the Dvi  widget  in  the  X  Toolkit.   It
     understands  all  of  the core resource names and classes as
     well as:

     width (class Width)
             Specifies the width of the window.

     height (class Height)
             Specifies the height of the window.

Groff Version 1.19.2 Last change: 3 July 2005                   3

User Commands                                        GXDITVIEW(1)

     foreground (class Foreground)
             Specifies the default foreground color.

     font (class Font)
             Specifies the font to be used for error messages.

     fontMap (class FontMap)
             Specifies the  mapping  from  groff  font  names  to
             X  font  names.   This must be a string containing a
             sequence of lines.  Each line  contains  two  white-
             space  separated  fields: first the groff font name,
             and secondly the X font name.  The default is
             TR   -adobe-times-medium-r-normal--*-100-*-*-*-*-iso8859-1\n\
             TI   -adobe-times-medium-i-normal--*-100-*-*-*-*-iso8859-1\n\
             TB   -adobe-times-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
             TBI  -adobe-times-bold-i-normal--*-100-*-*-*-*-iso8859-1\n\
             CR   -adobe-courier-medium-r-normal--*-100-*-*-*-*-iso8859-1\n\
             CI   -adobe-courier-medium-o-normal--*-100-*-*-*-*-iso8859-1\n\
             CB   -adobe-courier-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
             CBI  -adobe-courier-bold-o-normal--*-100-*-*-*-*-iso8859-1\n\
             HR   -adobe-helvetica-medium-r-normal--*-100-*-*-*-*-iso8859-1\n\
             HI   -adobe-helvetica-medium-o-normal--*-100-*-*-*-*-iso8859-1\n\
             HB   -adobe-helvetica-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
             HBI  -adobe-helvetica-bold-o-normal--*-100-*-*-*-*-iso8859-1\n\
             NR   -adobe-new century schoolbook-medium-r-normal--*-100-*-*-*-*-iso8859-1\n\
             NI   -adobe-new century schoolbook-medium-i-normal--*-100-*-*-*-*-iso8859-1\n\
             NB   -adobe-new century schoolbook-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
             NBI  -adobe-new century schoolbook-bold-i-normal--*-100-*-*-*-*-iso8859-1\n\
             S    -adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\n\
             SS   -adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\n\

     See  attributes(5)  for  descriptions   of   the   following

     |Availability   | text/groff       |
     |Stability      | Uncommitted      |
     X(1), xrdb(1), xditview(1), groff(1), groff_out(5)

     This  program is derived from xditview; portions of xditview
     originated in xtroff which was derived from suntroff.

Groff Version 1.19.2 Last change: 3 July 2005                   4

User Commands                                        GXDITVIEW(1)

     Copyright 1989, Massachusetts Institute of Technology.
     See X(1) for a full statement of rights and permissions.

     Keith Packard (MIT X Consortium)
     Richard L. Hyde (Purdue)
     David Slattengren (Berkeley)
     Malcolm Slaney (Schlumberger Palo Alto Research)
     Mark Moraes (University of Toronto)
     James Clark

     This  software  was   built   from   source   available   at    The  original
     community       source       was       downloaded       from

     Further  information about this software can be found on the
     open source community  website  at

Groff Version 1.19.2 Last change: 3 July 2005                   5