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