xemacs-21.4 / etc / xemacs.1

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
.TH XEMACS 1 "1997 November 19"
.UC 4
.SH NAME
xemacs \- Emacs: The Next Generation
.SH SYNOPSIS
.B xemacs
[
.I command-line switches
] [
.I files ...
]
.br
.SH DESCRIPTION
.I XEmacs
is a version of 
.IR Emacs ,
compatible with and containing many improvements over
.I GNU
.IR Emacs ,
written by Richard Stallman of the Free Software Foundation.  It was
originally based on an early release of
.I GNU Emacs Version
.IR 19 ,
and has tracked subsequent releases of
.I GNU Emacs
as they have become available.
.PP
The primary documentation of
.I XEmacs
is in the
.I XEmacs Reference
.IR Manual ,
which you can read on-line using Info, a subsystem of
.IR XEmacs .
Please look there for complete and up-to-date documentation.
Complete documentation on using Emacs Lisp is available on-line
through the
.I XEmacs Lisp Programmer's
.IR Manual .
Both manuals also can be printed out nicely using the
.I TeX
formatting package.
.PP
The user functionality of
.I XEmacs
encompasses everything other
.I Emacs
editors do, and it is easily extensible since its
editing commands are written in Lisp.
.PP
.I XEmacs
has an extensive interactive help facility,
but the facility assumes that you know how to manipulate
.I XEmacs
windows and buffers.
CTRL-h enters the Help facility.  Help Tutorial (CTRL-h t)
requests an interactive tutorial which can teach beginners the fundamentals
of 
.I XEmacs 
in a few minutes.
Help Apropos (CTRL-h a) helps you
find a command given its functionality, Help Key Binding (CTRL-h k)
describes a given key sequence's effect, and Help Function (CTRL-h f)
describes a given Lisp function specified by name.  You can also
look up key sequences in the
.I XEmacs Reference Manual
using Lookup Key Binding (CTRL-h CTRL-k),
and look up Lisp functions in the
.I XEmacs Lisp Programmer's Manual
using Lookup Function (CTRL-h CTRL-f).  All of these help functions,
and more, are available on the Help menu if you are using a window
system.
.PP
.I XEmacs
has extensive GUI (graphical user interface) support when running under
a window system such as
.IR X ,
including multiple frames (top-level windows), a menubar, a toolbar,
horizontal and vertical scrollbars, dialog boxes, and extensive mouse
support.
.PP
.I XEmacs
has full support for multiple fonts and colors, variable-width fonts,
and variable-height lines, and allows for pixmaps to be inserted into
a buffer. (This is used in the W3 web-browsing package and in some
of the debugger and outlining interfaces, among other things.)
.PP
.IR XEmacs 's
Undo can undo several steps of modification to your buffers, so it is
easy to recover from editing mistakes.
.PP
.IR XEmacs 's
many special packages handle mail reading (VM, MH-E and RMail) and
sending (Mail), Usenet news reading and posting (GNUS), World Wide Web
browsing (W3), specialized modes for editing source code in all common
programming languages, syntax highlighting for many languages
(Font-Lock), compiling (Compile), running subshells within
.I XEmacs
windows (Shell), outline editing (Outline), running a Lisp read-eval-print
loop (Lisp-Interaction-Mode), and automated psychotherapy (Doctor).
.PP
There is an extensive reference manual, but users of other Emacsen
should have little trouble adapting even without a copy.  Users new to
Emacs will be able to use basic features fairly rapidly by studying
the tutorial and using the self-documentation features.
.PP
.SM XEmacs Options
.PP
XEmacs accepts all standard X Toolkit command line options when run in
an X Windows environment.  In addition, the following options are accepted
(when options imply a sequence of actions to perform, they are
performed in the order encountered):
.TP 8
.BI \-t " file"
Use specified
.I file
as the terminal instead of using stdin/stdout.  This implies
.BR \-nw \.
.TP
.BI \-batch
Edit in batch mode.  The editor will send messages to stdout.  You
must use the
.BR \-l ,
.BR \-f ,
and
.B \-eval
options to specify files to execute and functions to call.
.TP
.B \-nw\ 
Inhibit the use of any window-system-specific display code: use the
current TTY.
.TP
.B \-debug\-init
Enter the debugger if an error occurs loading the init file.
.TP
.B \-unmapped
Do not map the initial frame.
.TP
.B \-no\-site\-file
Do not load the site-specific init file (site-start.el).
.TP
.B \-q, \-no\-init\-file
Do not load an init file.
.TP
.B \-no-packages
Do not process the package path.
.TP
.B \-vanilla
Load no extra files at startup.  Equivalent to the combination of
.B \-q
,
.B \-no-site-file
, and
.B \-no-packages
\.
.TP
.BI \-u " user, " \-user " user"
Load
.IR user 's
init file.
.TP 8
.I file
Edit
.IR file \.
.TP
.BI \+ number
Go to the line specified by
.I number
(do not insert a space between the "+" sign and the number).
.TP
.B \-help
Print a help message and exit.
.TP
.B \-V, \-version,
Print the version number and exit.
.TP
.BI \-f " function, " \-funcall " function"
Execute the lisp function
.IR function \.
.TP
.BI \-l " file, " \-load " file"
Load the Lisp code in the file
.IR file \.
.TP
.BI \-eval " form"
Evaluate the Lisp form
.IR form \.
.TP
.BI \-i " file, " \-insert " file"
Insert
.I file
into the current buffer.
.TP
.B \-kill
Exit
.I XEmacs
(useful with
.BR \-batch ).
.PP
.SM Using XEmacs with X
.PP
.I XEmacs
has been tailored to work well with the X window system.
If you run
.I XEmacs
from under X windows, it will create its own X window to
display in.  You will probably want to start the editor
as a background process
so that you can continue using your original window.
.PP
.I XEmacs
can be started with the following standard X options:
.TP
.BI \-geometry " ##x##+##+##"
Specify the geometry of the initial window.  The ##'s represent a number;
the four numbers are width (characters), height (characters), X offset
(pixels), and Y offset (pixels), respectively.  Partial specifications of
the form
.I ##x##
or
.I +##+##
are also allowed. (The geometry
specification is in the standard X format; see
.IR X (1)
for more information.)
.TP
.B \-iconic
Specifies that the initial window should initially appear iconified.
.TP 8
.BI \-name " name"
Specifies the program name which should be used when looking up
defaults in the user's X resources.
.TP
.BI \-title " title, " \-T " title, " \-wn " title"
Specifies the title which should be assigned to the
.I XEmacs
window.
.TP
.BI \-d " displayname, " \-display " displayname"
Create the
.I XEmacs
window on the display specified by
.IR displayname .
Must be the first option specified in the command line.
.TP
.BI \-font " font, " \-fn " font"
Set the
.I XEmacs
window's font to that specified by
.IR font \.
You will find the various
.I X
fonts in the
.I /usr/lib/X11/fonts
directory.
.I XEmacs
works with either fixed- or variable-width fonts, but will probably
look better with a fixed-width font.
.TP
.BI \-scrollbar\-width " pixels"
Specify the width of the vertical scrollbars.
.TP
.BI \-scrollbar\-height " pixels"
Specify the height of the horizontal scrollbars.
.TP
.BI \-bw " pixels, " \-borderwidth " pixels"
Set the
.I XEmacs
window's border width to the number of pixels specified by
.IR pixels \.
Defaults to one pixel on each side of the window.
.TP
.BI \-ib " pixels, " \-internal\-border\-width " pixels"
Specify the width between a frame's border and its text, in pixels.
Defaults to one pixel on each side of the window.
.TP
.BI \-fg " color, " \-foreground " color"
Sets the color of the text.

