1GXDITVIEW(1) General Commands Manual GXDITVIEW(1)
2
6 gxditview - display groff intermediate output files
7
9 gxditview [-toolkitoption ...] [-option ...] [filename]
10
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 The groff intermediate output can be generated by groff -Z. This can
18 be viewed by explicitly 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 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 groff -TX100-12 -man -rS12 gxditview.1
32 (option -rSXX is documented in the groff_man(7) man page).
34 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 groff -X -P-resolution -P100 document
41 yields acceptable results.
43 During the run of gxditview, the left mouse button brings up a menu
45 with the following entries:
46 Next Page
48 Display the next page.
49 Previous Page
51 Display the previous page.
52 Select Page
54 Select a particular numbered page specified by a dialog box.
55 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 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 Quit Exit from gxditview.
67 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 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
84 The gxditview program accepts all of the standard X Toolkit command
85 line options along with the additional options listed below:
86 -help This option indicates that a brief summary of the allowed
88 options should be printed.
89 -page This option specifies the page number of the document to be
91 displayed.
92 -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 -printCommand command
102 The default command displayed in the dialog box for the Print
103 menu entry will be command.
104 -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 -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 The following standard X Toolkit command line arguments are commonly
118 used with gxditview:
119 -bg color
121 This option specifies the color to use for the background of
122 the window. The default is white.
123 -bd color
125 This option specifies the color to use for the border of the
126 window. The default is black.
127 -bw number
129 This option specifies the width in pixels of the border sur‐
130 rounding the window.
131 -fg color
133 This option specifies the color to use for displaying text.
134 The default is black.
135 -fn font
137 This option specifies the font to be used for displaying widget
138 text. The default is fixed.
139 -rv This option indicates that reverse video should be simulated by
141 swapping the foreground and background colors.
142 -geometry geometry
144 This option specifies the preferred size and position of the
145 window.
146 -display host:display
148 This option specifies the X server to contact.
149 -xrm resourcestring
151 This option specifies a resource string to be used.
152
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 width (class Width)
158 Specifies the width of the window.
159 height (class Height)
161 Specifies the height of the window.
162 foreground (class Foreground)
164 Specifies the default foreground color.
165 font (class Font)
167 Specifies the font to be used for error messages.
168 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
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
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
209 X(7), xrdb(1), xditview(1), groff(1), groff_out(5)
210
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
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
226Groff Version 1.22.3 4 November 2014 GXDITVIEW(1)