Mercurial > hg > xemacs-beta
annotate etc/xemacs.1 @ 5853:1044acf60048
Revert part of Jerry's December 2014 that broke gnuclient on some OS X.
lib-src/ChangeLog addition:
2015-03-08 Aidan Kehoe <kehoea@parhasard.net>
* gnuserv.c (echo_request):
No longer close the file handle unconditionally, leave this to the
individual socket types.
* gnuserv.c (handle_internet_request):
Close the file handle here.
* gnuserv.c (handle_unix_request):
Don't close the file handle here, document why (it broke gnuclient
under OS X). It should actually be OK, but my suspicion is that
the issues is that the Unix (local) domain sockets are still
underdocumented compared to the internet sockets.
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Sun, 08 Mar 2015 20:59:25 +0000 |
| 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/>. |