See the file
.I /usr/lib/X11/rgb.txt
for a list of valid
color names.
.TP
.BI \-bg " color, " \-background " color"
Sets the color of the window's background.
.TP
.BI \-bd " color, " \-bordercolor " color"
Sets the color of the window's border.
.TP
.BI \-mc " color"
Sets the color of the mouse pointer.
.TP
.BI \-cr " color"
Sets the color of the text cursor.
.TP
.B \-rv, \-reverse
Reverses the foreground and background colors (reverse video).  Consider
explicitly setting the foreground and background colors instead of using
this option.
.TP
.BI \-xrm " argument"
This allows you to set an arbitrary resource on the command line.
.I argument
should be a resource specification, as might as in your
.I \.Xresources
or
.I \.Xdefaults
file.
.PP
You can also set resources, i.e.
.I X
default values, for your
.I XEmacs
windows in your
.I \.Xresources
or
.I \.Xdefaults
file (see
.IR xrdb (1)).
Use the following format:
.IP
Emacs.keyword:value
.PP
or
.IP
Emacs*EmacsFrame.keyword:value
.PP
where
.I value
specifies the default value of
.IR keyword \.
(Some resources need the former format; some the latter.)
.PP
You can also set resources for a particular frame by using the
format
.IP
Emacs*framename.keyword:value
.PP
where
.I framename
is the resource name assigned to that particular frame.
(Certain packages, such as VM, give their frames unique resource
names, in this case "VM".)
.PP
.I XEmacs
lets you set default values for the following keywords:
.TP 8
.B default.attributeFont (\fPclass\fB Face.AttributeFont)
Sets the window's text font.
.TP
.B default.attributeForeground (\fPclass\fB Face.AttributeForeground)
Sets the window's text color.
.TP
.B default.attributeBackground (\fPclass\fB Face.AttributeBackground)
Sets the window's background color.
.TP
.B \fIface\fB.attributeFont (\fPclass\fB Face.AttributeFont)
Sets the font for
.IR face ,
which should be the name of a face.  Common face names are
.PP
.in +\w'right-margin'u+12n
.ta \w'right-margin'u+4n
.ti -\w'right-margin'u+4n
FACE		PURPOSE
.br
.ti -\w'right-margin'u+4n
default	Normal text.
.br
.ti -\w'right-margin'u+4n
bold	Bold text.
.br
.ti -\w'right-margin'u+4n
italic	Italicized text.
.br
.ti -\w'right-margin'u+4n
bold-italic	Bold and italicized text.
.br
.ti -\w'right-margin'u+4n
modeline	Modeline text.
.br
.ti -\w'right-margin'u+4n
zmacs-region	Text selected with the mouse.
.br
.ti -\w'right-margin'u+4n
highlight	Text highlighted when the mouse passes over.
.br
.ti -\w'right-margin'u+4n
left-margin	Text in the left margin.
.br
.ti -\w'right-margin'u+4n
right-margin	Text in the right margin.
.br
.ti -\w'right-margin'u+4n
isearch	Text highlighted during incremental search.
.br
.ti -\w'right-margin'u+4n
info-node	Text of Info menu items.
.br
.ti -\w'right-margin'u+4n
info-xref	Text of Info cross references.
.TP 8
.B \fIface\fB.attributeForeground (\fPclass\fB Face.AttributeForeground)
Sets the foreground color for
.IR face \.
.TP 8
.B \fIface\fB.attributeBackground (\fPclass\fB Face.AttributeBackground)
Sets the background color for
.IR face \.
.TP 8
.B \fIface\fB.attributeBackgroundPixmap (\fPclass\fB Face.AttributeBackgroundPixmap)
Sets the background pixmap (stipple) for
.IR face \.
.TP 8
.B \fIface\fB.attributeUnderline (\fPclass\fB Face.AttributeUnderline)
Whether
.I face
should be underlined.
.TP
.B reverseVideo (\fPclass\fB ReverseVideo)
If set to
.IR on ,
the window will be displayed in reverse video.  Consider
explicitly setting the foreground and background colors instead
of using this resources.
.TP
.B borderWidth (\fPclass\fB BorderWidth)
Sets the window's border width in pixels.
.TP
.B internalBorderWidth (\fPclass\fB InternalBorderWidth)
Sets the window's internal border width in pixels.
.TP
.B borderColor (\fPclass\fB BorderColor)
Sets the color of the window's border.
.TP
.B cursorColor (\fPclass\fB Foreground)
Sets the color of the window's text cursor.
.TP
.B pointerColor (\fPclass\fB Foreground)
Sets the color of the window's mouse cursor.
.TP
.B geometry (\fPclass\fB Geometry)
Sets the geometry of the
.I XEmacs
window (as described above).
.TP
.B iconic (\fPclass\fB Iconic)
If set to on, the
.I XEmacs
window will initially appear as an icon.
.TP
.B menubar (\fPclass\fB Menubar)
Whether the
.I XEmacs
window will have a menubar.  Defaults to true.
.TP
.B initiallyUnmapped (\fPclass\fB InitiallyUnmapped)
Whether
.I XEmacs
will leave the initial frame unmapped when it starts up.
.TP
.B barCursor (\fPclass\fB BarCursor)
Whether the cursor should be a bar instead of the traditional box.
.TP
.B title (\fPclass\fB Title)
Sets the title of the
.I XEmacs
window.
.TP
.B iconName (\fPclass\fB Title)
Sets the icon name for the
.I XEmacs
window icon.
.TP
.B scrollBarWidth (\fPclass\fB ScrollBarWidth)
Sets the width of the vertical scrollbars, in pixels.  A width of 0
means no vertical scrollbars.
.TP
.B scrollBarHeight (\fPclass\fB ScrollBarHeight)
Sets the height of the horizontal scrollbars, in pixels.  A height of 0
means no horizontal scrollbars.
.TP
.B scrollBarPlacement (\fPclass\fB ScrollBarPlacement)
Sets the position of vertical and horizontal scrollbars.   Should be one
of the strings "top-left", "bottom-left", "top-right", or "bottom-right".
The default is "bottom-right" for the Motif and Lucid scrollbars and
"buttom-left" for the Athena scrollbars.
.TP
.B topToolBarHeight (\fPclass\fB TopToolBarHeight)
Sets the height of the top toolbar, in pixels.  0 means no top toolbar.
.TP
.B bottomToolBarHeight (\fPclass\fB BottomToolBarHeight)
Sets the height of the bottom toolbar, in pixels.  0 means no
bottom toolbar.
.TP
.B leftToolBarWidth (\fPclass\fB LeftToolBarWidth)
Sets the width of the left toolbar, in pixels.  0 means no left toolbar.
.TP
.B rightToolBarWidth (\fPclass\fB RightToolBarWidth)
Sets the width of the right toolbar, in pixels.  0 means no right toolbar.
.TP
.B topToolBarShadowColor (\fPclass\fB TopToolBarShadowColor)
Sets the color of the top shadows for the toolbars. (For all toolbars,
\fBnot\fR just the toolbar at the top of the frame.)
.TP
.B bottomToolBarShadowColor (\fPclass\fB BottomToolBarShadowColor)
Sets the color of the bottom shadows for the toolbars. (For all toolbars,
\fBnot\fR just the toolbar at the bottom of the frame.)
.TP
.B topToolBarShadowPixmap (\fPclass\fB TopToolBarShadowPixmap)
Sets the pixmap of the top shadows for the toolbars. (For all toolbars,
\fBnot\fR just the toolbar at the top of the frame.) If set, this
resource overrides the corresponding color resource.
.TP
.B bottomToolBarShadowPixmap (\fPclass\fB BottomToolBarShadowPixmap)
Sets the pixmap of the bottom shadows for the toolbars. (For all toolbars,
\fBnot\fR just the toolbar at the bottom of the frame.) If set, this
resource overrides the corresponding color resource.
.TP
.B toolBarShadowThickness (\fPclass\fB ToolBarShadowThickness)
Thickness of the shadows around the toolbars, in pixels.
.TP
.B visualBell (\fPclass\fB VisualBell)
Whether XEmacs should flash the screen rather than making an audible beep.
.TP
.B bellVolume (\fPclass\fB BellVolume)
Volume of the audible beep.  Range is 0 through 100.
.TP
.B useBackingStore (\fPclass\fB UseBackingStore)
Whether
.I XEmacs
should set the backing-store attribute of the
.I X
windows it creates.  This increases the memory usage of the
.I X
server but decreases the amount of
.I X
traffic necessary to update the screen, and is useful when the
connection to the
.I X
server goes over a low-bandwidth line such as a modem connection.
.TP
.B textPointer (\fPclass\fB Cursor)
The cursor to use when the mouse is over text.
.TP
.B selectionPointer (\fPclass\fB Cursor)
The cursor to use when the mouse is over a mouse-highlighted
text region.
.TP
.B spacePointer (\fPclass\fB Cursor)
The cursor to use when the mouse is over a blank space in a buffer (that
is, after the end of a line or after the end-of-file).
.TP
.B modeLinePointer (\fPclass\fB Cursor)
The cursor to use when the mouse is over a mode line.
.TP
.B gcPointer (\fPclass\fB Cursor)
The cursor to display when a garbage-collection is in progress.
.TP
.B scrollbarPointer (\fPclass\fB Cursor)
The cursor to use when the mouse is over the scrollbar.
.TP
.B pointerColor (\fPclass\fB Foreground)
The foreground color of the mouse cursor.
.TP
.B pointerBackground (\fPclass\fB Background)
The background color of the mouse cursor.
.PP
.SM Using the Mouse 
.PP
The following lists the mouse button bindings for the
.I XEmacs
window under X11.

