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