Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 9, 2022

gxditview (1)


gxditview - display groff intermediate output files


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


GXDITVIEW(1)                General Commands Manual               GXDITVIEW(1)

       gxditview - display groff intermediate output files

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

       The  gxditview  program  displays  the  groff  intermediate output, see
       groff_out(5), on an X 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 groff intermediate output can be generated by groff -Z.   This  can
       be  viewed by explicitly 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 device dependent.

       The best results are 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.  For example, to
       view this man page with a base resolution of 12pt, say

              groff -TX100-12 -man -rS12 gxditview.1

       (option -rSXX is documented in the groff_man(7) man page).

       groff's option -X  produces  intermediate  output  for  the  Postscript
       device and subsequently uses gxditview as a viewer for it.  The quality
       of the result depends mainly on the chosen point size and display reso-
       lution; for rapid previewing, however, something like

              groff -X -P-resolution -P100 document

       yields acceptable results.

       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 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 some groff  intermediate  output.   If  the
               filename starts with | it will be taken to be a command to read

       Quit    Exit from gxditview.

       The n, Space, Return, and Next (PgDn) keys are bound to  the  Next Page
       action.   The  p, b, BackSpace, Delete, and Prior (PgUp) keys are bound
       to the Previous Page 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 the Rerasterize action which
       rereads  the current file, and redisplays the current page; if the cur-
       rent file is a command,  the  command  will  be  reexecuted.   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 specify the
       length and width in machine units of  the  virtual  page  displayed  by

       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 document to be

       -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  view-
               port,  the  window  is  painted  from contents saved in backing
               store.  backing-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 reso-
               lution  of  res dpi, unless the DESC file contains the X11 com-
               mand, 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 sur-
               rounding 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

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

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

              A list of directories in which to search for the devname  direc-
              tory  in  addition  to  the  default  ones.   See  troff(1)  and
              groff_font(5) for more details.

              The default resource files of gxditview.  Users should  override
              these  values  in  the  .Xdefaults file, normally located in the
              user's home directory.  See xrdb(1) and appres(1) for more.

       See attributes(7) for descriptions of the following attributes:

       |Availability   | text/groff       |
       |Stability      | Uncommitted      |

       X(7), 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.

       Copyright (C) 1989, Massachusetts Institute of Technology.
       See X(7) 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

       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source                was                downloaded                from

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/groff.

Groff Version 1.22.3            4 November 2014                   GXDITVIEW(1)