.in +\w'CTRL-SHIFT-middle'u+4n
.ta \w'CTRL-SHIFT-middle'u+4n
.ti -\w'CTRL-SHIFT-middle'u+4n
MOUSE BUTTON	FUNCTION
.br
.ti -\w'CTRL-SHIFT-middle'u+4n
left	Set point or make a text selection.
.br
.ti -\w'CTRL-SHIFT-middle'u+4n
middle	Paste text.
.br
.ti -\w'CTRL-SHIFT-middle'u+4n
right	Pop up a menu of options.
.br
.ti -\w'CTRL-SHIFT-middle'u+4n
SHIFT-left	Extend a selection.
.br
.ti -\w'CTRL-SHIFT-middle'u+4n
CTRL-left	Make a selection and insert it at point.
.br
.ti -\w'CTRL-SHIFT-middle'u+4n
CTRL-middle	Set point and move selected text there.
.br
.ti -\w'CTRL-SHIFT-middle'u+4n
CTRL-SHIFT-left	Make a selection, delete it, and insert it at point.
.br
.ti -\w'CTRL-SHIFT-middle'u+4n
META-left	Make a rectangular selection.
.SH FILES
Lisp code is read at startup from the user's init file,
\fB$HOME/.emacs\fP.

/usr/local/info - files for the Info documentation browser
(a subsystem of
.IR XEmacs )
to refer to.  The complete text of the
.I XEmacs Reference Manual
and the
.I XEmacs Lisp Programmer's Manual
is included in a convenient tree structured form.

