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