# gxditview

## Name



           gxditview - display groff intermediate output files in X11
    


## Synopsis



           **gxditview**[_X-toolkit-option_ ...] [**-backingStore** _backing-store-_
                     _type_] [**-filename** _string_] [**-page** _n_]
                     [**-printCommand** _string_] [**-resolution** _res_] _file_
    
           **gxditview -help**
           **gxditview --help**
    


## Description



           _gxditview_ interprets and displays the intermediate output format
           of _groff_(1) on an X11 display.  It uses the standard X11 fonts, so
           it does not require access to the server machine for font loading.
           There are several ways to use _gxditview_.
    
           The intermediate output format of _groff_ , documented in
           _groff_out_(5), is produced by _troff_ or the **-Z** option to _groff_.  It
           can be viewed by explicitly calling “**gxditview** _file_ ”.  If the _file_
           operand is “**-** ”, _gxditview_ will read the standard input stream;
           _file_ cannot be omitted.  The intermediate output format of _groff_
           is device-independent but not device-agnostic.  _gxditview_ can view
           it for all typesetter devices, but the quality is device-
           dependent.  _gxditview_ will not display output for terminal (_nroff_)
           devices.
    
           The best results are achieved with the **X** * devices for _groff_ 's **-T**
           option, of which there are four: **-TX75** , **-TX75-12** , **-TX100** , and
           **-TX100-12**.  They differ by the X resolution (75 or 100 dots per
           inch) and the base point size (10 or 12 points).  They are
           especially built for _gxditview_.  When using one of these, _groff_
           generates the intermediate output for this device and calls
           _gxditview_ automatically for viewing.
    
           **-X** produces good results only with **-Tps** , **-TX75** , **-TX75-12** , **-TX100** ,
           and **-TX100-12**.  The default resolution for previewing **-Tps** output
           is 75dpi; this can be changed with the **-resolution** option.
    
           While _gxditview_ is running, the left mouse button brings up a menu
           with several 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 initially
                  displayed is controlled by the **printCommand** application
                  resource, and by the **-printCommand** option.
    
           **Open** Open for display a new file specified by a dialog box.  The
                  file should contain _groff_ intermediate output.  If the
                  filename starts with a bar or pipe symbol, “**|** ” it will be
                  interpreted as a command from which to read.
    
           **Quit** Exit from **gxditview**.
    
           The menu entries correspond to actions with similar but not
           identical names, which can also be accessed with keyboard
           accelerators.  The _n_ , _Space_ , _Return_ , and _Next_ (_PgDn_) keys are
           bound to the **NextPage** action.  The _p_ , _b_ , _BackSpace_ , _Delete_ , and
           _Prior_ (_PgUp_) keys are bound to the **PreviousPage** action.  The _g_ key
           is bound to the **SelectPage** action.  The _o_ key is bound to the
           **OpenFile** action.  The _q_ key is bound to the **Quit** action.  The _r_
           key is bound to a **Rerasterize** action which rereads the current
           file, and redisplays the current page; if the current file is a
           command, the command will be re-executed.  Vertical scrolling can
           be done with the _k_ and _j_ keys; horizontal scrolling is bound to
           the _h_ and _l_ keys.  The arrow keys (_up_ , _down_ , _left_ , and _right_) are
           also bound to the obvious scrolling actions.
    
           The **paperlength** and **paperwidth** commands in the _DESC_ file
           describing a _groff_ output device specify the length and width in
           machine units of the virtual page displayed by _gxditview_ ; see
           _groff_font_(5).
    
       **X defaults**
           This program uses the _Dvi_ widget from 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.
    
           **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 whitespace-separated fields:
                  firstly the _groff_ font name, and secondly the XLFD (X
                  Logical Font Description).  The default is shown in
                  subsection “Default font map” below.
    
       **Default font map**
           XLFDs are long and unwieldy, so some lines are shown broken and
           indented below.
    
           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\
    


## Options



           _gxditview_ 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 document to be
                  displayed.
    
           **-backingStore** _backing-store-type_
                  Because redisplay of the _groff_ intermediate output window
                  can take a perceiptible amount of time, 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.  _backing-store-type_ can be
                  one of **Always** , **WhenMapped** or **NotUseful**.
    
           **-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_ dots per inch, 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 **75**.
    
           **-filename** _string_
                  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 background
                  of the window.  The default is “**white** ”.
    
           **-bd** _color_
                  This option specifies the color to use for the border 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 displaying text.
                  The default is “**black** ”.
    
           **-fn** _font_
                  This option specifies the font to be used for displaying
                  widget text.  The default is “**fixed** ”.
    
           **-rv** This option indicates that reverse video should be
                  simulated by swapping the foreground and background colors.
    
           **-geometry** _geometry_
                  This option specifies the preferred size and position 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.
    


## Environment



           _GROFF_FONT_PATH_
                  A list of directories in which to seek the selected output
                  device's directory of device and font description files.
                  See _troff_(1) and _groff_font_(5).
    


## Files



           _/GXditview_
           _/GXditview-color_
                  The default resource files of _gxditview_.  Users can
                  override these values in the _.Xdefaults_ file, normally
                  located in the user's home directory.  See _xrdb_(1) and
                  _appres_(1) for more.
    


## Examples



           The following command views this man page with a base point size
           of 12.
    
                  groff -TX100-12 -man gxditview.1
    
           The quality of the result depends mainly on the chosen point size
           and display resolution; for rapid previewing, however, something
           like
                  groff -X -P-resolution -P100 _document_
           yields acceptable results.
    


## Authors



           _gxditview_ and its predecessor _xditview_ were written by Keith
           Packard (MIT X Consortium), Richard L. Hyde (Purdue), David
           Slattengren (Berkeley), Malcolm Slaney (Schlumberger Palo Alto
           Research), Mark Moraes (University of Toronto), and James Clark.
    
           This program is derived from _xditview_ ; portions of _xditview_
           originated in _xtroff_ , which was derived from _suntroff_.
    


## See also



           “X Logical Font Description Conventions” 
           ⟨https://www.x.org/releases/X11R7.6/doc/xorg-docs/specs/XLFD/xlfd
           .html⟩, by Jim Flowers and Stephen Gildea.
    
           _X_(7), _xrdb_(1), _xditview_(1), _groff_(1), _groff_out_(5)
    


* * *