/usr/local/lib/xemacs-$VERSION/info - the Info files may be here instead.

/usr/local/lib/xemacs-$VERSION/src - C source files and object files.
(May not be present.)

/usr/local/lib/xemacs-$VERSION/lisp/* - Lisp source files and compiled files
that define most editing commands.  The files are contained in subdirectories,
categorized by function or individual package.  Some are preloaded;
others are autoloaded from these directories when used.
  
/usr/local/lib/xemacs-$VERSION/etc - some files of information, pixmap
files, other data files used by certain packages, etc.

/usr/local/lib/xemacs-$VERSION/$CONFIGURATION - various programs that are used
with XEmacs.

/usr/local/lib/xemacs-$VERSION/$CONFIGURATION/DOC -
contains the documentation strings for the Lisp primitives and
preloaded Lisp functions of \fIXEmacs\fP.
They are stored here to reduce the size of \fIXEmacs\fP proper.

.br
/usr/local/lib/xemacs-$VERSION/etc/SERVICE - lists people offering
various services to assist users of \fIXEmacs\fP,
including education, troubleshooting, porting and customization.

/usr/local/lib/xemacs/lock - holds lock files that are made for all
files being modified in
.IR XEmacs ,
to prevent simultaneous modification of one file by two users.

/usr/local/lib/xemacs/site-lisp - locally-provided Lisp files.

/usr/lib/X11/rgb.txt - list of valid X color names.
.PP
.SH BUGS AND HELP
There is a newsgroup, comp.emacs.xemacs, for reporting
.I XEmacs
bugs and fixes and requesting help.  But before reporting something
as a bug, please try to be sure that it really is a bug, not a
misunderstanding or a deliberate feature.  We ask you to read the section
``Reporting XEmacs Bugs'' near the end of the reference manual (or Info
system) for hints on how and when to report bugs.  Also, include the version
number of the
.I XEmacs
you are running and the system you are running it on
in \fIevery\fR bug report that you send in.  Finally, the more you can
isolate the cause of a bug and the conditions it happens under, the more
likely it is to be fixed, so please take the time to do so.

The newsgroup is bidirectionally gatewayed to and from the mailing list
xemacs@xemacs.org.  You can read the list instead of the newsgroup if
you do not have convenient Usenet news access.  To request to be added
to the mailing list, send mail to xemacs-request@xemacs.org. (Do not
send mail to the list itself.)

The
.I XEmacs
maintainers read the newsgroup regularly and will attempt to
fix bugs reported in a timely fashion.  However, not every message will
get a response from one of the maintainers.  Note that there are many
people other than the maintainers who read the newsgroup, and will usually
be of assistance in helping with any problems encountered.

If you need more personal assistance than can be provided by the
newsgroup, look in the SERVICE file (see above) for a list of people
who offer it.

For more information about XEmacs mailing lists, see the
file /usr/local/lib/xemacs-$VERSION/etc/MAILINGLISTS.
.SH UNRESTRICTIONS
.PP
.I XEmacs 
is free; anyone may redistribute copies of 
.I XEmacs 
to
anyone under the terms stated in the 
.I XEmacs 
General Public License,
a copy of which accompanies each copy of 
.I XEmacs 
and which also
appears in the reference manual.
.PP
Copies of
.I XEmacs
may sometimes be received packaged with distributions of Unix systems,
but it is never included in the scope of any license covering those
systems.  Such inclusion violates the terms on which distribution
is permitted.  In fact, the primary purpose of the General Public
License is to prohibit anyone from attaching any other restrictions
to redistribution of 
.IR XEmacs \.
.SH SEE ALSO
X(1), xlsfonts(1), xterm(1), xrdb(1), emacs(1), vi(1)
.SH AUTHORS
.PP
.I XEmacs
was written by Chuck Thompson <cthomp@xemacs.org>, Ben Wing
<wing@666.com>, Jamie Zawinski <jwz@netscape.com>, Richard Mlynarik
<mly@adoc.xerox.com>, Martin Buchholz <mrb@eng.sun.com> and many
others.  It was based on an early version of
.I GNU Emacs Version
.IR 19 ,
written by Richard Stallman of the Free Software
Foundation, and has tracked subsequent releases of
.I GNU Emacs
as they have become available.  It was originally written by Lucid, Inc.
(now defunct) and was called
.I Lucid
.IR Emacs \.
.PP
Chuck Thompson wrote the
.I XEmacs
redisplay engine, maintains the
.I XEmacs
FTP and WWW sites, and has put out all releases of
.I XEmacs
since 19.11 (the first release called
.IR XEmacs ).
Ben Wing wrote the Asian-language support, the on-line documentation
(including this man page and much of the FAQ), the external widget code,
and retooled or rewrote most of the basic, low-level
.I XEmacs
subsystems.  Jamie Zawinski put out all releases of
.I Lucid
.IR Emacs ,
from the first (19.0) through the last (19.10), and was the primary
code contributor for all of these releases.  Richard Mlynarik rewrote
the
.I XEmacs
Lisp-object allocation system, improved the keymap and minibuffer code,
and did the initial synching of
.I XEmacs
with
.I GNU Emacs Version
.IR 19 \.
.PP
Many others have also contributed significantly.  For more detailed
information, including a long history of \fIXEmacs\fP from multiple
viewpoints and pretty pictures and bios of the major \fIXEmacs\fP
contributors, see the
.I XEmacs About Page
(the About XEmacs option on the Help menu).
.SH MORE INFORMATION
For more information about \fIXEmacs\fP, see the
.I XEmacs About Page
(mentioned above),
look in the file /usr/local/lib/xemacs-$VERSION/etc/NEWS,
or point your Web browser at
.PP
http://www.xemacs.org/
.PP
for up-to-the-minute information about \fIXEmacs\fP.
.PP
The
.I XEmacs
FAQ (Frequently Asked Questions) can be found at the Web site just listed.
A possibly out-of-date version is also accessible through the Info system
inside of \fIXEmacs\fP.
.PP
The latest version of \fIXEmacs\fP can be downloaded using anonymous
FTP from
.PP
ftp://ftp.xemacs.org/pub/xemacs/
.PP
or from a mirror site near you.  Here is an approximate (possibly
out-of-date) list of mirror sites:
.PP
ftp://ftp.ai.mit.edu/pub/xemacs/
.br
ftp://ftp.uu.net/systems/gnu/xemacs/
.br
ftp://ftp.sunet.se/pub/gnu/xemacs/
.br
ftp://ftp.cenatls.cena.dgac.fr/pub/Emacs/xemacs/
.br
ftp://liasun3.epfl.ch/pub/gnu/xemacs/
.br
ftp://ftp.th-darmstadt.de/pub/editors/xemacs/
.br
ftp://audrey.levels.unisa.edu.au/xemacs/
.br
ftp://sunsite.doc.ic.ac.uk/gnu/xemacs/
.br
ftp://ftp.ibp.fr/pub/emacs/xemacs/
.br
ftp://uiarchive.cso.uiuc.edu/pub/packages/xemacs/
.br
ftp://ftp.technion.ac.il/pub/unsupported/gnu/xemacs/
.br
ftp://thphys.irb.hr/pub/xemacs/
.PP
See the Web site for an up-to-date list of mirror sites.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.