XEmacs 21.2.14.
[chise/xemacs-chise.git.1] / etc / xemacs.1
1 .TH XEMACS 1 "1998 January 13"
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
15 is a version of
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 ,
33 which you can read on-line using Info, a subsystem of
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
58 of
59 .I XEmacs
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
65 look up key sequences in the
66 .I XEmacs Reference Manual
67 using Lookup Key Binding (CTRL-h CTRL-k),
68 and look up Lisp functions in the
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
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.
106 .PP
107 .SM XEmacs Options
108 .PP
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):
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
129 .B \-nw
130 Inhibit the use of any window-system-specific display code: use the
131 current TTY.
132 .TP
133 .B \-debug\-init
134 Enter the debugger if an error occurs loading the init file.
135 .TP
136 .B \-unmapped
137 Do not map the initial frame.
138 .TP
139 .B \-no\-site\-file
140 Do not load the site-specific init file (site-start.el).
141 .TP
142 .B \-q, \-no\-init\-file
143 Do not load an init file.
144 .TP
145 .B \-no-early-packages
146 Do not process the early packages.
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
154 .B \-no-packages
155 \.
156 .TP
157 .BI \-u " user, " \-user " user"
158 Load
159 .IR user 's
160 init file.
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
171 .B \-help
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 ).
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
212 can be started with the following standard X options:
213 .TP
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
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
321 should be a resource specification, as might as in your
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
442 of using this resources.
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
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
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
514 "buttom-left" for the Athena scrollbars.
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
596 .SM Using the Mouse
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
631 Lisp code is read at startup from the user's init file,
632 \fB$HOME/.emacs\fP.
633
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.
652
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
659 /usr/local/lib/xemacs-$VERSION/$CONFIGURATION/DOC -
660 contains the documentation strings for the Lisp primitives and
661 preloaded Lisp functions of \fIXEmacs\fP.
662 They are stored here to reduce the size of \fIXEmacs\fP proper.
663
664 .br
665 /usr/local/lib/xemacs-$VERSION/etc/SERVICE - lists people offering
666 various services to assist users of \fIXEmacs\fP,
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
715 .I XEmacs
716 is free; anyone may redistribute copies of
717 .I XEmacs
718 to
719 anyone under the terms stated in the
720 .I XEmacs
721 General Public License,
722 a copy of which accompanies each copy of
723 .I XEmacs
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
734 to redistribution of
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
741 was written by
742 Steve Baur <steve@xemacs.org>,
743 Martin Buchholz <martin@xemacs.org>,
744 Richard Mlynarik <mly@adoc.xerox.com>,
745 Hrvoje Niksic <hniksic@srce.hr>,
746 Chuck Thompson <cthomp@xemacs.org>,
747 Ben Wing <wing@666.com>,
748 Jamie Zawinski <jwz@netscape.com>,
749 and many others.
750 It was based on an early version of
751 .I GNU Emacs Version
752 .IR 19 ,
753 written by Richard Stallman <rms@gnu.org> of the Free Software
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
788 information, including a long history of \fIXEmacs\fP from multiple
789 viewpoints and pretty pictures and bios of the major \fIXEmacs\fP
790 contributors, see the
791 .I XEmacs About Page
792 (the About XEmacs option on the Help menu).
793 .SH MORE INFORMATION
794 For more information about \fIXEmacs\fP, see the
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
802 for up-to-the-minute information about \fIXEmacs\fP.
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
808 inside of \fIXEmacs\fP.
809 .PP
810 The latest version of \fIXEmacs\fP can be downloaded using anonymous
811 FTP from
812 .PP
813 ftp://ftp.xemacs.org/pub/xemacs/
814 .PP
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.