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