|
371
|
1 .TH XEMACS 1 "1998 January 13"
|
|
0
|
2 .UC 4
|
|
|
3 .SH NAME
|
|
|
4 xemacs \- Emacs: The Next Generation
|
|
|
5 .SH SYNOPSIS
|
|
|
6 .B xemacs
|
|
|
7 [
|
|
|
8 .I command-line switches
|
|
|
9 ] [
|
|
|
10 .I files ...
|
|
|
11 ]
|
|
|
12 .br
|
|
|
13 .SH DESCRIPTION
|
|
|
14 .I XEmacs
|
|
243
|
15 is a version of
|
|
0
|
16 .IR Emacs ,
|
|
|
17 compatible with and containing many improvements over
|
|
|
18 .I GNU
|
|
|
19 .IR Emacs ,
|
|
|
20 written by Richard Stallman of the Free Software Foundation. It was
|
|
|
21 originally based on an early release of
|
|
|
22 .I GNU Emacs Version
|
|
|
23 .IR 19 ,
|
|
|
24 and has tracked subsequent releases of
|
|
|
25 .I GNU Emacs
|
|
|
26 as they have become available.
|
|
|
27 .PP
|
|
|
28 The primary documentation of
|
|
|
29 .I XEmacs
|
|
|
30 is in the
|
|
|
31 .I XEmacs Reference
|
|
|
32 .IR Manual ,
|
|
70
|
33 which you can read on-line using Info, a subsystem of
|
|
0
|
34 .IR XEmacs .
|
|
|
35 Please look there for complete and up-to-date documentation.
|
|
|
36 Complete documentation on using Emacs Lisp is available on-line
|
|
|
37 through the
|
|
|
38 .I XEmacs Lisp Programmer's
|
|
|
39 .IR Manual .
|
|
|
40 Both manuals also can be printed out nicely using the
|
|
|
41 .I TeX
|
|
|
42 formatting package.
|
|
|
43 .PP
|
|
|
44 The user functionality of
|
|
|
45 .I XEmacs
|
|
|
46 encompasses everything other
|
|
|
47 .I Emacs
|
|
|
48 editors do, and it is easily extensible since its
|
|
|
49 editing commands are written in Lisp.
|
|
|
50 .PP
|
|
|
51 .I XEmacs
|
|
|
52 has an extensive interactive help facility,
|
|
|
53 but the facility assumes that you know how to manipulate
|
|
|
54 .I XEmacs
|
|
|
55 windows and buffers.
|
|
|
56 CTRL-h enters the Help facility. Help Tutorial (CTRL-h t)
|
|
|
57 requests an interactive tutorial which can teach beginners the fundamentals
|
|
243
|
58 of
|
|
|
59 .I XEmacs
|
|
0
|
60 in a few minutes.
|
|
|
61 Help Apropos (CTRL-h a) helps you
|
|
|
62 find a command given its functionality, Help Key Binding (CTRL-h k)
|
|
|
63 describes a given key sequence's effect, and Help Function (CTRL-h f)
|
|
|
64 describes a given Lisp function specified by name. You can also
|
|
70
|
65 look up key sequences in the
|
|
0
|
66 .I XEmacs Reference Manual
|
|
|
67 using Lookup Key Binding (CTRL-h CTRL-k),
|
|
70
|
68 and look up Lisp functions in the
|
|
0
|
69 .I XEmacs Lisp Programmer's Manual
|
|
|
70 using Lookup Function (CTRL-h CTRL-f). All of these help functions,
|
|
|
71 and more, are available on the Help menu if you are using a window
|
|
|
72 system.
|
|
|
73 .PP
|
|
|
74 .I XEmacs
|
|
|
75 has extensive GUI (graphical user interface) support when running under
|
|
|
76 a window system such as
|
|
|
77 .IR X ,
|
|
|
78 including multiple frames (top-level windows), a menubar, a toolbar,
|
|
|
79 horizontal and vertical scrollbars, dialog boxes, and extensive mouse
|
|
|
80 support.
|
|
|
81 .PP
|
|
|
82 .I XEmacs
|
|
|
83 has full support for multiple fonts and colors, variable-width fonts,
|
|
|
84 and variable-height lines, and allows for pixmaps to be inserted into
|
|
|
85 a buffer. (This is used in the W3 web-browsing package and in some
|
|
|
86 of the debugger and outlining interfaces, among other things.)
|
|
|
87 .PP
|
|
|
88 .IR XEmacs 's
|
|
|
89 Undo can undo several steps of modification to your buffers, so it is
|
|
|
90 easy to recover from editing mistakes.
|
|
|
91 .PP
|
|
|
92 .IR XEmacs 's
|
|
|
93 many special packages handle mail reading (VM, MH-E and RMail) and
|
|
|
94 sending (Mail), Usenet news reading and posting (GNUS), World Wide Web
|
|
|
95 browsing (W3), specialized modes for editing source code in all common
|
|
|
96 programming languages, syntax highlighting for many languages
|
|
|
97 (Font-Lock), compiling (Compile), running subshells within
|
|
|
98 .I XEmacs
|
|
|
99 windows (Shell), outline editing (Outline), running a Lisp read-eval-print
|
|
|
100 loop (Lisp-Interaction-Mode), and automated psychotherapy (Doctor).
|
|
|
101 .PP
|
|
70
|
102 There is an extensive reference manual, but users of other Emacsen
|
|
|
103 should have little trouble adapting even without a copy. Users new to
|
|
|
104 Emacs will be able to use basic features fairly rapidly by studying
|
|
|
105 the tutorial and using the self-documentation features.
|
|
0
|
106 .PP
|
|
|
107 .SM XEmacs Options
|
|
|
108 .PP
|
|
70
|
109 XEmacs accepts all standard X Toolkit command line options when run in
|
|
|
110 an X Windows environment. In addition, the following options are accepted
|
|
|
111 (when options imply a sequence of actions to perform, they are
|
|
|
112 performed in the order encountered):
|
|
0
|
113 .TP 8
|
|
|
114 .BI \-t " file"
|
|
|
115 Use specified
|
|
|
116 .I file
|
|
|
117 as the terminal instead of using stdin/stdout. This implies
|
|
|
118 .BR \-nw \.
|
|
|
119 .TP
|
|
|
120 .BI \-batch
|
|
|
121 Edit in batch mode. The editor will send messages to stdout. You
|
|
|
122 must use the
|
|
|
123 .BR \-l ,
|
|
|
124 .BR \-f ,
|
|
|
125 and
|
|
|
126 .B \-eval
|
|
|
127 options to specify files to execute and functions to call.
|
|
|
128 .TP
|
|
375
|
129 .B \-nw
|
|
0
|
130 Inhibit the use of any window-system-specific display code: use the
|
|
70
|
131 current TTY.
|
|
0
|
132 .TP
|
|
|
133 .B \-debug\-init
|
|
70
|
134 Enter the debugger if an error occurs loading the init file.
|
|
0
|
135 .TP
|
|
|
136 .B \-unmapped
|
|
|
137 Do not map the initial frame.
|
|
|
138 .TP
|
|
|
139 .B \-no\-site\-file
|
|
219
|
140 Do not load the site-specific init file (site-start.el).
|
|
0
|
141 .TP
|
|
|
142 .B \-q, \-no\-init\-file
|
|
|
143 Do not load an init file.
|
|
|
144 .TP
|
|
276
|
145 .B \-no-early-packages
|
|
|
146 Do not process the early packages.
|
|
215
|
147 .TP
|
|
|
148 .B \-vanilla
|
|
|
149 Load no extra files at startup. Equivalent to the combination of
|
|
|
150 .B \-q
|
|
|
151 ,
|
|
|
152 .B \-no-site-file
|
|
|
153 , and
|
|
371
|
154 .B \-no-packages
|
|
215
|
155 \.
|
|
|
156 .TP
|
|
0
|
157 .BI \-u " user, " \-user " user"
|
|
|
158 Load
|
|
|
159 .IR user 's
|
|
|
160 init file.
|
|
70
|
161 .TP 8
|
|
|
162 .I file
|
|
|
163 Edit
|
|
|
164 .IR file \.
|
|
|
165 .TP
|
|
|
166 .BI \+ number
|
|
|
167 Go to the line specified by
|
|
|
168 .I number
|
|
|
169 (do not insert a space between the "+" sign and the number).
|
|
|
170 .TP
|
|
215
|
171 .B \-help
|
|
70
|
172 Print a help message and exit.
|
|
|
173 .TP
|
|
|
174 .B \-V, \-version,
|
|
|
175 Print the version number and exit.
|
|
|
176 .TP
|
|
|
177 .BI \-f " function, " \-funcall " function"
|
|
|
178 Execute the lisp function
|
|
|
179 .IR function \.
|
|
|
180 .TP
|
|
|
181 .BI \-l " file, " \-load " file"
|
|
|
182 Load the Lisp code in the file
|
|
|
183 .IR file \.
|
|
|
184 .TP
|
|
|
185 .BI \-eval " form"
|
|
|
186 Evaluate the Lisp form
|
|
|
187 .IR form \.
|
|
|
188 .TP
|
|
|
189 .BI \-i " file, " \-insert " file"
|
|
|
190 Insert
|
|
|
191 .I file
|
|
|
192 into the current buffer.
|
|
|
193 .TP
|
|
|
194 .B \-kill
|
|
|
195 Exit
|
|
|
196 .I XEmacs
|
|
|
197 (useful with
|
|
|
198 .BR \-batch ).
|
|
0
|
199 .PP
|
|
|
200 .SM Using XEmacs with X
|
|
|
201 .PP
|
|
|
202 .I XEmacs
|
|
|
203 has been tailored to work well with the X window system.
|
|
|
204 If you run
|
|
|
205 .I XEmacs
|
|
|
206 from under X windows, it will create its own X window to
|
|
|
207 display in. You will probably want to start the editor
|
|
|
208 as a background process
|
|
|
209 so that you can continue using your original window.
|
|
|
210 .PP
|
|
|
211 .I XEmacs
|
|
70
|
212 can be started with the following standard X options:
|
|
0
|
213 .TP
|
|
398
|
214 .BI \-visual " <visualname><bitdepth>"
|
|
|
215 Select the visual that XEmacs will attempt to use.
|
|
|
216 .I <visualname>
|
|
|
217 should be one of the strings "StaticColor", "TrueColor", "GrayScale",
|
|
|
218 "PseudoColor" or "DirectColor", and
|
|
|
219 .I <bitdepth>
|
|
|
220 should be the number of bits per pixel (example, "-visual TrueColor24"
|
|
|
221 for a 24bit TrueColor visual) See
|
|
|
222 .IR X (1)
|
|
|
223 for more information.
|
|
|
224 .TP
|
|
|
225 .B -privateColormap
|
|
|
226 Require XEmacs to create and use a private colormap for display. This will keep
|
|
|
227 XEmacs from taking colors from the default colormap and keeping them from other
|
|
|
228 clients.
|
|
|
229 .TP
|
|
0
|
230 .BI \-geometry " ##x##+##+##"
|
|
|
231 Specify the geometry of the initial window. The ##'s represent a number;
|
|
|
232 the four numbers are width (characters), height (characters), X offset
|
|
|
233 (pixels), and Y offset (pixels), respectively. Partial specifications of
|
|
|
234 the form
|
|
|
235 .I ##x##
|
|
|
236 or
|
|
|
237 .I +##+##
|
|
|
238 are also allowed. (The geometry
|
|
|
239 specification is in the standard X format; see
|
|
|
240 .IR X (1)
|
|
|
241 for more information.)
|
|
|
242 .TP
|
|
|
243 .B \-iconic
|
|
|
244 Specifies that the initial window should initially appear iconified.
|
|
|
245 .TP 8
|
|
|
246 .BI \-name " name"
|
|
|
247 Specifies the program name which should be used when looking up
|
|
|
248 defaults in the user's X resources.
|
|
|
249 .TP
|
|
|
250 .BI \-title " title, " \-T " title, " \-wn " title"
|
|
|
251 Specifies the title which should be assigned to the
|
|
|
252 .I XEmacs
|
|
|
253 window.
|
|
|
254 .TP
|
|
|
255 .BI \-d " displayname, " \-display " displayname"
|
|
|
256 Create the
|
|
|
257 .I XEmacs
|
|
|
258 window on the display specified by
|
|
|
259 .IR displayname .
|
|
|
260 Must be the first option specified in the command line.
|
|
|
261 .TP
|
|
|
262 .BI \-font " font, " \-fn " font"
|
|
|
263 Set the
|
|
|
264 .I XEmacs
|
|
|
265 window's font to that specified by
|
|
|
266 .IR font \.
|
|
|
267 You will find the various
|
|
|
268 .I X
|
|
|
269 fonts in the
|
|
|
270 .I /usr/lib/X11/fonts
|
|
|
271 directory.
|
|
|
272 .I XEmacs
|
|
|
273 works with either fixed- or variable-width fonts, but will probably
|
|
|
274 look better with a fixed-width font.
|
|
|
275 .TP
|
|
|
276 .BI \-scrollbar\-width " pixels"
|
|
|
277 Specify the width of the vertical scrollbars.
|
|
|
278 .TP
|
|
|
279 .BI \-scrollbar\-height " pixels"
|
|
|
280 Specify the height of the horizontal scrollbars.
|
|
|
281 .TP
|
|
|
282 .BI \-bw " pixels, " \-borderwidth " pixels"
|
|
|
283 Set the
|
|
|
284 .I XEmacs
|
|
|
285 window's border width to the number of pixels specified by
|
|
|
286 .IR pixels \.
|
|
|
287 Defaults to one pixel on each side of the window.
|
|
|
288 .TP
|
|
|
289 .BI \-ib " pixels, " \-internal\-border\-width " pixels"
|
|
|
290 Specify the width between a frame's border and its text, in pixels.
|
|
|
291 Defaults to one pixel on each side of the window.
|
|
|
292 .TP
|
|
|
293 .BI \-fg " color, " \-foreground " color"
|
|
|
294 Sets the color of the text.
|
|
|
295
|
|
|
296 See the file
|
|
|
297 .I /usr/lib/X11/rgb.txt
|
|
|
298 for a list of valid
|
|
|
299 color names.
|
|
|
300 .TP
|
|
|
301 .BI \-bg " color, " \-background " color"
|
|
|
302 Sets the color of the window's background.
|
|
|
303 .TP
|
|
|
304 .BI \-bd " color, " \-bordercolor " color"
|
|
|
305 Sets the color of the window's border.
|
|
|
306 .TP
|
|
|
307 .BI \-mc " color"
|
|
|
308 Sets the color of the mouse pointer.
|
|
|
309 .TP
|
|
|
310 .BI \-cr " color"
|
|
|
311 Sets the color of the text cursor.
|
|
|
312 .TP
|
|
|
313 .B \-rv, \-reverse
|
|
|
314 Reverses the foreground and background colors (reverse video). Consider
|
|
|
315 explicitly setting the foreground and background colors instead of using
|
|
|
316 this option.
|
|
|
317 .TP
|
|
|
318 .BI \-xrm " argument"
|
|
|
319 This allows you to set an arbitrary resource on the command line.
|
|
|
320 .I argument
|
|
371
|
321 should be a resource specification, as might as in your
|
|
0
|
322 .I \.Xresources
|
|
|
323 or
|
|
|
324 .I \.Xdefaults
|
|
|
325 file.
|
|
|
326 .PP
|
|
|
327 You can also set resources, i.e.
|
|
|
328 .I X
|
|
|
329 default values, for your
|
|
|
330 .I XEmacs
|
|
|
331 windows in your
|
|
|
332 .I \.Xresources
|
|
|
333 or
|
|
|
334 .I \.Xdefaults
|
|
|
335 file (see
|
|
|
336 .IR xrdb (1)).
|
|
|
337 Use the following format:
|
|
|
338 .IP
|
|
|
339 Emacs.keyword:value
|
|
|
340 .PP
|
|
|
341 or
|
|
|
342 .IP
|
|
|
343 Emacs*EmacsFrame.keyword:value
|
|
|
344 .PP
|
|
|
345 where
|
|
|
346 .I value
|
|
|
347 specifies the default value of
|
|
|
348 .IR keyword \.
|
|
|
349 (Some resources need the former format; some the latter.)
|
|
|
350 .PP
|
|
|
351 You can also set resources for a particular frame by using the
|
|
|
352 format
|
|
|
353 .IP
|
|
|
354 Emacs*framename.keyword:value
|
|
|
355 .PP
|
|
|
356 where
|
|
|
357 .I framename
|
|
|
358 is the resource name assigned to that particular frame.
|
|
|
359 (Certain packages, such as VM, give their frames unique resource
|
|
|
360 names, in this case "VM".)
|
|
|
361 .PP
|
|
|
362 .I XEmacs
|
|
|
363 lets you set default values for the following keywords:
|
|
|
364 .TP 8
|
|
|
365 .B default.attributeFont (\fPclass\fB Face.AttributeFont)
|
|
|
366 Sets the window's text font.
|
|
|
367 .TP
|
|
|
368 .B default.attributeForeground (\fPclass\fB Face.AttributeForeground)
|
|
|
369 Sets the window's text color.
|
|
|
370 .TP
|
|
|
371 .B default.attributeBackground (\fPclass\fB Face.AttributeBackground)
|
|
|
372 Sets the window's background color.
|
|
|
373 .TP
|
|
|
374 .B \fIface\fB.attributeFont (\fPclass\fB Face.AttributeFont)
|
|
|
375 Sets the font for
|
|
|
376 .IR face ,
|
|
|
377 which should be the name of a face. Common face names are
|
|
|
378 .PP
|
|
|
379 .in +\w'right-margin'u+12n
|
|
|
380 .ta \w'right-margin'u+4n
|
|
|
381 .ti -\w'right-margin'u+4n
|
|
|
382 FACE PURPOSE
|
|
|
383 .br
|
|
|
384 .ti -\w'right-margin'u+4n
|
|
|
385 default Normal text.
|
|
|
386 .br
|
|
|
387 .ti -\w'right-margin'u+4n
|
|
|
388 bold Bold text.
|
|
|
389 .br
|
|
|
390 .ti -\w'right-margin'u+4n
|
|
|
391 italic Italicized text.
|
|
|
392 .br
|
|
|
393 .ti -\w'right-margin'u+4n
|
|
|
394 bold-italic Bold and italicized text.
|
|
|
395 .br
|
|
|
396 .ti -\w'right-margin'u+4n
|
|
|
397 modeline Modeline text.
|
|
|
398 .br
|
|
|
399 .ti -\w'right-margin'u+4n
|
|
|
400 zmacs-region Text selected with the mouse.
|
|
|
401 .br
|
|
|
402 .ti -\w'right-margin'u+4n
|
|
|
403 highlight Text highlighted when the mouse passes over.
|
|
|
404 .br
|
|
|
405 .ti -\w'right-margin'u+4n
|
|
|
406 left-margin Text in the left margin.
|
|
|
407 .br
|
|
|
408 .ti -\w'right-margin'u+4n
|
|
|
409 right-margin Text in the right margin.
|
|
|
410 .br
|
|
|
411 .ti -\w'right-margin'u+4n
|
|
|
412 isearch Text highlighted during incremental search.
|
|
|
413 .br
|
|
|
414 .ti -\w'right-margin'u+4n
|
|
|
415 info-node Text of Info menu items.
|
|
|
416 .br
|
|
|
417 .ti -\w'right-margin'u+4n
|
|
|
418 info-xref Text of Info cross references.
|
|
|
419 .TP 8
|
|
|
420 .B \fIface\fB.attributeForeground (\fPclass\fB Face.AttributeForeground)
|
|
|
421 Sets the foreground color for
|
|
|
422 .IR face \.
|
|
|
423 .TP 8
|
|
|
424 .B \fIface\fB.attributeBackground (\fPclass\fB Face.AttributeBackground)
|
|
|
425 Sets the background color for
|
|
|
426 .IR face \.
|
|
|
427 .TP 8
|
|
|
428 .B \fIface\fB.attributeBackgroundPixmap (\fPclass\fB Face.AttributeBackgroundPixmap)
|
|
|
429 Sets the background pixmap (stipple) for
|
|
|
430 .IR face \.
|
|
|
431 .TP 8
|
|
|
432 .B \fIface\fB.attributeUnderline (\fPclass\fB Face.AttributeUnderline)
|
|
|
433 Whether
|
|
|
434 .I face
|
|
|
435 should be underlined.
|
|
|
436 .TP
|
|
|
437 .B reverseVideo (\fPclass\fB ReverseVideo)
|
|
|
438 If set to
|
|
|
439 .IR on ,
|
|
|
440 the window will be displayed in reverse video. Consider
|
|
|
441 explicitly setting the foreground and background colors instead
|
|
371
|
442 of using this resources.
|
|
0
|
443 .TP
|
|
|
444 .B borderWidth (\fPclass\fB BorderWidth)
|
|
|
445 Sets the window's border width in pixels.
|
|
|
446 .TP
|
|
|
447 .B internalBorderWidth (\fPclass\fB InternalBorderWidth)
|
|
|
448 Sets the window's internal border width in pixels.
|
|
|
449 .TP
|
|
|
450 .B borderColor (\fPclass\fB BorderColor)
|
|
|
451 Sets the color of the window's border.
|
|
|
452 .TP
|
|
|
453 .B cursorColor (\fPclass\fB Foreground)
|
|
|
454 Sets the color of the window's text cursor.
|
|
|
455 .TP
|
|
|
456 .B pointerColor (\fPclass\fB Foreground)
|
|
|
457 Sets the color of the window's mouse cursor.
|
|
|
458 .TP
|
|
398
|
459 .B emacsVisual (\fPclass\fB EmacsVisual)
|
|
|
460 Sets the default visual
|
|
|
461 .I XEmacs
|
|
|
462 will try to use (as described above).
|
|
|
463 .TP
|
|
|
464 .B privateColormap (\fPclass\fB PrivateColormap)
|
|
|
465 If set,
|
|
|
466 .I XEmacs
|
|
|
467 will default to using a private colormap.
|
|
|
468 .TP
|
|
0
|
469 .B geometry (\fPclass\fB Geometry)
|
|
|
470 Sets the geometry of the
|
|
|
471 .I XEmacs
|
|
|
472 window (as described above).
|
|
|
473 .TP
|
|
|
474 .B iconic (\fPclass\fB Iconic)
|
|
|
475 If set to on, the
|
|
|
476 .I XEmacs
|
|
|
477 window will initially appear as an icon.
|
|
|
478 .TP
|
|
|
479 .B menubar (\fPclass\fB Menubar)
|
|
|
480 Whether the
|
|
|
481 .I XEmacs
|
|
|
482 window will have a menubar. Defaults to true.
|
|
|
483 .TP
|
|
|
484 .B initiallyUnmapped (\fPclass\fB InitiallyUnmapped)
|
|
|
485 Whether
|
|
|
486 .I XEmacs
|
|
|
487 will leave the initial frame unmapped when it starts up.
|
|
|
488 .TP
|
|
|
489 .B barCursor (\fPclass\fB BarCursor)
|
|
|
490 Whether the cursor should be a bar instead of the traditional box.
|
|
|
491 .TP
|
|
|
492 .B title (\fPclass\fB Title)
|
|
|
493 Sets the title of the
|
|
|
494 .I XEmacs
|
|
|
495 window.
|
|
|
496 .TP
|
|
|
497 .B iconName (\fPclass\fB Title)
|
|
|
498 Sets the icon name for the
|
|
|
499 .I XEmacs
|
|
|
500 window icon.
|
|
|
501 .TP
|
|
|
502 .B scrollBarWidth (\fPclass\fB ScrollBarWidth)
|
|
|
503 Sets the width of the vertical scrollbars, in pixels. A width of 0
|
|
|
504 means no vertical scrollbars.
|
|
|
505 .TP
|
|
|
506 .B scrollBarHeight (\fPclass\fB ScrollBarHeight)
|
|
|
507 Sets the height of the horizontal scrollbars, in pixels. A height of 0
|
|
|
508 means no horizontal scrollbars.
|
|
|
509 .TP
|
|
|
510 .B scrollBarPlacement (\fPclass\fB ScrollBarPlacement)
|
|
|
511 Sets the position of vertical and horizontal scrollbars. Should be one
|
|
|
512 of the strings "top-left", "bottom-left", "top-right", or "bottom-right".
|
|
|
513 The default is "bottom-right" for the Motif and Lucid scrollbars and
|
|
371
|
514 "buttom-left" for the Athena scrollbars.
|
|
0
|
515 .TP
|
|
|
516 .B topToolBarHeight (\fPclass\fB TopToolBarHeight)
|
|
|
517 Sets the height of the top toolbar, in pixels. 0 means no top toolbar.
|
|
|
518 .TP
|
|
|
519 .B bottomToolBarHeight (\fPclass\fB BottomToolBarHeight)
|
|
|
520 Sets the height of the bottom toolbar, in pixels. 0 means no
|
|
|
521 bottom toolbar.
|
|
|
522 .TP
|
|
|
523 .B leftToolBarWidth (\fPclass\fB LeftToolBarWidth)
|
|
|
524 Sets the width of the left toolbar, in pixels. 0 means no left toolbar.
|
|
|
525 .TP
|
|
|
526 .B rightToolBarWidth (\fPclass\fB RightToolBarWidth)
|
|
|
527 Sets the width of the right toolbar, in pixels. 0 means no right toolbar.
|
|
|
528 .TP
|
|
|
529 .B topToolBarShadowColor (\fPclass\fB TopToolBarShadowColor)
|
|
|
530 Sets the color of the top shadows for the toolbars. (For all toolbars,
|
|
|
531 \fBnot\fR just the toolbar at the top of the frame.)
|
|
|
532 .TP
|
|
|
533 .B bottomToolBarShadowColor (\fPclass\fB BottomToolBarShadowColor)
|
|
|
534 Sets the color of the bottom shadows for the toolbars. (For all toolbars,
|
|
|
535 \fBnot\fR just the toolbar at the bottom of the frame.)
|
|
|
536 .TP
|
|
|
537 .B topToolBarShadowPixmap (\fPclass\fB TopToolBarShadowPixmap)
|
|
|
538 Sets the pixmap of the top shadows for the toolbars. (For all toolbars,
|
|
|
539 \fBnot\fR just the toolbar at the top of the frame.) If set, this
|
|
|
540 resource overrides the corresponding color resource.
|
|
|
541 .TP
|
|
|
542 .B bottomToolBarShadowPixmap (\fPclass\fB BottomToolBarShadowPixmap)
|
|
|
543 Sets the pixmap of the bottom shadows for the toolbars. (For all toolbars,
|
|
|
544 \fBnot\fR just the toolbar at the bottom of the frame.) If set, this
|
|
|
545 resource overrides the corresponding color resource.
|
|
|
546 .TP
|
|
|
547 .B toolBarShadowThickness (\fPclass\fB ToolBarShadowThickness)
|
|
|
548 Thickness of the shadows around the toolbars, in pixels.
|
|
|
549 .TP
|
|
|
550 .B visualBell (\fPclass\fB VisualBell)
|
|
|
551 Whether XEmacs should flash the screen rather than making an audible beep.
|
|
|
552 .TP
|
|
|
553 .B bellVolume (\fPclass\fB BellVolume)
|
|
|
554 Volume of the audible beep. Range is 0 through 100.
|
|
|
555 .TP
|
|
|
556 .B useBackingStore (\fPclass\fB UseBackingStore)
|
|
|
557 Whether
|
|
|
558 .I XEmacs
|
|
|
559 should set the backing-store attribute of the
|
|
|
560 .I X
|
|
|
561 windows it creates. This increases the memory usage of the
|
|
|
562 .I X
|
|
|
563 server but decreases the amount of
|
|
|
564 .I X
|
|
|
565 traffic necessary to update the screen, and is useful when the
|
|
|
566 connection to the
|
|
|
567 .I X
|
|
|
568 server goes over a low-bandwidth line such as a modem connection.
|
|
|
569 .TP
|
|
|
570 .B textPointer (\fPclass\fB Cursor)
|
|
|
571 The cursor to use when the mouse is over text.
|
|
|
572 .TP
|
|
|
573 .B selectionPointer (\fPclass\fB Cursor)
|
|
|
574 The cursor to use when the mouse is over a mouse-highlighted
|
|
|
575 text region.
|
|
|
576 .TP
|
|
|
577 .B spacePointer (\fPclass\fB Cursor)
|
|
|
578 The cursor to use when the mouse is over a blank space in a buffer (that
|
|
|
579 is, after the end of a line or after the end-of-file).
|
|
|
580 .TP
|
|
|
581 .B modeLinePointer (\fPclass\fB Cursor)
|
|
|
582 The cursor to use when the mouse is over a mode line.
|
|
|
583 .TP
|
|
|
584 .B gcPointer (\fPclass\fB Cursor)
|
|
|
585 The cursor to display when a garbage-collection is in progress.
|
|
|
586 .TP
|
|
|
587 .B scrollbarPointer (\fPclass\fB Cursor)
|
|
|
588 The cursor to use when the mouse is over the scrollbar.
|
|
|
589 .TP
|
|
|
590 .B pointerColor (\fPclass\fB Foreground)
|
|
|
591 The foreground color of the mouse cursor.
|
|
|
592 .TP
|
|
|
593 .B pointerBackground (\fPclass\fB Background)
|
|
|
594 The background color of the mouse cursor.
|
|
|
595 .PP
|
|
243
|
596 .SM Using the Mouse
|
|
0
|
597 .PP
|
|
|
598 The following lists the mouse button bindings for the
|
|
|
599 .I XEmacs
|
|
|
600 window under X11.
|
|
|
601
|
|
|
602 .in +\w'CTRL-SHIFT-middle'u+4n
|
|
|
603 .ta \w'CTRL-SHIFT-middle'u+4n
|
|
|
604 .ti -\w'CTRL-SHIFT-middle'u+4n
|
|
|
605 MOUSE BUTTON FUNCTION
|
|
|
606 .br
|
|
|
607 .ti -\w'CTRL-SHIFT-middle'u+4n
|
|
|
608 left Set point or make a text selection.
|
|
|
609 .br
|
|
|
610 .ti -\w'CTRL-SHIFT-middle'u+4n
|
|
|
611 middle Paste text.
|
|
|
612 .br
|
|
|
613 .ti -\w'CTRL-SHIFT-middle'u+4n
|
|
|
614 right Pop up a menu of options.
|
|
|
615 .br
|
|
|
616 .ti -\w'CTRL-SHIFT-middle'u+4n
|
|
|
617 SHIFT-left Extend a selection.
|
|
|
618 .br
|
|
|
619 .ti -\w'CTRL-SHIFT-middle'u+4n
|
|
|
620 CTRL-left Make a selection and insert it at point.
|
|
|
621 .br
|
|
|
622 .ti -\w'CTRL-SHIFT-middle'u+4n
|
|
|
623 CTRL-middle Set point and move selected text there.
|
|
|
624 .br
|
|
|
625 .ti -\w'CTRL-SHIFT-middle'u+4n
|
|
|
626 CTRL-SHIFT-left Make a selection, delete it, and insert it at point.
|
|
|
627 .br
|
|
|
628 .ti -\w'CTRL-SHIFT-middle'u+4n
|
|
|
629 META-left Make a rectangular selection.
|
|
|
630 .SH FILES
|
|
70
|
631 Lisp code is read at startup from the user's init file,
|
|
|
632 \fB$HOME/.emacs\fP.
|
|
|
633
|
|
0
|
634 /usr/local/info - files for the Info documentation browser
|
|
|
635 (a subsystem of
|
|
|
636 .IR XEmacs )
|
|
|
637 to refer to. The complete text of the
|
|
|
638 .I XEmacs Reference Manual
|
|
|
639 and the
|
|
|
640 .I XEmacs Lisp Programmer's Manual
|
|
|
641 is included in a convenient tree structured form.
|
|
|
642
|
|
|
643 /usr/local/lib/xemacs-$VERSION/info - the Info files may be here instead.
|
|
|
644
|
|
|
645 /usr/local/lib/xemacs-$VERSION/src - C source files and object files.
|
|
|
646 (May not be present.)
|
|
|
647
|
|
|
648 /usr/local/lib/xemacs-$VERSION/lisp/* - Lisp source files and compiled files
|
|
|
649 that define most editing commands. The files are contained in subdirectories,
|
|
|
650 categorized by function or individual package. Some are preloaded;
|
|
|
651 others are autoloaded from these directories when used.
|
|
243
|
652
|
|
0
|
653 /usr/local/lib/xemacs-$VERSION/etc - some files of information, pixmap
|
|
|
654 files, other data files used by certain packages, etc.
|
|
|
655
|
|
|
656 /usr/local/lib/xemacs-$VERSION/$CONFIGURATION - various programs that are used
|
|
|
657 with XEmacs.
|
|
|
658
|
|
78
|
659 /usr/local/lib/xemacs-$VERSION/$CONFIGURATION/DOC -
|
|
0
|
660 contains the documentation strings for the Lisp primitives and
|
|
70
|
661 preloaded Lisp functions of \fIXEmacs\fP.
|
|
|
662 They are stored here to reduce the size of \fIXEmacs\fP proper.
|
|
0
|
663
|
|
|
664 .br
|
|
|
665 /usr/local/lib/xemacs-$VERSION/etc/SERVICE - lists people offering
|
|
70
|
666 various services to assist users of \fIXEmacs\fP,
|
|
0
|
667 including education, troubleshooting, porting and customization.
|
|
|
668
|
|
|
669 /usr/local/lib/xemacs/lock - holds lock files that are made for all
|
|
|
670 files being modified in
|
|
|
671 .IR XEmacs ,
|
|
|
672 to prevent simultaneous modification of one file by two users.
|
|
|
673
|
|
|
674 /usr/local/lib/xemacs/site-lisp - locally-provided Lisp files.
|
|
|
675
|
|
|
676 /usr/lib/X11/rgb.txt - list of valid X color names.
|
|
|
677 .PP
|
|
|
678 .SH BUGS AND HELP
|
|
|
679 There is a newsgroup, comp.emacs.xemacs, for reporting
|
|
|
680 .I XEmacs
|
|
|
681 bugs and fixes and requesting help. But before reporting something
|
|
|
682 as a bug, please try to be sure that it really is a bug, not a
|
|
|
683 misunderstanding or a deliberate feature. We ask you to read the section
|
|
|
684 ``Reporting XEmacs Bugs'' near the end of the reference manual (or Info
|
|
|
685 system) for hints on how and when to report bugs. Also, include the version
|
|
|
686 number of the
|
|
|
687 .I XEmacs
|
|
|
688 you are running and the system you are running it on
|
|
|
689 in \fIevery\fR bug report that you send in. Finally, the more you can
|
|
|
690 isolate the cause of a bug and the conditions it happens under, the more
|
|
|
691 likely it is to be fixed, so please take the time to do so.
|
|
|
692
|
|
|
693 The newsgroup is bidirectionally gatewayed to and from the mailing list
|
|
|
694 xemacs@xemacs.org. You can read the list instead of the newsgroup if
|
|
|
695 you do not have convenient Usenet news access. To request to be added
|
|
|
696 to the mailing list, send mail to xemacs-request@xemacs.org. (Do not
|
|
|
697 send mail to the list itself.)
|
|
|
698
|
|
|
699 The
|
|
|
700 .I XEmacs
|
|
|
701 maintainers read the newsgroup regularly and will attempt to
|
|
|
702 fix bugs reported in a timely fashion. However, not every message will
|
|
|
703 get a response from one of the maintainers. Note that there are many
|
|
|
704 people other than the maintainers who read the newsgroup, and will usually
|
|
|
705 be of assistance in helping with any problems encountered.
|
|
|
706
|
|
|
707 If you need more personal assistance than can be provided by the
|
|
|
708 newsgroup, look in the SERVICE file (see above) for a list of people
|
|
|
709 who offer it.
|
|
|
710
|
|
|
711 For more information about XEmacs mailing lists, see the
|
|
|
712 file /usr/local/lib/xemacs-$VERSION/etc/MAILINGLISTS.
|
|
|
713 .SH UNRESTRICTIONS
|
|
|
714 .PP
|
|
243
|
715 .I XEmacs
|
|
|
716 is free; anyone may redistribute copies of
|
|
|
717 .I XEmacs
|
|
0
|
718 to
|
|
243
|
719 anyone under the terms stated in the
|
|
|
720 .I XEmacs
|
|
0
|
721 General Public License,
|
|
243
|
722 a copy of which accompanies each copy of
|
|
|
723 .I XEmacs
|
|
0
|
724 and which also
|
|
|
725 appears in the reference manual.
|
|
|
726 .PP
|
|
|
727 Copies of
|
|
|
728 .I XEmacs
|
|
|
729 may sometimes be received packaged with distributions of Unix systems,
|
|
|
730 but it is never included in the scope of any license covering those
|
|
|
731 systems. Such inclusion violates the terms on which distribution
|
|
|
732 is permitted. In fact, the primary purpose of the General Public
|
|
|
733 License is to prohibit anyone from attaching any other restrictions
|
|
243
|
734 to redistribution of
|
|
0
|
735 .IR XEmacs \.
|
|
|
736 .SH SEE ALSO
|
|
|
737 X(1), xlsfonts(1), xterm(1), xrdb(1), emacs(1), vi(1)
|
|
|
738 .SH AUTHORS
|
|
|
739 .PP
|
|
|
740 .I XEmacs
|
|
243
|
741 was written by
|
|
|
742 Steve Baur <steve@xemacs.org>,
|
|
|
743 Martin Buchholz <martin@xemacs.org>,
|
|
371
|
744 Richard Mlynarik <mly@adoc.xerox.com>,
|
|
412
|
745 Hrvoje Niksic <hniksic@srce.hr>,
|
|
243
|
746 Chuck Thompson <cthomp@xemacs.org>,
|
|
412
|
747 Ben Wing <wing@666.com>,
|
|
|
748 Jamie Zawinski <jwz@netscape.com>,
|
|
243
|
749 and many others.
|
|
|
750 It was based on an early version of
|
|
0
|
751 .I GNU Emacs Version
|
|
|
752 .IR 19 ,
|
|
243
|
753 written by Richard Stallman <rms@gnu.org> of the Free Software
|
|
0
|
754 Foundation, and has tracked subsequent releases of
|
|
|
755 .I GNU Emacs
|
|
|
756 as they have become available. It was originally written by Lucid, Inc.
|
|
|
757 (now defunct) and was called
|
|
|
758 .I Lucid
|
|
|
759 .IR Emacs \.
|
|
|
760 .PP
|
|
|
761 Chuck Thompson wrote the
|
|
|
762 .I XEmacs
|
|
|
763 redisplay engine, maintains the
|
|
|
764 .I XEmacs
|
|
|
765 FTP and WWW sites, and has put out all releases of
|
|
|
766 .I XEmacs
|
|
|
767 since 19.11 (the first release called
|
|
|
768 .IR XEmacs ).
|
|
|
769 Ben Wing wrote the Asian-language support, the on-line documentation
|
|
|
770 (including this man page and much of the FAQ), the external widget code,
|
|
|
771 and retooled or rewrote most of the basic, low-level
|
|
|
772 .I XEmacs
|
|
|
773 subsystems. Jamie Zawinski put out all releases of
|
|
|
774 .I Lucid
|
|
|
775 .IR Emacs ,
|
|
|
776 from the first (19.0) through the last (19.10), and was the primary
|
|
|
777 code contributor for all of these releases. Richard Mlynarik rewrote
|
|
|
778 the
|
|
|
779 .I XEmacs
|
|
|
780 Lisp-object allocation system, improved the keymap and minibuffer code,
|
|
|
781 and did the initial synching of
|
|
|
782 .I XEmacs
|
|
|
783 with
|
|
|
784 .I GNU Emacs Version
|
|
|
785 .IR 19 \.
|
|
|
786 .PP
|
|
|
787 Many others have also contributed significantly. For more detailed
|
|
70
|
788 information, including a long history of \fIXEmacs\fP from multiple
|
|
|
789 viewpoints and pretty pictures and bios of the major \fIXEmacs\fP
|
|
0
|
790 contributors, see the
|
|
|
791 .I XEmacs About Page
|
|
|
792 (the About XEmacs option on the Help menu).
|
|
|
793 .SH MORE INFORMATION
|
|
70
|
794 For more information about \fIXEmacs\fP, see the
|
|
0
|
795 .I XEmacs About Page
|
|
|
796 (mentioned above),
|
|
|
797 look in the file /usr/local/lib/xemacs-$VERSION/etc/NEWS,
|
|
|
798 or point your Web browser at
|
|
|
799 .PP
|
|
|
800 http://www.xemacs.org/
|
|
|
801 .PP
|
|
70
|
802 for up-to-the-minute information about \fIXEmacs\fP.
|
|
0
|
803 .PP
|
|
|
804 The
|
|
|
805 .I XEmacs
|
|
|
806 FAQ (Frequently Asked Questions) can be found at the Web site just listed.
|
|
|
807 A possibly out-of-date version is also accessible through the Info system
|
|
70
|
808 inside of \fIXEmacs\fP.
|
|
0
|
809 .PP
|
|
70
|
810 The latest version of \fIXEmacs\fP can be downloaded using anonymous
|
|
|
811 FTP from
|
|
0
|
812 .PP
|
|
|
813 ftp://ftp.xemacs.org/pub/xemacs/
|
|
|
814 .PP
|
|
298
|
815 or from a mirror site near you. Mirror sites are listed in the file
|
|
|
816 etc/FTP in the XEmacs distribution or see the Web site for an up-to-date
|
|
|
817 list of mirror sites.
|
