442
+ − 1 .TH XEMACS 1 "2000-09-20"
428
+ − 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
442
+ − 154 .B \-no-early-packages
428
+ − 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
442
+ − 200 .SM Using XEmacs with X Windows
428
+ − 201 .PP
+ − 202 .I XEmacs
+ − 203 has been tailored to work well with the X window system.
+ − 204 If you run
+ − 205 .I XEmacs
442
+ − 206 from under X windows, it will create its own X window to display in.
428
+ − 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
442
+ − 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.
428
+ − 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
442
+ − 320 should be a resource specification, as might be found in your
428
+ − 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
442
+ − 441 of using this resource.
428
+ − 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)
442
+ − 464 If set,
428
+ − 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
442
+ − 513 "bottom-left" for the Athena scrollbars.
428
+ − 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.
