1GXDITVIEW(1)                General Commands Manual               GXDITVIEW(1)
2
3
4

NAME

6       gxditview - display groff intermediate output files
7

SYNOPSIS

9       gxditview [X-toolkit-option...] [-backingStore backing-store-type]
10                 [-filename string] [-page n] [-printCommand string]
11                 [-resolution res] [file]
12
13       gxditview -help
14       gxditview --help
15

DESCRIPTION

17       The  gxditview  program  displays  the  groff  intermediate output, see
18       groff_out(5), on an X display.  It uses the standard X11 fonts,  so  it
19       does  not require access to the server machine for font loading.  There
20       are several ways to use gxditview.
21
22       The groff intermediate output can be generated by groff -Z.   This  can
23       be  viewed by explicitly calling gxditview filename.  If filename is -,
24       gxditview will read the standard input;  filename  cannot  be  omitted.
25       The  groff intermediate output is different for all devices.  gxditview
26       can view it for all devices, but the quality is device dependent.
27
28       The best results are achieved with the X* devices  for  groff's  option
29       -T.   There  are  four  X* devices: -TX75, -TX75-12, -TX100, -TX100-12.
30       They differ by the X resolution (75dpi or 100dpi)  and  the  used  base
31       font  size  (10pt  or  12pt).  They are especially built for gxditview.
32       When using one of them groff generates the intermediate output for this
33       device  and calls gxditview automatically for viewing.  For example, to
34       view this man page with a base resolution of 12pt, say
35
36              groff -TX100-12 -man -rS12 gxditview.1
37
38       (option -rSXX is documented in the groff_man(7) man page).
39
40       groff's option -X produces intermediate output for the  PostScript  de‐
41       vice  and  subsequently uses gxditview as a viewer for it.  The quality
42       of the result depends mainly on the chosen point size and display reso‐
43       lution; for rapid previewing, however, something like
44
45              groff -X -P-resolution -P100 document
46
47       yields acceptable results.
48
49       During  the  run  of  gxditview, the left mouse button brings up a menu
50       with the following entries:
51
52       Next Page
53               Display the next page.
54
55       Previous Page
56               Display the previous page.
57
58       Select Page
59               Select a particular numbered page specified by a dialog box.
60
61       Print   Print the groff intermediate output using a  command  specified
62               by  a  dialog  box.  The default command initially displayed is
63               controlled by the printCommand application resource, and by the
64               -printCommand option.
65
66       Open    Open  for  display  a  new file specified by a dialog box.  The
67               file should contain some groff  intermediate  output.   If  the
68               filename starts with | it will be taken to be a command to read
69               from.
70
71       Quit    Exit from gxditview.
72
73       The n, Space, Return, and Next (PgDn) keys are bound to  the  Next Page
74       action.   The  p, b, BackSpace, Delete, and Prior (PgUp) keys are bound
75       to the Previous Page action.  The g key is bound to the SelectPage  ac‐
76       tion.   The  o key is bound to the OpenFile action.  The q key is bound
77       to the Quit action.  The r key is bound to the Rerasterize action which
78       rereads  the current file, and redisplays the current page; if the cur‐
79       rent file is a command,  the  command  will  be  reexecuted.   Vertical
80       scrolling  can  be  done with the k and j keys; horizontal scrolling is
81       bound to the h and l keys.  The arrow keys (up, down, left, and  right)
82       are also bound to the obvious scrolling actions.
83
84       The  paperlength  and  paperwidth commands in the DESC file specify the
85       length and width in machine units of  the  virtual  page  displayed  by
86       gxditview.
87

OPTIONS

