* fixes of groffer 0.9.2
[s-roff.git] / src / xditview / gxditview.man
blob86800019fccfb19062ecfe4390c61def6fc8700b
1 .TH GXDITVIEW 1 "Release 5" "X Version 11"
2 .SH NAME
3 gxditview \- display gtroff output files
4 .SH SYNOPSIS
5 .B gxditview
6 .RI [\fB\- toolkitoption\  .\|.\|.\|]
7 .RI [\fB\- option\  .\|.\|.\|]
8 .RI [ filename ]
9 .SH DESCRIPTION
10 The
11 .I gxditview 
12 program displays gtroff output on an X display.
13 It uses the standard X11 fonts,
14 so it does not require access to the server machine for font loading.
15 .PP
17 .I filename
19 .BR \- ,
20 .I gxditview
21 will read the standard input.
22 .PP
23 The left mouse button brings up a menu with the following entries:
24 .TP 8
25 .B "Next Page"
26 Display the next page.
27 .TP
28 .B "Previous Page"
29 Display the previous page.
30 .TP
31 .B "Select Page"
32 Select a particular numbered page specified by a dialog box.
33 .TP
34 .B Print
35 Print the gtroff output using a command specified by a dialog box.
36 The default command initially displayed is controlled by the
37 .B printCommand
38 application resource, and by the
39 .B \-printCommand
40 option.
41 .TP
42 .B Open
43 Open for display a new file specified by a dialog box.
44 The file should contain gtroff output.
45 If the filename starts with
46 .B |
47 it will be taken to be a command to read from.
48 .TP
49 .B Quit
50 Exit from
51 .IR gxditview .
52 .PP
53 The
54 .BR n ,
55 Space
56 and Return keys are bound to the
57 .B Next\ Page
58 action.
59 The
60 .BR p ,
61 BackSpace
62 and
63 Delete
64 keys are bound to the
65 .B Previous\ Page
66 action.
67 The
68 .B q
69 key is bound to the
70 .B Quit
71 action.
72 The
73 .B r
74 key is bound to the
75 .B Rerasterize
76 action which rereads the current file, and redisplays the current page;
77 if the current file is a command, the command will be reexecuted.
78 .PP
79 The
80 .B paperlength
81 and
82 .B paperwidth
83 commands in the DESC file specify the length and width in machine units
84 of the virtual page displayed by
85 .IR gxditview .
86 .SH OPTIONS
87 .I Gxditview
88 accepts all of the standard X Toolkit command line options along with the 
89 additional options listed below:
90 .TP 8
91 .B \-help
92 This option indicates that a brief summary of the allowed options should be
93 printed.
94 .TP
95 .B \-page
96 This option specifies the page number of the document to be displayed.
97 .TP
98 .BI \-backingStore\  backing-store-type
99 Redisplay of the gtroff output window can take upto a second or so,
100 this option causes the server to save the window contents so that when
101 it is scrolled around the viewport, the window is painted from
102 contents saved in backing store.
103 .I backing-store-type
104 can be one of
105 .BR Always ,
106 .B WhenMapped
107 or 
108 .BR NotUseful .
110 .BI \-printCommand\  command
111 The default command displayed in the dialog box for the
112 .B Print
113 menu entry will be
114 .IR command .
116 .BI \-resolution\  res
117 The gtroff output file will be displayed at a resolution of
118 .I res
119 dpi,
120 unless the DESC file contains the
121 .B X11
122 command, in which case the device resolution will be used.
123 This corresponds the
124 .I Dvi
125 widget's
126 .B resolution
127 resource.
128 The default is 75.
130 .BI \-filename\  string
131 The default filename displayed in the dialog box for the
132 .B Open
133 menu entry will be
134 .IR string .
135 This can be either a filename, or a command starting with
136 .BR | .
138 The following standard X Toolkit command line arguments are commonly used with 
139 .IR gxditview :
140 .TP 8
141 .BI \-bg\  color
142 This option specifies the color to use for the background of the window.  
143 The default is \fIwhite\fP.
145 .BI \-bd\  color
146 This option specifies the color to use for the border of the window.
147 The default is \fIblack\fP.
149 .BI \-bw\  number
150 This option specifies the width in pixels of the border surrounding the window.
152 .BI \-fg\  color
153 This option specifies the color to use for displaying text.  The default is 
154 \fIblack\fP.
156 .BI \-fn\  font
157 This option specifies the font to be used for displaying widget text.  The
158 default is \fIfixed\fP.
160 .B \-rv
161 This option indicates that reverse video should be simulated by swapping
162 the foreground and background colors.
164 .BI \-geometry\  geometry
165 This option specifies the preferred size and position of the window.
167 .BI \-display\  host : display
168 This option specifies the X server to contact.
170 .BI \-xrm\  resourcestring
171 This option specifies a resource string to be used.
172 .SH X DEFAULTS
173 This program uses the 
174 .I Dvi
175 widget in the X Toolkit.  It understands all of the core resource names and
176 classes as well as:
178 .TP 8
179 .BR width\  (class\  Width )
180 Specifies the width of the window.
182 .BR height\  (class\  Height )
183 Specifies the height of the window.
185 .BR foreground\  (class\  Foreground )
186 Specifies the default foreground color.
188 .BR font\  (class\  Font )
189 Specifies the font to be used for error messages.
191 .BR fontMap\  (class\  FontMap )
192 Specifies the mapping from groff font names to X font names.  This
193 must be a string containing a sequence of lines.  Each line contains
194 two whitespace separated fields: first the groff font name, and
195 secondly the X font name.  The default is
198 TR      -adobe-times-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
199 TI      -adobe-times-medium-i-normal--*-100-*-*-*-*-iso8859-1\en\e
200 TB      -adobe-times-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
201 TBI     -adobe-times-bold-i-normal--*-100-*-*-*-*-iso8859-1\en\e
202 CR      -adobe-courier-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
203 CI      -adobe-courier-medium-o-normal--*-100-*-*-*-*-iso8859-1\en\e
204 CB      -adobe-courier-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
205 CBI     -adobe-courier-bold-o-normal--*-100-*-*-*-*-iso8859-1\en\e
206 HR      -adobe-helvetica-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
207 HI      -adobe-helvetica-medium-o-normal--*-100-*-*-*-*-iso8859-1\en\e
208 HB      -adobe-helvetica-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
209 HBI     -adobe-helvetica-bold-o-normal--*-100-*-*-*-*-iso8859-1\en\e
210 NR      -adobe-new century schoolbook-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
211 NI      -adobe-new century schoolbook-medium-i-normal--*-100-*-*-*-*-iso8859-1\en\e
212 NB      -adobe-new century schoolbook-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
213 NBI     -adobe-new century schoolbook-bold-i-normal--*-100-*-*-*-*-iso8859-1\en\e
214 S       -adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\en\e
215 SS      -adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\en\e
219 .SH "SEE ALSO"
220 .IR X (1),
221 .IR xrdb (1),
222 .IR gtroff (1),
223 .IR groff (1)
224 .SH ORIGIN
225 This program is derived from xditview;
226 portions of xditview originated in xtroff which was derived
227 from suntroff.  
228 .SH COPYRIGHT
229 Copyright 1989, Massachusetts Institute of Technology.
232 .IR X (1)
233 for a full statement of rights and permissions.
234 .SH AUTHORS
235 Keith Packard (MIT X Consortium)
237 Richard L. Hyde (Purdue)
239 David Slattengren (Berkeley)
241 Malcolm Slaney (Schlumberger Palo Alto Research)
243 Mark Moraes (University of Toronto)
245 James Clark
247 .\" Local Variables:
248 .\" mode: nroff
249 .\" End: