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

NAME

6       gxditview - display groff intermediate output files
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

X DEFAULTS

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

ENVIRONMENT

196       GROFF_FONT_PATH
197              A list of directories in which to search for the devname  direc‐
198              tory  in  addition  to  the  default  ones.   See  troff(1)  and
199              groff_font(5) for more details.
200

FILES

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

SEE ALSO

209       X(7), xrdb(1), xditview(1), groff(1), groff_out(5)
210

ORIGIN

212       This program is derived from xditview; portions of xditview  originated
213       in xtroff which was derived from suntroff.
214
216       Copyright 1989, Massachusetts Institute of Technology.
217       See X(7) for a full statement of rights and permissions.
218

AUTHORS

220       Keith Packard (MIT X Consortium)
221       Richard L. Hyde (Purdue)
222       David Slattengren (Berkeley)
223       Malcolm Slaney (Schlumberger Palo Alto Research)
224       Mark Moraes (University of Toronto)
225       James Clark
226
227
228
229Groff Version 1.22.2            7 February 2013                   GXDITVIEW(1)
Impressum