89       The  gxditview  program  accepts all of the standard X Toolkit command-
90       line options along with the additional options listed below:
91
92       -help   This option indicates that a brief summary of the  allowed  op‐
93               tions should be printed.
94
95       -page   This  option  specifies  the  page number of the document to be
96               displayed.
97
98       -backingStore backing-store-type
99               Redisplay of the groff intermediate output window can  take  up
100               to  a  second  or so, this option causes the server to save the
101               window contents so that when it is scrolled  around  the  view‐
102               port,  the  window  is  painted  from contents saved in backing
103               store.  backing-store-type can be one of Always, WhenMapped  or
104               NotUseful.
105
106       -printCommand command
107               The  default  command displayed in the dialog box for the Print
108               menu entry will be command.
109
110       -resolution res
111               The groff intermediate output file will be displayed at a reso‐
112               lution  of  res dpi, unless the DESC file contains the X11 com‐
113               mand, in which case the device resolution will be  used.   This
114               corresponds  to  the Dvi widget's resolution resource.  The de‐
115               fault is 75.
116
117       -filename string
118               The default filename displayed in the dialog box for  the  Open
119               menu entry will be string.  This can be either a filename, or a
120               command starting with |.
121
122       The following standard X Toolkit command-line  arguments  are  commonly
123       used with gxditview:
124
125       -bg color
126               This  option  specifies  the color to use for the background of
127               the window.  The default is white.
128
129       -bd color
130               This option specifies the color to use for the  border  of  the
131               window.  The default is black.
132
133       -bw number
134               This  option  specifies  the width in pixels of the border sur‐
135               rounding the window.
136
137       -fg color
138               This option specifies the color to  use  for  displaying  text.
139               The default is black.
140
141       -fn font
142               This option specifies the font to be used for displaying widget
143               text.  The default is fixed.
144
145       -rv     This option indicates that reverse video should be simulated by
146               swapping the foreground and background colors.
147
148       -geometry geometry
149               This  option  specifies  the preferred size and position of the
150               window.
151
152       -display host:display
153               This option specifies the X server to contact.
154
155       -xrm resourcestring
156               This option specifies a resource string to be used.
157

X DEFAULTS

159       This program uses the Dvi widget in the X Toolkit.  It understands  all
160       of the core resource names and classes as well as:
161
162       width (class Width)
163               Specifies the width of the window.
164
165       height (class Height)
166               Specifies the height of the window.
167
168       foreground (class Foreground)
169               Specifies the default foreground color.
170
171       font (class Font)
172               Specifies the font to be used for error messages.
173
174       fontMap (class FontMap)
175               Specifies  the  mapping  from groff font names to X font names.
176               This must be a string containing a  sequence  of  lines.   Each
177               line  contains two whitespace separated fields: first the groff
178               font name, and secondly the X font name.  The default is
179               "\
180               TR   -adobe-times-medium-r-normal--*-100-*-*-*-*-iso8859-1\n\
181               TI   -adobe-times-medium-i-normal--*-100-*-*-*-*-iso8859-1\n\
182               TB   -adobe-times-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
183               TBI  -adobe-times-bold-i-normal--*-100-*-*-*-*-iso8859-1\n\
184               CR   -adobe-courier-medium-r-normal--*-100-*-*-*-*-iso8859-1\n\
185               CI   -adobe-courier-medium-o-normal--*-100-*-*-*-*-iso8859-1\n\
186               CB   -adobe-courier-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
187               CBI  -adobe-courier-bold-o-normal--*-100-*-*-*-*-iso8859-1\n\
188               HR   -adobe-helvetica-medium-r-normal--*-100-*-*-*-*-iso8859-1\n\
189               HI   -adobe-helvetica-medium-o-normal--*-100-*-*-*-*-iso8859-1\n\
190               HB   -adobe-helvetica-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
191               HBI  -adobe-helvetica-bold-o-normal--*-100-*-*-*-*-iso8859-1\n\
192               NR   -adobe-new century schoolbook-medium-r-normal--*-100-*-*-*-*-iso8859-1\n\
193               NI   -adobe-new century schoolbook-medium-i-normal--*-100-*-*-*-*-iso8859-1\n\
194               NB   -adobe-new century schoolbook-bold-r-normal--*-100-*-*-*-*-iso8859-1\n\
195               NBI  -adobe-new century schoolbook-bold-i-normal--*-100-*-*-*-*-iso8859-1\n\
196               S    -adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\n\
197               SS   -adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\n\
198               "
199

ENVIRONMENT

201       GROFF_FONT_PATH
202              A list of directories in which to search for the devname  direc‐
203              tory  in  addition  to  the  default  ones.   See  troff(1)  and
204              groff_font(5) for more details.
205

FILES

207       /usr/share/X11/app-defaults/GXditview
208       /usr/share/X11/app-defaults/GXditview-color
209              The default resource files of gxditview.  Users should  override
210              these  values  in  the  .Xdefaults file, normally located in the
211              user's home directory.  See xrdb(1) and appres(1) for more.
212

AUTHORS

214       gxditview and its predecessor xditview were written  by  Keith  Packard
215       (MIT X Consortium), Richard L. Hyde (Purdue), David Slattengren (Berke‐
216       ley), Malcolm Slaney (Schlumberger Palo  Alto  Research),  Mark  Moraes
217       (University of Toronto), and James Clark.
218

SEE ALSO

220       X(7), xrdb(1), xditview(1), groff(1), groff_out(5)
221

ORIGIN

223       This  program is derived from xditview; portions of xditview originated
224       in xtroff which was derived from suntroff.
225
226
227
228groff 1.22.4                    20 January 2022                   GXDITVIEW(1)
Impressum