1GXDITVIEW(1) General Commands Manual GXDITVIEW(1)
2
3
4
6 gxditview - display groff intermediate output files
7
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
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
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
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
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
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
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
220 X(7), xrdb(1), xditview(1), groff(1), groff_out(5)
221
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)