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