etc/xemacs.1

   1 .TH XEMACS 1 "2000-09-20"
   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-early-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 Windows
 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 display in.
 207 .PP
 208 .I XEmacs
 209 can be started with the following standard X options:
 210 .TP
 211 .BI \-visual " <visualname><bitdepth>"
 212 Select the visual that XEmacs will attempt to use.
 213 .I <visualname>
 214 should be one of the strings "StaticColor", "TrueColor", "GrayScale",
 215 "PseudoColor" or "DirectColor", and
 216 .I <bitdepth>
 217 should be the number of bits per pixel (example, "-visual TrueColor24"
 218 for a 24bit TrueColor visual) See
 219 .IR X (1)
 220 for more information.
 221 .TP
 222 .B -privateColormap
 223 Require XEmacs to create and use a private colormap for display.  This
 224 will keep XEmacs from taking colors from the default colormap and
 225 keeping them from other clients, at the cost of causing annoying
 226 flicker when the focus changes.  Use this option only if your X server
 227 does not support 24 bit visuals.
 228 .TP
 229 .BI \-geometry " ##x##+##+##"
 230 Specify the geometry of the initial window.  The ##'s represent a number;
 231 the four numbers are width (characters), height (characters), X offset
 232 (pixels), and Y offset (pixels), respectively.  Partial specifications of
 233 the form
 234 .I ##x##
 235 or
 236 .I +##+##
 237 are also allowed. (The geometry
 238 specification is in the standard X format; see
 239 .IR X (1)
 240 for more information.)
 241 .TP
 242 .B \-iconic
 243 Specifies that the initial window should initially appear iconified.
 244 .TP 8
 245 .BI \-name " name"
 246 Specifies the program name which should be used when looking up
 247 defaults in the user's X resources.
 248 .TP
 249 .BI \-title " title, " \-T " title, " \-wn " title"
 250 Specifies the title which should be assigned to the
 251 .I XEmacs
 252 window.
 253 .TP
 254 .BI \-d " displayname, " \-display " displayname"
 255 Create the
 256 .I XEmacs
 257 window on the display specified by
 258 .IR displayname .
 259 Must be the first option specified in the command line.
 260 .TP
 261 .BI \-font " font, " \-fn " font"
 262 Set the
 263 .I XEmacs
 264 window's font to that specified by
 265 .IR font \.
 266 You will find the various
 267 .I X
 268 fonts in the
 269 .I /usr/lib/X11/fonts
 270 directory.
 271 .I XEmacs
 272 works with either fixed- or variable-width fonts, but will probably
 273 look better with a fixed-width font.
 274 .TP
 275 .BI \-scrollbar\-width " pixels"
 276 Specify the width of the vertical scrollbars.
 277 .TP
 278 .BI \-scrollbar\-height " pixels"
 279 Specify the height of the horizontal scrollbars.
 280 .TP
 281 .BI \-bw " pixels, " \-borderwidth " pixels"
 282 Set the
 283 .I XEmacs
 284 window's border width to the number of pixels specified by
 285 .IR pixels \.
 286 Defaults to one pixel on each side of the window.
 287 .TP
 288 .BI \-ib " pixels, " \-internal\-border\-width " pixels"
 289 Specify the width between a frame's border and its text, in pixels.
 290 Defaults to one pixel on each side of the window.
 291 .TP
 292 .BI \-fg " color, " \-foreground " color"
 293 Sets the color of the text.
 294
 295 See the file
 296 .I /usr/lib/X11/rgb.txt
 297 for a list of valid
 298 color names.
 299 .TP
 300 .BI \-bg " color, " \-background " color"
 301 Sets the color of the window's background.
 302 .TP
 303 .BI \-bd " color, " \-bordercolor " color"
 304 Sets the color of the window's border.
 305 .TP
 306 .BI \-mc " color"
 307 Sets the color of the mouse pointer.
 308 .TP
 309 .BI \-cr " color"
 310 Sets the color of the text cursor.
 311 .TP
 312 .B \-rv, \-reverse
 313 Reverses the foreground and background colors (reverse video).  Consider
 314 explicitly setting the foreground and background colors instead of using
 315 this option.
 316 .TP
 317 .BI \-xrm " argument"
 318 This allows you to set an arbitrary resource on the command line.
 319 .I argument
 320 should be a resource specification, as might be found in your
 321 .I \.Xresources
 322 or
 323 .I \.Xdefaults
 324 file.
 325 .PP
 326 You can also set resources, i.e.
 327 .I X
 328 default values, for your
 329 .I XEmacs
 330 windows in your
 331 .I \.Xresources
 332 or
 333 .I \.Xdefaults
 334 file (see
 335 .IR xrdb (1)).
 336 Use the following format:
 337 .IP
 338 Emacs.keyword:value
 339 .PP
 340 or
 341 .IP
 342 Emacs*EmacsFrame.keyword:value
 343 .PP
 344 where
 345 .I value
 346 specifies the default value of
 347 .IR keyword \.
 348 (Some resources need the former format; some the latter.)
 349 .PP
 350 You can also set resources for a particular frame by using the
 351 format
 352 .IP
 353 Emacs*framename.keyword:value
 354 .PP
 355 where
 356 .I framename
 357 is the resource name assigned to that particular frame.
 358 (Certain packages, such as VM, give their frames unique resource
 359 names, in this case "VM".)
 360 .PP
 361 .I XEmacs
 362 lets you set default values for the following keywords:
 363 .TP 8
 364 .B default.attributeFont (\fPclass\fB Face.AttributeFont)
 365 Sets the window's text font.
 366 .TP
 367 .B default.attributeForeground (\fPclass\fB Face.AttributeForeground)
 368 Sets the window's text color.
 369 .TP
 370 .B default.attributeBackground (\fPclass\fB Face.AttributeBackground)
 371 Sets the window's background color.
 372 .TP
 373 .B \fIface\fB.attributeFont (\fPclass\fB Face.AttributeFont)
 374 Sets the font for
 375 .IR face ,
 376 which should be the name of a face.  Common face names are
 377 .PP
 378 .in +\w'right-margin'u+12n
 379 .ta \w'right-margin'u+4n
 380 .ti -\w'right-margin'u+4n
 381 FACE            PURPOSE
 382 .br
 383 .ti -\w'right-margin'u+4n
 384 default Normal text.
 385 .br
 386 .ti -\w'right-margin'u+4n
 387 bold    Bold text.
 388 .br
 389 .ti -\w'right-margin'u+4n
 390 italic  Italicized text.
 391 .br
 392 .ti -\w'right-margin'u+4n
 393 bold-italic     Bold and italicized text.
 394 .br
 395 .ti -\w'right-margin'u+4n
 396 modeline        Modeline text.
 397 .br
 398 .ti -\w'right-margin'u+4n
 399 zmacs-region    Text selected with the mouse.
 400 .br
 401 .ti -\w'right-margin'u+4n
 402 highlight       Text highlighted when the mouse passes over.
 403 .br
 404 .ti -\w'right-margin'u+4n
 405 left-margin     Text in the left margin.
 406 .br
 407 .ti -\w'right-margin'u+4n
 408 right-margin    Text in the right margin.
 409 .br
 410 .ti -\w'right-margin'u+4n
 411 isearch Text highlighted during incremental search.
 412 .br
 413 .ti -\w'right-margin'u+4n
 414 info-node       Text of Info menu items.
 415 .br
 416 .ti -\w'right-margin'u+4n
 417 info-xref       Text of Info cross references.
 418 .TP 8
 419 .B \fIface\fB.attributeForeground (\fPclass\fB Face.AttributeForeground)
 420 Sets the foreground color for
 421 .IR face \.
 422 .TP 8
 423 .B \fIface\fB.attributeBackground (\fPclass\fB Face.AttributeBackground)
 424 Sets the background color for
 425 .IR face \.
 426 .TP 8
 427 .B \fIface\fB.attributeBackgroundPixmap (\fPclass\fB Face.AttributeBackgroundPixmap)
 428 Sets the background pixmap (stipple) for
 429 .IR face \.
 430 .TP 8
 431 .B \fIface\fB.attributeUnderline (\fPclass\fB Face.AttributeUnderline)
 432 Whether
 433 .I face
 434 should be underlined.
 435 .TP
 436 .B reverseVideo (\fPclass\fB ReverseVideo)
 437 If set to
 438 .IR on ,
 439 the window will be displayed in reverse video.  Consider
 440 explicitly setting the foreground and background colors instead
 441 of using this resource.
 442 .TP
 443 .B borderWidth (\fPclass\fB BorderWidth)
 444 Sets the window's border width in pixels.
 445 .TP
 446 .B internalBorderWidth (\fPclass\fB InternalBorderWidth)
 447 Sets the window's internal border width in pixels.
 448 .TP
 449 .B borderColor (\fPclass\fB BorderColor)
 450 Sets the color of the window's border.
 451 .TP
 452 .B cursorColor (\fPclass\fB Foreground)
 453 Sets the color of the window's text cursor.
 454 .TP
 455 .B pointerColor (\fPclass\fB Foreground)
 456 Sets the color of the window's mouse cursor.
 457 .TP
 458 .B emacsVisual (\fPclass\fB EmacsVisual)
 459 Sets the default visual
 460 .I XEmacs
 461 will try to use (as described above).
 462 .TP
 463 .B privateColormap (\fPclass\fB PrivateColormap)
 464 If set,
 465 .I XEmacs
 466 will default to using a private colormap.
 467 .TP
 468 .B geometry (\fPclass\fB Geometry)
 469 Sets the geometry of the
 470 .I XEmacs
 471 window (as described above).
 472 .TP
 473 .B iconic (\fPclass\fB Iconic)
 474 If set to on, the
 475 .I XEmacs
 476 window will initially appear as an icon.
 477 .TP
 478 .B menubar (\fPclass\fB Menubar)
 479 Whether the
 480 .I XEmacs
 481 window will have a menubar.  Defaults to true.
 482 .TP
 483 .B initiallyUnmapped (\fPclass\fB InitiallyUnmapped)
 484 Whether
 485 .I XEmacs
 486 will leave the initial frame unmapped when it starts up.
 487 .TP
 488 .B barCursor (\fPclass\fB BarCursor)
 489 Whether the cursor should be a bar instead of the traditional box.
 490 .TP
 491 .B title (\fPclass\fB Title)
 492 Sets the title of the
 493 .I XEmacs
 494 window.
 495 .TP
 496 .B iconName (\fPclass\fB Title)
 497 Sets the icon name for the
 498 .I XEmacs
 499 window icon.
 500 .TP
 501 .B scrollBarWidth (\fPclass\fB ScrollBarWidth)
 502 Sets the width of the vertical scrollbars, in pixels.  A width of 0
 503 means no vertical scrollbars.
 504 .TP
 505 .B scrollBarHeight (\fPclass\fB ScrollBarHeight)
 506 Sets the height of the horizontal scrollbars, in pixels.  A height of 0
 507 means no horizontal scrollbars.
 508 .TP
 509 .B scrollBarPlacement (\fPclass\fB ScrollBarPlacement)
 510 Sets the position of vertical and horizontal scrollbars.   Should be one
 511 of the strings "top-left", "bottom-left", "top-right", or "bottom-right".
 512 The default is "bottom-right" for the Motif and Lucid scrollbars and
 513 "bottom-left" for the Athena scrollbars.
 514 .TP
 515 .B topToolBarHeight (\fPclass\fB TopToolBarHeight)
 516 Sets the height of the top toolbar, in pixels.  0 means no top toolbar.
 517 .TP
 518 .B bottomToolBarHeight (\fPclass\fB BottomToolBarHeight)
 519 Sets the height of the bottom toolbar, in pixels.  0 means no
 520 bottom toolbar.
 521 .TP
 522 .B leftToolBarWidth (\fPclass\fB LeftToolBarWidth)
 523 Sets the width of the left toolbar, in pixels.  0 means no left toolbar.
 524 .TP
 525 .B rightToolBarWidth (\fPclass\fB RightToolBarWidth)
 526 Sets the width of the right toolbar, in pixels.  0 means no right toolbar.
 527 .TP
 528 .B topToolBarShadowColor (\fPclass\fB TopToolBarShadowColor)
 529 Sets the color of the top shadows for the toolbars. (For all toolbars,
 530 \fBnot\fR just the toolbar at the top of the frame.)
 531 .TP
 532 .B bottomToolBarShadowColor (\fPclass\fB BottomToolBarShadowColor)
 533 Sets the color of the bottom shadows for the toolbars. (For all toolbars,
 534 \fBnot\fR just the toolbar at the bottom of the frame.)
 535 .TP
 536 .B topToolBarShadowPixmap (\fPclass\fB TopToolBarShadowPixmap)
 537 Sets the pixmap of the top shadows for the toolbars. (For all toolbars,
 538 \fBnot\fR just the toolbar at the top of the frame.) If set, this
 539 resource overrides the corresponding color resource.
 540 .TP
 541 .B bottomToolBarShadowPixmap (\fPclass\fB BottomToolBarShadowPixmap)
 542 Sets the pixmap of the bottom shadows for the toolbars. (For all toolbars,
 543 \fBnot\fR just the toolbar at the bottom of the frame.) If set, this
 544 resource overrides the corresponding color resource.
 545 .TP
 546 .B toolBarShadowThickness (\fPclass\fB ToolBarShadowThickness)
 547 Thickness of the shadows around the toolbars, in pixels.
 548 .TP
 549 .B visualBell (\fPclass\fB VisualBell)
 550 Whether XEmacs should flash the screen rather than making an audible beep.
 551 .TP
 552 .B bellVolume (\fPclass\fB BellVolume)
 553 Volume of the audible beep.  Range is 0 through 100.
 554 .TP
 555 .B useBackingStore (\fPclass\fB UseBackingStore)
 556 Whether
 557 .I XEmacs
 558 should set the backing-store attribute of the
 559 .I X
 560 windows it creates.  This increases the memory usage of the
 561 .I X
 562 server but decreases the amount of
 563 .I X
 564 traffic necessary to update the screen, and is useful when the
 565 connection to the
 566 .I X
 567 server goes over a low-bandwidth line such as a modem connection.
 568 .TP
 569 .B textPointer (\fPclass\fB Cursor)
 570 The cursor to use when the mouse is over text.
 571 .TP
 572 .B selectionPointer (\fPclass\fB Cursor)
 573 The cursor to use when the mouse is over a mouse-highlighted
 574 text region.
 575 .TP
 576 .B spacePointer (\fPclass\fB Cursor)
 577 The cursor to use when the mouse is over a blank space in a buffer (that
 578 is, after the end of a line or after the end-of-file).
 579 .TP
 580 .B modeLinePointer (\fPclass\fB Cursor)
 581 The cursor to use when the mouse is over a mode line.
 582 .TP
 583 .B gcPointer (\fPclass\fB Cursor)
 584 The cursor to display when a garbage-collection is in progress.
 585 .TP
 586 .B scrollbarPointer (\fPclass\fB Cursor)
 587 The cursor to use when the mouse is over the scrollbar.
 588 .TP
 589 .B pointerColor (\fPclass\fB Foreground)
 590 The foreground color of the mouse cursor.
 591 .TP
 592 .B pointerBackground (\fPclass\fB Background)
 593 The background color of the mouse cursor.
 594 .PP
 595 .SM Using the Mouse
 596 .PP
 597 The following lists the mouse button bindings for the
 598 .I XEmacs
 599 window under X11.
 600
 601 .in +\w'CTRL-SHIFT-middle'u+4n
 602 .ta \w'CTRL-SHIFT-middle'u+4n
 603 .ti -\w'CTRL-SHIFT-middle'u+4n
 604 MOUSE BUTTON    FUNCTION
 605 .br
 606 .ti -\w'CTRL-SHIFT-middle'u+4n
 607 left    Set point or make a text selection.
 608 .br
 609 .ti -\w'CTRL-SHIFT-middle'u+4n
 610 middle  Paste text.
 611 .br
 612 .ti -\w'CTRL-SHIFT-middle'u+4n
 613 right   Pop up a menu of options.
 614 .br
 615 .ti -\w'CTRL-SHIFT-middle'u+4n
 616 SHIFT-left      Extend a selection.
 617 .br
 618 .ti -\w'CTRL-SHIFT-middle'u+4n
 619 CTRL-left       Make a selection and insert it at point.
 620 .br
 621 .ti -\w'CTRL-SHIFT-middle'u+4n
 622 CTRL-middle     Set point and move selected text there.
 623 .br
 624 .ti -\w'CTRL-SHIFT-middle'u+4n
 625 CTRL-SHIFT-left Make a selection, delete it, and insert it at point.
 626 .br
 627 .ti -\w'CTRL-SHIFT-middle'u+4n
 628 META-left       Make a rectangular selection.
 629 .SH FILES
 630 Lisp code is read at startup from the user's init file,
 631 \fB$HOME/.emacs\fP.
 632
 633 /usr/local/info - files for the Info documentation browser
 634 (a subsystem of
 635 .IR XEmacs )
 636 to refer to.  The complete text of the
 637 .I XEmacs Reference Manual
 638 and the
 639 .I XEmacs Lisp Programmer's Manual
 640 is included in a convenient tree structured form.
 641
 642 /usr/local/lib/xemacs-$VERSION/info - the Info files may be here instead.
 643
 644 /usr/local/lib/xemacs-$VERSION/lisp/* - Lisp source files and compiled files
 645 that define most editing commands.  The files are contained in subdirectories,
 646 categorized by function or individual package.  Some are preloaded;
 647 others are autoloaded from these directories when used.
 648
 649 /usr/local/lib/xemacs-$VERSION/etc - some files of information, pixmap
 650 files, other data files used by certain packages, etc.
 651
 652 /usr/local/lib/xemacs-$VERSION/$CONFIGURATION - various programs that are used
 653 with XEmacs.
 654
 655 /usr/local/lib/xemacs-$VERSION/$CONFIGURATION/DOC -
 656 contains the documentation strings for the Lisp primitives and
 657 preloaded Lisp functions of \fIXEmacs\fP.
 658 They are stored here to reduce the size of \fIXEmacs\fP proper.
 659
 660 /usr/local/lib/xemacs/site-lisp - locally-provided Lisp files.
 661 .PP
 662 .SH BUGS AND HELP
 663 There is a newsgroup, comp.emacs.xemacs, for reporting
 664 .I XEmacs
 665 bugs and fixes and requesting help.  But before reporting something
 666 as a bug, please try to be sure that it really is a bug, not a
 667 misunderstanding or a deliberate feature.  We ask you to read the section
 668 ``Reporting XEmacs Bugs'' near the end of the reference manual (or Info
 669 system) for hints on how and when to report bugs.  Also, include the version
 670 number of the
 671 .I XEmacs
 672 you are running and the system you are running it on
 673 in \fIevery\fR bug report that you send in.  Finally, the more you can
 674 isolate the cause of a bug and the conditions it happens under, the more
 675 likely it is to be fixed, so please take the time to do so.
 676
 677 The newsgroup is bidirectionally gatewayed to and from the mailing list
 678 xemacs@xemacs.org.  You can read the list instead of the newsgroup if
 679 you do not have convenient Usenet news access.  To request to be added
 680 to the mailing list, send mail to xemacs-request@xemacs.org. (Do not
 681 send mail to the list itself.)
 682
 683 The
 684 .I XEmacs
 685 maintainers read the newsgroup regularly and will attempt to
 686 fix bugs reported in a timely fashion.  However, not every message will
 687 get a response from one of the maintainers.  Note that there are many
 688 people other than the maintainers who read the newsgroup, and will usually
 689 be of assistance in helping with any problems encountered.
 690
 691 If you need more personal assistance than can be provided by the
 692 newsgroup, look in the SERVICE file (see above) for a list of people
 693 who offer it.
 694
 695 For more information about XEmacs mailing lists, see the
 696 file /usr/local/lib/xemacs-$VERSION/etc/MAILINGLISTS.
 697 .SH UNRESTRICTIONS
 698 .PP
 699 .I XEmacs
 700 is free; anyone may redistribute copies of
 701 .I XEmacs
 702 to
 703 anyone under the terms stated in the
 704 .I XEmacs
 705 General Public License,
 706 a copy of which accompanies each copy of
 707 .I XEmacs
 708 and which also
 709 appears in the reference manual.
 710 .PP
 711 Copies of
 712 .I XEmacs
 713 may sometimes be received packaged with distributions of Unix systems,
 714 but it is never included in the scope of any license covering those
 715 systems.  Such inclusion violates the terms on which distribution
 716 is permitted.  In fact, the primary purpose of the General Public
 717 License is to prohibit anyone from attaching any other restrictions
 718 to redistribution of
 719 .IR XEmacs \.
 720 .SH SEE ALSO
 721 X(1), xlsfonts(1), xterm(1), xrdb(1), emacs(1), vi(1)
 722 .SH AUTHORS
 723 .PP
 724 .I XEmacs
 725 was written by
 726 Steve Baur <steve@xemacs.org>,
 727 Martin Buchholz <martin@xemacs.org>,
 728 Richard Mlynarik <mly@adoc.xerox.com>,
 729 Hrvoje Niksic <hniksic@xemacs.org>,
 730 Chuck Thompson <cthomp@xemacs.org>,
 731 Ben Wing <ben@xemacs.org>,
 732 Jamie Zawinski <jwz@jwz.org>,
 733 and many others.
 734 It was based on an early version of
 735 .I GNU Emacs Version
 736 .IR 19 ,
 737 written by Richard Stallman <rms@gnu.org> of the Free Software
 738 Foundation, and has tracked subsequent releases of
 739 .I GNU Emacs
 740 as they have become available.  It was originally written by Lucid, Inc.
 741 (now defunct) and was called
 742 .I Lucid
 743 .IR Emacs \.
 744 .PP
 745 Chuck Thompson wrote the
 746 .I XEmacs
 747 redisplay engine, maintains the
 748 .I XEmacs
 749 FTP and WWW sites, and has put out all releases of
 750 .I XEmacs
 751 since 19.11 (the first release called
 752 .IR XEmacs ).
 753 Ben Wing wrote the Asian-language support, the on-line documentation
 754 (including this man page and much of the FAQ), the external widget code,
 755 and retooled or rewrote most of the basic, low-level
 756 .I XEmacs
 757 subsystems.  Jamie Zawinski put out all releases of
 758 .I Lucid
 759 .IR Emacs ,
 760 from the first (19.0) through the last (19.10), and was the primary
 761 code contributor for all of these releases.  Richard Mlynarik rewrote
 762 the
 763 .I XEmacs
 764 Lisp-object allocation system, improved the keymap and minibuffer code,
 765 and did the initial synching of
 766 .I XEmacs
 767 with
 768 .I GNU Emacs Version
 769 .IR 19 \.
 770 .PP
 771 Many others have also contributed significantly.  For more detailed
 772 information, including a long history of \fIXEmacs\fP from multiple
 773 viewpoints and pretty pictures and bios of the major \fIXEmacs\fP
 774 contributors, see the
 775 .I XEmacs About Page
 776 (the About XEmacs option on the Help menu).
 777 .SH MORE INFORMATION
 778 For more information about \fIXEmacs\fP, see the
 779 .I XEmacs About Page
 780 (mentioned above),
 781 look in the file /usr/local/lib/xemacs-$VERSION/etc/NEWS,
 782 or point your Web browser at
 783 .PP
 784 http://www.xemacs.org/
 785 .PP
 786 for up-to-the-minute information about \fIXEmacs\fP.
 787 .PP
 788 The
 789 .I XEmacs
 790 FAQ (Frequently Asked Questions) can be found at the Web site just listed.
 791 A possibly out-of-date version is also accessible through the Info system
 792 inside of \fIXEmacs\fP.
 793 .PP
 794 The latest version of \fIXEmacs\fP can be downloaded using anonymous
 795 FTP from
 796 .PP
 797 ftp://ftp.xemacs.org/pub/xemacs/
 798 .PP
 799 or from a mirror site near you.  Mirror sites are listed in the file
 800 etc/FTP in the XEmacs distribution or see the Web site for an up-to-date
 801 list of mirror sites.