Mercurial > hg > xemacs-beta
annotate etc/xemacs.1 @ 4882:eab9498ecc0e
merge most of rest of redisplay-x.c and redisplay-gtk.c into redisplay-xlike-inc.c
-------------------- ChangeLog entries follow: --------------------
src/ChangeLog addition:
2010-01-18 Ben Wing <ben@xemacs.org>
* redisplay-gtk.c:
* redisplay-gtk.c (gtk_bevel_area):
* redisplay-x.c:
* redisplay-x.c (THIS_IS_X):
* redisplay-xlike-inc.c:
* redisplay-xlike-inc.c (XLIKE_text_width_single_run):
* redisplay-xlike-inc.c (XLIKE_text_width):
* redisplay-xlike-inc.c (XLIKE_output_display_block):
* redisplay-xlike-inc.c (XLIKE_get_gc):
* redisplay-xlike-inc.c (XLIKE_output_string):
* redisplay-xlike-inc.c (XLIKE_OUTPUT_XLIKE_PIXMAP):
* redisplay-xlike-inc.c (XLIKE_output_pixmap):
* redisplay-xlike-inc.c (XLIKE_output_vertical_divider):
* redisplay-xlike-inc.c (XLIKE_output_blank):
* redisplay-xlike-inc.c (XLIKE_output_horizontal_line):
* redisplay-xlike-inc.c (XLIKE_clear_region):
* redisplay-xlike-inc.c (XLIKE_output_eol_cursor):
* redisplay-xlike-inc.c (XLIKE_clear_frame_window):
* redisplay-xlike-inc.c (XLIKE_clear_frame):
* redisplay-xlike-inc.c (XLIKE_flash):
* redisplay-xlike-inc.c (console_type_create_redisplay_XLIKE):
Move lots more code into redisplay-xlike-inc.c. Use macros to
isolate the code that differs among X vs. GTK, to reduce the need
for ifdefs in the middle of the code. Now, redisplay-x.c and
redisplay-gtk.c only contain a few functions whose implementation
is completely different from one to the other, or which are not
present at all in one of them.
GTK code not currently tested, but it has bitrotted somewhat
any. Doing this will help keep it less bitrotty.
* depend: Regenerate.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Mon, 18 Jan 2010 08:44:49 -0600 |
| parents | ea7a6c12df45 |
| 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. |