Mercurial > hg > xemacs-beta
annotate etc/OONEWS @ 5887:6eca500211f4
Prototype for X509_check_host() has changed, detect this in configure.ac
ChangeLog addition:
2015-04-09 Aidan Kehoe <kehoea@parhasard.net>
* configure.ac:
If X509_check_host() is available, check the number of arguments
it takes. Don't use it if it takes any number of arguments other
than five. Also don't use it if <openssl/x509v3.h> does not
declare it, since if that is so there is no portable way to tell
how many arguments it should take, and so we would end up smashing
the stack.
* configure: Regenerate.
src/ChangeLog addition:
2015-04-09 Aidan Kehoe <kehoea@parhasard.net>
* tls.c:
#include <openssl/x509v3.h> for its prototype for
X509_check_host().
* tls.c (tls_open):
Pass the new fifth argument to X509_check_host().
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Thu, 09 Apr 2015 14:27:02 +0100 |
| parents | 5d2981eee77e |
| children |
| rev | line source |
|---|---|
|
5441
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
1 |
| 428 | 2 -*- mode:outline; minor-mode:outl-mouse -*- |
| 3 C-c TAB This shows subheadings (if any) of current heading. | |
| 4 C-c C-s Show _all_ the text and headings under current heading | |
| 5 | |
|
5441
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
6 Copyright (C) 1992-1994 Free Software Foundation, Inc. |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
7 Copyright (C) 1995-1996 Chuck Thompson |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
8 Copyright (C) 1996-1997 Steve Baur |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
9 Copyright (C) 1997 Hrvoje Niksic |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
10 |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
11 This file is part of XEmacs. |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
12 |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
13 XEmacs is free software: you can redistribute it and/or modify it |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
14 under the terms of the GNU General Public License as published by the |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
15 Free Software Foundation, either version 3 of the License, or (at your |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
16 option) any later version. |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
17 |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
18 XEmacs is distributed in the hope that it will be useful, but WITHOUT |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
19 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
20 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
21 for more details. |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
22 |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
23 You should have received a copy of the GNU General Public License |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
24 along with XEmacs. If not, see <http://www.gnu.org/licenses/>. |
|
5d2981eee77e
Added copyright notices and GPLV3 or later license to NEWS files.
Mats Lidell <matsl@xemacs.org>
parents:
442
diff
changeset
|
25 |
| 428 | 26 |
| 27 * Introduction | |
| 28 ============== | |
| 29 | |
| 30 This file presents some general information about XEmacs. It is primarily | |
| 31 about the evolution of XEmacs and its release history. | |
| 32 | |
| 33 There are five sections. | |
| 34 | |
| 35 Introduction................(this section) provides an introduction | |
| 36 | |
| 37 Using Outline Mode..........briefly explains how to use outline mode | |
| 38 | |
| 39 XEmacs Release Notes........detailed changes to this release | |
| 40 | |
| 41 Future Plans for XEmacs.....what's next | |
| 42 | |
| 43 The History of XEmacs.......some historical notes | |
| 44 | |
| 45 A Long List of Packages.....all the stuff in XEmacs | |
| 46 | |
| 47 What Changed................between versions and also FSF GNU Emacs | |
| 48 | |
| 49 New users should look at the next section on "Using Outline Mode". | |
| 50 You will be more efficient when you can navigate quickly through this | |
| 51 file. Users who want to know which capabilities have been introduced | |
| 52 in this release should look at the "XEmacs Release Notes." Users | |
| 53 interested in some of the details of how XEmacs differs from GNU Emacs | |
| 54 should read the section "What Changed?". | |
| 55 | |
| 56 N.B. The term "FSF GNU Emacs" refers to any release of Emacs | |
| 57 Version 19 from the Free Software Foundation's GNU Project. (We do | |
| 58 not say just "GNU Emacs" because Richard M. Stallman ["RMS"] | |
| 59 thinks that this term is too generic; although we sometimes say | |
| 60 e.g. "GNU Emacs 19.30" to refer to a specific version of FSF GNU | |
| 61 Emacs. The term "XEmacs" refers to this program or to its | |
| 62 predecessors "Era", "Epoch", and "Lucid Emacs". The predecessor | |
| 63 of all these program is called "Emacs 18". When no particular | |
| 64 version is implied, "Emacs" will be used. | |
| 65 | |
| 66 | |
| 67 * Using Outline Mode | |
| 68 ==================== | |
| 69 | |
| 70 This file is in outline mode, a major mode for viewing (or editing) | |
| 71 outlines. It allows you to make parts of the text temporarily invisible so | |
| 72 that you can see just the overall structure of the outline. | |
| 73 | |
| 74 There are two ways of using outline mode: with keys or with menus. Using | |
| 75 outline mode with menus is the simplest and is just as effective as using | |
| 76 keystrokes. There are menus for outline mode on the menubar as well as in | |
| 77 popup menus activated by pressing mouse button 3. | |
| 78 | |
| 79 Try the following to help you read this file. | |
| 80 | |
| 81 C-c C-q This hides everything but the very top level headings | |
| 82 You can then move to an interesting section | |
| 83 C-c TAB This shows subheadings (if any) of current heading. | |
| 84 C-c C-s Show _all_ the text and headings under current heading | |
| 85 C-c C-d Hide _all_ the text and headings under current heading | |
| 86 | |
| 87 It's then easy to navigate through the file alternating between | |
| 88 showing, C-C C-s, and hiding, C-c C-d, the text. Also, use the "Show" | |
| 89 and "Hide" menus displayed to get access to the same commands. | |
| 90 | |
| 91 You may at any time press `C-h m' to get a listing of the outline mode key | |
| 92 bindings. | |
| 93 | |
| 94 * XEmacs Release Notes | |
| 95 ====================== | |
| 96 | |
| 97 ** Major Differences Between 19.15 and 19.16 | |
| 98 ============================================ | |
| 99 | |
| 100 Many bugs have been fixed. XEmacs 19.16 is a bug-fix release only. No | |
| 101 new features have been added. | |
| 102 | |
| 103 -- shell-command did not respect its output-buffer argument. | |
| 104 | |
| 105 -- When using CVS in conjunction with frame-icon, an error | |
| 106 would occur when a frame was iconified. | |
| 107 | |
| 108 -- dired did not properly protect its data structures during | |
| 109 garbage collection. | |
| 110 | |
| 111 -- y-or-n-p-minibuf could crash XEmacs 19.15. | |
| 112 | |
| 113 -- overlay-lists did not always return a pair of lists. | |
| 114 | |
| 115 -- Starting with the -nw option did not prevent XEmacs 19.15 from | |
| 116 attempting to connect to a tooltalk server. | |
| 117 | |
| 118 -- XEmacs 19.15 could not be built on a DUNIX4.0 system. | |
| 119 | |
| 120 -- appt.el did not respect the user's hooks. | |
| 121 | |
| 122 -- outline-mode did not work in a tty-only XEmacs 19.15. | |
| 123 | |
| 124 -- MD5 checksum generation did not work on a 64-bit machine. | |
| 125 | |
| 126 -- XEmacs 19.15 ignored the user's mail path. | |
| 127 | |
| 128 -- The rcompile package checked for ange-ftp instead of efs. | |
| 129 | |
| 130 -- vc-directory did not work. | |
| 131 | |
| 132 -- Sometimes clicking on a modeline did not advance to the | |
| 133 next or previous buffer as it should have. | |
| 134 | |
| 135 -- The variable enable-local-variables was sometimes ignored. | |
| 136 | |
| 137 -- pending-del did not respect the user's hooks. | |
| 138 | |
| 139 -- CRiSP mode was synchronized with FSF emacs. | |
| 140 | |
| 141 -- The performance of font-lock was improved. | |
| 142 | |
| 143 -- There were numerous holes in the garbage collection. | |
| 144 | |
| 145 -- There were 2 minor bugs with using XEmacs 19.15 on a tty. | |
| 146 | |
| 147 -- XEmacs 19.15 ignored certain dead_key events. | |
| 148 | |
| 149 -- XEmacs 19.15 had minor fontification problems with java. | |
| 150 | |
| 151 -- mark-pop did not always restore the mark properly. | |
| 152 | |
| 153 -- smtpmail.el had a couple of minor bugs. | |
| 154 | |
| 155 -- telnet-mode did not always respond to the telnet prompt. | |
| 156 | |
| 157 -- gomoku was broken in XEmacs 19.15. | |
| 158 | |
| 159 -- recover-all files did not work in XEmacs 19.15. | |
| 160 | |
| 161 -- transient-mark-mode and skeleton.el did not work together. | |
| 162 | |
| 163 -- Footnotes were not properly formatted in info. | |
| 164 | |
| 165 -- Configuration of XEmacs 19.15 did not work on Sequent | |
| 166 computers, because they do not have a working version of alloca. | |
| 167 | |
| 168 -- In XEmacs 19.15 it was impossible to compile with Lucid | |
| 169 scrollbars without Motif. | |
| 170 | |
| 171 -- XEmacs 19.15 would erroneously report an internal error on | |
| 172 certain types of minibuffer input. | |
| 173 | |
| 174 -- When using virtual screens with your X server, sometimes | |
| 175 iconify-frame would cause XEmacs 19.15 to lose one of the frames. | |
| 176 | |
| 177 -- server-kill-buffer always returned nil. | |
| 178 | |
| 179 -- The :filter keyword on a menubar could crash XEmacs 19.15. | |
| 180 | |
| 181 -- psgml-mode did not respect the user's hooks. | |
| 182 | |
| 183 -- Many bugs in efs mode were fixed. | |
| 184 | |
| 185 -- sh-script.el could hang XEmacs. | |
| 186 | |
| 187 -- Options could not be saved after fonts were changed in | |
| 188 XEmacs 19.15. | |
| 189 | |
| 190 -- read-from-string could not read "1.". | |
| 191 | |
| 192 -- dired was confused about where chown lives on Linux. | |
| 193 | |
| 194 -- Edebug did not work on floating point numbers. | |
| 195 | |
| 196 -- first-change-hook saved the wrong buffer, so unwinding the | |
| 197 stack could result in the wrong buffer's being restored. | |
| 198 | |
| 199 -- pcl-cvs was incompatible with live-icon. | |
| 200 | |
| 201 -- save-buffer deactivated the zmacs region. | |
| 202 | |
| 203 -- When running a sub-process, if the standard error could | |
| 204 not be opened, the error was reported incorectly. | |
| 205 | |
| 206 -- shell-command-on-region had a bogus test for the active | |
| 207 region. | |
| 208 | |
| 209 -- get-frame-for-buffer ignored relevant properties. | |
| 210 | |
| 211 -- make-database did not correctly expand its filename | |
| 212 argument. | |
| 213 | |
| 214 -- A few minor improvements were made to the optimizer in the | |
| 215 byte-compiler. | |
| 216 | |
| 217 -- kill-region could get confused when the beginning of the | |
| 218 region was after the end of the region. | |
| 219 | |
| 220 -- movemail was upgraded to the same version which shipped | |
| 221 with XEmacs 20.2; this version understands Linux file locking. | |
| 222 | |
| 223 -- The regexp cache size was too small. | |
| 224 | |
| 225 -- The "save as" dialog was buggy. | |
| 226 | |
| 227 -- Minor bugs in sendmail mode. | |
| 228 | |
| 229 -- tm did not understand the png image format. | |
| 230 | |
| 231 -- set-text-properties only removed the first text property. | |
| 232 | |
| 233 -- add-log.el has been upgraded to the version supported by | |
| 234 FSF emacs 20.1. | |
| 235 | |
| 236 -- When tags-loop-continue was called inappropriately, the | |
| 237 wrong error message resulted. | |
| 238 | |
| 239 -- Frame creation was buggy, and could crash XEmacs. | |
| 240 | |
| 241 -- PNG support did not work on Linux. | |
| 242 | |
| 243 -- Asynchronous process output did not always work. | |
| 244 | |
| 245 -- x-compose.el did not support the degree sign or the | |
| 246 grave keysym. | |
| 247 | |
| 248 -- mh-invisible-headers did not work. | |
| 249 | |
| 250 -- Creating a tty frame could crash XEmacs 19.15. | |
| 251 | |
| 252 -- detach-extent could crash XEmacs. | |
| 253 | |
| 254 -- The minibuffer could get the read-only attribute. | |
| 255 | |
| 256 -- When the mouse was in the right side of the frame, its | |
| 257 position could be reported incorrectly. | |
| 258 | |
| 259 -- lib-complete didn't work with compressed files. | |
| 260 | |
| 261 -- getloadavg.c was brought into sync with the XEmacs 20.2 | |
| 262 version. | |
| 263 | |
| 264 ** Major Differences Between 19.14 and 19.15 | |
| 265 ============================================ | |
| 266 | |
| 267 Many bugs have been fixed. An effort has been made to eradicate all | |
| 268 XEmacs crashes, although we are not quite done yet. The overall | |
| 269 quality of XEmacs should be higher than any previous release. XEmacs | |
| 270 now compiles with nary a warning with some compilers. | |
| 271 | |
| 272 User visible changes: | |
| 273 | |
| 274 -- EFS replaces ange-ftp for remote file manipulation capability. | |
| 275 | |
| 276 -- TM (Tools for Mime) now comes with XEmacs. This provides MIME | |
| 277 (Multi-purpose Internet Multi-media Extensions?) support for Mail | |
| 278 and News. The primary author is Morioka Tomohiko. | |
| 279 | |
| 280 -- There is a new way to customize faces and (some) variables. | |
| 281 Try it with `M-x customize RET', or from the Options->Customize menu. | |
| 282 Documented in <URL:info:custom>. | |
| 283 | |
| 284 -- The AUC TeX environment for editing and running TeX is now bundled. | |
| 285 (Per Abrahamsen.) | |
| 286 Enable with (require 'tex-site) in your .emacs file. | |
| 287 Documented in <URL:info:auctex>. | |
| 288 | |
| 289 -- New user option `init-face-from-resources'. | |
| 290 If you don't set faces with X resources, you can speed up the | |
| 291 initialization of new faces by setting this to nil. | |
| 292 | |
| 293 -- `column.el' removed, use `column-number-mode' instead. | |
| 294 | |
| 295 -- Command line processing should work much better now - no more order | |
| 296 dependencies. | |
| 297 | |
| 298 -- html mode now defaults to using HTML-3.2 | |
| 299 | |
| 300 -- VM now has a native MIME mode | |
| 301 | |
| 302 -- The traditional time.el package now has optional modeline graphics | |
| 303 | |
| 304 -- The XEmacs Logo has been changed courtesy of Jens Lautenbacher | |
| 305 | |
| 306 -- Default background changed to gray80 | |
| 307 | |
| 308 -- The XEmacs build procedure has been changed to make it easier than | |
| 309 ever to include new packages to be dumped with the binary | |
| 310 | |
| 311 -- cc-mode is no longer auto-loaded. (require 'cc-mode) is now needed | |
| 312 before you customize cc-mode in your .emacs. | |
| 313 | |
| 314 -- blink-cursor-mode is somewhat more useable now that the cursor | |
| 315 stops blinking during keyboard activity. | |
| 316 | |
| 317 -- Dired is now part of efs and went from version 6.X to 7.9. | |
| 318 Keybindings have been synced with FSF Emacs, there are more menus and | |
| 319 items in menus are sometimes grouped differently. Any personnal | |
| 320 customization to dired will probably have to be checked. | |
| 321 | |
| 322 If you are a 19.14 user and use its dired a lot, expect to get mad at | |
| 323 'c', 'r' and '^' keybindings." | |
| 324 | |
| 325 | |
| 326 ** New Packages | |
| 327 ------------ | |
| 328 | |
| 329 Noteworthy new packages: | |
| 330 redo | |
| 331 igrep | |
| 332 uniquify | |
| 333 auctex | |
| 334 | |
| 335 | |
| 336 -- Many new packages have been added: | |
| 337 *** auctex (Per Abrahamsen) | |
| 338 *** customize (Per Abrahamsen)) | |
| 339 *** m4-mode 1.8 (Andrew Csillag) | |
| 340 *** crisp.el - crisp/brief emulation (Gary D. Foster) | |
| 341 Minor mode emulation for Borland's Brief/Crisp editor | |
| 342 *** Johan Vroman's iso-acc.el has been ported to XEmacs by Alexandre Oliva | |
| 343 *** psgml-1.01 (Lennart Staflin, James Clark) | |
| 344 *** python-mode.el 2.90 (Barry Warsaw) | |
| 345 *** vrml-mode.el (Ben Wing) | |
| 346 *** enriched.el, face-menu.el (Boris Goldowsky, Michael Sperber) | |
| 347 *** sh-script.el (Daniel Pfeiffer) | |
| 348 *** decipher.el (Christopher J. Madsen) | |
| 349 *** mic-paren.el (Mikael Sjödin) | |
| 350 *** xrdb-mode.el 1.21 (Barry Warsaw) | |
| 351 *** redo.el 1.01 (Kyle Jones) | |
| 352 *** edmacro.el (ported by Hrvoje Niksic) | |
| 353 *** verilog-mode.el (Michael McNamara) | |
| 354 *** webjump.el-1.4 (Neil W. Van Dyke) | |
| 355 *** overlay.el (Joseph Nuspl support for Emacs overlay API) | |
| 356 *** browse-cltl2.el 1.1 (Holger Schauer) | |
| 357 *** mine.el 1.17 (Jacques Duthen) | |
| 358 *** igrep.el 2.56 (Kevin Rodgers) | |
| 359 *** speedbar.el (Eric Ludlam) | |
| 360 *** frame-icon.el (Michael Lamoureux) | |
| 361 *** winmgr-mode.el (David Konerding, Stefan Strobel & Barry Warsaw) | |
| 362 *** whitespace-mode.el (Heiko Muenkel) | |
| 363 *** detached-minibuf.el (Alvin Shelton) | |
| 364 | |
| 365 ** Updated Packages | |
| 366 ------------ | |
| 367 | |
| 368 Most packages have been updated to the latest available versions. | |
| 369 (thanks go to countless maintainers): | |
| 370 | |
| 371 *** ediff 2.64 (Michael Kifer) | |
| 372 *** Gnus Gnus 5.4.36 (Lars Magne Ingebrigtsen) | |
| 373 | |
| 374 **** nntp.el has been totally rewritten in an asynchronous fashion. | |
| 375 | |
| 376 **** Article prefetching functionality has been moved up into | |
| 377 Gnus. | |
| 378 | |
| 379 **** Scoring can now be performed with logical operators like | |
| 380 `and', `or', `not', and parent redirection. | |
| 381 | |
| 382 **** Article washing status can be displayed in the | |
| 383 article mode line. | |
| 384 | |
| 385 **** gnus.el has been split into many smaller files. | |
| 386 | |
| 387 **** Suppression of duplicate articles based on Message-ID. | |
| 388 | |
| 389 (setq gnus-suppress-duplicates t) | |
| 390 | |
| 391 **** New variables for specifying what score and adapt files | |
| 392 are to be considered home score and adapt files. See | |
| 393 `gnus-home-score-file' and `gnus-home-adapt-files'. | |
| 394 | |
| 395 **** Groups can inherit group parameters from parent topics. | |
| 396 | |
| 397 **** Article editing has been revamped and is now usable. | |
| 398 | |
| 399 **** Signatures can be recognized in more intelligent fashions. | |
| 400 See `gnus-signature-separator' and `gnus-signature-limit'. | |
| 401 | |
| 402 **** Summary pick mode has been made to look more nn-like. | |
| 403 Line numbers are displayed and the `.' command can be | |
| 404 used to pick articles. | |
| 405 | |
| 406 **** Commands for moving the .newsrc.eld from one server to | |
| 407 another have been added. | |
| 408 | |
| 409 `M-x gnus-change-server' | |
| 410 | |
| 411 **** A way to specify that "uninteresting" fields be suppressed when | |
| 412 generating lines in buffers. | |
| 413 | |
| 414 **** Several commands in the group buffer can be undone with | |
| 415 `M-C-_'. | |
| 416 | |
| 417 **** Scoring can be done on words using the new score type `w'. | |
| 418 | |
| 419 **** Adaptive scoring can be done on a Subject word-by-word basis: | |
| 420 | |
| 421 (setq gnus-use-adaptive-scoring '(word)) | |
| 422 | |
| 423 **** Scores can be decayed. | |
| 424 | |
| 425 (setq gnus-decay-scores t) | |
| 426 | |
| 427 **** Scoring can be performed using a regexp on the Date header. The | |
| 428 Date is normalized to compact ISO 8601 format first. | |
| 429 | |
| 430 **** A new command has been added to remove all data on articles from | |
| 431 the native server. | |
| 432 | |
| 433 `M-x gnus-group-clear-data-on-native-groups' | |
| 434 | |
| 435 **** A new command for reading collections of documents | |
| 436 (nndoc with nnvirtual on top) has been added -- `M-C-d'. | |
| 437 | |
| 438 **** Process mark sets can be pushed and popped. | |
| 439 | |
| 440 **** A new mail-to-news backend makes it possible to post | |
| 441 even when the NNTP server doesn't allow posting. | |
| 442 | |
| 443 **** A new backend for reading searches from Web search engines | |
| 444 (DejaNews, Alta Vista, InReference) has been added. | |
| 445 | |
| 446 Use the `G w' command in the group buffer to create such | |
| 447 a group. | |
| 448 | |
| 449 **** Groups inside topics can now be sorted using the standard | |
| 450 sorting functions, and each topic can be sorted independently. | |
| 451 | |
| 452 See the commands under the `T S' submap. | |
| 453 | |
| 454 **** Subsets of the groups can be sorted independently. | |
| 455 | |
| 456 See the commands under the `G P' submap. | |
| 457 | |
| 458 **** Cached articles can be pulled into the groups. | |
| 459 | |
| 460 Use the `Y c' command. | |
| 461 | |
| 462 **** Score files are now applied in a more reliable order. | |
| 463 | |
| 464 **** Reports on where mail messages end up can be generated. | |
| 465 | |
| 466 `M-x nnmail-split-history' | |
| 467 | |
| 468 **** More hooks and functions have been added to remove junk | |
| 469 from incoming mail before saving the mail. | |
| 470 | |
| 471 See `nnmail-prepare-incoming-header-hook'. | |
| 472 | |
| 473 **** The nnml mail backend now understands compressed article files. | |
| 474 *** w3 3.0.71 (Bill Perry) | |
| 475 - Major upgrade to Emacs/W3, including | |
| 476 - Much fuller stylesheet support | |
| 477 - Tables support | |
| 478 - Frames support | |
| 479 - better asynchronous downloads | |
| 480 - now uses the widget library for consistent look of form elements | |
| 481 - Much much much faster | |
| 482 *** ilisp 5.8 (Chris McConnell, Ivan Vasquez, Marco Antoniotti, Rick | |
| 483 Campbell) | |
| 484 *** VM 6.22 (Kyle Jones) | |
| 485 *** etags 11.78 (Francesco Potorti`) | |
| 486 *** ksh-mode.el 2.9 | |
| 487 *** vhdl-mode.el 2.73 (Rod Whitby) | |
| 488 *** id-select.el 1.4.5 (Bob Weiner) | |
| 489 *** EDT/TPU emulation modes should work now for the first time. | |
| 490 *** viper 2.93 (Michael Kifer) is now the `official' vi emulator for XEmacs. | |
| 491 *** big-menubar should work much better now. | |
| 492 *** mode-motion+.el 3.16 | |
| 493 *** backup-dir 2.0 (Greg Klanderman) | |
| 494 *** ps-print.el-3.05 (Jacques Duthen Prestataire) | |
| 495 *** lazy-lock-1.16 (Simon Marshall) | |
| 496 *** fast-lock.el 3.10.2 (Simon Marshall) | |
| 497 *** reporter 3.3 (Barry Warsaw) | |
| 498 *** hm--html-menus 5.4 (Heiko Muenkel) | |
| 499 *** cc-mode 4.387 (Barry Warsaw) | |
| 500 *** elp 2.37 (Barry Warsaw) | |
| 501 *** itimer.el-1.05 (Kyle Jones) | |
| 502 *** floating-toolbar.el-1.02 (Kyle Jones) | |
| 503 *** balloon-help.el-1.05 (Kyle Jones) | |
| 504 *** hyperbole-4.023 (Bob Weiner) | |
| 505 *** cperl-mode-1.31+ | |
| 506 *** OO-Browser 2.10 (Bob Weiner) | |
| 507 | |
| 508 ** Changes at Lisp level | |
| 509 ------------ | |
| 510 | |
| 511 -- New `widget' library for inserting UI components in buffers. | |
| 512 Documented in <URL:info:widget>. | |
| 513 | |
| 514 -- New `custom' library for declaring user options and faces. | |
| 515 Documented in <URL:info:custom>. | |
| 516 | |
| 517 -- New function `make-empty-face'. | |
| 518 Like `make-face', but doesn't query the resource database. | |
| 519 | |
| 520 -- New function x-keysym-on-keyboard-p helps determine keyboard | |
| 521 characteristics for key rebinding: | |
| 522 | |
| 523 x-keysym-on-keyboard-p: (KEYSYM &optional DEVICE) | |
| 524 -- a built-in function. | |
| 525 Return true if KEYSYM names a key on the keyboard of DEVICE. | |
| 526 More precisely, return true if pressing a physical key | |
| 527 on the keyboard of DEVICE without any modifier keys generates KEYSYM. | |
| 528 Valid keysyms are listed in the files /usr/include/X11/keysymdef.h and in | |
| 529 /usr/lib/X11/XKeysymDB, or whatever the equivalents are on your system. | |
| 530 | |
| 531 -- Usage of keysyms of the form kp_0 is deprecated and one should use | |
| 532 the Emacs compatible kp-0 instead. | |
| 533 | |
| 534 | |
| 535 -- preceding-char and following-char have been obsoleted. Use the | |
| 536 much safer and correct functions char-after and char-before instead. | |
| 537 | |
| 538 -- Many symbols present for compatibility with GNU Emacs no longer | |
| 539 generate bytecompiler warning messages | |
| 540 | |
| 541 -- Installed info files are now compressed (support courtesy of Joseph J Nuspl) | |
| 542 | |
| 543 -- (load-average) works on Solaris, even if you're not root. Thanks to | |
| 544 Hrvoje Niksic. | |
| 545 | |
| 546 -- OffiX drag-and-drop support added | |
| 547 | |
| 548 -- lots of syncing with 19.34 elisp files, most by Steven Baur | |
| 549 | |
| 550 -- M-: (eval-expression) is now enabled by default since it is much | |
| 551 more difficult to type. | |
| 552 | |
| 553 -- new variables: | |
| 554 signal-error-on-buffer-boundary | |
| 555 | |
| 556 | |
| 557 * Future Plans for XEmacs | |
| 558 ========================== | |
| 559 | |
| 560 This is the end of the line for XEmacs v19. No new development is planned | |
| 561 on this source tree. XEmacs 20.1 will contain the functionality in 19.15, | |
| 562 and development will continue with XEmacs 20.2. The major new `feature' | |
| 563 planned in 20.2 will be the introduction of separable packages and the | |
| 564 capability to download and use an XEmacs lite distribution. | |
| 565 | |
| 566 * The History of XEmacs | |
| 567 ======================= | |
| 568 | |
| 569 This product is an extension of GNU Emacs, previously known to some as | |
| 570 "Lucid Emacs" or "ERA". It was initially based on an early version of Emacs | |
| 571 Version 19 from the Free Software Foundation and has since been kept | |
| 572 up-to-date with recent versions of that product. It stems from a | |
| 573 collaboration of Lucid, Inc. with SunSoft DevPro (a division of Sun | |
| 574 Microsystems, Inc.; formerly called SunPro) and the University of Illinois. | |
| 575 | |
| 576 NOTE: Lucid, Inc. is currently out of business but development on XEmacs | |
| 577 continues strong. Recently, Amdahl Corporation and INS Engineering have | |
| 578 both contributed significantly to the development of XEmacs. | |
| 579 | |
| 580 | |
| 581 * A Long List of Packages | |
| 582 ======================= | |
| 583 | |
| 584 This section gives a detailed list of packages included with XEmacs. | |
| 585 It's long! Of particular interest are: games, gnus, modes, packages, | |
| 586 and utils. | |
| 587 | |
| 588 ** auctex - Super TeX | |
| 589 *** auctex/auc-old.el | |
| 590 This file contains an alternative keymapping, compatible with | |
| 591 older versions of AUC TeX. You are strongly suggested to try the | |
| 592 new keyboard layout, as we would like this file to go away | |
| 593 eventually. | |
| 594 *** auctex/bib-cite.el | |
| 595 Commentary: | |
| 596 | |
| 597 This package is used in various TeX modes to display or edit references | |
| 598 associated with \cite commands, or matching \ref and \label commands. | |
| 599 *** auctex/font-latex.el | |
| 600 Commentary: | |
| 601 *** auctex/style/german.el | |
| 602 Commentary: | |
| 603 | |
| 604 `german.sty' use `"' to give next character an umlaut. | |
| 605 *** auctex/style/harvard.el | |
| 606 Commentary: | |
| 607 | |
| 608 Harvard citation style is from Peter Williams available on the CTAN | |
| 609 servers | |
| 610 *** auctex/style/plfonts.el | |
| 611 Commentary: | |
| 612 | |
| 613 `plfonts.sty' use `"' to make next character Polish. | |
| 614 `plfonts.sty' <C> L. Holenderski, IIUW, lhol@mimuw.edu.pl | |
| 615 *** auctex/style/plhb.el | |
| 616 Commentary: | |
| 617 | |
| 618 `plhb.sty' use `"' to make next character Polish. | |
| 619 `plhb.sty' <C> J. S. Bie\'n, IIUW, jsbien@mimuw.edu.pl | |
| 620 | |
| 621 | |
| 622 ** bytecomp - Byte compile Emacs Lisp files | |
| 623 *** bytecomp/byte-optimize.el | |
| 624 Commentary: | |
| 625 | |
| 626 ======================================================================== | |
| 627 "No matter how hard you try, you can't make a racehorse out of a pig. | |
| 628 You can, however, make a faster pig." | |
| 629 | |
| 630 Or, to put it another way, the emacs byte compiler is a VW Bug. This code | |
| 631 makes it be a VW Bug with fuel injection and a turbocharger... You're | |
| 632 still not going to make it go faster than 70 mph, but it might be easier | |
| 633 to get it there. | |
| 634 | |
| 635 *** bytecomp/bytecomp-runtime.el | |
| 636 Commentary: | |
| 637 | |
| 638 interface to selectively inlining functions. | |
| 639 This only happens when source-code optimization is turned on. | |
| 640 *** bytecomp/bytecomp.el | |
| 641 Commentary: | |
| 642 | |
| 643 The Emacs Lisp byte compiler. This crunches lisp source into a sort | |
| 644 of p-code which takes up less space and can be interpreted faster. | |
| 645 The user entry points are byte-compile-file and byte-recompile-directory. | |
| 646 *** bytecomp/disass.el | |
| 647 Commentary: | |
| 648 | |
| 649 The single entry point, `disassemble', disassembles a code object generated | |
| 650 by the Emacs Lisp byte-compiler. This doesn't invert the compilation | |
| 651 operation, not by a long shot, but it's useful for debugging. | |
| 652 | |
| 653 ** calendar - Calendars, diaries and appointments | |
| 654 *** calendar/calendar.el | |
| 655 Commentary: | |
| 656 | |
| 657 This collection of functions implements a calendar window. It | |
| 658 generates a calendar for the current month, together with the previous | |
| 659 and coming months, or for any other three-month period. The calendar | |
| 660 can be scrolled forward and backward in the window to show months in | |
| 661 the past or future; the cursor can move forward and backward by days, | |
| 662 weeks, or months, making it possible, for instance, to jump to the | |
| 663 date a specified number of days, weeks, or months from the date under | |
| 664 the cursor. The user can display a list of holidays and other notable | |
| 665 days for the period shown; the notable days can be marked on the | |
| 666 calendar, if desired. The user can also specify that dates having | |
| 667 corresponding diary entries (in a file that the user specifies) be | |
| 668 marked; the diary entries for any date can be viewed in a separate | |
| 669 window. The diary and the notable days can be viewed independently of | |
| 670 the calendar. Dates can be translated from the (usual) Gregorian | |
| 671 calendar to the day of the year/days remaining in year, to the ISO | |
| 672 commercial calendar, to the Julian (old style) calendar, to the Hebrew | |
| 673 calendar, to the Islamic calendar, to the French Revolutionary calendar, | |
| 674 to the Mayan calendar, and to the astronomical (Julian) day number. | |
| 675 When floating point is available, times of sunrise/sunset can be displayed, | |
| 676 as can the phases of the moon. Appointment notification for diary entries | |
| 677 is available. | |
| 678 *** calendar/cal-dst.el | |
| 679 Commentary: | |
| 680 | |
| 681 This collection of functions implements the features of calendar.el and | |
| 682 holiday.el that deal with daylight savings time. | |
| 683 *** calendar/cal-french.el | |
| 684 Commentary: | |
| 685 | |
| 686 This collection of functions implements the features of calendar.el and | |
| 687 diary.el that deal with the French Revolutionary calendar. | |
| 688 *** calendar/cal-mayan.el | |
| 689 Commentary: | |
| 690 | |
| 691 This collection of functions implements the features of calendar.el and | |
| 692 diary.el that deal with the Mayan calendar. It was written jointly by | |
| 693 *** calendar/cal-x.el | |
| 694 Commentary: | |
| 695 | |
| 696 This collection of functions implements dedicated frames in x-windows for | |
| 697 calendar.el. | |
| 698 *** calendar/cal-xemacs.el | |
| 699 Commentary: | |
| 700 | |
| 701 This collection of functions implements menu bar and popup menu support for | |
| 702 calendar.el. | |
| 703 *** calendar/diary-ins.el | |
| 704 Commentary: | |
| 705 | |
| 706 This collection of functions implements the diary insertion features as | |
| 707 described in calendar.el. | |
| 708 *** calendar/solar.el | |
| 709 Commentary: | |
| 710 | |
| 711 This collection of functions implements the features of calendar.el, | |
| 712 diary.el, and holiday.el that deal with times of day, sunrise/sunset, and | |
| 713 eqinoxes/solstices. | |
| 714 | |
| 715 ** cl - Common Lisp compatibility with Emacs Lisp | |
| 716 *** cl/cl-compat.el | |
| 717 Commentary: | |
| 718 | |
| 719 These are extensions to Emacs Lisp that provide a degree of | |
| 720 Common Lisp compatibility, beyond what is already built-in | |
| 721 in Emacs Lisp. | |
| 722 | |
| 723 ** comint - For running shells, telnet, rsh, gdb, dbx under Emacs | |
| 724 *** comint/comint-xemacs.el | |
| 725 Commentary: | |
| 726 | |
| 727 Declare customizable faces for comint outside the main code so it can | |
| 728 be dumped with XEmacs. | |
| 729 *** comint/comint.el | |
| 730 Commentary: | |
| 731 | |
| 732 This file defines a general command-interpreter-in-a-buffer package | |
| 733 (comint mode). The idea is that you can build specific process-in-a-buffer | |
| 734 modes on top of comint mode -- e.g., lisp, shell, scheme, T, soar, .... | |
| 735 This way, all these specific packages share a common base functionality, | |
| 736 and a common set of bindings, which makes them easier to use (and | |
| 737 saves code, implementation time, etc., etc.). | |
| 738 | |
| 739 Several packages are already defined using comint mode: | |
| 740 - shell.el defines a shell-in-a-buffer mode. | |
| 741 - cmulisp.el defines a simple lisp-in-a-buffer mode. | |
| 742 | |
| 743 - The file cmuscheme.el defines a scheme-in-a-buffer mode. | |
| 744 - The file tea.el tunes scheme and inferior-scheme modes for T. | |
| 745 - The file soar.el tunes lisp and inferior-lisp modes for Soar. | |
| 746 - cmutex.el defines tex and latex modes that invoke tex, latex, bibtex, | |
| 747 previewers, and printers from within emacs. | |
| 748 - background.el allows csh-like job control inside emacs. | |
| 749 *** comint/gdb.el | |
| 750 Commentary: | |
| 751 | |
| 752 A facility is provided for the simultaneous display of the source code | |
| 753 in one window, while using gdb to step through a function in the | |
| 754 other. A small arrow in the source window, indicates the current | |
| 755 line. | |
| 756 *** comint/gud.el | |
| 757 Commentary: | |
| 758 *** comint/history.el | |
| 759 Commentary: | |
| 760 | |
| 761 suggested generic history stuff -- tale | |
| 762 | |
| 763 This is intended to provided easy access to a list of elements | |
| 764 being kept as a history ring. | |
| 765 *** comint/inf-lisp.el | |
| 766 Commentary: | |
| 767 | |
| 768 This file defines a a lisp-in-a-buffer package (inferior-lisp | |
| 769 mode) built on top of comint mode. This version is more | |
| 770 featureful, robust, and uniform than the Emacs 18 version. The | |
| 771 key bindings are also more compatible with the bindings of Hemlock | |
| 772 and Zwei (the Lisp Machine emacs). | |
| 773 *** comint/kermit.el | |
| 774 Commentary: | |
| 775 | |
| 776 I'm not sure, but I think somebody asked about running kermit under shell | |
| 777 mode a while ago. Anyway, here is some code that I find useful. The result | |
| 778 is that I can log onto machines with primitive operating systems (VMS and | |
| 779 ATT system V :-), and still have the features of shell-mode available for | |
| 780 command history, etc. It's also handy to be able to run a file transfer in | |
| 781 an emacs window. The transfer is in the "background", but you can also | |
| 782 monitor or stop it easily. | |
| 783 *** comint/rlogin.el | |
| 784 Commentary: | |
| 785 | |
| 786 Support for remote logins using `rlogin'. | |
| 787 This program is layered on top of shell.el; the code here only accounts | |
| 788 for the variations needed to handle a remote process, e.g. directory | |
| 789 tracking and the sending of some special characters. | |
| 790 *** comint/shell.el | |
| 791 Commentary: | |
| 792 | |
| 793 This file defines a a shell-in-a-buffer package (shell mode) built | |
| 794 on top of comint mode. This is actually cmushell with things | |
| 795 renamed to replace its counterpart in Emacs 18. cmushell is more | |
| 796 featureful, robust, and uniform than the Emacs 18 version. | |
| 797 *** comint/telnet.el | |
| 798 Commentary: | |
| 799 | |
| 800 This mode is intended to be used for telnet or rsh to a remode host; | |
| 801 `telnet' and `rsh' are the two entry points. Multiple telnet or rsh | |
| 802 sessions are supported. | |
| 803 | |
| 804 ** custom - Allow's user to customize Emacs | |
| 805 *** custom/custom.el | |
| 806 Commentary: | |
| 807 | |
| 808 This file only contain the code needed to declare and initialize | |
| 809 user options. The code to customize options is autoloaded from | |
| 810 `cus-edit.el'. | |
| 811 | |
| 812 The code implementing face declarations is in `cus-face.el' | |
| 813 | |
| 814 ** edebug - Emacs Lisp debugger | |
| 815 *** edebug/cl-read.el | |
| 816 Commentary: | |
| 817 | |
| 818 Please send bugs and comments to the author. | |
| 819 | |
| 820 This package replaces the standard Emacs Lisp reader (implemented | |
| 821 as a set of built-in Lisp function in C) by a flexible and | |
| 822 customizable Common Lisp like one (implemented entirely in Emacs | |
| 823 Lisp). During reading of Emacs Lisp source files, it is about 40% | |
| 824 slower than the built-in reader, but there is no difference in | |
| 442 | 825 loading byte compiled files - they don't contain any syntactic sugar |
| 428 | 826 and are loaded with the built in subroutine `load'. |
| 827 | |
| 828 ** ediff - Compare and merge files with graphical difference display | |
| 829 *** ediff/ediff.el | |
| 830 Commentary: | |
| 831 | |
| 832 Never read that diff output again! | |
| 833 Apply patch interactively! | |
| 834 Merge with ease! | |
| 835 | |
| 836 This package provides a convenient way of simultaneous browsing through | |
| 837 the differences between a pair (or a triple) of files or buffers. The | |
| 838 files being compared, file-A, file-B, and file-C (if applicable) are | |
| 839 shown in separate windows (side by side, one above the another, or in | |
| 840 separate frames), and the differences are highlighted as you step | |
| 841 through them. You can also copy difference regions from one buffer to | |
| 842 another (and recover old differences if you change your mind). | |
| 843 | |
| 844 Ediff also supports merging operations on files and buffers, including | |
| 845 merging using ancestor versions. Both comparison and merging operations can | |
| 846 be performed on directories, i.e., by pairwise comparison of files in those | |
| 847 directories. | |
| 848 | |
| 849 ** efs - Remote file access (replaces ange-ftp) | |
| 850 See online manual. | |
| 851 | |
| 852 ** electric - The "electric" commands; these implement temporary | |
| 853 windows for help, list-buffers, etc. | |
| 854 | |
| 855 *** electric/ehelp.el | |
| 856 Commentary: | |
| 857 | |
| 858 This package provides a pre-packaged `Electric Help Mode' for | |
| 859 browsing on-line help screens. There is one entry point, | |
| 860 `with-electric-help'; all you have to give it is a no-argument | |
| 861 function that generates the actual text of the help into the current | |
| 862 buffer. | |
| 863 | |
| 864 ** emulators - Various emulations: mocklisp, teco, TPU/EDT, WordStar | |
| 865 *** emulators/mlconvert.el | |
| 866 Commentary: | |
| 867 | |
| 868 This package converts Mocklisp code written under a Gosling or UniPress | |
| 869 Emacs for use with GNU Emacs. The translated code will require runtime | |
| 870 support from the mlsupport.el equivalent. | |
| 871 *** emulators/mlsupport.el | |
| 872 Commentary: | |
| 873 | |
| 874 This package provides equivalents of certain primitives from Gosling | |
| 875 Emacs (including the commercial UniPress versions). These have an | |
| 876 ml- prefix to distinguish them from native GNU Emacs functions with | |
| 877 similar names. The package mlconvert.el translates Mocklisp code | |
| 878 to use these names. | |
| 879 *** emulators/teco.el | |
| 880 Commentary: | |
| 881 | |
| 882 This code has been tested some, but no doubt contains a zillion bugs. | |
| 883 You have been warned. | |
| 884 | |
| 885 Written by Dale R. Worley based on a C implementation by Matt Fichtenbaum. | |
| 886 Please send comments, bug fixes, enhancements, etc. to drw@math.mit.edu. | |
| 887 *** emulators/tpu-edt.el | |
| 888 Commentary: | |
| 889 | |
| 890 %% TPU-edt -- Emacs emulating TPU emulating EDT | |
| 891 | |
| 892 %% Introduction | |
| 893 | |
| 894 TPU-edt emulates the popular DEC VMS editor EDT (actually, it emulates | |
| 895 DEC TPU's EDT emulation, hence the name TPU-edt). | |
| 896 *** emulators/tpu-extras.el | |
| 897 Commentary: | |
| 898 | |
| 899 Use the functions defined here to customize TPU-edt to your tastes by | |
| 900 setting scroll margins and/or turning on free cursor mode. Here's an | |
| 901 example for your .emacs file. | |
| 902 *** emulators/ws-mode.el | |
| 903 Commentary: | |
| 904 | |
| 905 This emulates WordStar, with a major mode. | |
| 906 | |
| 907 ** energize - Interface to now-defunct Lucid's C/C++ integrated | |
| 908 environment XEmacs (nee Lucid Emacs) saw birth explicitly to serve | |
| 909 Energize. | |
| 910 | |
| 911 ** eos - SPARCworks | |
| 912 | |
| 913 ** eterm - Full terminal emulation under Emacs | |
| 914 *** eterm/term.el | |
| 915 Commentary: | |
| 916 | |
| 917 This file defines a general command-interpreter-in-a-buffer package | |
| 918 (term mode). The idea is that you can build specific process-in-a-buffer | |
| 919 modes on top of term mode -- e.g., lisp, shell, scheme, T, soar, .... | |
| 920 This way, all these specific packages share a common base functionality, | |
| 921 and a common set of bindings, which makes them easier to use (and | |
| 922 saves code, implementation time, etc., etc.). | |
| 923 *** eterm/tgud.el | |
| 924 Commentary: | |
| 925 | |
| 926 The ancestral gdb.el was by W. Schelter <wfs@rascal.ics.utexas.edu> | |
| 927 It was later rewritten by rms. Some ideas were due to Masanobu. | |
| 928 Grand Unification (sdb/dbx support) by Eric S. Raymond <esr@thyrsus.com> | |
| 929 The overloading code was then rewritten by Barry Warsaw <bwarsaw@cen.com>, | |
| 930 who also hacked the mode to use comint.el. Shane Hartman <shane@spr.com> | |
| 931 added support for xdb (HPUX debugger). Rick Sladkey <jrs@world.std.com> | |
| 932 wrote the GDB command completion code. Dave Love <d.love@dl.ac.uk> | |
| 933 added the IRIX kluge and re-implemented the Mips-ish variant. | |
| 934 Then hacked by Per Bothner <bothner@cygnus.com> to use term.el. | |
| 935 *** eterm/tshell.el | |
| 936 Commentary: | |
| 937 | |
| 938 This file defines a a shell-in-a-buffer package (shell mode) built | |
| 939 on top of term mode. This is actually cmushell with things | |
| 940 renamed to replace its counterpart in Emacs 18. cmushell is more | |
| 941 featureful, robust, and uniform than the Emacs 18 version. | |
| 942 | |
| 943 ** games - blackbox, mines, decipher, doctor, ... | |
| 944 *** games/blackbox.el | |
| 945 Commentary: | |
| 946 | |
| 947 The object of the game is to find four hidden balls by shooting rays | |
| 948 into the black box. There are four possibilities: 1) the ray will | |
| 949 pass thru the box undisturbed, 2) it will hit a ball and be absorbed, | |
| 950 3) it will be deflected and exit the box, or 4) be deflected immediately, | |
| 951 not even being allowed entry into the box. | |
| 952 *** games/conx.el | |
| 953 Commentary: | |
| 954 | |
| 955 conx.el: Yet Another Dissociator. | |
| 956 | |
| 957 Select a buffer with a lot of text in it. Say M-x conx-buffer | |
| 958 or M-x conx-region. Repeat on as many other bodies of text as | |
| 959 you like. | |
| 960 | |
| 961 M-x conx will use the word-frequency tree the above generated | |
| 962 to produce random sentences in a popped-up buffer. It will pause | |
| 963 at the end of each paragraph for two seconds; type ^G to stop it. | |
| 964 *** games/cookie1.el | |
| 965 Commentary: | |
| 966 | |
| 967 Support for random cookie fetches from phrase files, used for such | |
| 968 critical applications as emulating Zippy the Pinhead and confounding | |
| 969 the NSA Trunk Trawler. | |
| 970 *** games/decipher.el | |
| 971 Commentary: | |
| 972 | |
| 973 This package is designed to help you crack simple substitution | |
| 974 ciphers where one letter stands for another. It works for ciphers | |
| 975 with or without word divisions. (You must set the variable | |
| 976 decipher-ignore-spaces for ciphers without word divisions.) | |
| 977 *** games/dissociate.el | |
| 978 Commentary: | |
| 979 | |
| 980 The single entry point, `dissociated-press', applies a travesty | |
| 981 generator to the current buffer. The results can be quite amusing. | |
| 982 *** games/doctor.el | |
| 983 Commentary: | |
| 984 | |
| 985 The single entry point `doctor', simulates a Rogerian analyst using | |
| 986 phrase-production techniques similar to the classic ELIZA demonstration | |
| 987 of pseudo-AI. | |
| 988 *** games/flame.el | |
| 989 Commentary: | |
| 990 | |
| 991 "Flame" program. This has a chequered past. | |
| 992 *** games/gomoku.el | |
| 993 Gomoku is a game played between two players on a rectangular board. Each | |
| 994 player, in turn, marks a free square of its choice. The winner is the first | |
| 995 one to mark five contiguous squares in any direction (horizontally, | |
| 996 vertically or diagonally). | |
| 997 | |
| 998 *** games/hanoi.el | |
| 999 Commentary: | |
| 1000 | |
| 1001 Solves the Towers of Hanoi puzzle while-U-wait. | |
| 1002 | |
| 1003 The puzzle: Start with N rings, decreasing in sizes from bottom to | |
| 1004 top, stacked around a post. There are two other posts. Your mission, | |
| 1005 should you choose to accept it, is to shift the pile, stacked in its | |
| 1006 original order, to another post. | |
| 1007 *** games/life.el | |
| 1008 Commentary: | |
| 1009 | |
| 1010 A demonstrator for John Horton Conway's "Life" cellular automaton | |
| 1011 in Emacs Lisp. Picks a random one of a set of interesting Life | |
| 1012 patterns and evolves it according to the familiar rules. | |
| 1013 *** games/mine.el | |
| 1014 Commentary: | |
| 1015 | |
| 1016 The object of this classical game is to locate the hidden mines. | |
| 1017 To do this, you hit the squares on the game board that do not | |
| 1018 contain mines, and you mark the squares that do contain mines. | |
| 1019 *** games/mpuz.el | |
| 1020 Commentary: | |
| 1021 | |
| 1022 When this package is loaded, `M-x mpuz' generates a random multiplication | |
| 1023 puzzle. This is a multiplication example in which each digit has been | |
| 1024 consistently replaced with some letter. Your job is to reconstruct | |
| 1025 the original digits. Type `?' while the mode is active for detailed help. | |
| 1026 *** games/spook.el | |
| 1027 Commentary: | |
| 1028 | |
| 1029 Just before sending mail, do M-x spook. | |
| 1030 A number of phrases will be inserted into your buffer, to help | |
| 1031 give your message that extra bit of attractiveness for automated | |
| 1032 keyword scanners. | |
| 1033 *** games/studly.el | |
| 1034 Commentary: | |
| 1035 | |
| 1036 Functions to studlycapsify a region, word, or buffer. Possibly the | |
| 1037 esoteric significance of studlycapsification escapes you; that is, | |
| 1038 you suffer from autostudlycapsifibogotification. Too bad. | |
| 1039 *** games/yow.el | |
| 1040 Commentary: | |
| 1041 | |
| 1042 Important pinheadery for GNU Emacs. | |
| 1043 | |
| 1044 See cookie1.el for implementation. Note --- the `n' argument of yow | |
| 1045 from the 18.xx implementation is no longer; we only support *random* | |
| 1046 random access now. | |
| 1047 | |
| 1048 ** gnus - The ultimate News and Mail reader | |
| 1049 See online manual | |
| 1050 *** gnus/gnus-audio.el | |
| 1051 Commentary: | |
| 1052 This file provides access to sound effects in Gnus. | |
| 1053 Prerelease: This file is partially stripped to support earcons.el | |
| 1054 You can safely ignore most of it until Red Gnus. **Evil Laugh** | |
| 1055 *** gnus/gnus-gl.el | |
| 1056 Commentary: | |
| 1057 *** gnus/gnus-undo.el | |
| 1058 Commentary: | |
| 1059 | |
| 1060 This package allows arbitrary undoing in Gnus buffers. As all the | |
| 1061 Gnus buffers aren't very text-oriented (what is in the buffers is | |
| 1062 just some random representation of the actual data), normal Emacs | |
| 1063 undoing doesn't work at all for Gnus. | |
| 1064 *** gnus/mailheader.el | |
| 1065 Commentary: | |
| 1066 | |
| 1067 This package provides an abstraction to RFC822-style messages, used in | |
| 1068 mail news, and some other systems. The simple syntactic rules for such | |
| 1069 headers, such as quoting and line folding, are routinely reimplemented | |
| 1070 in many individual packages. This package removes the need for this | |
| 1071 redundancy by representing message headers as association lists, | |
| 1072 offering functions to extract the set of headers from a message, to | |
| 1073 parse individual headers, to merge sets of headers, and to format a set | |
| 1074 of headers. | |
| 1075 *** gnus/message.el | |
| 1076 Commentary: | |
| 1077 | |
| 1078 This mode provides mail-sending facilities from within Emacs. It | |
| 1079 consists mainly of large chunks of code from the sendmail.el, | |
| 1080 gnus-msg.el and rnewspost.el files. | |
| 1081 *** gnus/nnheader.el | |
| 1082 Commentary: | |
| 1083 | |
| 1084 These macros may look very much like the ones in GNUS 4.1. They | |
| 1085 are, in a way, but you should note that the indices they use have | |
| 1086 been changed from the internal GNUS format to the NOV format. The | |
| 1087 makes it possible to read headers from XOVER much faster. | |
| 1088 | |
| 1089 ** hm--html-menus - Menus and popups for writing/viewing html documents | |
| 1090 | |
| 1091 ** hyperbole - Personal database | |
| 1092 | |
| 1093 ** ilisp - A comint-based package for interacting with inferior | |
| 1094 lisp processes. | |
| 1095 | |
| 1096 | |
| 1097 ** iso - Implement various ISO character standards | |
| 1098 *** iso/iso-acc.el | |
| 1099 Commentary: | |
| 1100 | |
| 1101 Function `iso-accents-mode' activates a minor mode in which | |
| 1102 typewriter "dead keys" are emulated. The purpose of this emulation | |
| 1103 is to provide a simple means for inserting accented characters | |
| 1104 according to the ISO-8859-1 character set. | |
| 1105 *** iso/iso-ascii.el | |
| 1106 Commentary: | |
| 1107 | |
| 1108 This code sets up to display ISO 8859/1 characters on plain | |
| 1109 ASCII terminals. The display strings for the characters are | |
| 1110 more-or-less based on TeX. | |
| 1111 *** iso/iso-cvt.el | |
| 1112 Commentary: | |
| 1113 | |
| 1114 This lisp code serves two purposes, both of which involve | |
| 1115 the translation of various conventions for representing European | |
| 1116 character sets to ISO 8859-1. | |
| 1117 | |
| 1118 ** mailcrypt - Encrypting/decrypting of mail messages | |
| 1119 | |
| 1120 ** mel - MIME encoding library (see also TM) | |
| 1121 | |
| 1122 ** mh-e - Emacs interface to MH mail reader | |
| 1123 *** mh-e/mh-e.el | |
| 1124 Commentary: | |
| 1125 | |
| 1126 mh-e is an Emacs interface to the MH mail system. | |
| 1127 | |
| 1128 ** modes - How to edit files: Ada, asm, awk, bib, cperl, eiffel, ... | |
| 1129 *** modes/arc-mode.el | |
| 1130 Commentary: | |
| 1131 | |
| 1132 NAMING: "arc" is short for "archive" and does not refer specifically | |
| 1133 to files whose name end in ".arc" | |
| 1134 | |
| 1135 ARCHIVE TYPES: Currently only the archives below are handled, but the | |
| 1136 structure for handling just about anything is in place. | |
| 1137 | |
| 1138 Arc Lzh Zip Zoo | |
| 1139 -------------------------------- | |
| 1140 View listing Intern Intern Intern Intern | |
| 1141 Extract member Y Y Y Y | |
| 1142 Save changed member Y Y Y Y | |
| 1143 Add new member N N N N | |
| 1144 Delete member Y Y Y Y | |
| 1145 Rename member Y Y N N | |
| 1146 Chmod - Y Y - | |
| 1147 Chown - Y - - | |
| 1148 Chgrp - Y - - | |
| 1149 *** modes/asm-mode.el | |
| 1150 Commentary: | |
| 1151 | |
| 1152 This minor mode is based on text mode. It defines a private abbrev table | |
| 1153 that can be used to save abbrevs for assembler mnemonics. | |
| 1154 *** modes/auto-show.el | |
| 1155 Commentary: | |
| 1156 | |
| 1157 This file provides functions that | |
| 1158 automatically scroll the window horizontally when the point moves | |
| 1159 off the left or right side of the window. | |
| 1160 *** modes/awk-mode.el | |
| 1161 Commentary: | |
| 1162 | |
| 1163 Sets up C-mode with support for awk-style #-comments and a lightly | |
| 1164 hacked syntax table. | |
| 1165 *** modes/bib-mode.el | |
| 1166 Commentary: | |
| 1167 | |
| 1168 GNU Emacs code to help maintain databases compatible with (troff) | |
| 1169 refer and lookbib. The file bib-file should be set to your | |
| 1170 bibliography file. Keys are automagically inserted as you type, | |
| 1171 and appropriate keys are presented for various kinds of entries. | |
| 1172 *** modes/bibtex.el | |
| 1173 *** modes/cc-compat.el | |
| 1174 Commentary: | |
| 1175 | |
| 1176 Boring old c-mode.el (BOCM) is confusion and brain melt. cc-mode.el | |
| 1177 is clarity of thought and purity of chi. If you are still unwilling | |
| 1178 to accept enlightenment, this might help, or it may prolong your | |
| 1179 agony. | |
| 1180 *** modes/cc-guess.el | |
| 1181 Commentary: | |
| 1182 | |
| 1183 This file contains routines that help guess the cc-mode style in a | |
| 1184 particular region of C, C++, or Objective-C code. It is provided | |
| 1185 for example and experimentation only. It is not supported in | |
| 1186 anyway. Some folks have asked for a style guesser and the best way | |
| 1187 to show my thoughts on the subject is with this sample code. Feel | |
| 1188 free to improve upon it in anyway you'd like. Please send me the | |
| 1189 results. Note that style guessing is lossy! | |
| 1190 *** modes/cc-lobotomy.el | |
| 1191 Commentary: | |
| 1192 | |
| 1193 Every effort has been made to improve the performance of | |
| 1194 cc-mode. However, due to the nature of the C, C++, and Objective-C | |
| 1195 language definitions, a trade-off is often required between | |
| 1196 accuracy of construct recognition and speed. I believe it is always | |
| 1197 best to be correct, and that the mode is currently fast enough for | |
| 1198 most normal usage. Others disagree. I have no intention of | |
| 1199 including these hacks in the main distribution. When cc-mode | |
| 1200 version 5 comes out, it will include a rewritten indentation engine | |
| 1201 so that performance will be greatly improved automatically. This | |
| 1202 was not included in this release of version 4 so that Emacs 18 | |
| 1203 could still be supported. Note that this implies that cc-mode | |
| 1204 version 5 will *not* work on Emacs 18! | |
| 1205 *** modes/cc-mode.el | |
| 1206 Commentary: | |
| 1207 | |
| 1208 This package provides modes in GNU Emacs for editing C, C++, | |
| 1209 Objective-C, and Java code. It is intended to be a replacement for | |
| 1210 c-mode.el (a.k.a. BOCM -- Boring Old C-Mode), c++-mode.el, | |
| 1211 cplus-md.el, and cplus-md1.el, all of which are in some way | |
| 1212 ancestors of this file. A number of important improvements have | |
| 1213 been made, briefly: complete K&R C, ANSI C, `ARM' C++, Objective-C, | |
| 1214 and Java support with consistent indentation across all modes, more | |
| 1215 intuitive indentation controlling variables, compatibility across | |
| 1216 all known Emacsen, nice new features, and tons of bug fixes. This | |
| 1217 package is called "CC Mode" to distinguish it from its ancestors, | |
| 1218 but there is no cc-mode command. Usage and programming details are | |
| 1219 contained in an accompanying texinfo manual. | |
| 1220 *** modes/cl-indent.el | |
| 1221 Commentary: | |
| 1222 | |
| 1223 This package supplies a single entry point, common-lisp-indent-function, | |
| 1224 which performs indentation in the preferred style for Common Lisp code. | |
| 1225 *** modes/cperl-mode.el Can't find any Commentary section | |
| 1226 *** modes/eiffel3.el Can't find any Commentary section | |
| 1227 *** modes/enriched.el Can't find any Commentary section | |
| 1228 *** modes/executable.el | |
| 1229 Commentary: | |
| 1230 | |
| 1231 executable.el is used by certain major modes to insert a suitable | |
| 1232 #! line at the beginning of the file, if the file does not already | |
| 1233 have one. | |
| 1234 | |
| 1235 *** modes/f90.el | |
| 1236 Commentary: | |
| 1237 | |
| 1238 Smart mode for editing F90 programs in FREE FORMAT. | |
| 1239 Knows about continuation lines, named structured statements, and other | |
| 1240 new features in F90 including HPF (High Performance Fortran) structures. | |
| 1241 The basic feature is to provide an accurate indentation of F90 programs. | |
| 1242 In addition, there are many more features like automatic matching of all | |
| 1243 end statements, an auto-fill function to break long lines, a join-lines | |
| 1244 function which joins continued lines etc etc. | |
| 1245 To facilitate typing, a fairly complete list of abbreviations is provided. | |
| 1246 For example, `i is short-hand for integer (if abbrev-mode is on). | |
| 1247 | |
| 1248 *** modes/follow.el | |
| 1249 Commentary: | |
| 1250 | |
| 1251 `Follow mode' is a minor mode for Emacs 19 and XEmacs which | |
| 1252 combines windows into one tall virtual window. | |
| 1253 | |
| 1254 The feeling of a "virtual window" has been accomplished by the use | |
| 1255 of two major techniques: | |
| 1256 | |
| 1257 * The windows always displays adjacent sections of the buffer. | |
| 1258 This means that whenever one window is moved, all the | |
| 1259 others will follow. (Hence the name Follow Mode.) | |
| 1260 | |
| 1261 * Should the point (cursor) end up outside a window, another | |
| 1262 window displaying that point is selected, if possible. This | |
| 1263 makes it possible to walk between windows using normal cursor | |
| 1264 movement commands. | |
| 1265 *** modes/fortran.el | |
| 1266 Commentary: | |
| 1267 | |
| 1268 Fortran mode has been upgraded and is now maintained by Stephen A. Wood | |
| 1269 (saw@cebaf.gov). It now will use either fixed format continuation line | |
| 1270 markers (character in 6th column), or tab format continuation line style | |
| 1271 (digit after a TAB character.) A auto-fill mode has been added to | |
| 1272 automatically wrap fortran lines that get too long. | |
| 1273 | |
| 1274 We acknowledge many contributions and valuable suggestions by | |
| 1275 Lawrence R. Dodd, Ralf Fassel, Ralph Finch, Stephen Gildea, | |
| 1276 Dr. Anil Gokhale, Ulrich Mueller, Mark Neale, Eric Prestemon, | |
| 1277 Gary Sabot and Richard Stallman. | |
| 1278 *** modes/hideif.el | |
| 1279 Commentary: | |
| 1280 | |
| 1281 Hide-ifdef suppresses the display of code that the preprocessor wouldn't | |
| 1282 pass through. The support of constant expressions in #if lines is | |
| 1283 limited to identifiers, parens, and the operators: &&, ||, !, and | |
| 1284 "defined". Please extend this. | |
| 1285 *** modes/hideshow.el | |
| 1286 Commentary: | |
| 1287 | |
| 1288 This file provides `hs-minor-mode'. When active, six commands: | |
| 1289 hs-{hide,show}-{all,block}, hs-show-region and hs-minor-mode | |
| 1290 are available. They implement block hiding and showing. Blocks are | |
| 1291 defined in mode-specific way. In c-mode or c++-mode, they are simply | |
| 1292 curly braces, while in lisp-ish modes they are parens. Multi-line | |
| 1293 comments (c-mode) can also be hidden. The command M-x hs-minor-mode | |
| 1294 toggles the minor mode or sets it (similar to outline minor mode). | |
| 1295 See documentation for each command for more info. | |
| 1296 *** modes/icon.el | |
| 1297 Commentary: | |
| 1298 | |
| 1299 A major mode for editing the Icon programming language. | |
| 1300 *** modes/ksh-mode.el | |
| 1301 | |
| 1302 | |
| 1303 Description: | |
| 1304 sh, ksh, and bash script editing commands for emacs. | |
| 1305 | |
| 1306 This major mode assists shell script writers with indentation | |
| 1307 control and control structure construct matching in much the same | |
| 1308 fashion as other programming language modes. Invoke describe-mode | |
| 1309 for more information. | |
| 1310 *** modes/lisp-mnt.el | |
| 1311 Commentary: | |
| 1312 | |
| 1313 This minor mode adds some services to Emacs-Lisp editing mode. | |
| 1314 | |
| 1315 First, it knows about the header conventions for library packages. | |
| 1316 One entry point supports generating synopses from a library directory. | |
| 1317 Another can be used to check for missing headers in library files. | |
| 1318 *** modes/lisp-mode.el | |
| 1319 Commentary: | |
| 1320 | |
| 1321 The base major mode for editing Lisp code (used also for Emacs Lisp). | |
| 1322 This mode is documented in the Emacs manual | |
| 1323 *** modes/m4-mode.el | |
| 1324 Commentary: | |
| 1325 | |
| 1326 A smart editing mode for m4 macro definitions. It seems to have most of the | |
| 1327 syntax right (sexp motion commands work, but function motion commands don't). | |
| 1328 It also sets the font-lock syntax stuff for colorization | |
| 1329 *** modes/mail-abbrevs.el Can't find any Commentary section | |
| 1330 *** modes/make-mode.el | |
| 1331 Commentary: | |
| 1332 | |
| 1333 A major mode for editing makefiles. The mode knows about Makefile | |
| 1334 syntax and defines M-n and M-p to move to next and previous productions. | |
| 1335 *** modes/modula2.el | |
| 1336 Commentary: | |
| 1337 | |
| 1338 A major mode for editing Modula-2 code. It provides convenient abbrevs | |
| 1339 for Modula-2 keywords, knows about the standard layout rules, and supports | |
| 1340 a native compile command. | |
| 1341 *** modes/nroff-mode.el | |
| 1342 Commentary: | |
| 1343 | |
| 1344 This package is a major mode for editing nroff source code. It knows | |
| 1345 about various nroff constructs, ms, mm, and me macros, and will fill | |
| 1346 and indent paragraphs properly in their presence. It also includes | |
| 1347 a command to count text lines (excluding nroff constructs), a command | |
| 1348 to center a line, and movement commands that know how to skip macros. | |
| 1349 *** modes/old-c-mode.el | |
| 1350 Commentary: | |
| 1351 | |
| 1352 A smart editing mode for C code. It knows a lot about C syntax and tries | |
| 1353 to position the cursor according to C layout conventions. You can | |
| 1354 change the details of the layout style with option variables. Load it | |
| 1355 and do M-x describe-mode for details. | |
| 1356 *** modes/outl-mouse.el Can't find any Commentary section | |
| 1357 *** modes/outline.el | |
| 1358 Commentary: | |
| 1359 | |
| 1360 This package is a major mode for editing outline-format documents. | |
| 1361 An outline can be `abstracted' to show headers at any given level, | |
| 1362 with all stuff below hidden. See the Emacs manual for details. | |
| 1363 *** modes/pascal.el | |
| 1364 | |
| 1365 Emacs should enter Pascal mode when you find a Pascal source file. | |
| 1366 When you have entered Pascal mode, you may get more info by pressing | |
| 1367 C-h m. You may also get online help describing various functions by: | |
| 1368 C-h f <Name of function you want described> | |
| 1369 *** modes/perl-mode.el | |
| 1370 *** modes/picture.el | |
| 1371 Commentary: | |
| 1372 | |
| 1373 This code provides the picture-mode commands documented in the Emacs | |
| 1374 manual. The screen is treated as a semi-infinite quarter-plane with | |
| 1375 support for rectangle operations and `etch-a-sketch' character | |
| 1376 insertion in any of eight directions. | |
| 1377 *** modes/postscript.el Can't find any Commentary section | |
| 1378 modes/prolog.el | |
| 1379 Commentary: | |
| 1380 | |
| 1381 This package provides a major mode for editing Prolog. It knows | |
| 1382 about Prolog syntax and comments, and can send regions to an inferior | |
| 1383 Prolog interpreter process. | |
| 1384 *** modes/python-mode.el | |
| 1385 Commentary: | |
| 1386 | |
| 1387 This is a major mode for editing Python programs. It was developed | |
| 1388 by Tim Peters after an original idea by Michael A. Guravage. Tim | |
| 1389 subsequently left the net; in 1995, Barry Warsaw inherited the | |
| 1390 mode and is the current maintainer. | |
| 1391 *** modes/rexx-mode.el Can't find any Commentary section | |
| 1392 *** modes/rsz-minibuf.el | |
| 1393 Commentary: | |
| 1394 | |
| 1395 This package allows the entire contents (or as much as possible) of the | |
| 1396 minibuffer to be visible at once when typing. As the end of a line is | |
| 1397 reached, the minibuffer will resize itself. When the user is done | |
| 1398 typing, the minibuffer will return to its original size. | |
| 1399 *** modes/scheme.el | |
| 1400 Commentary: | |
| 1401 | |
| 1402 Adapted from Lisp mode by Bill Rozas, jinx@prep. | |
| 1403 Initially a query replace of Lisp mode, except for the indentation | |
| 1404 of special forms. Probably the code should be merged at some point | |
| 1405 so that there is sharing between both libraries. | |
| 1406 *** modes/scribe.el Can't find any Commentary section | |
| 1407 *** modes/sendmail.el | |
| 1408 Commentary: | |
| 1409 | |
| 1410 This mode provides mail-sending facilities from within Emacs. It is | |
| 1411 documented in the Emacs user's manual. | |
| 1412 *** modes/sh-script.el | |
| 1413 Commentary: | |
| 1414 | |
| 1415 Major mode for editing shell scripts. Bourne, C and rc shells as well | |
| 1416 as various derivatives are supported and easily derived from. Structured | |
| 1417 statements can be inserted with one command or abbrev. Completion is | |
| 1418 available for filenames, variables known from the script, the shell and | |
| 1419 the environment as well as commands. | |
| 1420 *** modes/simula.el | |
| 1421 Commentary: | |
| 1422 | |
| 1423 A major mode for editing the Simula language. It knows about Simula | |
| 1424 syntax and standard indentation commands. It also provides convenient | |
| 1425 abbrevs for Simula keywords. | |
| 1426 *** modes/tcl.el | |
| 1427 Commentary: | |
| 1428 | |
| 1429 Major mode for editing Tcl | |
| 1430 *** modes/texinfo.el Can't find any Commentary section | |
| 1431 *** modes/text-mode.el | |
| 1432 Commentary: | |
| 1433 | |
| 1434 This package provides the fundamental text mode documented in the | |
| 1435 Emacs user's manual. | |
| 1436 *** modes/two-column.el Can't find any Commentary section | |
| 1437 *** modes/verilog-mode.el | |
| 1438 Commentary: | |
| 1439 | |
| 1440 A major mode for editing Verilog HDL source code. When you have | |
| 1441 entered Verilog mode, you may get more info by pressing C-h m. You | |
| 1442 may also get online help describing various functions by: C-h f | |
| 1443 <Name of function you want described> | |
| 1444 *** modes/view-less.el | |
| 1445 Commentary: | |
| 1446 | |
| 1447 This mode is for browsing files without changing them. Keybindings | |
| 1448 similar to those used by the less(1) program are used. | |
| 1449 *** modes/view.el | |
| 1450 Commentary: | |
| 1451 | |
| 1452 This package provides the `view' minor mode documented in the Emacs | |
| 1453 user's manual. | |
| 1454 | |
| 1455 XEmacs: We don't autoload this because we use `view-less' instead. | |
| 1456 *** modes/vrml-mode.el | |
| 1457 Commentary: | |
| 1458 | |
| 1459 Mostly bastardized from tcl.el. | |
| 1460 *** modes/whitespace-mode.el | |
| 1461 Commentary: | |
| 1462 | |
| 1463 This is a minor mode, which highlights whitespaces (blanks and | |
| 1464 tabs) with different faces, so that it is easier to | |
| 1465 distinguish between them. | |
| 1466 Toggle the mode with: M-x whitespace-mode | |
| 1467 or with: M-x whitespace-incremental-mode | |
| 1468 The second one should be used in big files. | |
| 1469 *** modes/winmgr-mode.el | |
| 1470 Commentary: | |
| 1471 | |
| 1472 This package is a major mode for editing window configuration files and | |
| 1473 also defines font-lock keywords for such files. | |
| 1474 *** modes/xpm-mode.el Can't find any Commentary section | |
| 1475 modes/xrdb-mode.el Can't find any Commentary section | |
| 1476 | |
| 1477 ** mu - Message Utilities library (part of the Tools for MIME). | |
| 1478 | |
| 1479 ** ns - NeXTstep | |
| 1480 | |
| 1481 ** oobr - Browser for Object Oriented languages | |
| 1482 *** oobr/br-c++-ft.el Can't find any Commentary section | |
| 1483 | |
| 1484 ** packages - Lot's of stuff: array, baloon help, version control, ... | |
| 1485 *** packages/add-log.el | |
| 1486 Commentary: | |
| 1487 | |
| 1488 This facility is documented in the Emacs Manual. | |
| 1489 *** packages/apropos.el | |
| 1490 Commentary: | |
| 1491 | |
| 1492 The ideas for this package were derived from the C code in | |
| 1493 src/keymap.c and elsewhere. The functions in this file should | |
| 1494 always be byte-compiled for speed. Someone should rewrite this in | |
| 1495 C (as part of src/keymap.c) for speed. | |
| 1496 *** packages/array.el | |
| 1497 Commentary: | |
| 1498 | |
| 1499 Commands for editing a buffer interpreted as a rectangular array | |
| 1500 or matrix of whitespace-separated strings. You specify the array | |
| 1501 dimensions and some other parameters at startup time. | |
| 1502 *** packages/auto-save.el Can't find any Commentary section | |
| 1503 packages/autoinsert.el | |
| 1504 Commentary: | |
| 1505 | |
| 1506 The following defines an association list for text to be | |
| 1507 automatically inserted when a new file is created, and a function | |
| 1508 which automatically inserts these files; the idea is to insert | |
| 1509 default text much as the mode is automatically set using | |
| 1510 auto-mode-alist. | |
| 1511 *** packages/avoid.el | |
| 1512 Commentary: | |
| 1513 | |
| 1514 For those who are annoyed by the mouse pointer obscuring text, | |
| 1515 this mode moves the mouse pointer - either just a little out of | |
| 1516 the way, or all the way to the corner of the frame. | |
| 1517 To use, load or evaluate this file and type M-x mouse-avoidance-mode . | |
| 1518 To set up permanently, put this file on your .emacs: | |
| 1519 *** packages/backup-dir.el Can't find any Commentary section | |
| 1520 *** packages/balloon-help.el Can't find any Commentary section | |
| 1521 *** packages/big-menubar.el Can't find any Commentary section | |
| 1522 *** packages/blink-cursor.el | |
| 1523 *** packages/blink-paren.el Can't find any Commentary section | |
| 1524 *** packages/bookmark.el Can't find any Commentary section | |
| 1525 *** packages/buff-menu.el | |
| 1526 Commentary: | |
| 1527 | |
| 1528 Edit, delete, or change attributes of all currently active Emacs | |
| 1529 buffers from a list summarizing their state. A good way to browse | |
| 1530 any special or scratch buffers you have loaded, since you can't find | |
| 1531 them by filename. The single entry point is `Buffer-menu-mode', | |
| 1532 normally bound to C-x C-b. | |
| 1533 *** packages/chistory.el | |
| 1534 Commentary: | |
| 1535 | |
| 1536 This really has nothing to do with list-command-history per se, but | |
| 1537 its a nice alternative to C-x ESC ESC (repeat-complex-command) and | |
| 1538 functions as a lister if given no pattern. It's not important | |
| 1539 enough to warrant a file of its own. | |
| 1540 *** packages/cmuscheme.el | |
| 1541 Commentary: | |
| 1542 | |
| 1543 This is a customisation of comint-mode (see comint.el) | |
| 1544 *** packages/crypt.el | |
| 1545 Commentary: | |
| 1546 | |
| 1547 NOTE: Apparently not being maintained by the author, who now | |
| 1548 uses jka-compr.el. --ben (1/26/96) | |
| 1549 Included patch (1/26/96) | |
| 1550 | |
| 1551 Code for handling all sorts of compressed and encrypted files.| | |
| 1552 *** packages/cu-edit-faces.el Can't find any Commentary section | |
| 1553 *** packages/dabbrev.el | |
| 1554 Commentary: | |
| 1555 | |
| 1556 The purpose with this package is to let you write just a few | |
| 1557 characters of words you've written earlier to be able to expand | |
| 1558 them. | |
| 1559 *** packages/desktop.el | |
| 1560 Commentary: | |
| 1561 | |
| 1562 Save the Desktop, i.e., | |
| 1563 - some global variables | |
| 1564 - the list of buffers with associated files. For each buffer also | |
| 1565 - the major mode | |
| 1566 - the default directory | |
| 1567 - the point | |
| 1568 - the mark & mark-active | |
| 1569 - buffer-read-only | |
| 1570 - some local variables | |
| 1571 *** packages/fast-lock.el | |
| 1572 Commentary: | |
| 1573 | |
| 1574 Lazy Lock mode is a Font Lock support mode. | |
| 1575 It makes visiting a file in Font Lock mode faster by restoring its face text | |
| 1576 properties from automatically saved associated Font Lock cache files. | |
| 1577 *** packages/font-lock.el | |
| 1578 Font-lock-mode is a minor mode that causes your comments to be | |
| 1579 displayed in one face, strings in another, reserved words in another, | |
| 1580 documentation strings in another, and so on. | |
| 1581 *** packages/func-menu.el Can't find any Commentary section | |
| 1582 *** packages/generic-sc.el Can't find any Commentary section | |
| 1583 *** packages/gnuserv.el Can't find any Commentary section | |
| 1584 *** packages/gopher.el | |
| 1585 Commentary: | |
| 1586 OPERATING INSTRUCTIONS | |
| 1587 | |
| 1588 To use, `M-x gopher'. To specify a different root server, use | |
| 1589 `C-u M-x gopher'. If you want to use bookmarks, set the variable | |
| 1590 gopher-support-bookmarks appropriately. | |
| 1591 *** packages/hexl.el | |
| 1592 Commentary: | |
| 1593 | |
| 1594 This package implements a major mode for editing binary files. It uses | |
| 1595 a program called hexl, supplied with the GNU Emacs distribution, that | |
| 1596 can filter a binary into an editable format or from the format back into | |
| 1597 binary. For full instructions, invoke `hexl-mode' on an empty buffer and | |
| 1598 do `M-x describe-mode'. | |
| 1599 *** packages/hyper-apropos.el | |
| 1600 Commentary: | |
| 1601 | |
| 1602 Rather than run apropos and print all the documentation at once, | |
| 1603 I find it easier to view a "table of contents" first, then | |
| 1604 get the details for symbols as you need them. | |
| 1605 *** packages/icomplete.el | |
| 1606 Commentary: | |
| 1607 | |
| 1608 Loading this package implements a more fine-grained minibuffer | |
| 1609 completion feedback scheme. Prospective completions are concisely | |
| 1610 indicated within the minibuffer itself, with each successive | |
| 1611 keystroke. | |
| 1612 *** packages/igrep.el Can't find any Commentary section | |
| 1613 *** packages/info.el Can't find any Commentary section | |
| 1614 *** packages/informat.el Can't find any Commentary section | |
| 1615 *** packages/ispell.el | |
| 1616 Commentary: | |
| 1617 *** packages/jka-compr.el | |
| 1618 Commentary: | |
| 1619 | |
| 1620 This package implements low-level support for reading, writing, | |
| 1621 and loading compressed files. It hooks into the low-level file | |
| 1622 I/O functions (including write-region and insert-file-contents) so | |
| 1623 that they automatically compress or uncompress a file if the file | |
| 1624 appears to need it (based on the extension of the file name). | |
| 1625 Packages like Rmail, VM, GNUS, and Info should be able to work | |
| 1626 with compressed files without modification. | |
| 1627 *** packages/lazy-lock.el | |
| 1628 Commentary: | |
| 1629 | |
| 1630 Purpose: | |
| 1631 | |
| 1632 To make visiting buffers in `font-lock-mode' faster by making fontification | |
| 1633 be demand-driven and stealthy. | |
| 1634 Fontification only occurs when, and where, necessary. | |
| 1635 *** packages/ledit.el | |
| 1636 Commentary: | |
| 1637 | |
| 1638 This is a major mode for editing Liszt. See etc/LEDIT for details. | |
| 1639 *** packages/lispm-fonts.el Can't find any Commentary section | |
| 1640 *** packages/lpr.el | |
| 1641 Commentary: | |
| 1642 | |
| 1643 Commands to send the region or a buffer your printer. Entry points | |
| 1644 are `lpr-buffer', `print-buffer', lpr-region', or `print-region'; option | |
| 1645 variables include `lpr-switches' and `lpr-command'. | |
| 1646 *** packages/makeinfo.el | |
| 1647 Commentary: | |
| 1648 | |
| 1649 The Texinfo mode `makeinfo' related commands are: | |
| 1650 *** packages/makesum.el | |
| 1651 Commentary: | |
| 1652 | |
| 1653 Displays a nice human-readable summary of all keybindings in a | |
| 1654 two-column format. | |
| 1655 *** packages/man.el Can't find any Commentary section | |
| 1656 *** packages/metamail.el | |
| 1657 Commentary: | |
| 1658 | |
| 1659 Note: Metamail does not have all options which is compatible with | |
| 1660 the environment variables. For that reason, matamail.el have to | |
| 1661 hack the environment variables. In addition, there is no way to | |
| 1662 display all header fields without extra informative body messages | |
| 1663 which are suppressed by "-q" option. | |
| 1664 | |
| 1665 The idea of using metamail to process MIME messages is from | |
| 1666 gnus-mime.el by Spike <Spike@world.std.com>. | |
| 1667 *** packages/mic-paren.el Can't find any Commentary section | |
| 1668 *** packages/mime-compose.el Can't find any Commentary section | |
| 1669 *** packages/mode-motion+.el Can't find any Commentary section | |
| 1670 *** packages/netunam.el | |
| 1671 Commentary: | |
| 1672 | |
| 1673 Use the Remote File Access (RFA) facility of HP-UX from Emacs. | |
| 1674 *** packages/page-ext.el | |
| 1675 Commentary: | |
| 1676 | |
| 1677 You may use these commands to handle an address list or other | |
| 1678 small data base. | |
| 1679 *** packages/paren.el | |
| 1680 Commentary: | |
| 1681 | |
| 1682 Purpose of this package: | |
| 1683 | |
| 1684 This package highlights matching parens (or whole sexps) for easier | |
| 1685 editing of source code, particularly lisp source code. | |
| 1686 *** packages/pending-del.el Can't find any Commentary section | |
| 1687 *** packages/ps-print.el | |
| 1688 Commentary: | |
| 1689 | |
| 1690 This package provides printing of Emacs buffers on PostScript | |
| 1691 printers; the buffer's bold and italic text attributes are | |
| 1692 preserved in the printer output. Ps-print is intended for use with | |
| 1693 Emacs 19 or Lucid Emacs, together with a fontifying package such as | |
| 1694 font-lock or hilit. | |
| 1695 *** packages/rcompile.el | |
| 1696 Commentary: | |
| 1697 | |
| 1698 This package is for running a remote compilation and using emacs to parse | |
| 1699 the error messages. It works by rsh'ing the compilation to a remote host | |
| 1700 and parsing the output. If the file visited at the time remote-compile was | |
| 1701 called was loaded remotely (ange-ftp), the host and user name are obtained | |
| 1702 by the calling ange-ftp-ftp-name on the current directory. In this case the | |
| 1703 next-error command will also ange-ftp the files over. This is achieved | |
| 1704 automatically because the compilation-parse-errors function uses | |
| 1705 default-directory to build it's file names. If however the file visited was | |
| 1706 loaded locally, remote-compile prompts for a host and user and assumes the | |
| 1707 files mounted locally (otherwise, how was the visited file loaded). | |
| 1708 *** packages/recent-files.el Can't find any Commentary section | |
| 1709 *** packages/refbib.el | |
| 1710 Commentary: | |
| 1711 | |
| 1712 Use: from a buffer containing the refer-style bibliography, | |
| 1713 M-x r2b-convert-buffer | |
| 1714 Program will prompt for an output buffer name, and will log | |
| 1715 warnings during the conversion process in the buffer *Log*. | |
| 1716 *** packages/remote.el Can't find any Commentary section | |
| 1717 *** packages/reportmail.el Can't find any Commentary section | |
| 1718 *** packages/resume.el | |
| 1719 Commentary: | |
| 1720 | |
| 1721 The purpose of this library is to handle command line arguments | |
| 1722 when you resume an existing Emacs job. | |
| 1723 | |
| 1724 You can't get the benefit of this library by using the `emacs' command, | |
| 1725 since that always starts a new Emacs job. Instead you must use a | |
| 1726 command called `edit' which knows how to resume an existing Emacs job | |
| 1727 if you have one, or start a new Emacs job if you don't have one. | |
| 1728 | |
| 1729 To define the `edit' command, run the script etc/emacs.csh (if you use CSH), | |
| 1730 or etc/emacs.bash if you use BASH. You would normally do this in your | |
| 1731 login script. | |
| 1732 *** packages/saveconf.el Can't find any Commentary section | |
| 1733 *** packages/saveplace.el | |
| 1734 Commentary: | |
| 1735 | |
| 1736 Automatically save place in files, so that visiting them later | |
| 1737 (even during a different Emacs session) automatically moves point | |
| 1738 to the saved position, when the file is first found. Uses the | |
| 1739 value of buffer-local variable save-place to determine whether to | |
| 1740 save position or not. | |
| 1741 *** packages/sccs.el Can't find any Commentary section | |
| 1742 *** packages/scroll-in-place.el Can't find any Commentary section | |
| 1743 *** packages/server.el | |
| 1744 Commentary: | |
| 1745 | |
| 1746 This Lisp code is run in Emacs when it is to operate as | |
| 1747 a server for other processes. | |
| 1748 | |
| 1749 *** packages/shell-font.el Can't find any Commentary section | |
| 1750 *** packages/spell.el | |
| 1751 Commentary: | |
| 1752 | |
| 1753 This mode provides an Emacs interface to the UNIX spell(1) program. | |
| 1754 Entry points are `spell-buffer', `spell-word', `spell-region' and | |
| 1755 `spell-string'. These facilities are documented in the Emacs user's | |
| 1756 manual. | |
| 1757 *** packages/supercite.el Can't find any Commentary section | |
| 1758 *** packages/tar-mode.el Can't find any Commentary section | |
| 1759 *** packages/terminal.el Can't find any Commentary section | |
| 1760 *** packages/tex-latin1.el Can't find any Commentary section | |
| 1761 *** packages/texinfmt.el Can't find any Commentary section | |
| 1762 *** packages/texnfo-tex.el Can't find any Commentary section | |
| 1763 *** packages/texnfo-upd.el | |
| 1764 Commentary: | |
| 1765 *** packages/time-stamp.el | |
| 1766 Commentary: | |
| 1767 | |
| 1768 If you put a time stamp template anywhere in the first 8 lines of a file, | |
| 1769 it can be updated every time you save the file. See the top of | |
| 1770 time-stamp.el for a sample. The template looks like one of the following: | |
| 1771 Time-stamp: <> | |
| 1772 Time-stamp: " " | |
| 1773 The time stamp is written between the brackets or quotes, resulting in | |
| 1774 Time-stamp: <95/01/18 10:20:51 gildea> | |
| 1775 *** packages/time.el | |
| 1776 Commentary: | |
| 1777 | |
| 1778 Facilities to display current time/date and a new-mail indicator | |
| 1779 in the Emacs mode line. The single entry point is `display-time'. | |
| 1780 *** packages/uncompress.el | |
| 1781 Commentary: | |
| 1782 | |
| 1783 This package can be used to arrange for automatic uncompress of | |
| 1784 files packed with the UNIX compress(1) utility when they are visited. | |
| 1785 All that's necessary is to load it. This can conveniently be done from | |
| 1786 your .emacs file. | |
| 1787 *** packages/underline.el | |
| 1788 Commentary: | |
| 1789 | |
| 1790 This package deals with the primitive form of underlining | |
| 1791 consisting of prefixing each character with "_\^h". The entry | |
| 1792 point `underline-region' performs such underlining on a region. | |
| 1793 The entry point `ununderline-region' removes it. | |
| 1794 *** packages/upd-copyr.el Can't find any Commentary section | |
| 1795 *** packages/vc.el | |
| 1796 Commentary: | |
| 1797 | |
| 1798 This mode is fully documented in the Emacs user's manual. | |
| 1799 | |
| 1800 Supported version-control systems presently include SCCS, RCS, and CVS. | |
| 1801 The RCS lock-stealing code doesn't work right unless you use RCS 5.6.2 | |
| 1802 or newer. Currently (January 1994) that is only a beta test release. | |
| 1803 Even initial checkins will fail if your RCS version is so old that ci | |
| 1804 doesn't understand -t-; this has been known to happen to people running | |
| 1805 NExTSTEP 3.0. | |
| 1806 *** packages/webjump.el | |
| 1807 Change Log: | |
| 1808 *** packages/webster-ucb.el Can't find any Commentary section | |
| 1809 *** packages/webster.el Can't find any Commentary section | |
| 1810 *** packages/xscheme.el Can't find any Commentary section | |
| 1811 | |
| 1812 | |
| 1813 ** pcl-cvs - Front end to CVS (see also vc -- version control) | |
| 1814 *** pcl-cvs/cookie.el | |
| 1815 Commentary: | |
| 1816 | |
| 1817 Introduction | |
| 1818 ============ | |
| 1819 | |
| 1820 Cookie is a package that implements a connection between an | |
| 1821 dll (a doubly linked list) and the contents of a buffer. | |
| 1822 Possible uses are dired (have all files in a list, and show them), | |
| 1823 buffer-list, kom-prioritize (in the LysKOM elisp client) and | |
| 1824 others. pcl-cvs.el uses cookie.el. | |
| 1825 *** pcl-cvs/dll-debug.el | |
| 1826 Commentary: | |
| 1827 | |
| 1828 This is a plug-in replacement for dll.el. It is dreadfully | |
| 1829 slow, but it facilitates debugging. Don't trust the comments in | |
| 1830 this file too much. | |
| 1831 (provide 'dll) | |
| 1832 | |
| 1833 *** pcl-cvs/dll.el | |
| 1834 Commentary: | |
| 1835 | |
| 1836 A doubly linked list consists of one cons cell which holds the tag | |
| 1837 'DL-LIST in the car cell and a pointer to a dummy node in the cdr | |
| 1838 cell. The doubly linked list is implemented as a circular list | |
| 1839 with the dummy node first and last. The dummy node is recognized | |
| 1840 by comparing it to the node which the cdr of the cons cell points | |
| 1841 to. | |
| 1842 | |
| 1843 *** pcl-cvs/elib-node.el | |
| 1844 Commentary: | |
| 1845 | |
| 1846 A node is implemented as an array with three elements, using | |
| 1847 (elt node 0) as the left pointer | |
| 1848 (elt node 1) as the right pointer | |
| 1849 (elt node 2) as the data | |
| 1850 *** pcl-cvs/pcl-cvs-startup.el Can't find any Commentary section | |
| 1851 *** pcl-cvs/pcl-cvs-xemacs.el Can't find any Commentary section | |
| 1852 *** pcl-cvs/pcl-cvs.el Can't find any Commentary section | |
| 1853 *** pcl-cvs/string.el | |
| 1854 Commentary: | |
| 1855 | |
| 1856 | |
| 1857 This file is part of the elisp library Elib. | |
| 1858 It implements simple generic string functions for use in other | |
| 1859 elisp code: replace regexps in strings, split strings on regexps. | |
| 1860 | |
| 1861 ** prim - Lots of XEmacs primitives (see Emacs-Lisp manual). | |
| 1862 *** prim/about.el Can't find any Commentary section | |
| 1863 *** prim/advocacy.el Can't find any Commentary section | |
| 1864 *** prim/auto-autoloads.el Can't find any Commentary section | |
| 1865 *** prim/backquote.el Can't find any Commentary section | |
| 1866 *** prim/buffer.el Can't find any Commentary section | |
| 1867 *** prim/case-table.el Can't find any Commentary section | |
| 1868 *** prim/cleantree.el | |
| 1869 Commentary: | |
| 1870 | |
| 1871 This code is derived from Gnus based on a suggestion by | |
| 1872 David Moore <dmoore@ucsd.edu> | |
| 1873 *** prim/cmdloop.el Can't find any Commentary section | |
| 1874 *** prim/cmdloop1.el Can't find any Commentary section | |
| 1875 *** prim/console.el Can't find any Commentary section | |
| 1876 *** prim/custom-load.el Can't find any Commentary section | |
| 1877 *** prim/debug.el | |
| 1878 Commentary: | |
| 1879 | |
| 1880 This is a major mode documented in the Emacs manual. | |
| 1881 *** prim/device.el Can't find any Commentary section | |
| 1882 *** prim/dialog.el Can't find any Commentary section | |
| 1883 *** prim/disp-table.el Can't find any Commentary section | |
| 1884 *** prim/env.el | |
| 1885 Commentary: | |
| 1886 | |
| 1887 UNIX processes inherit a list of name-to-string associations from their | |
| 1888 parents called their `environment'; these are commonly used to control | |
| 1889 program options. This package permits you to set environment variables | |
| 1890 to be passed to any sub-process run under XEmacs. | |
| 1891 *** prim/events.el Can't find any Commentary section | |
| 1892 *** prim/extents.el Can't find any Commentary section | |
| 1893 *** prim/faces.el Can't find any Commentary section | |
| 1894 *** prim/files.el | |
| 1895 Commentary: | |
| 1896 | |
| 1897 Defines most of XEmacs's file- and directory-handling functions, | |
| 1898 including basic file visiting, backup generation, link handling, | |
| 1899 ITS-id version control, load- and write-hook handling, and the like. | |
| 1900 *** prim/fill.el | |
| 1901 Commentary: | |
| 1902 | |
| 1903 All the commands for filling text. These are documented in the XEmacs | |
| 1904 Reference Manual. | |
| 1905 *** prim/float-sup.el Can't find any Commentary section | |
| 1906 *** prim/format.el | |
| 1907 Commentary: | |
| 1908 | |
| 1909 This file defines a unified mechanism for saving & loading files stored | |
| 1910 in different formats. `format-alist' contains information that directs | |
| 1911 Emacs to call an encoding or decoding function when reading or writing | |
| 1912 files that match certain conditions. | |
| 1913 *** prim/frame.el Can't find any Commentary section | |
| 1914 *** prim/glyphs.el Can't find any Commentary section | |
| 1915 *** prim/gui.el Can't find any Commentary section | |
| 1916 *** prim/help.el | |
| 1917 Commentary: | |
| 1918 | |
| 1919 This code implements XEmacs's on-line help system, the one invoked by | |
| 1920 `M-x help-for-help'. | |
| 1921 *** prim/inc-vers.el Can't find any Commentary section | |
| 1922 *** prim/indent.el | |
| 1923 Commentary: | |
| 1924 | |
| 1925 Commands for making and changing indentation in text. These are | |
| 1926 described in the XEmacs Reference Manual. | |
| 1927 *** prim/isearch-mode.el Can't find any Commentary section | |
| 1928 *** prim/itimer-autosave.el | |
| 1929 Commentary: | |
| 1930 | |
| 1931 itimer-driven auto-saves | |
| 1932 *** prim/itimer.el Can't find any Commentary section | |
| 1933 *** prim/keydefs.el Can't find any Commentary section | |
| 1934 *** prim/keymap.el Can't find any Commentary section | |
| 1935 *** prim/lisp.el | |
| 1936 Commentary: | |
| 1937 | |
| 1938 Lisp editing commands to go with Lisp major mode. | |
| 1939 *** prim/loaddefs.el | |
| 1940 Commentary: | |
| 1941 | |
| 1942 You should never need to write autoloads by hand and put them here. | |
| 1943 | |
| 1944 It is no longer necessary. Instead use autoload.el to maintain them | |
| 1945 for you. Just insert ";;;###autoload" before defuns or defmacros you | |
| 1946 want to be autoloaded, or other forms you want copied into loaddefs.el | |
| 1947 (defvars, key definitions, etc.). | |
| 1948 *** prim/loadup-el.el Can't find any Commentary section | |
| 1949 *** prim/loadup.el | |
| 1950 Commentary: | |
| 1951 | |
| 1952 This is loaded into a bare Emacs to make a dumpable one. | |
| 1953 *** prim/macros.el | |
| 1954 Commentary: | |
| 1955 | |
| 1956 Extension commands for keyboard macros. These permit you to assign | |
| 1957 a name to the last-defined keyboard macro, expand and insert the | |
| 1958 lisp corresponding to a macro, query the user from within a macro, | |
| 1959 or apply a macro to each line in the reason. | |
| 1960 | |
| 1961 This file is largely superseded by edmacro.el as of XEmacs 20.1. -sb | |
| 1962 *** prim/menubar.el Can't find any Commentary section | |
| 1963 *** prim/minibuf.el | |
| 1964 Commentary: | |
| 1965 | |
| 1966 Written by Richard Mlynarik 2-Oct-92 | |
| 1967 *** prim/misc.el Can't find any Commentary section | |
| 1968 *** prim/mode-motion.el Can't find any Commentary section | |
| 1969 *** prim/modeline.el Can't find any Commentary section | |
| 1970 *** prim/mouse.el Can't find any Commentary section | |
| 1971 *** prim/novice.el | |
| 1972 Commentary: | |
| 1973 | |
| 1974 This mode provides a hook which is, by default, attached to various | |
| 1975 putatively dangerous commands in a (probably futile) attempt to | |
| 1976 prevent lusers from shooting themselves in the feet. | |
| 1977 *** prim/objects.el Can't find any Commentary section | |
| 1978 *** prim/obsolete.el Can't find any Commentary section | |
| 1979 *** prim/options.el | |
| 1980 Commentary: | |
| 1981 | |
| 1982 This code provides functions to list and edit the values of all global | |
| 1983 option variables known to loaded Emacs Lisp code. There are two entry | |
| 1984 points, `list-options' and `edit' options'. The latter enters a major | |
| 1985 mode specifically for editing option values. Do `M-x describe-mode' in | |
| 1986 that context for more details. | |
| 1987 *** prim/overlay.el Can't find any Commentary section | |
| 1988 *** prim/page.el | |
| 1989 Commentary: | |
| 1990 | |
| 1991 This code provides the page-oriented movement and selection commands | |
| 1992 documented in the XEmacs Reference Manual. | |
| 1993 *** prim/paragraphs.el | |
| 1994 Commentary: | |
| 1995 | |
| 1996 This package provides the paragraph-oriented commands documented in the | |
| 1997 XEmacs Reference Manual. | |
| 1998 *** prim/process.el Can't find any Commentary section | |
| 1999 *** prim/profile.el Can't find any Commentary section | |
| 2000 *** prim/rect.el | |
| 2001 Commentary: | |
| 2002 | |
| 2003 This package provides the operations on rectangles that are ocumented | |
| 2004 in the XEmacs Reference Manual. | |
| 2005 *** prim/register.el | |
| 2006 Commentary: | |
| 2007 | |
| 2008 This package of functions emulates and somewhat extends the venerable | |
| 2009 TECO's `register' feature, which permits you to save various useful | |
| 2010 pieces of buffer state to named variables. The entry points are | |
| 2011 documented in the XEmacs Reference Manual. | |
| 2012 *** prim/replace.el | |
| 2013 Commentary: | |
| 2014 | |
| 2015 This package supplies the string and regular-expression replace functions | |
| 2016 documented in the XEmacs Reference Manual. | |
| 2017 | |
| 2018 All the gettext calls are for XEmacs I18N3 message catalog support. | |
| 2019 *** prim/reposition.el | |
| 2020 Commentary: | |
| 2021 | |
| 2022 Reposition-window makes an entire function definition or comment visible, | |
| 2023 or, if it is already visible, places it at the top of the window; | |
| 2024 additional invocations toggle the visibility of comments preceding the | |
| 2025 code. For the gory details, see the documentation for reposition-window; | |
| 2026 rather than reading that, you may just want to play with it. | |
| 2027 | |
| 2028 This tries pretty hard to do the recentering correctly; the precise | |
| 2029 action depends on what the buffer looks like. If you find a situation | |
| 2030 where it doesn't behave well, let me know. This function is modeled | |
| 2031 after one of the same name in ZMACS, but the code is all-new and the | |
| 2032 behavior in some situations differs. | |
| 2033 *** prim/scrollbar.el Can't find any Commentary section | |
| 2034 *** prim/simple.el | |
| 2035 Commentary: | |
| 2036 | |
| 2037 A grab-bag of basic XEmacs commands not specifically related to some | |
| 2038 major mode or to file-handling. | |
| 2039 *** prim/sort.el | |
| 2040 Commentary: | |
| 2041 | |
| 2042 This package provides the sorting facilities documented in the XEmacs | |
| 2043 Reference Manual. | |
| 2044 *** prim/sound.el Can't find any Commentary section | |
| 2045 *** prim/specifier.el Can't find any Commentary section | |
| 2046 *** prim/startup.el Can't find any Commentary section | |
| 2047 *** prim/subr.el | |
| 2048 Commentary: | |
| 2049 | |
| 2050 There's not a whole lot in common now with the FSF version, | |
| 2051 be wary when applying differences. I've left in a number of lines | |
| 2052 of commentary just to give diff(1) something to synch itself with to | |
| 2053 provide useful context diffs. -sb | |
| 2054 *** prim/symbols.el | |
| 2055 Commentary: | |
| 2056 | |
| 2057 The idea behind magic variables is that you can specify arbitrary | |
| 2058 behavior to happen when setting or retrieving a variable's value. The | |
| 2059 purpose of this is to make it possible to cleanly provide support for | |
| 2060 obsolete variables (e.g. unread-command-event, which is obsolete for | |
| 2061 unread-command-events) and variable compatibility | |
| 2062 (e.g. suggest-key-bindings, the FSF equivalent of | |
| 2063 teach-extended-commands-p and teach-extended-commands-timeout). | |
| 2064 *** prim/syntax.el Can't find any Commentary section | |
| 2065 *** prim/tabify.el | |
| 2066 Commentary: | |
| 2067 | |
| 2068 Commands to optimize spaces to tabs or expand tabs to spaces in a region | |
| 2069 (`tabify' and `untabify'). The variable tab-width does the obvious. | |
| 2070 *** prim/toolbar.el Can't find any Commentary section | |
| 2071 *** prim/undo-stack.el Can't find any Commentary section | |
| 2072 *** prim/update-elc.el Can't find any Commentary section | |
| 2073 *** prim/userlock.el | |
| 2074 Commentary: | |
| 2075 | |
| 2076 This file is autoloaded to handle certain conditions | |
| 2077 detected by the file-locking code within XEmacs. | |
| 2078 The two entry points are `ask-user-about-lock' and | |
| 2079 `ask-user-about-supersession-threat'. | |
| 2080 *** prim/window.el Can't find any Commentary section | |
| 2081 | |
| 2082 ** psgml - SGML/HTML editing mode | |
| 2083 *** psgml/iso-sgml.el Can't find any Commentary section | |
| 2084 *** psgml/psgml-api.el | |
| 2085 Commentary: | |
| 2086 | |
| 2087 Provides some extra functions for the API to PSGML. | |
| 2088 | |
| 2089 *** psgml/psgml-charent.el | |
| 2090 Commentary: | |
| 2091 | |
| 2092 Functions to convert character entities into displayable characters | |
| 2093 and displayable characters back into character entities. | |
| 2094 | |
| 2095 *** psgml/psgml-debug.el Can't find any Commentary section | |
| 2096 *** psgml/psgml-dtd.el | |
| 2097 Commentary: | |
| 2098 | |
| 2099 Part of major mode for editing the SGML document-markup language. | |
| 2100 | |
| 2101 *** psgml/psgml-edit.el | |
| 2102 Commentary: | |
| 2103 | |
| 2104 Part of major mode for editing the SGML document-markup language. | |
| 2105 | |
| 2106 *** psgml/psgml-fs.el | |
| 2107 Commentary: | |
| 2108 | |
| 2109 The function `style-format' formats the SGML-file in the current | |
| 2110 buffer according to the style defined in the file `psgml-style.fs' | |
| 2111 (or the file given by the variable `fs-style'). | |
| 2112 | |
| 2113 To try it load this file and open the test file example.sgml. Then | |
| 2114 run the emacs command `M-x style-format'. | |
| 2115 | |
| 2116 The style file should contain a single Lisp list. The elements of | |
| 2117 this list, are them self lists, describe the style for an element type. | |
| 2118 The sublists begin with the generic identifier for the element types and | |
| 2119 the rest of the list are characteristic/value pairs. | |
| 2120 | |
| 2121 E.g. ("p" block t left 4 top 2) | |
| 2122 | |
| 2123 Defines the style for p-elements to be blocks with left margin 4 and | |
| 2124 at least to blank lines before the block. | |
| 2125 | |
| 2126 *** psgml/psgml-html.el | |
| 2127 Commentary: | |
| 2128 | |
| 2129 Parts were taken from html-helper-mode and from code by Alastair Burt. | |
| 2130 | |
| 2131 Feb 18 1997, Heiko Muenkel: Added the hook variable html-mode-hook. | |
| 2132 ; With that you can now use the hm--html-minor-mode together | |
| 2133 ; with this mode. For that you've to add the following line | |
| 2134 ; to your ~/.emacs: | |
| 2135 ; (add-hook 'html-mode-hook 'hm--html-minor-mode) | |
| 2136 *** psgml/psgml-info.el | |
| 2137 Commentary: | |
| 2138 | |
| 2139 This file is an addon to the PSGML package. | |
| 2140 | |
| 2141 This file contains some commands to print out information about the | |
| 2142 current DTD. | |
| 2143 *** psgml/psgml-other.el | |
| 2144 Commentary: | |
| 2145 | |
| 2146 Part of psgml.el. Code not compatible with XEmacs. | |
| 2147 | |
| 2148 *** psgml/psgml-parse.el | |
| 2149 Commentary: | |
| 2150 | |
| 2151 Part of major mode for editing the SGML document-markup language. | |
| 2152 | |
| 2153 *** psgml/psgml-xemacs.el | |
| 2154 Commentary: | |
| 2155 | |
| 2156 Part of psgml.el | |
| 2157 | |
| 2158 Menus for use with XEmacs | |
| 2159 | |
| 2160 *** psgml/psgml.el | |
| 2161 Commentary: | |
| 2162 | |
| 2163 Major mode for editing the SGML document-markup language. | |
| 2164 *** psgml/tempo.el | |
| 2165 Commentary: | |
| 2166 | |
| 2167 This file provides a simple way to define powerful templates, or | |
| 2168 macros, if you wish. It is mainly intended for, but not limited to, | |
| 2169 other programmers to be used for creating shortcuts for editing | |
| 2170 certain kind of documents. It was originally written to be used by | |
| 2171 a HTML editing mode written by Nelson Minar <nelson@santafe.edu>, | |
| 2172 and his html-helper-mode.el is probably the best example of how to | |
| 2173 use this program. | |
| 2174 | |
| 2175 ** rmail - Reading Mail (see also VM and GNUS) | |
| 2176 *** rmail/rmail-kill.el | |
| 2177 Commentary: | |
| 2178 *** rmail/rmail-xemacs.el | |
| 2179 Commentary: | |
| 2180 | |
| 2181 Right button pops up a menu of commands in Rmail and Rmail summary buffers. | |
| 2182 Middle button selects indicated mail message in Rmail summary buffer | |
| 2183 *** rmail/rmail.el Can't find any Commentary section | |
| 2184 *** rmail/rmailedit.el Can't find any Commentary section | |
| 2185 *** rmail/rmailkwd.el Can't find any Commentary section | |
| 2186 *** rmail/rmailmsc.el Can't find any Commentary section | |
| 2187 *** rmail/rmailout.el Can't find any Commentary section | |
| 2188 *** rmail/rmailsort.el Can't find any Commentary section | |
| 2189 *** rmail/rmailsum.el | |
| 2190 Commentary: | |
| 2191 | |
| 2192 Provided all commands from rmail-mode in rmail-summary-mode and made key | |
| 2193 bindings in both modes wholly compatible. | |
| 2194 *** rmail/undigest.el | |
| 2195 Commentary: | |
| 2196 | |
| 2197 See Internet RFC 934 | |
| 2198 *** rmail/unrmail.el Can't find any Commentary section | |
| 2199 | |
| 2200 ** sunpro - Additional code for interfacing with SunPro products. | |
| 2201 *** sunpro/sunpro-init.el Can't find any Commentary section | |
| 2202 *** sunpro/sunpro-keys.el Can't find any Commentary section | |
| 2203 *** sunpro/sunpro-load.el Can't find any Commentary section | |
| 2204 *** sunpro/sunpro-menubar.el | |
| 2205 Commentary: | |
| 2206 Creates the default SunPro menubars. | |
| 2207 *** sunpro/sunpro-sparcworks.el | |
| 2208 Commentary: | |
| 2209 | |
| 2210 Called from the SPARCworks Manager with the command: | |
| 2211 | |
| 2212 xemacs -q -l sunpro-sparcworks $SUNPRO_SWM_TT_ARGS $SUNPRO_SWM_GUI_ARGS | |
| 2213 | |
| 2214 ** term - Terminal specific initialization: vt100, wyse, ... | |
| 2215 *** term/AT386.el | |
| 2216 Commentary: | |
| 2217 | |
| 2218 Uses the Emacs 19 terminal initialization features --- won't work with 18. | |
| 2219 *** term/apollo.el Can't find any Commentary section | |
| 2220 *** term/bg-mouse.el Can't find any Commentary section | |
| 2221 *** term/bobcat.el Can't find any Commentary section | |
| 2222 *** term/internal.el Can't find any Commentary section | |
| 2223 *** term/keyswap.el | |
| 2224 Commentary: | |
| 2225 | |
| 2226 This package is meant to be called by other terminal packages. | |
| 2227 *** term/linux.el Can't find any Commentary section | |
| 2228 *** term/lk201.el Can't find any Commentary section | |
| 2229 *** term/news.el | |
| 2230 Commentary: | |
| 2231 | |
| 2232 Uses the Emacs 19 terminal initialization features --- won't work with 18. | |
| 2233 *** term/pc-win.el Can't find any Commentary section | |
| 2234 *** term/scoansi.el Can't find any Commentary section | |
| 2235 *** term/sun-mouse.el | |
| 2236 Commentary: | |
| 2237 *** term/sun.el | |
| 2238 Commentary: | |
| 2239 | |
| 2240 The function key sequences for the console have been converted for | |
| 2241 use with function-key-map, but the *tool stuff hasn't been touched. | |
| 2242 *** term/sup-mouse.el Can't find any Commentary section | |
| 2243 *** term/tty-init.el | |
| 2244 Commentary: | |
| 2245 *** term/tvi970.el | |
| 2246 Commentary: | |
| 2247 | |
| 2248 Uses the Emacs 19 terminal initialization features --- won't work with 18. | |
| 2249 *** term/vt-control.el | |
| 2250 Commentary: | |
| 2251 | |
| 2252 The functions contained in this file send various VT control codes | |
| 2253 to the terminal where emacs is running. The following functions are | |
| 2254 available. | |
| 2255 *** term/vt100-led.el Can't find any Commentary section | |
| 2256 *** term/vt100.el | |
| 2257 Commentary: | |
| 2258 | |
| 2259 Uses the Emacs 19 terminal initialization features --- won't work with 18. | |
| 2260 | |
| 2261 Handles all VT100 clones, including the Apollo terminal. Also handles | |
| 2262 the VT200 --- its PF- and arrow- keys are different, but all those | |
| 2263 are really set up by the terminal initialization code, which mines them | |
| 2264 out of termcap. This package is here to define the keypad comma, dash | |
| 2265 and period (which aren't in termcap's repertoire) and the function for | |
| 2266 changing from 80 to 132 columns & vv. | |
| 2267 *** term/vt102.el Can't find any Commentary section | |
| 2268 *** term/vt125.el Can't find any Commentary section | |
| 2269 *** term/vt200.el Can't find any Commentary section | |
| 2270 *** term/vt201.el Can't find any Commentary section | |
| 2271 *** term/vt220.el Can't find any Commentary section | |
| 2272 *** term/vt240.el Can't find any Commentary section | |
| 2273 *** term/vt300.el Can't find any Commentary section | |
| 2274 *** term/vt320.el Can't find any Commentary section | |
| 2275 *** term/vt400.el Can't find any Commentary section | |
| 2276 *** term/vt420.el Can't find any Commentary section | |
| 2277 *** term/win32-win.el | |
| 2278 Commentary: | |
| 2279 | |
| 2280 win32-win.el: this file is loaded from ../lisp/startup.el when it recognizes | |
| 2281 that win32 windows are to be used. Command line switches are parsed and those | |
| 2282 pertaining to win32 are processed and removed from the command line. The | |
| 2283 win32 display is opened and hooks are set for popping up the initial window. | |
| 2284 | |
| 2285 startup.el will then examine startup files, and eventually call the hooks | |
| 2286 which create the first window (s). | |
| 2287 *** term/wyse50.el | |
| 2288 Commentary: | |
| 2289 | |
| 2290 The Wyse50 is ergonomically wonderful, but its escape-sequence design sucks | |
| 2291 rocks. The left-arrow key emits a backspace (!) and the down-arrow a line | |
| 2292 feed (!!). Thus, you have to unbind some commonly-used Emacs keys to | |
| 2293 enable the arrows. | |
| 2294 *** term/xterm.el Can't find any Commentary section | |
| 2295 | |
| 2296 ** tl - Tiny Library (Part of the Tools for MIME). | |
| 2297 *** tl/bitmap.el Can't find any Commentary section | |
| 2298 *** tl/cless.el Can't find any Commentary section | |
| 2299 *** tl/emu-e19.el Can't find any Commentary section | |
| 2300 *** tl/emu-orig.el Can't find any Commentary section | |
| 2301 *** tl/emu-xemacs.el Can't find any Commentary section | |
| 2302 *** tl/emu.el Can't find any Commentary section | |
| 2303 *** tl/file-detect.el Can't find any Commentary section | |
| 2304 *** tl/filename.el Can't find any Commentary section | |
| 2305 *** tl/mu-cite.el | |
| 2306 Commentary: | |
| 2307 *** tl/mu-comment.el | |
| 2308 Commentary: | |
| 2309 | |
| 2310 type `C-c C-q' at the beginning of S-expression you want to | |
| 2311 comment out. | |
| 2312 *** tl/mu-replace.el | |
| 2313 Commentary: | |
| 2314 *** tl/range.el Can't find any Commentary section | |
| 2315 *** tl/richtext.el Can't find any Commentary section | |
| 2316 *** tl/std11-parse.el Can't find any Commentary section | |
| 2317 *** tl/std11.el Can't find any Commentary section | |
| 2318 *** tl/texi-util.el Can't find any Commentary section | |
| 2319 *** tl/tinyrich.el Can't find any Commentary section | |
| 2320 *** tl/tl-822.el Can't find any Commentary section | |
| 2321 *** tl/tl-atype.el Can't find any Commentary section | |
| 2322 *** tl/tl-list.el Can't find any Commentary section | |
| 2323 *** tl/tl-misc.el Can't find any Commentary section | |
| 2324 *** tl/tl-num.el Can't find any Commentary section | |
| 2325 *** tl/tl-seq.el Can't find any Commentary section | |
| 2326 *** tl/tl-str.el Can't find any Commentary section | |
| 2327 *** tl/tu-comment.el | |
| 2328 Commentary: | |
| 2329 *** tl/tu-replace.el | |
| 2330 Commentary: | |
| 2331 | |
| 2332 ** tm - Tools for MIME -- integrates in VM, RMAIL, GNUS | |
| 2333 *** tm/gnus-art-mime.el Can't find any Commentary section | |
| 2334 *** tm/gnus-charset.el Can't find any Commentary section | |
| 2335 *** tm/gnus-mime-old.el Can't find any Commentary section | |
| 2336 *** tm/gnus-mime.el Can't find any Commentary section | |
| 2337 *** tm/gnus-msg-mime.el Can't find any Commentary section | |
| 2338 *** tm/gnus-sum-mime.el Can't find any Commentary section | |
| 2339 *** tm/message-mime.el Can't find any Commentary section | |
| 2340 *** tm/mime-setup.el Can't find any Commentary section | |
| 2341 *** tm/sc-setup.el Can't find any Commentary section | |
| 2342 *** tm/signature.el Can't find any Commentary section | |
| 2343 *** tm/tm-bbdb.el Can't find any Commentary section | |
| 2344 *** tm/tm-def.el Can't find any Commentary section | |
| 2345 *** tm/tm-edit-mc.el Can't find any Commentary section | |
| 2346 *** tm/tm-edit.el | |
| 2347 Commentary: | |
| 2348 | |
| 2349 This is an Emacs minor mode for editing Internet multimedia | |
| 2350 messages formatted in MIME (RFC 2045, 2046, 2047, 2048 and 2049). | |
| 2351 All messages in this mode are composed in the tagged MIME format, | |
| 2352 that are described in the following examples. The messages | |
| 2353 composed in the tagged MIME format are automatically translated | |
| 2354 into a MIME compliant message when exiting the mode. | |
| 2355 *** tm/tm-ew-d.el Can't find any Commentary section | |
| 2356 *** tm/tm-ew-e.el Can't find any Commentary section | |
| 2357 *** tm/tm-file.el Can't find any Commentary section | |
| 2358 *** tm/tm-ftp.el Can't find any Commentary section | |
| 2359 *** tm/tm-gd3.el Can't find any Commentary section | |
| 2360 *** tm/tm-gnus.el Can't find any Commentary section | |
| 2361 *** tm/tm-gnus4.el Can't find any Commentary section | |
| 2362 *** tm/tm-gnus5.el Can't find any Commentary section | |
| 2363 *** tm/tm-html.el Can't find any Commentary section | |
| 2364 *** tm/tm-image.el | |
| 2365 Commentary: | |
| 2366 If you use this program with MULE, please install | |
| 2367 etl8x16-bitmap.bdf font included in tl package. | |
| 2368 *** tm/tm-latex.el Can't find any Commentary section | |
| 2369 *** tm/tm-mail.el Can't find any Commentary section | |
| 2370 *** tm/tm-mh-e.el Can't find any Commentary section | |
| 2371 *** tm/tm-orig.el Can't find any Commentary section | |
| 2372 *** tm/tm-parse.el Can't find any Commentary section | |
| 2373 *** tm/tm-partial.el Can't find any Commentary section | |
| 2374 *** tm/tm-pgp.el | |
| 2375 Commentary: | |
| 2376 | |
| 2377 This module is based on 2 drafts about PGP MIME integration: | |
| 2378 *** tm/tm-play.el Can't find any Commentary section | |
| 2379 *** tm/tm-rmail.el Can't find any Commentary section | |
| 2380 *** tm/tm-setup.el Can't find any Commentary section | |
| 2381 *** tm/tm-sgnus.el Can't find any Commentary section | |
| 2382 *** tm/tm-tar.el Can't find any Commentary section | |
| 2383 *** tm/tm-text.el Can't find any Commentary section | |
| 2384 *** tm/tm-view.el Can't find any Commentary section | |
| 2385 *** tm/tm-vm.el | |
| 2386 Commentary: | |
| 2387 | |
| 2388 Plese insert `(require 'tm-vm)' in your ~/.vm file. | |
| 2389 *** tm/tmh-comp.el Can't find any Commentary section | |
| 2390 | |
| 2391 ** tooltalk - Support for Tooltalk protocol | |
| 2392 *** tooltalk/tooltalk-init.el Can't find any Commentary section | |
| 2393 *** tooltalk/tooltalk-load.el Can't find any Commentary section | |
| 2394 *** tooltalk/tooltalk-macros.el Can't find any Commentary section | |
| 2395 *** tooltalk/tooltalk-util.el Can't find any Commentary section | |
| 2396 | |
| 2397 ** utils - Lots of stuff | |
| 2398 *** utils/abbrevlist.el Can't find any Commentary section | |
| 2399 *** utils/advice.el | |
| 2400 Commentary: | |
| 2401 | |
| 2402 This package implements a full-fledged Lisp-style advice mechanism | |
| 2403 for Emacs Lisp. Advice is a clean and efficient way to modify the | |
| 2404 behavior of Emacs Lisp functions without having to keep personal | |
| 2405 modified copies of such functions around. A great number of such | |
| 2406 modifications can be achieved by treating the original function as a | |
| 2407 black box and specifying a different execution environment for it | |
| 2408 with a piece of advice. Think of a piece of advice as a kind of fancy | |
| 2409 hook that you can attach to any function/macro/subr. | |
| 2410 *** utils/annotations.el Can't find any Commentary section | |
| 2411 *** utils/assoc.el | |
| 2412 Commentary: | |
| 2413 | |
| 2414 Association list utilities providing insertion, deletion, sorting | |
| 2415 fetching off key-value pairs in association lists. | |
| 2416 *** utils/atomic-extents.el Can't find any Commentary section | |
| 2417 *** utils/autoload.el | |
| 2418 Commentary: | |
| 2419 | |
| 2420 This code helps GNU Emacs maintainers keep the loaddefs.el file up to | |
| 2421 date. It interprets magic cookies of the form ";;;###autoload" in | |
| 2422 lisp source files in various useful ways. To learn more, read the | |
| 2423 source; if you're going to use this, you'd better be able to. | |
| 2424 *** utils/bench.el | |
| 2425 Commentary: | |
| 2426 | |
| 2427 Adapted from Shane Holder's bench.el by steve@xemacs.org. | |
| 2428 | |
| 2429 To run | |
| 2430 Extract the shar file in /tmp, or modify bench-lisp-file to | |
| 2431 point to the gnus.el file. | |
| 2432 At the shell prompt emacs -q --no-site-file <= don't load users .emacs or site- | |
| 2433 file | |
| 2434 M-x byte-compile-file "/tmp/bench.el" | |
| 2435 M-x load-file "/tmp/bench.elc" | |
| 2436 In the scratch buffer (bench 1) | |
| 2437 | |
| 2438 | |
| 2439 All bench marks must be named bench-mark-<something> | |
| 2440 Results are put in bench-mark-<something-times which is a list of | |
| 2441 times for the runs. | |
| 2442 If the bench mark is not simple then there needs to be a | |
| 2443 corresponding bench-handler-<something> | |
| 2444 *** utils/blessmail.el | |
| 2445 Commentary: | |
| 2446 | |
| 2447 This is loaded into a bare Emacs to create the blessmail script, | |
| 2448 which (on systems that need it) is used during installation | |
| 2449 to give appropriate permissions to movemail. | |
| 2450 | |
| 2451 It has to be done from lisp in order to be sure of getting the | |
| 2452 correct value of rmail-spool-directory. | |
| 2453 *** utils/browse-cltl2.el Can't find any Commentary section | |
| 2454 *** utils/browse-url.el | |
| 2455 Commentary: | |
| 2456 | |
| 2457 This package provides functions which read a URL (Uniform Resource | |
| 2458 Locator) from the minibuffer, defaulting to the URL around point, | |
| 2459 and ask a World-Wide Web browser to load it. It can also load the | |
| 2460 URL associated with the current buffer. Different browsers use | |
| 2461 different methods of remote control so there is one function for | |
| 2462 each supported browser. If the chosen browser is not running, it | |
| 2463 is started. Currently there is support for: | |
| 2464 | |
| 2465 *** utils/crontab.el Can't find any Commentary section | |
| 2466 *** utils/delbackspace.el Can't find any Commentary section | |
| 2467 *** utils/derived.el | |
| 2468 Commentary: | |
| 2469 | |
| 2470 GNU Emacs is already, in a sense, object oriented -- each object | |
| 2471 (buffer) belongs to a class (major mode), and that class defines | |
| 2472 the relationship between messages (input events) and methods | |
| 2473 (commands) by means of a keymap. | |
| 2474 | |
| 2475 In the mean time, this package offers most of the advantages of | |
| 2476 full inheritance with the existing major modes. The macro | |
| 2477 `define-derived-mode' allows the user to make a variant of an existing | |
| 2478 major mode, with its own keymap. The new mode will inherit the key | |
| 2479 bindings of its parent, and will, in fact, run its parent first | |
| 2480 every time it is called. For example, the commands | |
| 2481 *** utils/detached-minibuf.el | |
| 2482 Commentary: | |
| 2483 | |
| 2484 WARNING. DANGER. This file reportedly crashes 19.14, use it only with a | |
| 2485 recent XEmacs. | |
| 2486 | |
| 2487 Version: 1.1 | |
| 2488 *** utils/docref.el | |
| 2489 Commentary: | |
| 2490 | |
| 2491 This package allows you to use a simple form of cross references in | |
| 2492 your Emacs Lisp documentation strings. Cross-references look like | |
| 2493 \\(type@[label@]data), where type defines a method for retrieving | |
| 2494 reference informatin, data is used by a method routine as an argument, | |
| 2495 and label "represents" the reference in text. If label is absent, data | |
| 2496 is used instead. | |
| 2497 *** utils/easymenu.el Can't find any Commentary section | |
| 2498 *** utils/edmacro.el | |
| 2499 Commentary: | |
| 2500 | |
| 2501 Usage: | |
| 2502 | |
| 2503 The `C-x C-k' (`edit-kbd-macro') command edits a keyboard macro | |
| 2504 in a special buffer. It prompts you to type a key sequence, | |
| 2505 which should be one of: | |
| 2506 *** utils/eldoc.el | |
| 2507 Commentary: | |
| 2508 | |
| 2509 This program was inspired by the behavior of the "mouse documentation | |
| 2510 window" on many Lisp Machine systems; as you type a function's symbol | |
| 2511 name as part of a sexp, it will print the argument list for that | |
| 2512 function. Behavior is not identical; for example, you need not actually | |
| 2513 type the function name, you need only move point around in a sexp that | |
| 2514 calls it. Also, if point is over a documented variable, it will print | |
| 2515 the one-line documentation for that variable instead, to remind you of | |
| 2516 that variable's meaning. | |
| 2517 *** utils/elp.el | |
| 2518 Commentary: | |
| 2519 | |
| 2520 If you want to profile a bunch of functions, set elp-function-list | |
| 2521 to the list of symbols, then do a M-x elp-instrument-list. This | |
| 2522 hacks those functions so that profiling information is recorded | |
| 2523 whenever they are called. To print out the current results, use | |
| 2524 M-x elp-results. If you want output to go to standard-output | |
| 2525 instead of a separate buffer, setq elp-use-standard-output to | |
| 2526 non-nil. With elp-reset-after-results set to non-nil, profiling | |
| 2527 information will be reset whenever the results are displayed. You | |
| 2528 can also reset all profiling info at any time with M-x | |
| 2529 elp-reset-all. | |
| 2530 *** utils/facemenu.el | |
| 2531 Commentary: | |
| 2532 | |
| 2533 This file defines a menu of faces (bold, italic, etc) which allows you to | |
| 2534 set the face used for a region of the buffer. Some faces also have | |
| 2535 keybindings, which are shown in the menu. Faces with names beginning with | |
| 2536 "fg:" or "bg:", as in "fg:red", are treated specially. | |
| 2537 Such faces are assumed to consist only of a foreground (if "fg:") or | |
| 2538 background (if "bg:") color. They are thus put into the color submenus | |
| 2539 rather than the general Face submenu. These faces can also be | |
| 2540 automatically created by selecting the "Other..." menu items in the | |
| 2541 "Foreground" and "Background" submenus. | |
| 2542 *** utils/find-gc.el | |
| 2543 Commentary: | |
| 2544 | |
| 2545 Produce in unsafe-list the set of all functions that may invoke GC. | |
| 2546 This expects the Emacs sources to live in emacs-source-directory. | |
| 2547 It creates a temporary working directory /tmp/esrc. | |
| 2548 *** utils/finder.el | |
| 2549 Commentary: | |
| 2550 | |
| 2551 This mode uses the Keywords library header to provide code-finding | |
| 2552 services by keyword. | |
| 2553 *** utils/floating-toolbar.el | |
| 2554 Commentary: | |
| 2555 | |
| 2556 The command `floating-toolbar' pops up a small frame | |
| 2557 containing a toolbar. The command should be bound to a | |
| 2558 button-press event. If the mouse press happens over an | |
| 2559 extent that has a non-nil 'floating-toolbar property, the | |
| 2560 value of that property is the toolbar instantiator that will | |
| 2561 be displayed. Otherwise the toolbar displayed is taken from | |
| 2562 the variable `floating-toolbar'. This variable can be made | |
| 2563 buffer local to produce buffer local floating toolbars. | |
| 2564 *** utils/flow-ctrl.el | |
| 2565 Commentary: | |
| 2566 | |
| 2567 Terminals that use XON/XOFF flow control can cause problems with | |
| 2568 GNU Emacs users. This file contains Emacs Lisp code that makes it | |
| 2569 easy for a user to deal with this problem, when using such a | |
| 2570 terminal. | |
| 2571 | |
| 2572 *** utils/foldout.el | |
| 2573 Commentary: | |
| 2574 | |
| 2575 This file provides folding editor extensions for outline-mode and | |
| 2576 outline-minor-mode buffers. What's a "folding editor"? Read on... | |
| 2577 | |
| 2578 Imagine you're in an outline-mode buffer and you've hidden all the text and | |
| 2579 subheadings under your level-1 headings. You now want to look at the stuff | |
| 2580 hidden under one of these headings. Normally you'd do C-c C-e (show-entry) | |
| 2581 to expose the body or C-c C-i to expose the child (level-2) headings. | |
| 2582 | |
| 2583 With foldout, you do C-c C-z (foldout-zoom-subtree). This exposes the body | |
| 2584 and child subheadings and narrows the buffer so that only the level-1 | |
| 2585 heading, the body and the level-2 headings are visible. If you now want to | |
| 2586 look under one of the level-2 headings, position the cursor on it and do C-c | |
| 2587 C-z again. This exposes the level-2 body and its level-3 child subheadings | |
| 2588 and narrows the buffer again. You can keep on zooming in on successive | |
| 2589 subheadings as much as you like. A string in the modeline tells you how | |
| 2590 deep you've gone. | |
| 2591 *** utils/forms-d2.el Can't find any Commentary section | |
| 2592 *** utils/forms-pass.el Can't find any Commentary section | |
| 2593 *** utils/forms.el | |
| 2594 Commentary: | |
| 2595 | |
| 2596 Visit a file using a form. | |
| 2597 | |
| 2598 Forms mode means visiting a data file which is supposed to consist | |
| 2599 of records each containing a number of fields. The records are | |
| 2600 separated by a newline, the fields are separated by a user-defined | |
| 2601 field separator (default: TAB). | |
| 2602 When shown, a record is transferred to an Emacs buffer and | |
| 2603 presented using a user-defined form. One record is shown at a | |
| 2604 time. | |
| 2605 *** utils/frame-icon.el | |
| 2606 Commentary: | |
| 2607 *** utils/hide-copyleft.el Can't find any Commentary section | |
| 2608 *** utils/highlight-headers.el Can't find any Commentary section | |
| 2609 *** utils/id-select.el Can't find any Commentary section | |
| 2610 *** utils/lib-complete.el Can't find any Commentary section | |
| 2611 *** utils/live-icon.el Can't find any Commentary section | |
| 2612 *** utils/loadhist.el | |
| 2613 Commentary: | |
| 2614 | |
| 2615 These functions exploit the load-history system variable. | |
| 2616 *** utils/mail-extr.el | |
| 2617 Commentary: | |
| 2618 | |
| 2619 mail-extract-address-components: (address) | |
| 2620 | |
| 2621 Given an RFC-822 ADDRESS, extract full name and canonical address. | |
| 2622 Returns a list of the form (FULL-NAME CANONICAL-ADDRESS). | |
| 2623 If no name can be extracted, FULL-NAME will be nil. | |
| 2624 ADDRESS may be a string or a buffer. If it is a buffer, the visible | |
| 2625 (narrowed) portion of the buffer will be interpreted as the address. | |
| 2626 (This feature exists so that the clever caller might be able to avoid | |
| 2627 consing a string.) | |
| 2628 If ADDRESS contains more than one RFC-822 address, only the first is | |
| 2629 returned. | |
| 2630 | |
| 2631 *** utils/mail-utils.el | |
| 2632 Commentary: | |
| 2633 | |
| 2634 Utility functions for mail and netnews handling. These handle fine | |
| 2635 points of header parsing. | |
| 2636 *** utils/mailpost.el | |
| 2637 Commentary: | |
| 2638 | |
| 2639 Yet another mail interface. this for the rmail system to provide | |
| 2640 the missing sendmail interface on systems without /usr/lib/sendmail, | |
| 2641 but with /usr/uci/post. | |
| 2642 *** utils/map-ynp.el | |
| 2643 Commentary: | |
| 2644 | |
| 2645 map-y-or-n-p is a general-purpose question-asking function. | |
| 2646 It asks a series of y/n questions (a la y-or-n-p), and decides to | |
| 2647 applies an action to each element of a list based on the answer. | |
| 2648 The nice thing is that you also get some other possible answers | |
| 2649 to use, reminiscent of query-replace: ! to answer y to all remaining | |
| 2650 questions; ESC or q to answer n to all remaining questions; . to answer | |
| 2651 y once and then n for the remainder; and you can get help with C-h. | |
| 2652 *** utils/meese.el | |
| 2653 Commentary: | |
| 2654 This file is grossly misnamed. It should be called reno.el. | |
| 2655 *** utils/passwd.el Can't find any Commentary section | |
| 2656 *** utils/pp.el Can't find any Commentary section | |
| 2657 *** utils/pretty-print.el Can't find any Commentary section | |
| 2658 *** utils/redo.el | |
| 2659 Commentary: | |
| 2660 | |
| 2661 Emacs' normal undo system allows you to undo an arbitrary | |
| 2662 number of buffer changes. These undos are recorded as ordinary | |
| 2663 buffer changes themselves. So when you break the chain of | |
| 2664 undos by issuing some other command, you can then undo all | |
| 2665 the undos. The chain of recorded buffer modifications | |
| 2666 therefore grows without bound, truncated only at garbage | |
| 2667 collection time. | |
| 2668 | |
| 2669 *** utils/regi.el Can't find any Commentary section | |
| 2670 *** utils/reporter.el | |
| 2671 Commentary: | |
| 2672 Lisp Package Authors | |
| 2673 ==================== | |
| 2674 Reporter was written primarily for Emacs Lisp package authors so | |
| 2675 that their users can easily report bugs. When invoked, | |
| 2676 reporter-submit-bug-report will set up an outgoing mail buffer with | |
| 2677 the appropriate bug report address, including a lisp expression the | |
| 2678 maintainer of the package can eval to completely reproduce the | |
| 2679 environment in which the bug was observed (e.g. by using | |
| 2680 eval-last-sexp). This package proved especially useful during my | |
| 2681 development of cc-mode, which is highly dependent on its | |
| 2682 configuration variables. | |
| 2683 *** utils/rfc822.el Can't find any Commentary section | |
| 2684 *** utils/ring.el | |
| 2685 Commentary: | |
| 2686 | |
| 2687 This code defines a ring data structure. A ring is a | |
| 2688 (hd-index length . vector) | |
| 2689 list. You can insert to, remove from, and rotate a ring. When the ring | |
| 2690 fills up, insertions cause the oldest elts to be quietly dropped. | |
| 2691 *** utils/shadowfile.el Can't find any Commentary section | |
| 2692 *** utils/skeleton.el | |
| 2693 Commentary: | |
| 2694 | |
| 2695 A very concise language extension for writing structured statement | |
| 2696 skeleton insertion commands for programming language modes. This | |
| 2697 originated in shell-script mode and was applied to ada-mode's | |
| 2698 commands which shrunk to one third. And these commands are now | |
| 2699 user configurable. | |
| 2700 *** utils/smtpmail.el | |
| 2701 Commentary: | |
| 2702 | |
| 2703 Send Mail to smtp host from smtpmail temp buffer. | |
| 2704 *** utils/soundex.el | |
| 2705 Commentary: | |
| 2706 | |
| 2707 The Soundex algorithm maps English words into representations of | |
| 2708 how they sound. Words with vaguely similar sound map to the same string. | |
| 2709 *** utils/speedbar.el | |
| 2710 Commentary: | |
| 2711 | |
| 2712 The speedbar provides a frame in which files, and locations in | |
| 2713 files are displayed. These items can be clicked on with mouse-2 | |
| 2714 in order to make the last active frame display that file location. | |
| 2715 *** utils/symbol-syntax.el Can't find any Commentary section | |
| 2716 *** utils/sysdep.el Can't find any Commentary section | |
| 2717 *** utils/text-props.el | |
| 2718 Commentary: | |
| 2719 | |
| 2720 This is a nearly complete implementation of the FSF19 text properties API. | |
| 2721 Please let me know if you notice any differences in behavior between | |
| 2722 this implementation and the FSF implementation. | |
| 2723 *** utils/thing.el Can't find any Commentary section | |
| 2724 *** utils/timezone.el Can't find any Commentary section | |
| 2725 *** utils/tq.el | |
| 2726 Commentary: | |
| 2727 | |
| 2728 manages receiving a stream asynchronously, | |
| 2729 parsing it into transactions, and then calling | |
| 2730 handler functions | |
| 2731 | |
| 2732 Our basic structure is the queue/process/buffer triple. Each entry | |
| 2733 of the queue is a regexp/closure/function triple. We buffer | |
| 2734 bytes from the process until we see the regexp at the head of the | |
| 2735 queue. Then we call the function with the closure and the | |
| 2736 collected bytes. | |
| 2737 *** utils/trace.el | |
| 2738 Commentary: | |
| 2739 | |
| 2740 A simple trace package that utilizes advice.el. It generates trace | |
| 2741 information in a Lisp-style fashion and inserts it into a trace output | |
| 2742 buffer. Tracing can be done in the background (or silently) so that | |
| 2743 generation of trace output won't interfere with what you are currently | |
| 2744 doing. | |
| 2745 *** utils/tree-menu.el Can't find any Commentary section | |
| 2746 *** utils/uniquify.el | |
| 2747 Commentary: | |
| 2748 | |
| 2749 Emacs's standard method for making buffer names unique adds <2>, <3>, | |
| 2750 etc. to the end of (all but one of) the buffers. This file replaces | |
| 2751 that behavior, for buffers visiting files and dired buffers, with a | |
| 2752 uniquification that adds parts of the file name until the buffer names | |
| 2753 are unique. For instance, buffers visiting /u/mernst/tmp/Makefile and | |
| 2754 /usr/projects/zaphod/Makefile would be named Makefile|tmp and | |
| 2755 Makefile|zaphod, respectively (instead of Makefile and Makefile<2>). | |
| 2756 Other buffer name styles are also available. | |
| 2757 *** utils/xbm-button.el Can't find any Commentary section | |
| 2758 *** utils/xpm-button.el Can't find any Commentary section | |
| 2759 | |
| 2760 ** viper - VI emulator | |
| 2761 *** viper/viper-ex.el Can't find any Commentary section | |
| 2762 *** viper/viper-init.el Can't find any Commentary section | |
| 2763 *** viper/viper-keym.el Can't find any Commentary section | |
| 2764 *** viper/viper-macs.el Can't find any Commentary section | |
| 2765 *** viper/viper-mous.el Can't find any Commentary section | |
| 2766 *** viper/viper-util.el Can't find any Commentary section | |
| 2767 *** viper/viper.el Can't find any Commentary section | |
| 2768 | |
| 2769 ** vm - Mail reader | |
| 2770 See the online documentation. | |
| 2771 | |
| 2772 ** vms - Stuff for Emacs under VMS | |
| 2773 vms/vms-patch.el Can't find any Commentary section | |
| 2774 *** vms/vmsproc.el Can't find any Commentary section | |
| 2775 *** vms/vmsx.el Can't find any Commentary section | |
| 2776 | |
| 2777 ** w3 - World Wide Web browser under Emacs | |
| 2778 See the online documentation. | |
| 2779 | |
| 2780 ** x11 - X11 specific stuff: compose keys, menubars, toolbar, ... | |
| 2781 *** x11/x-compose.el Can't find any Commentary section | |
| 2782 *** x11/x-faces.el Can't find any Commentary section | |
| 2783 *** x11/x-font-menu.el | |
| 2784 Commentary: | |
| 2785 | |
| 2786 Creates three menus, "Font", "Size", and "Weight", and puts them on the | |
| 2787 "Options" menu. The contents of these menus are the superset of those | |
| 2788 properties available on any fonts, but only the intersection of the three | |
| 2789 sets is selectable at one time. | |
| 2790 *** x11/x-init.el | |
| 2791 Commentary: | |
| 2792 *** x11/x-iso8859-1.el Can't find any Commentary section | |
| 2793 *** x11/x-menubar.el | |
| 2794 Commentary: | |
| 2795 *** x11/x-misc.el Can't find any Commentary section | |
| 2796 *** x11/x-mouse.el Can't find any Commentary section | |
| 2797 *** x11/x-scrollbar.el Can't find any Commentary section | |
| 2798 *** x11/x-select.el Can't find any Commentary section | |
| 2799 *** x11/x-toolbar.el Can't find any Commentary section | |
| 2800 *** x11/x-win-sun.el | |
| 2801 Commentary: | |
| 2802 | |
| 2803 This file is loaded by x-win.el at run-time when we are sure that XEmacs | |
| 2804 is running on the display of a Sun. | |
| 2805 | |
| 2806 The Sun X server (both the MIT and OpenWindows varieties) have extremely | |
| 2807 stupid names for their keypad and function keys. For example, the key | |
| 2808 labeled 3 / PgDn, with R15 written on the front, is actually called F35. | |
| 2809 *** x11/x-win-xfree86.el Can't find any Commentary section | |
| 2810 | |
| 2811 | |
| 2812 * What Changed | |
| 2813 =================== | |
| 2814 | |
| 2815 | |
| 2816 ** Differences between XEmacs and GNU Emacs 19 | |
| 2817 ================================================== | |
| 2818 | |
| 2819 In XEmacs, events are first-class objects. FSF 19 represents them as | |
| 2820 integers, which obscures the differences between a key gesture and the | |
| 2821 ancient ASCII code used to represent a particular overlapping subset of them. | |
| 2822 | |
| 2823 In XEmacs, keymaps are first-class opaque objects. FSF 19 represents them as | |
| 2824 complicated combinations of association lists and vectors. If you use the | |
| 2825 advertised functional interface to manipulation of keymaps, the same code | |
| 2826 will work in XEmacs, Emacs 18, and GNU Emacs 19; if your code depends | |
| 2827 on the underlying implementation of keymaps, it will not. | |
| 2828 | |
| 2829 XEmacs uses "extents" to represent all non-textual aspects of buffers; | |
| 2830 FSF 19 uses two distinct objects, "text properties" and "overlays", | |
| 2831 which divide up the functionality between them. Extents are a | |
| 2832 superset of the functionality of the two FSF data types. The full FSF | |
| 2833 19 interface to text properties is supported in XEmacs (with extents | |
| 2834 being the underlying representation). | |
| 2835 | |
| 2836 Extents can be made to be copied into strings, and thus restored by kill | |
| 2837 and yank. Thus, one can specify this behavior on either "extents" or | |
| 2838 "text properties", whereas in FSF 19 text properties always have this | |
| 2839 behavior and overlays never do. | |
| 2840 | |
| 2841 Many more packages are provided standard with XEmacs than with FSF 19. | |
| 2842 | |
| 2843 Pixmaps of arbitrary size can be embedded in a buffer. | |
| 2844 | |
| 2845 Variable width fonts work. | |
| 2846 | |
| 2847 The height of a line is the height of the tallest font on that line, instead | |
| 2848 of all lines having the same height. | |
| 2849 | |
| 2850 XEmacs uses the MIT "Xt" toolkit instead of raw Xlib calls, which | |
| 2851 makes it be a more well-behaved X citizen (and also improves | |
| 2852 portability). A result of this is that it is possible to include | |
| 2853 other Xt "Widgets" in the XEmacs window. Also, XEmacs understands the | |
| 2854 standard Xt command-line arguments. | |
| 2855 | |
| 2856 XEmacs provides support for ToolTalk on systems that have it. | |
| 2857 | |
| 2858 XEmacs can ask questions using popup dialog boxes. Any command executed from | |
| 2859 a menu will ask yes/no questions with dialog boxes, while commands executed | |
| 2860 via the keyboard will use the minibuffer. | |
| 2861 | |
| 2862 XEmacs has a built-in toolbar. Four toolbars can actually be configured: | |
| 2863 top, bottom, left, and right toolbars. | |
| 2864 | |
| 2865 XEmacs has vertical and horizontal scrollbars. Unlike in FSF 19 (which | |
| 2866 provides a primitive form of vertical scrollbar), these are true toolkit | |
| 2867 scrollbars. A look-alike Motif scrollbar is provided for those who | |
| 2868 don't have Motif. (Even for those who do, the look-alike may be preferable | |
| 2869 as it is faster.) | |
| 2870 | |
| 2871 If you're running on a machine with audio hardware, you can specify sound | |
| 2872 files for XEmacs to play instead of the default X beep. See the documentation | |
| 2873 of the function load-sound-file and the variable sound-alist. | |
| 2874 | |
| 2875 An XEmacs frame can be placed within an "external client widget" managed by | |
| 2876 another application. This allows an application to use an XEmacs frame as its | |
| 2877 text pane rather than the standard Text widget that is provided with Motif or | |
| 2878 Athena. XEmacs supports Motif applications, generic Xt (e.g. Athena) | |
| 2879 applications, and raw Xlib applications. | |
| 2880 | |
| 2881 Here are some more specifics about the XEmacs implementation: | |
| 2882 | |
| 2883 *** The Input Model | |
| 2884 ------------------- | |
| 2885 | |
| 2886 The fundamental unit of input is an "event" instead of a character. An | |
| 2887 event is a new data type that contains several pieces of information. | |
| 2888 There are several kinds of event, and corresponding accessor and utility | |
| 2889 functions. We tried to abstract them so that they would apply equally | |
| 2890 well to a number of window systems. | |
| 2891 | |
| 2892 NOTE: All timestamps are measured as milliseconds since Emacs started. | |
| 2893 | |
| 2894 key_press_event | |
| 2895 event_channel A token representing which keyboard generated it. | |
| 2896 For this kind of event, this is a frame object. | |
| 2897 (This is for eventual support of multiple displays.) | |
| 2898 timestamp When it happened | |
| 2899 key What keysym this is; an integer or a symbol. | |
| 2900 If this is an integer, it will be in the printing | |
| 2901 ASCII range: >32 and <127. | |
| 2902 modifiers Bucky-bits on that key: control, meta, etc. | |
| 2903 For most keys, Shift is not a bit; that is implicit | |
| 2904 in the keyboard layout. | |
| 2905 | |
| 2906 button_press_event | |
| 2907 button_release_event | |
| 2908 event_channel A token representing which mouse generated it. | |
| 2909 For this kind of event, this is a frame object. | |
| 2910 timestamp When it happened | |
| 2911 button What button went down or up. | |
| 2912 modifiers Bucky-bits on that button: shift, control, meta, etc. | |
| 2913 x, y Where it was at the button-state-change (in pixels). | |
| 2914 | |
| 2915 pointer_motion_event | |
| 2916 event_channel A token representing which mouse generated it. | |
| 2917 For this kind of event, this is a frame object. | |
| 2918 timestamp When it happened | |
| 2919 x, y Where it was after it moved (in pixels). | |
| 2920 modifiers Bucky-bits down when the motion was detected. | |
| 2921 (Possibly not all window systems will provide this?) | |
| 2922 | |
| 2923 process_event | |
| 2924 timestamp When it happened | |
| 2925 process the emacs "process" object in question | |
| 2926 | |
| 2927 timeout_event | |
| 2928 timestamp Now (really, when the timeout was signaled) | |
| 2929 interval_id The ID returned when the associated call to | |
| 2930 add_timeout_cb() was made | |
| 2931 ------ the rest of the fields are filled in by Emacs ----- | |
| 2932 id_number The Emacs timeout ID for this timeout (more | |
| 2933 than one timeout event can have the same value | |
| 2934 here, since Emacs timeouts, as opposed to | |
| 2935 add_timeout_cb() timeouts, can resignal | |
| 2936 themselves) | |
| 2937 function An elisp function to call when this timeout is | |
| 2938 processed. | |
| 2939 object The object passed to that function. | |
| 2940 | |
| 2941 eval_event | |
| 2942 timestamp When it happened | |
| 2943 function An elisp function to call with this event object. | |
| 2944 object Anything. | |
| 2945 This kind of event is used internally; sometimes the | |
| 2946 window system interface would like to inform emacs of | |
| 2947 some user action (such as focusing on another frame) | |
| 2948 but needs that to happen synchronously with the other | |
| 2949 user input, like keypresses. This is useful when | |
| 2950 events are reported through callbacks rather | |
| 2951 than in the standard event stream. | |
| 2952 | |
| 2953 misc_user_event | |
| 2954 timestamp When it happened | |
| 2955 function An elisp function to call with this event object. | |
| 2956 object Anything. | |
| 2957 This is similar to an eval_event, except that it is | |
| 2958 generated by user actions: selections in the | |
| 2959 menubar or scrollbar actions. It is a "command" | |
| 2960 event, like key and mouse presses (and unlike mouse | |
| 2961 motion, process output, and enter and leave window | |
| 2962 hooks). In many ways, eval_events are not the same | |
| 2963 as keypresses or misc_user_events. | |
| 2964 | |
| 2965 magic_event | |
| 2966 No user-serviceable parts within. This is for things | |
| 2967 like KeymapNotify and ExposeRegion events and so on | |
| 2968 that emacs itself doesn't care about, but which it | |
| 2969 must do something with for proper interaction with | |
| 2970 the window system. | |
| 2971 | |
| 2972 Magic_events are handled somewhat asynchronously, just | |
| 2973 like subprocess filters. However, occasionally a | |
| 2974 magic_event needs to be handled synchronously; in that | |
| 2975 case, the asynchronous handling of the magic_event will | |
| 2976 push an eval_event back onto the queue, which will be | |
| 2977 handled synchronously later. This is one of the | |
| 2978 reasons why eval_events exist; I'm not entirely happy | |
| 2979 with this aspect of this event model. | |
| 2980 | |
| 2981 | |
| 2982 The function `next-event' blocks and returns one of the above-described | |
| 2983 event objects. The function `dispatch-event' takes an event and processes | |
| 2984 it in the appropriate way. | |
| 2985 | |
| 2986 For a process-event, dispatch-event calls the process's handler; for a | |
| 2987 mouse-motion event, the mouse-motion-handler hook is called, and so on. | |
| 2988 For magic-events, dispatch-event does window-system-dependent things, | |
| 2989 including calling some non-window-system-dependent hooks: map-frame-hook, | |
| 2990 unmap-frame-hook, mouse-enter-frame-hook, and mouse-leave-frame-hook. | |
| 2991 | |
| 2992 The function `next-command-event' calls `next-event' until it gets a key or | |
| 2993 button from the user (that is, not a process, motion, timeout, or magic | |
| 2994 event). If it gets an event that is not a key or button, it calls | |
| 2995 `dispatch-event' on it immediately and reads another one. The | |
| 2996 next-command-event function could be implemented in Emacs Lisp, though it | |
| 2997 isn't. Generally one should call `next-command-event' instead of | |
| 2998 `next-event'. | |
| 2999 | |
| 3000 read-char calls next-command-event; if it doesn't get an event that can be | |
| 3001 converted to an ASCII character, it signals an error. Otherwise it returns | |
| 3002 an integer. | |
| 3003 | |
| 3004 The variable `last-command-char' always contains an integer, or nil (if the | |
| 3005 last read event has no ASCII equivalent, as when it is a mouse-click or a | |
| 3006 non-ASCII character chord.) | |
| 3007 | |
| 3008 The new variable `last-command-event' holds an event object, that could be | |
| 3009 a non-ASCII character, a button click, a menu selection, etc. | |
| 3010 | |
| 3011 The variable `unread-command-char' no longer exists, and has been replaced | |
| 3012 by `unread-command-events'. With the new event model, it is incorrect for | |
| 3013 code to do (setq unread-command-char (read-char)), because all user-input | |
| 3014 can't be represented as ASCII characters. *** This is an incompatible | |
| 3015 change. Code which sets `unread-command-char' must be updated to use the | |
| 3016 combination of `next-command-event' and `unread-command-events' instead. | |
| 3017 | |
| 3018 The functions `this-command-keys' and `recent-keys' return a vector of | |
| 3019 event objects, instead of a string of ASCII characters. *** This also | |
| 3020 is an incompatible change. | |
| 3021 | |
| 3022 Almost nothing happens at interrupt level; the SIGIO handler simply sets a | |
| 3023 flag, and later, the X event queue is scanned for KeyPress events which map | |
| 3024 to ^G. All redisplay happens in the main thread of the process. | |
| 3025 | |
| 3026 | |
| 3027 *** Keymaps | |
| 3028 ----------- | |
| 3029 | |
| 3030 Instead of keymaps being alists or obarrays, they are a new primary data | |
| 3031 type. The only user access to the contents of a keymap is through the | |
| 3032 existing keymap-manipulation functions, and a new function, map-keymap. | |
| 3033 This means that existing code that manipulates keymaps may need to | |
| 3034 be changed. | |
| 3035 | |
| 3036 One of our goals with the new input and keymap code was to make more | |
| 3037 character combinations available for binding, besides just ASCII and | |
| 3038 function keys. We want to be able bind different commands to Control-a | |
| 3039 and Control-Shift-a; we also want it to be possible for the keys Control-h | |
| 3040 and Backspace (and Control-M and Return, and Control-I and Tab, etc) to | |
| 3041 be distinct. | |
| 3042 | |
| 3043 One of the most common complaints that new Emacs users have is that backspace | |
| 3044 is help. The answer is to play around with the keyboard-translate-table, or | |
| 3045 be lucky enough to have a system administrator who has done this for you | |
| 3046 already; but if it were possible to bind backspace and C-h to different | |
| 3047 things, then (under a window manager at least) both backspace and delete | |
| 3048 would delete a character, and ^H would be help. There's no need to deal | |
| 3049 with xmodmap, kbd-translate-table, etc. | |
| 3050 | |
| 3051 Here are some more examples: suppose you want to bind one function to Tab, | |
| 3052 and another to Control-Tab. This can't be done if Tab and Control-I are the | |
| 3053 same thing. What about control keys that have no ASCII equivalent, like | |
| 3054 Control-< ? One might want that to be bound to set-mark-at-point-min. We | |
| 3055 want M-C-Backspace to be kill-backward-sexp. But we want M-Backspace to be | |
| 3056 kill-backward-word. Again, this can't be done if Backspace and C-h are | |
| 3057 indistinguishable. | |
| 3058 | |
| 3059 The user represents keys as a string of ASCII characters (when possible and | |
| 3060 convenient), or as a vector of event objects, or as a vector of "key | |
| 3061 description lists", that looks like (control a), or (control meta delete) | |
| 3062 or (shift f1). The order of the modifier-names is not significant, so | |
| 3063 (meta control x) and (control meta x) are the same. | |
| 3064 | |
| 3065 `define-key' knows how to take any of the above representations and store them | |
| 3066 into a keymap. When Emacs wants to return a key sequence (this-command-keys, | |
| 3067 recent-keys, keyboard-macros, and read-key-sequence, for example) it returns | |
| 3068 a vector of event objects. Keyboard macros can also be represented as ASCII | |
| 3069 strings or as vectors of key description lists. | |
| 3070 | |
| 3071 This is an incompatible change: code which calls `this-command-keys', | |
| 3072 `recent-keys', `read-key-sequence', or manipulates keyboard-macros probably | |
| 3073 needs to be changed so that it no longer assumes that the returned value is a | |
| 3074 string. | |
| 3075 | |
| 3076 Control-Shift-a is specified as (control A), not (control shift a), since A | |
| 3077 is a two-case character. But for keys that don't have an upper case | |
| 3078 version, like F1, Backspace, and Escape, you use the (shift backspace) syntax. | |
| 3079 | |
| 3080 See the doc string for our version of define-key, reproduced below in the | |
| 3081 `Changed Functions' section. Note that when the KEYS argument is a string, | |
| 3082 it has the same semantics as the v18 define-key. | |
| 3083 | |
| 3084 | |
| 3085 *** Xt Integration | |
| 3086 ------------------ | |
| 3087 | |
| 3088 The heart of the event loop is implemented in terms of the Xt event functions | |
| 3089 (specifically XtAppProcessEvent), and uses Xt's concept of timeouts and | |
| 3090 file-descriptor callbacks, eliminating a large amount of system-dependent code | |
| 3091 (Xt does it for you.) | |
| 3092 | |
| 3093 If Emacs is compiled with support for X, it uses the Xt event loop even when | |
| 3094 Emacs is not running on an X display (the Xt event loop supports this). This | |
| 3095 makes it possible to run Emacs on a dumb TTY, and later connect it to one or | |
| 3096 more X servers. It should also be possible to later connect an existing Emacs | |
| 3097 process to additional TTY's, although this code is still experimental. (Our | |
| 3098 intent at this point is not to have an Emacs that is being used by multiple | |
| 3099 people at the same time: it is to make it possible for someone to go home, log | |
| 3100 in on a dialup line, and connect to the same Emacs process that is running | |
| 3101 under X in their office without having to recreate their buffer state and so | |
| 3102 on.) | |
| 3103 | |
| 3104 If Emacs is not compiled with support for X, then it instead uses more general | |
| 3105 code, something like what v18 does; but this way of doing things is a lot more | |
| 3106 modular. | |
| 3107 | |
| 3108 (Linking Emacs with Xt seems to only add about 300k to the executable size, | |
| 3109 compared with an Emacs linked with Xlib only.) | |
| 3110 | |
| 3111 | |
| 3112 *** Region Highlighting | |
| 3113 ----------------------- | |
| 3114 | |
| 3115 If the variable `zmacs-regions' is true, then the region between point and | |
| 3116 mark will be highlighted when "active". Those commands which push a mark | |
| 3117 (such as C-SPC, and C-x C-x) make the region become "active" and thus | |
| 3118 highlighted. Most commands (all non-motion commands, basically) cause it to | |
| 3119 become non-highlighted (non-"active"). Commands that operate on the region | |
| 3120 (such as C-w, C-x C-l, etc.) only work if the region is in the highlighted | |
| 3121 state. | |
| 3122 | |
| 3123 zmacs-activate-region-hook and zmacs-deactivate-region-hook are run at the | |
| 3124 appropriate times; under X, zmacs-activate-region-hook makes the X selection | |
| 3125 be the region between point and mark, thus doing two things at once: making | |
| 3126 the region and the X selection be the same; and making the region highlight | |
| 3127 in the same way as the X selection. | |
| 3128 | |
| 3129 If `zmacs-regions' is true, then the `mark-marker' command returns nil unless | |
| 3130 the region is currently in the active (highlighted) state. With an argument | |
| 3131 of t, this returns the mark (if there is one) regardless of the active-region | |
| 3132 state. You should *generally* not use the mark unless the region is active, | |
| 3133 if the user has expressed a preference for the active-region model. Watch | |
| 3134 out! Moving this marker changes the mark position. If you set the marker not | |
| 3135 to point anywhere, the buffer will have no mark. | |
| 3136 | |
| 3137 In this way, the primary selection is a fairly transitory entity; but | |
| 3138 when something is copied to the kill ring, it is made the Clipboard | |
| 3139 selection. It is also stored into CUT_BUFFER0, for compatibility with | |
| 3140 X applications that don't understand selections (like Emacs18). | |
| 3141 | |
| 3142 Compatibility note: if you have code which uses (mark) or (mark-marker), | |
| 3143 then you need to either: change those calls to (mark t) or (mark-marker t); | |
| 3144 or simply bind `zmacs-regions' to nil around the call to mark or mark-marker. | |
| 3145 This is probably the best solution, since it will work in Emacs 18 as well. | |
| 3146 | |
| 3147 | |
| 3148 *** Menubars and Dialog Boxes | |
| 3149 ----------------------------- | |
| 3150 | |
| 3151 Here is an example of a menubar definition: | |
| 3152 | |
| 3153 (defvar default-menubar | |
| 3154 '(("File" ["Open File..." find-file t] | |
| 3155 ["Save Buffer" save-buffer t] | |
| 3156 ["Save Buffer As..." write-file t] | |
| 3157 ["Revert Buffer" revert-buffer t] | |
| 3158 "-----" | |
| 3159 ["Print Buffer" lpr-buffer t] | |
| 3160 "-----" | |
| 3161 ["Delete Frame" delete-frame t] | |
| 3162 ["Kill Buffer..." kill-buffer t] | |
| 3163 ["Exit Emacs" save-buffers-kill-emacs t] | |
| 3164 ) | |
| 3165 ("Edit" ["Undo" advertised-undo t] | |
| 3166 ["Cut" kill-primary-selection t] | |
| 3167 ["Copy" copy-primary-selection t] | |
| 3168 ["Paste" yank-clipboard-selection t] | |
| 3169 ["Clear" delete-primary-selection t] | |
| 3170 ) | |
| 3171 ...)) | |
| 3172 | |
| 3173 The first element of each menu item is the string to print on the menu. | |
| 3174 | |
| 3175 The second element is the callback function; if it is a symbol, it is | |
| 3176 invoked with `call-interactively.' If it is a list, it is invoked with | |
| 3177 `eval'. | |
| 3178 | |
| 3179 If the second element is a symbol, then the menu also displays the key that | |
| 3180 is bound to that command (if any). | |
| 3181 | |
| 3182 The third element of the menu items determines whether the item is selectable. | |
| 3183 It may be t, nil, or a form to evaluate. Also, a hook is run just before a | |
| 3184 menu is exposed, which can be used to change the value of these slots. | |
| 3185 For example, there is a hook that makes the "undo" menu item be selectable | |
| 3186 only in the cases when `advertised-undo' would not signal an error. | |
| 3187 | |
| 3188 Menus may have other menus nested within them; they will cascade. | |
| 3189 | |
| 3190 There are utility functions for adding items to menus, deleting items, | |
| 3191 disabling them, etc. | |
| 3192 | |
| 3193 The function `popup-menu' takes a menu description and pops it up. | |
| 3194 | |
| 3195 The function `popup-dialog-box' takes a dialog-box description and pops | |
| 3196 it up. Dialog box descriptions look a lot like menu descriptions. | |
| 3197 | |
| 3198 The menubar, menu, and dialog-box code is implemented as a library, | |
| 3199 with an interface which hides the toolkit that implements it. | |
| 3200 | |
| 3201 | |
| 3202 *** Isearch Changes | |
| 3203 ------------------- | |
| 3204 | |
| 3205 Isearch has been reimplemented in a different way, adding some new features, | |
| 3206 and causing a few incompatible changes. | |
| 3207 | |
| 3208 - the old isearch-*-char variables are no longer supported. In the old | |
| 3209 system, one could make ^A mean "repeat the search" by doing something | |
| 3210 like (setq search-repeat-char ?C-a). In the new system, this is | |
| 3211 accomplished with | |
| 3212 | |
| 3213 (define-key isearch-mode-map "\C-a" 'isearch-repeat-forward) | |
| 3214 | |
| 3215 - The advantage of using the normal keymap mechanism for this is that you | |
| 3216 can bind more than one key to an isearch command: for example, both C-a | |
| 3217 and C-s could do the same thing inside isearch mode. You can also bind | |
| 3218 multi-key sequences inside of isearch mode, and bind non-ASCII keys. | |
| 3219 For example, to use the F1 key to terminate a search: | |
| 3220 | |
| 3221 (define-key isearch-mode-map 'f1 'isearch-exit) | |
| 3222 | |
| 3223 or to make ``C-c C-c'' terminate a search: | |
| 3224 | |
| 3225 (define-key isearch-mode-map "\C-c\C-c" 'isearch-exit) | |
| 3226 | |
| 3227 - If isearch is behaving case-insensitively (the default) and you type an | |
| 3228 upper case character, then the search will become case-sensitive. This | |
| 3229 can be disabled by setting `search-caps-disable-folding' to nil. | |
| 3230 | |
| 3231 - There is a history ring of the strings previously searched for; typing | |
| 3232 M-p or M-n while searching will cycle through this ring. Typing M-TAB | |
| 3233 will do completion across the set of items in the history ring. | |
| 3234 | |
| 3235 - The ESC key is no longer used to terminate an incremental search. The | |
| 3236 RET key should be used instead. This change is necessary for it to be | |
| 3237 possible to bind "meta" characters to isearch commands. | |
| 3238 | |
| 3239 | |
| 3240 *** Startup Code Changes | |
| 3241 ------------------------ | |
| 3242 | |
| 3243 The initial X frame is mapped before the user's .emacs file is executed. | |
| 3244 Without this, there is no way for the user to see any error messages | |
| 3245 generated by their .emacs file, any windows created by the .emacs file | |
| 3246 don't show up, and the copyleft notice isn't shown. | |
| 3247 | |
| 3248 The default values for load-path, exec-path, lock-directory, and | |
| 3249 Info-directory-list are not (necessarily) built into Emacs, but are | |
| 3250 computed at startup time. | |
| 3251 | |
| 3252 First, Emacs looks at the directory in which its executable file resides: | |
| 3253 | |
| 3254 o If that directory contains subdirectories named "lisp" and "lib-src", | |
| 3255 then those directories are used as the lisp library and exec directory. | |
| 3256 | |
| 3257 o If the parent of the directory in which the emacs executable is located | |
| 3258 contains "lisp" and "lib-src" subdirectories, then those are used. | |
| 3259 | |
| 3260 o If ../lib/xemacs-<version> (starting from the directory in which the | |
| 3261 emacs executable is located) contains a "lisp" subdirectory and either | |
| 3262 a "lib-src" subdirectory or a <configuration-name> subdirectory, then | |
| 3263 those are used. | |
| 3264 | |
| 3265 o If the emacs executable that was run is a symbolic link, then the link | |
| 3266 is chased, and the resultant directory is checked as above. | |
| 3267 | |
| 3268 (Actually, it doesn't just look for "lisp/", it looks for "lisp/prim/", | |
| 3269 which reduces the chances of a false positive.) | |
| 3270 | |
| 3271 If the lisp directory contains subdirectories, they are added to the default | |
| 3272 load-path as well. If the site-lisp directory exists and contains | |
| 3273 subdirectories, they are then added. Subdirectories whose names begin with | |
| 3274 a dot or a hyphen are not added to the load-path. | |
| 3275 | |
| 3276 These heuristics fail if the Emacs binary was copied from the main Emacs | |
| 3277 tree to some other directory, and links for the lisp directory were not put | |
| 3278 in. This isn't much of a restriction: either make there be subdirectories | |
| 3279 (or symbolic links) of the directory of the emacs executable, or make the | |
| 3280 "installed" emacs executable be a symbolic link to an executable in a more | |
| 3281 appropriate directory structure. For example, this setup works: | |
| 3282 | |
| 3283 /usr/local/xemacs/xemacs* ; The executable. | |
| 3284 /usr/local/xemacs/lisp/ ; The associated directories. | |
| 3285 /usr/local/xemacs/etc/ ; Any of the files in this list | |
| 3286 /usr/local/xemacs/lock/ ; could be symbolic links as well. | |
| 3287 /usr/local/xemacs/info/ | |
| 3288 | |
| 3289 As does this: | |
| 3290 | |
| 3291 /usr/local/bin/xemacs -> ../xemacs/src/xemacs-19.14 ; A link... | |
| 3292 /usr/local/xemacs/src/xemacs-19.14* ; The executable, | |
| 3293 /usr/local/xemacs/lisp/ ; and the rest of | |
| 3294 /usr/local/xemacs/etc/ ; the source tree | |
| 3295 /usr/local/xemacs/lock/ | |
| 3296 /usr/local/xemacs/info/ | |
| 3297 | |
| 3298 This configuration might be used for a multi-architecture installation; assume | |
| 3299 that $LOCAL refers to a directory which contains only files specific to a | |
| 3300 particular architecture (i.e., executables) and $SHARED refers to those files | |
| 3301 which are not machine specific (i.e., lisp code and documentation.) | |
| 3302 | |
| 3303 $LOCAL/bin/xemacs@ -> $LOCAL/xemacs-19.14/xemacs* | |
| 3304 $LOCAL/xemacs-19.14/lisp@ -> $SHARED/xemacs-19.14/lisp/ | |
| 3305 $LOCAL/xemacs-19.14/etc@ -> $SHARED/xemacs-19.14/etc/ | |
| 3306 $LOCAL/xemacs-19.14/info@ -> $SHARED/xemacs-19.14/info/ | |
| 3307 | |
| 3308 The following would also work, but the above is probably more attractive: | |
| 3309 | |
| 3310 $LOCAL/bin/xemacs* | |
| 3311 $LOCAL/bin/lisp@ -> $SHARED/xemacs-19.14/lisp/ | |
| 3312 $LOCAL/bin/etc@ -> $SHARED/xemacs-19.14/etc/ | |
| 3313 $LOCAL/bin/info@ -> $SHARED/xemacs-19.14/info/ | |
| 3314 | |
| 3315 If Emacs can't find the requisite directories, it writes a message like this | |
| 3316 (or some appropriate subset of it) to stderr: | |
| 3317 | |
| 3318 WARNING: | |
| 3319 couldn't find an obvious default for load-path, exec-directory, and | |
| 3320 lock-directory, and there were no defaults specified in paths.h when | |
| 3321 Emacs was built. Perhaps some directories don't exist, or the Emacs | |
| 3322 executable, /cadillac-th/jwz/somewhere/xemacs is in a strange place? | |
| 3323 | |
| 3324 Without both exec-directory and load-path, Emacs will be very broken. | |
| 3325 Consider making a symbolic link from /cadillac-th/jwz/somewhere/etc | |
| 3326 to wherever the appropriate Emacs etc/ directory is, and from | |
| 3327 /cadillac-th/jwz/somewhere/lisp/ to wherever the appropriate Emacs | |
| 3328 lisp library is. | |
| 3329 | |
| 3330 Without lock-directory set, file locking won't work. Consider | |
| 3331 creating /cadillac-th/jwz/somewhere/lock as a directory or symbolic | |
| 3332 link for use as the lock directory. | |
| 3333 | |
| 3334 The default installation tree is the following: | |
| 3335 | |
| 3336 /usr/local/bin/b2m ; | |
| 3337 ctags ; executables that | |
| 3338 emacsclient ; should be in | |
| 3339 etags ; user's path | |
| 3340 xemacs -> xemacs-<version> ; | |
| 3341 xemacs ; | |
| 3342 /usr/local/lib/xemacs/site-lisp | |
| 3343 /usr/local/lib/xemacs/lock | |
| 3344 /usr/local/lib/xemacs-<version>/etc ; architecture ind. files | |
| 3345 /usr/local/lib/xemacs-<version>/info | |
| 3346 /usr/local/lib/xemacs-<version>/lisp | |
| 3347 /usr/local/lib/xemacs-<version>/<configuration> ; binaries emacs may run | |
| 3348 | |
| 3349 | |
| 3350 *** X Resources | |
| 3351 --------------- | |
| 3352 | |
| 3353 (Note: This section is copied verbatim from the XEmacs Reference Manual.) | |
| 3354 | |
| 3355 The Emacs resources are generally set per-frame. Each Emacs frame | |
| 3356 can have its own name or the same name as another, depending on the | |
| 3357 name passed to the `make-frame' function. | |
| 3358 | |
| 3359 You can specify resources for all frames with the syntax: | |
| 3360 | |
| 3361 Emacs*parameter: value | |
| 3362 | |
| 3363 or | |
| 3364 | |
| 3365 Emacs*EmacsFrame.parameter:value | |
| 3366 | |
| 3367 You can specify resources for a particular frame with the syntax: | |
| 3368 | |
| 3369 Emacs*FRAME-NAME.parameter: value | |
| 3370 | |
| 3371 | |
| 3372 **** Geometry Resources | |
| 3373 ----------------------- | |
| 3374 | |
| 3375 To make the default size of all Emacs frames be 80 columns by 55 | |
| 3376 lines, do this: | |
| 3377 | |
| 3378 Emacs*EmacsFrame.geometry: 80x55 | |
| 3379 | |
| 3380 To set the geometry of a particular frame named `fred', do this: | |
| 3381 | |
| 3382 Emacs*fred.geometry: 80x55 | |
| 3383 | |
| 3384 Important! Do not use the following syntax: | |
| 3385 | |
| 3386 Emacs*geometry: 80x55 | |
| 3387 | |
| 3388 You should never use `*geometry' with any X application. It does not | |
| 3389 say "make the geometry of Emacs be 80 columns by 55 lines." It really | |
| 3390 says, "make Emacs and all subwindows thereof be 80x55 in whatever units | |
| 3391 they care to measure in." In particular, that is both telling the | |
| 3392 Emacs text pane to be 80x55 in characters, and telling the menubar pane | |
| 3393 to be 80x55 pixels, which is surely not what you want. | |
| 3394 | |
| 3395 As a special case, this geometry specification also works (and sets | |
| 3396 the default size of all Emacs frames to 80 columns by 55 lines): | |
| 3397 | |
| 3398 Emacs.geometry: 80x55 | |
| 3399 | |
| 3400 since that is the syntax used with most other applications (since most | |
| 3401 other applications have only one top-level window, unlike Emacs). In | |
| 3402 general, however, the top-level shell (the unmapped ApplicationShell | |
| 3403 widget named `Emacs' that is the parent of the shell widgets that | |
| 3404 actually manage the individual frames) does not have any interesting | |
| 3405 resources on it, and you should set the resources on the frames instead. | |
| 3406 | |
| 3407 The `-geometry' command-line argument sets only the geometry of the | |
| 3408 initial frame created by Emacs. | |
| 3409 | |
| 3410 A more complete explanation of geometry-handling is | |
| 3411 | |
| 3412 * The `-geometry' command-line option sets the `Emacs.geometry' | |
| 3413 resource, that is, the geometry of the ApplicationShell. | |
| 3414 | |
| 3415 * For the first frame created, the size of the frame is taken from | |
| 3416 the ApplicationShell if it is specified, otherwise from the | |
| 3417 geometry of the frame. | |
| 3418 | |
| 3419 * For subsequent frames, the order is reversed: First the frame, and | |
| 3420 then the ApplicationShell. | |
| 3421 | |
| 3422 * For the first frame created, the position of the frame is taken | |
| 3423 from the ApplicationShell (`Emacs.geometry') if it is specified, | |
| 3424 otherwise from the geometry of the frame. | |
| 3425 | |
| 3426 * For subsequent frames, the position is taken only from the frame, | |
| 3427 and never from the ApplicationShell. | |
| 3428 | |
| 3429 This is rather complicated, but it does seem to provide the most | |
| 3430 intuitive behavior with respect to the default sizes and positions of | |
| 3431 frames created in various ways. | |
| 3432 | |
| 3433 | |
| 3434 **** Iconic Resources | |
| 3435 --------------------- | |
| 3436 | |
| 3437 Analogous to `-geometry', the `-iconic' command-line option sets the | |
| 3438 iconic flag of the ApplicationShell (`Emacs.iconic') and always applies | |
| 3439 to the first frame created regardless of its name. However, it is | |
| 3440 possible to set the iconic flag on particular frames (by name) by using | |
| 3441 the `Emacs*FRAME-NAME.iconic' resource. | |
| 3442 | |
| 3443 | |
| 3444 **** Resource List | |
| 3445 ------------------ | |
| 3446 | |
| 3447 Emacs frames accept the following resources: | |
| 3448 | |
| 3449 `geometry' (class `Geometry'): string | |
| 3450 Initial geometry for the frame. *Note Geometry Resources:: for a | |
| 3451 complete discussion of how this works. | |
| 3452 | |
| 3453 `iconic' (class `Iconic'): boolean | |
| 3454 Whether this frame should appear in the iconified state. | |
| 3455 | |
| 3456 `internalBorderWidth' (class `InternalBorderWidth'): int | |
| 3457 How many blank pixels to leave between the text and the edge of the | |
| 3458 window. | |
| 3459 | |
| 3460 `interline' (class `Interline'): int | |
| 3461 How many pixels to leave between each line (may not be | |
| 3462 implemented). | |
| 3463 | |
| 3464 `menubar' (class `Menubar'): boolean | |
| 3465 Whether newly-created frames should initially have a menubar. Set | |
| 3466 to true by default. | |
| 3467 | |
| 3468 `initiallyUnmapped' (class `InitiallyUnmapped'): boolean | |
| 3469 Whether XEmacs should leave the initial frame unmapped when it | |
| 3470 starts up. This is useful if you are starting XEmacs as a server | |
| 3471 (e.g. in conjunction with gnuserv or the external client widget). | |
| 3472 You can also control this with the `-unmapped' command-line option. | |
| 3473 | |
| 3474 `barCursor' (class `BarColor'): boolean | |
| 3475 Whether the cursor should be displayed as a bar, or the | |
| 3476 traditional box. | |
| 3477 | |
| 3478 `textPointer' (class `Cursor'): cursor-name | |
| 3479 The cursor to use when the mouse is over text. This resource is | |
| 3480 used to initialize the variable `x-pointer-shape'. | |
| 3481 | |
| 3482 `selectionPointer' (class `Cursor'): cursor-name | |
| 3483 The cursor to use when the mouse is over a selectable text region | |
| 3484 (an extent with the `highlight' property; for example, an Info | |
| 3485 cross-reference). This resource is used to initialize the variable | |
| 3486 `x-selection-pointer-shape'. | |
| 3487 | |
| 3488 `spacePointer' (class `Cursor'): cursor-name | |
| 3489 The cursor to use when the mouse is over a blank space in a buffer | |
| 3490 (that is, after the end of a line or after the end-of-file). This | |
| 3491 resource is used to initialize the variable | |
| 3492 `x-nontext-pointer-shape'. | |
| 3493 | |
| 3494 `modeLinePointer' (class `Cursor'): cursor-name | |
| 3495 The cursor to use when the mouse is over a mode line. This | |
| 3496 resource is used to initialize the variable `x-mode-pointer-shape'. | |
| 3497 | |
| 3498 `gcPointer' (class `Cursor'): cursor-name | |
| 3499 The cursor to display when a garbage-collection is in progress. | |
| 3500 This resource is used to initialize the variable | |
| 3501 `x-gc-pointer-shape'. | |
| 3502 | |
| 3503 `scrollbarPointer' (class `Cursor'): cursor-name | |
| 3504 The cursor to use when the mouse is over the scrollbar. This | |
| 3505 resource is used to initialize the variable | |
| 3506 `x-scrollbar-pointer-shape'. | |
| 3507 | |
| 3508 `pointerColor' (class `Foreground'): color-name | |
| 3509 `pointerBackground' (class `Background'): color-name | |
| 3510 The foreground and background colors of the mouse cursor. These | |
| 3511 resources are used to initialize the variables | |
| 3512 `x-pointer-foreground-color' and `x-pointer-background-color'. | |
| 3513 | |
| 3514 `scrollBarWidth' (class `ScrollBarWidth'): integer | |
| 3515 How wide the vertical scrollbars should be, in pixels; 0 means no | |
| 3516 vertical scrollbars. You can also use a resource specification of | |
| 3517 the form `*scrollbar.width', or the usual toolkit scrollbar | |
| 3518 resources: `*XmScrollBar.width' (Motif), `*XlwScrollBar.width' | |
| 3519 (Lucid), or `*Scrollbar.thickness' (Athena). We don't recommend | |
| 3520 that you use the toolkit resources, though, because they're | |
| 3521 dependent on how exactly your particular build of XEmacs was | |
| 3522 configured. | |
| 3523 | |
| 3524 `scrollBarHeight' (class `ScrollBarHeight'): integer | |
| 3525 How high the horizontal scrollbars should be, in pixels; 0 means no | |
| 3526 horizontal scrollbars. You can also use a resource specification | |
| 3527 of the form `*scrollbar.height', or the usual toolkit scrollbar | |
| 3528 resources: `*XmScrollBar.height' (Motif), `*XlwScrollBar.height' | |
| 3529 (Lucid), or `*Scrollbar.thickness' (Athena). We don't recommend | |
| 3530 that you use the toolkit resources, though, because they're | |
| 3531 dependent on how exactly your particular build of XEmacs was | |
| 3532 configured. | |
| 3533 | |
| 3534 `scrollBarPlacement' (class `ScrollBarPlacement'): string | |
| 3535 Where the horizontal and vertical scrollbars should be positioned. | |
| 3536 This should be one of the four strings `bottom-left', | |
| 3537 `bottom-right', `top-left', and `top-right'. Default is | |
| 3538 `bottom-right' for the Motif and Lucid scrollbars and | |
| 3539 `bottom-left' for the Athena scrollbars. | |
| 3540 | |
| 3541 `topToolBarHeight' (class `TopToolBarHeight'): integer | |
| 3542 `bottomToolBarHeight' (class `BottomToolBarHeight'): integer | |
| 3543 `leftToolBarWidth' (class `LeftToolBarWidth'): integer | |
| 3544 `rightToolBarWidth' (class `RightToolBarWidth'): integer | |
| 3545 Height and width of the four possible toolbars. | |
| 3546 | |
| 3547 `topToolBarShadowColor' (class `TopToolBarShadowColor'): color-name | |
| 3548 `bottomToolBarShadowColor' (class `BottomToolBarShadowColor'): color-name | |
| 3549 Color of the top and bottom shadows for the toolbars. NOTE: These | |
| 3550 resources do *not* have anything to do with the top and bottom | |
| 3551 toolbars (i.e. the toolbars at the top and bottom of the frame)! | |
| 3552 Rather, they affect the top and bottom shadows around the edges of | |
| 3553 all four kinds of toolbars. | |
| 3554 | |
| 3555 `topToolBarShadowPixmap' (class `TopToolBarShadowPixmap'): pixmap-name | |
| 3556 `bottomToolBarShadowPixmap' (class `BottomToolBarShadowPixmap'): pixmap-name | |
| 3557 Pixmap of the top and bottom shadows for the toolbars. If set, | |
| 3558 these resources override the corresponding color resources. NOTE: | |
| 3559 These resources do *not* have anything to do with the top and | |
| 3560 bottom toolbars (i.e. the toolbars at the top and bottom of the | |
| 3561 frame)! Rather, they affect the top and bottom shadows around the | |
| 3562 edges of all four kinds of toolbars. | |
| 3563 | |
| 3564 `toolBarShadowThickness' (class `ToolBarShadowThickness'): integer | |
| 3565 Thickness of the shadows around the toolbars, in pixels. | |
| 3566 | |
| 3567 `visualBell' (class `VisualBell'): boolean | |
| 3568 Whether XEmacs should flash the screen rather than making an | |
| 3569 audible beep. | |
| 3570 | |
| 3571 `bellVolume' (class `BellVolume'): integer | |
| 3572 Volume of the audible beep. | |
| 3573 | |
| 3574 `useBackingStore' (class `UseBackingStore'): boolean | |
| 3575 Whether XEmacs should set the backing-store attribute of the X | |
| 3576 windows it creates. This increases the memory usage of the X | |
| 3577 server but decreases the amount of X traffic necessary to update | |
| 3578 the screen, and is useful when the connection to the X server goes | |
| 3579 over a low-bandwidth line such as a modem connection. | |
| 3580 | |
| 3581 | |
| 3582 **** Face Resources | |
| 3583 ------------------- | |
| 3584 | |
| 3585 The attributes of faces are also per-frame. They can be specified as: | |
| 3586 | |
| 3587 Emacs.FACE_NAME.parameter: value | |
| 3588 | |
| 3589 (*do not* use `Emacs*FACE_NAME...') | |
| 3590 | |
| 3591 or | |
| 3592 | |
| 3593 Emacs*FRAME_NAME.FACE_NAME.parameter: value | |
| 3594 | |
| 3595 Faces accept the following resources: | |
| 3596 | |
| 3597 `attributeFont' (class `AttributeFont'): font-name | |
| 3598 The font of this face. | |
| 3599 | |
| 3600 `attributeForeground' (class `AttributeForeground'): color-name | |
| 3601 `attributeBackground' (class `AttributeBackground'): color-name | |
| 3602 The foreground and background colors of this face. | |
| 3603 | |
| 3604 `attributeBackgroundPixmap' (class `AttributeBackgroundPixmap'): file-name | |
| 3605 The name of an XBM file (or XPM file, if your version of Emacs | |
| 3606 supports XPM), to use as a background stipple. | |
| 3607 | |
| 3608 `attributeUnderline' (class `AttributeUnderline'): boolean | |
| 3609 Whether text in this face should be underlined. | |
| 3610 | |
| 3611 All text is displayed in some face, defaulting to the face named | |
| 3612 `default'. To set the font of normal text, use | |
| 3613 `Emacs*default.attributeFont'. To set it in the frame named `fred', use | |
| 3614 `Emacs*fred.default.attributeFont'. | |
| 3615 | |
| 3616 These are the names of the predefined faces: | |
| 3617 | |
| 3618 `default' | |
| 3619 Everything inherits from this. | |
| 3620 | |
| 3621 `bold' | |
| 3622 If this is not specified in the resource database, Emacs tries to | |
| 3623 find a bold version of the font of the default face. | |
| 3624 | |
| 3625 `italic' | |
| 3626 If this is not specified in the resource database, Emacs tries to | |
| 3627 find an italic version of the font of the default face. | |
| 3628 | |
| 3629 `bold-italic' | |
| 3630 If this is not specified in the resource database, Emacs tries to | |
| 3631 find a bold-italic version of the font of the default face. | |
| 3632 | |
| 3633 `modeline' | |
| 3634 This is the face that the modeline is displayed in. If not | |
| 3635 specified in the resource database, it is determined from the | |
| 3636 default face by reversing the foreground and background colors. | |
| 3637 | |
| 3638 `highlight' | |
| 3639 This is the face that highlighted extents (for example, Info | |
| 3640 cross-references and possible completions, when the mouse passes | |
| 3641 over them) are displayed in. | |
| 3642 | |
| 3643 `left-margin' | |
| 3644 `right-margin' | |
| 3645 These are the faces that the left and right annotation margins are | |
| 3646 displayed in. | |
| 3647 | |
| 3648 `zmacs-region' | |
| 3649 This is the face that mouse selections are displayed in. | |
| 3650 | |
| 3651 `text-cursor' | |
| 3652 This is the face that the cursor is displayed in. | |
| 3653 | |
| 3654 `isearch' | |
| 3655 This is the face that the matched text being searched for is | |
| 3656 displayed in. | |
| 3657 | |
| 3658 `info-node' | |
| 3659 This is the face of info menu items. If unspecified, it is copied | |
| 3660 from `bold-italic'. | |
| 3661 | |
| 3662 `info-xref' | |
| 3663 This is the face of info cross-references. If unspecified, it is | |
| 3664 copied from `bold'. (Note that, when the mouse passes over a | |
| 3665 cross-reference, the cross-reference's face is determined from a | |
| 3666 combination of the `info-xref' and `highlight' faces.) | |
| 3667 | |
| 3668 Other packages might define their own faces; to see a list of all | |
| 3669 faces, use any of the interactive face-manipulation commands such as | |
| 3670 `set-face-font' and type `?' when you are prompted for the name of a | |
| 3671 face. | |
| 3672 | |
| 3673 If the `bold', `italic', and `bold-italic' faces are not specified | |
| 3674 in the resource database, then XEmacs attempts to derive them from the | |
| 3675 font of the default face. It can only succeed at this if you have | |
| 3676 specified the default font using the XLFD (X Logical Font Description) | |
| 3677 format, which looks like | |
| 3678 | |
| 3679 *-courier-medium-r-*-*-*-120-*-*-*-*-*-* | |
| 3680 | |
| 3681 If you use any of the other, less strict font name formats, some of | |
| 3682 which look like | |
| 3683 | |
| 3684 lucidasanstypewriter-12 | |
| 3685 fixed | |
| 3686 9x13 | |
| 3687 | |
| 3688 then XEmacs won't be able to guess the names of the bold and italic | |
| 3689 versions. All X fonts can be referred to via XLFD-style names, so you | |
| 3690 should use those forms. See the man pages for `X(1)', `xlsfonts(1)', | |
| 3691 and `xfontsel(1)'. | |
| 3692 | |
| 3693 | |
| 3694 **** Widgets | |
| 3695 ------------ | |
| 3696 | |
| 3697 There are several structural widgets between the terminal EmacsFrame | |
| 3698 widget and the top level ApplicationShell; the exact names and types of | |
| 3699 these widgets change from release to release (for example, they changed | |
| 3700 in 19.9, 19.10, 19.12, and 19.13) and are subject to further change in | |
| 3701 the future, so you should avoid mentioning them in your resource database. | |
| 3702 The above-mentioned syntaxes should be forward-compatible. As of 19.14, | |
| 3703 the exact widget hierarchy is as follows: | |
| 3704 | |
| 3705 INVOCATION-NAME "shell" "container" FRAME-NAME | |
| 3706 x-emacs-application-class "TopLevelEmacsShell" "EmacsManager" "EmacsFrame" | |
| 3707 | |
| 3708 (for normal frames) | |
| 3709 | |
| 3710 or | |
| 3711 | |
| 3712 INVOCATION-NAME "shell" "container" FRAME-NAME | |
| 3713 x-emacs-application-class "TransientEmacsShell" "EmacsManager" "EmacsFrame" | |
| 3714 | |
| 3715 (for popup/dialog-box frames) | |
| 3716 | |
| 3717 where INVOCATION-NAME is the terminal component of the name of the | |
| 3718 XEmacs executable (usually `xemacs'), and `x-emacs-application-class' | |
| 3719 is generally `Emacs'. | |
| 3720 | |
| 3721 | |
| 3722 **** Menubar Resources | |
| 3723 ---------------------- | |
| 3724 | |
| 3725 As the menubar is implemented as a widget which is not a part of | |
| 3726 XEmacs proper, it does not use the face mechanism for specifying fonts | |
| 3727 and colors: It uses whatever resources are appropriate to the type of | |
| 3728 widget which is used to implement it. | |
| 3729 | |
| 3730 If Emacs was compiled to use only the Motif-lookalike menu widgets, | |
| 3731 then one way to specify the font of the menubar would be | |
| 3732 | |
| 3733 Emacs*menubar*font: *-courier-medium-r-*-*-*-120-*-*-*-*-*-* | |
| 3734 | |
| 3735 If the Motif library is being used, then one would have to use | |
| 3736 | |
| 3737 Emacs*menubar*fontList: *-courier-medium-r-*-*-*-120-*-*-*-*-*-* | |
| 3738 | |
| 3739 because the Motif library uses the `fontList' resource name instead | |
| 3740 of `font', which has subtly different semantics. | |
| 3741 | |
| 3742 The same is true of the scrollbars: They accept whichever resources | |
| 3743 are appropriate for the toolkit in use. | |
| 3744 | |
| 3745 | |
| 3746 *** Source Code Highlighting | |
| 3747 ---------------------------- | |
| 3748 | |
| 3749 It's possible to have your buffers "decorated" with fonts or colors | |
| 3750 indicating syntactic structures (such as strings, comments, function names, | |
| 3751 "reserved words", etc.). In XEmacs, the preferred way to do this is with | |
| 3752 font-lock-mode; activate it by adding the following code to your .emacs file: | |
| 3753 | |
| 3754 (add-hook 'emacs-lisp-mode-hook 'turn-on-font-lock) | |
| 3755 (add-hook 'c-mode-hook 'turn-on-font-lock) | |
| 3756 (add-hook 'c++-mode-hook 'turn-on-font-lock) | |
| 3757 (add-hook 'dired-mode-hook 'turn-on-font-lock) | |
| 3758 ...etc... | |
| 3759 | |
| 3760 To customize it, see the descriptions of the function `font-lock-mode' and | |
| 3761 the variables `font-lock-keywords', `c-font-lock-keywords', etc. | |
| 3762 | |
| 3763 There exist several other source code highlighting packages, but font-lock | |
| 3764 does one thing that most others don't do: highlights as you type new text; | |
| 3765 and one thing that no others do: bases part of its decoration on the | |
| 3766 syntax table of the major mode. Font-lock has C-level support to do this | |
| 3767 efficiently, so it should also be significantly faster than the others. | |
| 3768 | |
| 3769 If there's something that another highlighting package does that you can't | |
| 3770 make font-lock do, let us know. We would prefer to consolidate all of the | |
| 3771 desired functionality into one package rather than ship several different | |
| 3772 packages which do essentially the same thing in different ways. | |
| 3773 | |
| 3774 | |
| 3775 ** Differences Between XEmacs and Emacs 18 | |
| 3776 ========================================== | |
| 3777 | |
| 3778 Auto-configure support has been added, so it should be fairly easy to compile | |
| 3779 XEmacs on different systems. If you have any problems or feedback about | |
| 3780 compiling on your system, please let us know. | |
| 3781 | |
| 3782 We have reimplemented the basic input model in a more general way; instead of | |
| 3783 X input being a special-case of the normal ASCII input stream, XEmacs has a | |
| 3784 concept of "input events", and ASCII characters are a subset of that. The | |
| 3785 events that XEmacs knows about are not X events, but are a generalization of | |
| 3786 them, so that XEmacs can eventually be ported to different window systems. | |
| 3787 | |
| 3788 We have reimplemented keymaps so that sequences of events can be stored into | |
| 3789 them instead of just ASCII codes; it is possible to, for example, bind | |
| 3790 different commands to each of the chords Control-h, Control-H, Backspace, | |
| 3791 Control-Backspace, and Super-Shift-Backspace. Key bindings, function key | |
| 3792 bindings, and mouse bindings live in the same keymaps. | |
| 3793 | |
| 3794 Input and display of all ISO-8859-1 characters is supported. | |
| 3795 | |
| 3796 You can have multiple X windows ("frames" in XEmacs terminology). | |
| 3797 | |
| 3798 XEmacs has objects called "extents" and "faces", which are roughly | |
| 3799 analogous to Epoch's "buttons," "zones," and "styles." An extent is a | |
| 3800 region of text (a start position and an end position) and a face is a | |
| 3801 collection of textual attributes like fonts and colors. Every extent | |
| 3802 is displayed in some "face", so changing the properties of a face | |
| 3803 immediately updates the display of all associated extents. Faces can | |
| 3804 be frame-local: you can have a region of text which displays with | |
| 3805 completely different attributes when its buffer is viewed from a | |
| 3806 different X window. | |
| 3807 | |
| 3808 The display attributes of faces may be specified either in lisp or through | |
| 3809 the X resource manager. | |
| 3810 | |
| 3811 Pixmaps of arbitrary size can be embedded in a buffer. | |
| 3812 | |
| 3813 Variable width fonts work. | |
| 3814 | |
| 3815 The height of a line is the height of the tallest font on that line, instead | |
| 3816 of all lines having the same height. | |
| 3817 | |
| 3818 XEmacs uses the MIT "Xt" toolkit instead of raw Xlib calls, which | |
| 3819 makes it be a more well-behaved X citizen (and also improves | |
| 3820 portability). A result of this is that it is possible to include | |
| 3821 other Xt "Widgets" in the XEmacs window. Also, XEmacs understands the | |
| 3822 standard Xt command-line arguments. | |
| 3823 | |
| 3824 XEmacs understands the X11 "Selection" mechanism; it's possible to define | |
| 3825 and customize selection converter functions and new selection types from | |
| 3826 Emacs Lisp, without having to recompile XEmacs. | |
| 3827 | |
| 3828 XEmacs provides support for ToolTalk on systems that have it. | |
| 3829 | |
| 3830 XEmacs supports the Zmacs/Lispm style of region highlighting, where the | |
| 3831 region between the point and mark is highlighted when in its "active" state. | |
| 3832 | |
| 3833 XEmacs has a menubar, whose contents are customizable from emacs-lisp. | |
| 3834 This menubar looks Motif-ish, but does not require Motif. If you already | |
| 3835 own Motif, however, you can configure XEmacs to use a *real* Motif menubar | |
| 3836 instead. | |
| 3837 | |
| 3838 XEmacs can ask questions using popup dialog boxes. Any command executed from | |
| 3839 a menu will ask yes/no questions with dialog boxes, while commands executed | |
| 3840 via the keyboard will use the minibuffer. | |
| 3841 | |
| 3842 XEmacs has vertical and horizontal scrollbars. | |
| 3843 | |
| 3844 The initial load-path is computed at run-time, instead of at compile-time. | |
| 3845 This means that if you move the XEmacs executable and associated directories | |
| 3846 to somewhere else, you don't have to recompile anything. | |
| 3847 | |
| 3848 You can specify what the title of the XEmacs windows and icons should be | |
| 3849 with the variables `frame-title-format' and `frame-icon-title-format', | |
| 3850 which have the same syntax as `mode-line-format'. | |
| 3851 | |
| 3852 XEmacs now supports floating-point numbers. | |
| 3853 | |
| 3854 XEmacs now knows about timers directly, instead of them being simulated by | |
| 3855 a subprocess. | |
| 3856 | |
| 3857 XEmacs understands truenames, and can be configured to notice when you are | |
| 3858 visiting two names of the same file. See the variables find-file-use-truenames | |
| 3859 and find-file-compare-truenames. | |
| 3860 | |
| 3861 If you're running on a machine with audio hardware, you can specify sound | |
| 3862 files for XEmacs to play instead of the default X beep. See the documentation | |
| 3863 of the function load-sound-file and the variable sound-alist. | |
| 3864 | |
| 3865 An XEmacs frame can be placed within an "external client widget" managed by | |
| 3866 another application. This allows an application to use an XEmacs frame as its | |
| 3867 text pane rather than the standard Text widget that is provided with Motif or | |
| 3868 Athena. XEmacs supports Motif applications, generic Xt (e.g. Athena) | |
| 3869 applications, and raw Xlib applications. | |
| 3870 | |
| 3871 Random changes to the emacs-lisp library: (some of this was not written by | |
| 3872 us, but is included because it's free software and we think it's good stuff) | |
| 3873 | |
| 3874 - there is a new optimizing byte-compiler | |
| 3875 - there is a new abbrev-based mail-alias mechanism | |
| 3876 - the -*- line can contain local-variable settings | |
| 3877 - there is a new TAGS package | |
| 3878 - there is a new VI-emulation mode (viper) | |
| 3879 - there is a new implementation of Dired | |
| 3880 - there is a new implementation of Isearch | |
| 3881 - the VM package for reading mail is provided | |
| 3882 - the W3 package for browsing the World Wide Web hypertext information | |
| 3883 system is provided | |
| 3884 - the Hyperbole package, a programmable information management and | |
| 3885 hypertext system | |
| 3886 - the OO-Browser package, a multi-language object-oriented browser | |
| 3887 | |
| 3888 There are many more specifics in the "Miscellaneous Changes" section, below. | |
| 3889 | |
| 3890 The online Emacs Manual and Emacs-Lisp Manual are now both relatively | |
| 3891 up-to-date. | |
| 3892 | |
| 3893 ** Major Differences Between 19.13 and 19.14 | |
| 3894 ============================================ | |
| 3895 | |
| 3896 XEmacs has a new address! The canonical ftp site is now | |
| 3897 ftp.xemacs.org:/pub/xemacs and the Web page is now at | |
| 3898 http://www.xemacs.org/. All mailing lists now have @xemacs.org | |
| 3899 addresses. For the time being the @cs.uiuc.edu addresses will | |
| 3900 continue to function. | |
| 3901 | |
| 3902 This is a major new release. Many features have been added, as well | |
| 3903 as many bugs fixed. The Motif menubar has still _NOT_ been fixed for | |
| 3904 19.14. You should use the Lucid menubar instead. | |
| 3905 | |
| 3906 | |
| 3907 | |
| 3908 Major user-visible changes: | |
| 3909 --------------------------- | |
| 3910 | |
| 3911 -- Color support in TTY mode is provided. You have to have a TTY capable | |
| 3912 of displaying them, such as color xterm or the console under Linux. | |
| 3913 If your terminal type supports colors (e.g. `xterm-color'), XEmacs | |
| 3914 will automatically notice this and start using color. | |
| 3915 | |
| 3916 -- blink-cursor-mode enables a blinking text cursor. There is a | |
| 3917 menubar option for this also. | |
| 3918 | |
| 3919 -- auto-show-mode is turned on by default; this means that XEmacs | |
| 3920 will automatically scroll a window horizontally as necessary to | |
| 3921 keep point in view. | |
| 3922 | |
| 3923 -- a file dialog box is provided and will be used whenever you | |
| 3924 are prompted for a filename as a result of a menubar selection. | |
| 3925 | |
| 3926 -- XEmacs can be compiled with built-in GIF, JPEG, and PNG support. | |
| 3927 The GIF libraries are supplied with XEmacs; for JPEG and PNG, | |
| 3928 you have to obtain the appropriate libraries (this is well- | |
| 3929 documented). This makes image display much easier and faster under | |
| 3930 W3 (the web browser) and TM (adds MIME support to VM and GNUS; | |
| 3931 not yet included with XEmacs but will be in 19.15). | |
| 3932 | |
| 3933 -- XEmacs provides a really nice mode (PSGML with "Wing improvements") | |
| 3934 for editing HTML and other SGML documents. It parses the document, | |
| 3935 and as a result it does proper indentation, can show you the context | |
| 3936 you're in, the allowed tags at a particular position, etc. | |
| 3937 | |
| 3938 -- XEmacs comes standard with modes for editing Java and VRML code, | |
| 3939 including font-lock support. | |
| 3940 | |
| 3941 -- GNUS 5.2 comes standard with XEmacs. | |
| 3942 | |
| 3943 -- You can now embed colors in the modeline, with different sections | |
| 3944 of the modeline responding appropriately to various mouse gestures: | |
| 3945 For example, clicking on the "read-only" indicator toggles the | |
| 3946 read-only status of a buffer, and clicking on the buffer name | |
| 3947 cycles to the next buffer. Pressing button3 on these areas brings | |
| 3948 up a popup menu of appropriate commands. | |
| 3949 | |
| 3950 -- There is a much nicer mode for completion lists and such. | |
| 3951 At the minibuffer prompt, if you hit page-up or Meta-V, the completion | |
| 3952 buffer will be displayed (if it wasn't already), you're moved into | |
| 3953 it, and can move around and select filenames using the arrow keys | |
| 3954 and the return key. Rather than a cursor, a filename is highlighted, | |
| 3955 and the arrow keys change which filename is highlighted. | |
| 3956 | |
| 3957 -- The edit-faces subsystem has also been much improved, in somewhat | |
| 3958 similar ways to the completion list improvements. | |
| 3959 | |
| 3960 -- Many improvements were made to the multi-device support. | |
| 3961 We now provide an auxiliary utility called "gnuattach" that | |
| 3962 lets you connect to an existing XEmacs process and display | |
| 3963 a TTY frame on the current TTY connection, and commands | |
| 3964 `make-frame-on-display' (with a corresponding menubar entry) | |
| 3965 and `make-frame-on-tty' for more easily creating frames on | |
| 3966 new TTY or X connections. | |
| 3967 | |
| 3968 -- We have incorporated nearly all of the functionality of GNU Emacs | |
| 3969 19.30 into XEmacs. This includes support for lazy-loaded | |
| 3970 byte code and documentation strings, improved paragraph filling, | |
| 3971 better support for margins within documents, v19 regular expression | |
| 3972 routines (including caching of compiled regexps), etc. | |
| 3973 | |
| 3974 -- In accordance with GNU Emacs 19.30, the following key binding | |
| 3975 changes have been made: | |
| 3976 | |
| 3977 C-x ESC -> C-x ESC ESC | |
| 3978 ESC ESC -> ESC : | |
| 3979 ESC ESC ESC is "abort anything" (keyboard-escape-quit). | |
| 3980 | |
| 3981 -- All major packages have been updated to their latest-released | |
| 3982 versions. | |
| 3983 | |
| 3984 -- XEmacs now gracefully handles a full colormap (such as typically | |
| 3985 results when running Netscape). The nearest available color | |
| 3986 is automatically substituted. | |
| 3987 | |
| 3988 -- Many bug fixes to the subprocess/PTY code, ps-print, menubar | |
| 3989 functions, `set-text-properties', DEC Alpha support, toolbar | |
| 3990 resizing (the "phantom VM toolbar" bug), and lots and lots | |
| 3991 of other things were made. | |
| 3992 | |
| 3993 -- The ncurses library (a replacement for curses, found especially | |
| 3994 under Linux) is supported, and will be automatically used | |
| 3995 if it can be found. | |
| 3996 | |
| 3997 -- You can now undo in the minibuffer. | |
| 3998 | |
| 3999 -- Surrogate minibuffers now work. These are also sometimes referred | |
| 4000 to as "global" minibuffers. | |
| 4001 | |
| 4002 -- font-lock has been merged with GNU Emacs 19.30, improved defaults | |
| 4003 have been added, and changes have been made to the way it is | |
| 4004 configured. | |
| 4005 | |
| 4006 -- Many, many modes have menubar entries for them. | |
| 4007 | |
| 4008 -- `recover-session' lets you recover whatever files can be recovered | |
| 4009 after your XEmacs process has died unexpectedly. | |
| 4010 | |
| 4011 -- C-h k followed by a toolbar button press correctly reports | |
| 4012 the binding of the toolbar button. | |
| 4013 | |
| 4014 -- `function-key-map', `key-translation-map', and `keyboard-translate-table' | |
| 4015 are now correctly implemented. | |
| 4016 | |
| 4017 -- `show-message-log' (and its menubar entry under Edit) have been | |
| 4018 removed; instead use `view-lossage' (and its menubar entry under | |
| 4019 Help). | |
| 4020 | |
| 4021 -- There is a standard menubar entry for specifying which browser | |
| 4022 (Netscape, W3, Mosaic, etc.) to use when dispatching URL's | |
| 4023 in mail, Usenet news, etc. | |
| 4024 | |
| 4025 -- Improved native sound support under Linux. | |
| 4026 | |
| 4027 -- Lots of other things we forgot to mention. | |
| 4028 | |
| 4029 | |
| 4030 | |
| 4031 Significant Lisp-level changes: | |
| 4032 ------------------------------- | |
| 4033 | |
| 4034 -- Many improvements to the E-Lisp documentation have been made; | |
| 4035 it should now be up-to-date and complete in nearly all cases. | |
| 4036 | |
| 4037 -- XEmacs has extensive documentation on its internals, for | |
| 4038 would-be C hackers. | |
| 4039 | |
| 4040 -- Common-Lisp support (the CL package) is now dumped standard | |
| 4041 into XEmacs. No more need for (require 'cl) or anything | |
| 4042 like that. | |
| 4043 | |
| 4044 -- Full support for extents and text properties over strings is | |
| 4045 provided. | |
| 4046 | |
| 4047 -- The extent properties `start-open', `end-open', `start-closed', | |
| 4048 and `end-closed' now work correctly w.r.t. text properties. | |
| 4049 | |
| 4050 -- The `face' property of extents and text properties can now | |
| 4051 be a list. | |
| 4052 | |
| 4053 -- The `mouse-face' property from GNU Emacs is now supported. | |
| 4054 It supersedes the `highlight' property. | |
| 4055 | |
| 4056 -- `enriched' and `facemenu' packages from GNU Emacs have been ported. | |
| 4057 | |
| 4058 -- New functions for easier creation of dialog boxes: | |
| 4059 `get-dialog-box-response', `message-box', and `message-or-box'. | |
| 4060 | |
| 4061 -- `function-min-args' and `function-max-args' allow you to determine | |
| 4062 the minimum and maximum allowed arguments for any type of | |
| 4063 function (i.e. subr, lambda expression, byte-compiled function, etc.). | |
| 4064 | |
| 4065 -- Some C-level support for doing E-Lisp profiling is provided. | |
| 4066 See `start-profiling', `stop-profiling', and | |
| 4067 `pretty-print-profiling-info'. | |
| 4068 | |
| 4069 -- `current-process-time' reports the user, system, and real times | |
| 4070 for the currently running XEmacs process. | |
| 4071 | |
| 4072 -- `next-window', `previous-window', `next-frame', `previous-frame', | |
| 4073 `other-window', `get-lru-window', etc. have an extra device | |
| 4074 argument that allows you to restrict which devices it includes | |
| 4075 (normally all devices). Some functions that incorrectly ignored | |
| 4076 frames on different devices (e.g. C-x 0) are fixed. | |
| 4077 | |
| 4078 -- new functions `run-hook-with-args-until-success', | |
| 4079 `run-hook-with-args-until-failure'. | |
| 4080 | |
| 4081 -- generalized facility for local vs. global hooks. See `make-local-hook', | |
| 4082 `add-hook'. | |
| 4083 | |
| 4084 -- New functions for querying the window tree: `frame-leftmost-window', | |
| 4085 `frame-rightmost-window', `window-first-hchild', `window-first-vchild', | |
| 4086 `window-next-child', `window-previous-child', and `window-parent'. | |
| 4087 | |
| 4088 -- Epoch support works. This gets you direct access to some X events | |
| 4089 and objects (e.g. properties and property-notify events). | |
| 4090 | |
| 4091 -- The multi-device support has been majorly revamped. There is now | |
| 4092 a new concept of "consoles" (devices grouped together under a | |
| 4093 common keyboard/mouse), console-local variables, and a generalized | |
| 4094 concept of device/console connection. | |
| 4095 | |
| 4096 -- `display-buffer' synched with GNU Emacs 19.30, giving you lots of | |
| 4097 wondrous cruft such as | |
| 4098 -- unsplittable frames | |
| 4099 -- pop-up-frames, pop-up-frame-function | |
| 4100 -- special-display-buffer-names, special-display-regexps, | |
| 4101 special-display-function | |
| 4102 -- same-window-buffer-names, same-window-regexps | |
| 4103 | |
| 4104 -- XEmacs has support for accessing DBM- and/or DB-format databases, | |
| 4105 provided that you have the appropriate libraries on your system. | |
| 4106 | |
| 4107 -- There is a new font style: "strikethru" fonts. | |
| 4108 | |
| 4109 -- New data type "weak list", which is a list with special | |
| 4110 garbage-collection properties, similar to weak hash tables. | |
| 4111 | |
| 4112 -- `set-face-parent' makes one face inherit all properties from another. | |
| 4113 | |
| 4114 -- The junky frame parameters mechanism has been revamped as | |
| 4115 frame properties, which a standard property-list interface. | |
| 4116 | |
| 4117 -- Lots and lots of functions for working with property lists have | |
| 4118 been added. | |
| 4119 | |
| 4120 -- New functions `push-window-configuration', `pop-window-configuration', | |
| 4121 `unpop-window-configuration' for maintain a stack of window | |
| 4122 configurations. | |
| 4123 | |
| 4124 -- Many fixups to the glyph code; icons and mouse pointers are now | |
| 4125 properly merged into the glyph mechanism. | |
| 4126 | |
| 4127 -- `set-specifier' works more sensibly, like `set-face-property'. | |
| 4128 | |
| 4129 -- Many new specifiers for individually controlling toolbar height/width | |
| 4130 and visibility and text cursor visibility. | |
| 4131 | |
| 4132 -- New face `text-cursor' controls the colors of the text cursor. | |
| 4133 | |
| 4134 -- Many new variables for turning on debug information about the | |
| 4135 inner workings of XEmacs. | |
| 4136 | |
| 4137 -- Hash tables can now compare their keys using `equal' or `eql' | |
| 4138 as well as `eq'. | |
| 4139 | |
| 4140 -- Other things too numerous to mention. | |
| 4141 | |
| 4142 | |
| 4143 | |
| 4144 Significant configuration/build changes: | |
| 4145 ---------------------------------------- | |
| 4146 | |
| 4147 -- You can disable TTY support, toolbar support, scrollbar support, | |
| 4148 menubar support, and/or dialog box support at configure time | |
| 4149 to save memory. | |
| 4150 | |
| 4151 -- New configure option `--extra-verbose' shows the diagnostic | |
| 4152 output from feature testing; this should help track down | |
| 4153 problems with incorrect feature detection. | |
| 4154 | |
| 4155 -- `dont-have-xmu' is now `with-xmu', with the reversed sense. | |
| 4156 (It defaults to `yes'.) | |
| 4157 | |
| 4158 -- `with-mocklisp' lets you add Mocklisp support if you really | |
| 4159 need this. | |
| 4160 | |
| 4161 -- `with-term' for adding TERM support for Linux users. | |
| 4162 | |
| 4163 | |
| 4164 | |
| 4165 ** Major Differences Between 19.12 and 19.13 | |
| 4166 ============================================ | |
| 4167 | |
| 4168 This is primarily a bug-fix release. Lots of bugs have been fixed. | |
| 4169 Hopefully only a few have been introduced. The most noteworthy bug | |
| 4170 fixes are: | |
| 4171 | |
| 4172 -- There should be no more problems connecting XEmacs to an X | |
| 4173 server over SLIP or other slow connections. | |
| 4174 -- Periodic crashes when using the Buffers menu should be gone. | |
| 4175 -- etags would sometimes erase the current buffer; it doesn't | |
| 4176 any more. | |
| 4177 -- XEmacs will correctly exit if the X server dies. | |
| 4178 -- uniconified frames are displayed properly under TVTWM. | |
| 4179 -- Breakage in `add-menu-item' / `add-menu-button' is fixed. | |
| 4180 | |
| 4181 The Motif menubar has _NOT_ been fixed for 19.13. You should use the | |
| 4182 Lucid menubar instead. | |
| 4183 | |
| 4184 Multi-device support should now be working properly. You can now open | |
| 4185 an X device after having started out on a TTY device. | |
| 4186 | |
| 4187 Background pixmaps now work. See `set-face-background-pixmap'. | |
| 4188 | |
| 4189 Echo area messages are now saved to a buffer, " *Message Log*". To | |
| 4190 see this buffer, use the command `show-message-log'. It is possible | |
| 4191 to filter the message which are actually included by modifying the | |
| 4192 variables `log-message-ignore-regexps' and `log-message-ignore-labels'. | |
| 4193 | |
| 4194 You can now control which warnings you want to see. See | |
| 4195 `display-warning-suppressed-classes' and friends. | |
| 4196 | |
| 4197 You can now set the default location of an "other window" from the | |
| 4198 Options menu. | |
| 4199 | |
| 4200 "Save Options" now saves the state of all faces. | |
| 4201 | |
| 4202 You can choose which file "Save Options" writes into; see | |
| 4203 `save-options-file'. | |
| 4204 | |
| 4205 XPM support is no longer required for the toolbar. | |
| 4206 | |
| 4207 The relocating allocator is now enabled by default whenever possible. | |
| 4208 This allows buffer memory to be returned to the system when no longer | |
| 4209 in use which helps keep XEmacs process size down. | |
| 4210 | |
| 4211 The ability to have captioned toolbars has been added. Currently only | |
| 4212 the default toolbar actually has a captioned version provided. A new | |
| 4213 specifier variable, `toolbar-buttons-captioned-p' controls whether the | |
| 4214 toolbar is captioned. | |
| 4215 | |
| 4216 A copy of the XEmacs FAQ is now included and is available through info. | |
| 4217 | |
| 4218 The on-line E-Lisp reference manual has been significantly updated. | |
| 4219 | |
| 4220 There is now audio support under Linux. | |
| 4221 | |
| 4222 Modifier keys can now be sticky. This is controlled by the variable | |
| 4223 `modifier-keys-are-sticky'. | |
| 4224 | |
| 4225 manual-entry should now work correctly under Irix with the penalty of | |
| 4226 a longer startup time the first time it is invoked. If you are having | |
| 4227 problems with this on another system try setting | |
| 4228 `Manual-use-subdirectory-list' to t. | |
| 4229 | |
| 4230 make-tty-device no longer automatically creates the first frame. | |
| 4231 | |
| 4232 Rectangular regions now work correctly. | |
| 4233 | |
| 4234 ediff no longer sets synchronize-minibuffers to t unless you first set | |
| 4235 ediff-synchronize-minibuffers | |
| 4236 | |
| 4237 keyboard-translate-table has been implemented. This means that the | |
| 4238 `enable-flow-control' command for dealing with TTY connections that | |
| 4239 filter out ^S and ^Q now works. | |
| 4240 | |
| 4241 You can now create frames that are initially unmapped and frames that | |
| 4242 are "transient for another frame", meaning that they behave more like | |
| 4243 dialog-box frames. | |
| 4244 | |
| 4245 Other E-Lisp changes: | |
| 4246 | |
| 4247 -- Specifier `menubar-visible-p' for controlling menubar visibility | |
| 4248 -- Local command hooks should be set using `local-pre-command-hook' | |
| 4249 and `local-post-command-hook' instead of making the global | |
| 4250 equivalents be buffer-local. | |
| 4251 -- `quit-char', `help-char', `meta-prefix-char' can be any key specifier | |
| 4252 instead of just an integer. | |
| 4253 -- new functions `add-async-timeout' and `disable-async-timeout'. | |
| 4254 These let you create asynchronous timeouts, which are like | |
| 4255 normal timeouts except that they're executed even during | |
| 4256 running Lisp code. Use this with care! | |
| 4257 -- `debug-on-error' and `stack-trace-on-error' now enter the debugger | |
| 4258 only when an *unhandled* error occurs. If you want the old | |
| 4259 behavior, use `debug-on-signal' and `stack-trace-on-signal'. | |
| 4260 -- \U, \L, \u, \l, \E recognized specially in `replace-match'. | |
| 4261 These are standard ex/perl commands for changing the case of | |
| 4262 replaced text. | |
| 4263 -- New function event-matches-key-specifier-p. This provides | |
| 4264 a clean way of comparing keypress events with key specifiers | |
| 4265 such as 65, (shift home), etc. without having to resort | |
| 4266 to ugly `character-to-event' / `event-to-character' hacks. | |
| 4267 -- New function `add-to-list' | |
| 4268 -- New Common-Lisp functions `some', `every', `notevery', `notany', | |
| 4269 `adjoin', `union', `intersection', `set-difference', | |
| 4270 `set-exclusive-or', `subsetp' | |
| 4271 -- `remove-face-property' provides a clean way of removing a | |
| 4272 face property. | |
| 4273 | |
| 4274 Many of the Emacs Lisp packages have been updated. Some of the new | |
| 4275 Emacs Lisp packages --- | |
| 4276 | |
| 4277 ada-mode: major mode for editing Ada source | |
| 4278 | |
| 4279 arc-mode: simple editing of archives | |
| 4280 | |
| 4281 auto-show-mode: automatically scrolls horizontally to keep point on-screen | |
| 4282 | |
| 4283 completion: dynamic word completion mode | |
| 4284 | |
| 4285 dabbrev: the dynamic abbrev package has been rewritten and is much | |
| 4286 more powerful -- e.g. it searches in other buffers as well | |
| 4287 as the current one | |
| 4288 | |
| 4289 easymenu: menu support package | |
| 4290 | |
| 4291 live-icon: makes frame icons represent the current frame contents | |
| 4292 | |
| 4293 mailcrypt 3.2: mail encryption with PGP; included but v2.4 is still | |
| 4294 the default | |
| 4295 | |
| 4296 two-column: for editing two-column text | |
| 4297 | |
| 4298 | |
| 4299 ** Major Differences Between 19.11 and 19.12 | |
| 4300 ============================================ | |
| 4301 | |
| 4302 This is a huge new release. Almost every aspect of XEmacs has been changed | |
| 4303 at least somewhat. The highlights are: | |
| 4304 | |
| 4305 -- TTY support (includes face support) | |
| 4306 -- new redisplay engine; should be faster, less buggy, and more powerful | |
| 4307 -- terminology change from "screen" to "frame" | |
| 4308 -- built-in toolbar | |
| 4309 -- toolbar support added to many packages | |
| 4310 -- multiple device support (still in beta; improvements to come in | |
| 4311 19.13) | |
| 4312 -- Purify used to ensure that there are no memory leaks or memory corruption | |
| 4313 problems | |
| 4314 -- horizontal and vertical scrollbars in all windows | |
| 4315 -- new Lucid (i.e. look-alike Motif) scrollbar widget | |
| 4316 -- stay-up menus in the Lucid (look-alike Motif) menubar widget | |
| 4317 -- 3-d modeline | |
| 4318 -- new extents engine; should be faster, less buggy, and more powerful | |
| 4319 -- much more powerful control over faces | |
| 4320 -- expanded menubar | |
| 4321 -- more work on synching with GNU Emacs 19.28 | |
| 4322 -- new packages: Hyperbole, OOBR (object browser), hm--html-menus, viper, | |
| 4323 lazy-lock.el, ksh-mode.el, rsz-minibuf.el | |
| 4324 -- package updates for all major packages | |
| 4325 -- dynodump package for Solaris: provides proper undumping and portable | |
| 4326 binaries across different OS versions and machine types | |
| 4327 -- Greatly expanded concept of "glyphs" (pixmaps etc. in a buffer) | |
| 4328 -- built-in support for displaying X-Faces, if the X-Face library is | |
| 4329 available | |
| 4330 -- built-in support for SOCKS if the SOCKS library is available | |
| 4331 -- graceful behavior when the colormap is full (e.g. Netscape ate | |
| 4332 all the colors) | |
| 4333 -- built-in MD5 (secure hashing function) support | |
| 4334 | |
| 4335 | |
| 4336 More specific information: | |
| 4337 | |
| 4338 *** TTY Support | |
| 4339 --------------- | |
| 4340 | |
| 4341 The long-awaited TTY support is now available. XEmacs will start up | |
| 4342 in TTY mode (using the tty you started XEmacs from) if the DISPLAY | |
| 4343 environment variable is not set or if you use the `-nw' option. | |
| 4344 | |
| 4345 Faces are available on TTY's. For a demonstration, try editing a C | |
| 4346 file and turning on font-lock-mode. | |
| 4347 | |
| 4348 You can also connect to additional TTY's using `make-tty-device', | |
| 4349 whether your first frame was a TTY or an X window. This ability is | |
| 4350 not yet completely finished. | |
| 4351 | |
| 4352 The full event-loop capabilities (processes, timeouts, etc.) are | |
| 4353 available on TTY's. | |
| 4354 | |
| 4355 | |
| 4356 | |
| 4357 *** New Redisplay Engine | |
| 4358 ------------------------ | |
| 4359 | |
| 4360 The redisplay engine has been rewritten to improve its efficiency and | |
| 4361 to increase its functionality. It should also be significantly more | |
| 4362 bug-free than the previous redisplay engine. | |
| 4363 | |
| 4364 A line that is not big enough to display at the bottom of the window | |
| 4365 will normally be clipped (so that it is partially visible) rather than | |
| 4366 not displayed at all. The variable `pixel-vertical-clip-threshold' | |
| 4367 can be used to control the minimum space that must be available for a | |
| 4368 line to be clipped rather than not displayed at all. | |
| 4369 | |
| 4370 Tabs are displayed in such a way that things line up fairly well even | |
| 4371 in the presence of variable-width fonts and/or lines with | |
| 4372 multiply-sized fonts. | |
| 4373 | |
| 4374 Display tables are implemented, through the specifier variable | |
| 4375 `current-display-table'. They can be buffer-local, window-local, | |
| 4376 frame-local, or device-local. See below for info about specifiers. | |
| 4377 | |
| 4378 | |
| 4379 | |
| 4380 *** Toolbar | |
| 4381 ----------- | |
| 4382 | |
| 4383 There is now built-in support for a toolbar. A sample toolbar is | |
| 4384 visible by default at the top of the frame. Four separate toolbars | |
| 4385 can be configured (at the top, bottom, left, and right of the frame). | |
| 4386 The toolbar specification is similar to the menubar specification. | |
| 4387 The up, down, and disabled glyphs of a toolbar button can be | |
| 4388 separately controlled. Explanatory text can be echoed in the echo | |
| 4389 area when the mouse passes over a toolbar button. The size, contents, | |
| 4390 and visibility of the various toolbars can be controlled on a | |
| 4391 per-buffer, per-window, per-frame, and per-device basis through the | |
| 4392 use of specifiers. See the chapter on toolbars in the Lisp Reference | |
| 4393 Manual (included with XEmacs) for more information. | |
| 4394 | |
| 4395 The toolbar color and shadow thicknesses are currently controlled only | |
| 4396 through `modify-frame-parameters' and through X resources. We are | |
| 4397 planning on making these controllable through specifiers as well. (Our | |
| 4398 hope is to make `modify-frame-parameters' obsolete, as it is a clunky | |
| 4399 and not very powerful mechanism.) | |
| 4400 | |
| 4401 Info, GNUS, VM, W3, and various other packages include custom toolbars | |
| 4402 with them. | |
| 4403 | |
| 4404 | |
| 4405 | |
| 4406 *** Menubar | |
| 4407 ----------- | |
| 4408 | |
| 4409 Stay-up menus are implemented in the look-alike Motif menubar. | |
| 4410 | |
| 4411 The default menubar has been expanded to include most commonly-used | |
| 4412 functions in XEmacs. | |
| 4413 | |
| 4414 The options menu has been greatly expanded to include many more | |
| 4415 options. | |
| 4416 | |
| 4417 The menubar specification format has been greatly expanded. Per-menu | |
| 4418 activation hooks can be specified through the :filter keyword (thus | |
| 4419 obsoleting `activate-menubar-hook'); this allows for fast response | |
| 4420 time when you have a large and complex menu. You can dynamically | |
| 4421 control whether menu items are present through the :included and | |
| 4422 :config keywords. (The latter keyword implements a simple menubar | |
| 4423 configuration scheme, in conjunction with the variable | |
| 4424 `menubar-configuration'.) Many different menu-item separators (single | |
| 4425 or double line; solid or dashed; flat, etched-in, or etched-out) are | |
| 4426 available. See the chapter on menus in the Lisp Reference Manual for | |
| 4427 more information about all of this. | |
| 4428 | |
| 4429 New functions `add-submenu' and `add-menu-button' are available. | |
| 4430 These supersede the older `add-menu' and `add-menu-item' functions, | |
| 4431 and provide a more powerful and consistent interface. | |
| 4432 | |
| 4433 New convenience functions for popping up the part or all of the | |
| 4434 menubar in a pop-up menu are available: `popup-menubar-menu' and | |
| 4435 `popup-buffer-menu'. | |
| 4436 | |
| 4437 Menus are now incrementally constructed greatly improving menubar | |
| 4438 response time. | |
| 4439 | |
| 4440 | |
| 4441 | |
| 4442 *** Scrollbars | |
| 4443 -------------- | |
| 4444 | |
| 4445 A look-alike Motif scrollbar is now included with XEmacs. No longer | |
| 4446 will you have to suffer with ugly Athena scrollbars. | |
| 4447 | |
| 4448 Windows can now have horizontal scrollbars. Normally they are visible | |
| 4449 when the window's buffer is set to truncate lines rather than wrap | |
| 4450 them (e.g. `(setq truncate-lines t)'). | |
| 4451 | |
| 4452 All windows, not only the right-most ones, can have vertical | |
| 4453 scrollbars. | |
| 4454 | |
| 4455 The functions to change a scrollbar's width have been superseded by | |
| 4456 the specifier variables `scrollbar-width' and `scrollbar-height'. | |
| 4457 This allows their values to be controlled on a buffer-local, | |
| 4458 window-local, frame-local, and device-local basis. See below. | |
| 4459 | |
| 4460 The scrollbars interact better with the event loop (for example, you | |
| 4461 can type `C-h k', do a scrollbar action, and see a description of this | |
| 4462 scrollbar action printed as if you had pressed a key sequence or | |
| 4463 selected a menu item). | |
| 4464 | |
| 4465 The scrollbar behavior can be reprogrammed, by advising the | |
| 4466 `scrollbar-*' functions. | |
| 4467 | |
| 4468 | |
| 4469 | |
| 4470 *** Key Bindings | |
| 4471 ---------------- | |
| 4472 | |
| 4473 The oft-used function `goto-line' now has its own binding: M-g. | |
| 4474 | |
| 4475 New bindings are available for scrolling the "other" window: M-next, | |
| 4476 M-prior, M-home, M-end. (On many keyboards, `next' and `prior' | |
| 4477 labelled `PgUp' and `PgDn'.) | |
| 4478 | |
| 4479 You can reactivate a deactivated Zmacs region, without having any | |
| 4480 other effects, with the binding M-C-z. | |
| 4481 | |
| 4482 The bindings `M-u', `M-l', and `M-c' now work on the region (if a | |
| 4483 region is active) or work on a word, as before. | |
| 4484 | |
| 4485 Shift-Control-G forces a "critical quit", which drops immediately into | |
| 4486 the debugger; see below. | |
| 4487 | |
| 4488 | |
| 4489 | |
| 4490 *** Modeline | |
| 4491 ------------ | |
| 4492 | |
| 4493 The modeline can now have a 3-d look; this is enabled by default. The | |
| 4494 specifier variable `modeline-shadow-thickness' controls the size. | |
| 4495 | |
| 4496 The modeline can now be turned off on a per-buffer, per-window, | |
| 4497 per-frame, or per-device basis. The specifier variable | |
| 4498 `has-modeline-p' controls whether the modeline is visible. See below | |
| 4499 for details about the vastly powerful specifier mechanism. | |
| 4500 | |
| 4501 The modeline functions and variables have been renamed to be | |
| 4502 `*-modeline-*' rather than `*-mode-line-*'. Aliases are provided for | |
| 4503 all the old names. | |
| 4504 | |
| 4505 Variable width fonts now work correctly when used in the modeline. | |
| 4506 | |
| 4507 | |
| 4508 | |
| 4509 *** Minibuffer, Echo Area | |
| 4510 ------------------------- | |
| 4511 | |
| 4512 The minibuffer is no longer constrained to be one line high. The | |
| 4513 package rsz-minibuf.el is included to automatically resize the | |
| 4514 minibuffer when its contents are too big; enable this with | |
| 4515 `resize-minibuffer-mode'. | |
| 4516 | |
| 4517 The echo area is now a true buffer, called " *Echo Area*". This | |
| 4518 allows you to customize the echo area behavior through | |
| 4519 before-change-functions and after-change-functions. | |
| 4520 | |
| 4521 | |
| 4522 | |
| 4523 *** Specifiers | |
| 4524 -------------- | |
| 4525 | |
| 4526 XEmacs has a new concept called "specifiers", used to configure most | |
| 4527 display options (toolbar size and contents, scrollbar size, face | |
| 4528 properties, modeline visibility and shadow-thickness, glyphs, display | |
| 4529 tables, etc.). We are planning on converting all display | |
| 4530 characteristics to use specifiers, and obsoleting the clunky functions | |
| 4531 `frame-parameters' and `modify-frame-parameters'. Specifically: | |
| 4532 | |
| 4533 -- You can specify values (called "instantiators") for particular | |
| 4534 "locales" (i.e. buffers, windows, frames, devices, or a global value). | |
| 4535 When determining what the actual value (or "instance") of a specifier | |
| 4536 is, the specifications that are provided are searched from most | |
| 4537 specific (i.e. buffer-local) to most general (i.e. global), looking | |
| 4538 for a matching one. | |
| 4539 | |
| 4540 -- You can specify multiple instantiators for a particular locale. | |
| 4541 For example, when specifying what the foreground color of a face | |
| 4542 is in a particular buffer, you could specify two instantiators: | |
| 4543 "dark sea green" and "green". The color would then be dark sea | |
| 4544 green on devices that recognize that color, and green on other | |
| 4545 devices. You have effectively provided a fallback value to make | |
| 4546 sure you get reasonable behavior on all devices. | |
| 4547 | |
| 4548 -- You can add one or more tags to an instantiator, where a tag | |
| 4549 is a symbol that has been previously registered with XEmacs. | |
| 4550 This allows you to identify your instantiators for later | |
| 4551 removal in a way that won't interfere with other applications | |
| 4552 using the same specifier. Furthermore, particular tags can | |
| 4553 be restricted to match only particular sorts of devices. | |
| 4554 Any tagged instantiator will be ignored if the device over which | |
| 4555 it is being instanced does not match any of its tags. This | |
| 4556 allows you, for example, to restrict an instantiator to a | |
| 4557 particular device type (X or TTY) and/or class (color, grayscale, | |
| 4558 or mono). (You might want to specify, for example, that a | |
| 4559 particular face is displayed in green on color devices and is | |
| 4560 underlined on mono devices.) | |
| 4561 | |
| 4562 -- A full API is provided for manipulating specifiers, and full | |
| 4563 documentation is provided in the Lisp Reference Manual. | |
| 4564 | |
| 4565 | |
| 4566 | |
| 4567 *** Basic Lisp Stuff | |
| 4568 -------------------- | |
| 4569 | |
| 4570 Common-Lisp backquote syntax is recognized. For example, the old | |
| 4571 expression | |
| 4572 | |
| 4573 (` (a b (, c))) | |
| 4574 | |
| 4575 can now be written | |
| 4576 | |
| 4577 `(a b ,c) | |
| 4578 | |
| 4579 The old backquote syntax is still accepted. | |
| 4580 | |
| 4581 The new function `type-of' returns a symbol describing the type of a | |
| 4582 Lisp object (`integer', `string', `symbol', etc.) | |
| 4583 | |
| 4584 Symbols beginning with a colon (called "keywords") are treated | |
| 4585 specially in that they are automatically made self-evaluating when | |
| 4586 they are interned into `obarray'. The new function `keywordp' returns | |
| 4587 whether a symbol begins with a colon. | |
| 4588 | |
| 4589 `get', `put', and `remprop' have been generalized to allow you to set | |
| 4590 and retrieve properties on many different kinds of objects: symbols, | |
| 4591 strings, faces, glyphs, and extents (for extents, however, this is not | |
| 442 | 4592 yet implemented). They are joined by a new function `object-plist' |
| 428 | 4593 that returns all of the properties that have been set on an object. |
| 4594 | |
| 4595 New functions `plists-eq' and `plists-equal' are provided for | |
| 4596 comparing property lists (a property list is an alternating list | |
| 4597 of keys and values). | |
| 4598 | |
| 4599 The Common-Lisp functions `caar', `cadr', `cdar', `cddr', `caaar', etc. | |
| 4600 (up to four a's and/or d's), `first', `second', `third', etc. (up to | |
| 4601 `tenth'), `last', `rest', and `endp' have been added, for more | |
| 4602 convenient manipulation of lists. | |
| 4603 | |
| 4604 New function `mapvector' maps over a sequence and returns a vector | |
| 4605 of the results, analogous to `mapcar'. | |
| 4606 | |
| 4607 New functions `rassoc', `remassoc', `remassq', `remrassoc', and | |
| 4608 `remrassq' are provided for working with alists. | |
| 4609 | |
| 4610 New functions `defvaralias', `variable-alias' and `indirect-variable' | |
| 4611 are provided for creating variable aliases. | |
| 4612 | |
| 4613 Strings have a modified-tick that is bumped every time a string | |
| 4614 is modified in-place with `aset' or `fillarray'. This is retrieved | |
| 4615 with the new function `string-modified-tick'. | |
| 4616 | |
| 4617 New macro `push' destructively adds an element to the beginning of a | |
| 4618 list. New macro `pop' destructively removes and returns the first | |
| 4619 element of a list. | |
| 4620 | |
| 4621 | |
| 4622 | |
| 4623 *** Buffers | |
| 4624 ----------- | |
| 4625 | |
| 4626 Most functions that operate on buffer text now take an optional BUFFER | |
| 4627 argument, specifying which buffer they operate on. (Previously, they | |
| 4628 always operated on the current buffer.) | |
| 4629 | |
| 4630 The new function `transpose-regions' is provided, ported from GNU | |
| 4631 Emacs. | |
| 4632 | |
| 4633 The new function `save-current-buffer' works like `save-excursion' | |
| 4634 but only saves the current buffer, not the location of point in | |
| 4635 that buffer. | |
| 4636 | |
| 4637 | |
| 4638 | |
| 4639 *** Devices | |
| 4640 ----------- | |
| 4641 | |
| 4642 XEmacs has a new concept of "device", which is represents a particular | |
| 4643 X display or TTY connection. `make-frame' has a new, optional device | |
| 4644 parameter that allows you to specify which device the frame is to be | |
| 4645 created on. | |
| 4646 | |
| 4647 Multiple simultaneous TTY and/or X connections may be made. The | |
| 4648 specifier mechanism provides reasonable behavior of glyphs, faces, | |
| 4649 etc. over heterogeneous device types and over devices whose individual | |
| 4650 capabilities may vary. | |
| 4651 | |
| 4652 There is also a device type called "stream" that represents a STDIO | |
| 4653 device that has no redisplay or cursor-motion capabilities, such as | |
| 4654 the "glass terminal" that XEmacs uses when it is run noninteractively. | |
| 4655 There is not all that much you can do with stream devices currently; | |
| 4656 please let us know if there are good uses you can think of for this | |
| 4657 capability. (For example, log files?) | |
| 4658 | |
| 4659 A new device API is provided. Functions are provided such as | |
| 4660 `device-name' (the name of the device, which generally is based on the | |
| 4661 X display or TTY file name), `device-type' (X, TTY, or stream), | |
| 4662 `device-class' (color, grayscale, or mono), etc. See the Lisp | |
| 4663 Reference Manual. | |
| 4664 | |
| 4665 Many functions have been extended to contain an additional, optional | |
| 4666 device argument, where such an extension makes sense. In general, if | |
| 4667 the argument is omitted, it is equivalent to specifying | |
| 4668 `(selected-device)'. | |
| 4669 | |
| 4670 Many previous functions and variables are obsoleted in favor of the | |
| 4671 device API. For example, `window-system' is obsoleted by | |
| 4672 `device-type', and `x-color-display-p' and friends are obsoleted by | |
| 4673 `device-class'. | |
| 4674 | |
| 4675 *** NOTE **: The obsolete variable `window-system' is going | |
| 4676 to be deleted soon, probably in 19.14. Please correct all | |
| 4677 your code to use `device-type'. | |
| 4678 | |
| 4679 *** INCOMPATIBLE CHANGE **: The function `x-display-visual-class' | |
| 4680 returns different values from previous versions of XEmacs. | |
| 4681 | |
| 4682 | |
| 4683 | |
| 4684 *** Errors, Warnings, C-g | |
| 4685 ------------------------- | |
| 4686 | |
| 4687 There is a new warnings system implemented. Many warnings that were | |
| 4688 formerly displayed in various ad-hoc ways (e.g. warnings about screwy | |
| 4689 modifier mappings, messages about failures handling the mouse cursor | |
| 4690 and errors in a gc-hook) have been regularized through this system. | |
| 4691 The new function `warn' displays a warning before the next redisplay | |
| 4692 (the actually display of the warning messages is accomplished through | |
| 4693 `display-warning-buffer'). Both `warn' and `display-warning-buffer' | |
| 4694 are Lisp functions (the C code calls out to them as necessary), and | |
| 4695 thus you can customize the warning system. | |
| 4696 | |
| 4697 Under an X display, you can press Shift-Control-G to force a "critical | |
| 4698 quit". This will immediately display a backtrace and pop you into the | |
| 4699 debugger, regardless of the settings of `inhibit-quit' and | |
| 4700 `debug-on-quit'. | |
| 4701 | |
| 4702 C-g now works properly even on systems that don't implement SIGIO or | |
| 4703 for which SIGIO is broken (e.g. IRIX 5.3 and older versions of Linux). | |
| 4704 In addition, the SIGIO support has been fixed for many systems on | |
| 4705 which it didn't always work properly before (e.g. HPUX and Solaris). | |
| 4706 | |
| 4707 | |
| 4708 | |
| 4709 *** Events | |
| 4710 ---------- | |
| 4711 | |
| 4712 *** INCOMPATIBLE CHANGE **: Many event functions have been changed to | |
| 4713 accept and return windows instead of frames. | |
| 4714 | |
| 4715 New function: `event-live-p', specifying whether `deallocate-event' | |
| 4716 has been called on an event. | |
| 4717 | |
| 4718 The "menu event" type has been renamed to "misc-user event", and | |
| 4719 encompasses scrollbar events as well as menu events. We are planning | |
| 4720 on making it also encompass toolbar events in a future release. | |
| 4721 | |
| 4722 New functions are provided for determining whether an particular | |
| 4723 sections of a frame: `event-over-border-p', `event-over-glyph-p', | |
| 4724 `event-over-modeline-p', `event-over-text-area-p', and | |
| 4725 `event-over-toolbar-p'. The old, kludgey methods of checking the | |
| 4726 window-height, the internal-border-width, etc. are unreliable and | |
| 4727 should not be used. | |
| 4728 | |
| 4729 New functions `event-window-x-pixel' and `event-window-y-pixel' are | |
| 4730 provided for determining where in a particular window an event | |
| 4731 happened. | |
| 4732 | |
| 4733 New functions `event-glyph-x-pixel' and `event-glyph-y-pixel' are | |
| 4734 provided for determining where in a particular glyph an event | |
| 4735 happened. | |
| 4736 | |
| 4737 New function `event-closest-point', which returns the closest buffer | |
| 4738 position to the event even if the event did not occur over any text. | |
| 4739 | |
| 4740 New variable `unread-command-events', superseding the older | |
| 4741 `unread-command-event'. | |
| 4742 | |
| 4743 Many event-loop bugs have been fixed. | |
| 4744 | |
| 4745 | |
| 4746 | |
| 4747 *** Extents | |
| 4748 ----------- | |
| 4749 | |
| 4750 The extent code has been largely rewritten. It should be faster and | |
| 4751 more reliable. | |
| 4752 | |
| 4753 The text-property implementation has been greatly improved. | |
| 4754 | |
| 4755 Some new extent primitives are provided to return the position of the | |
| 4756 next or previous property change in a buffer. | |
| 4757 | |
| 4758 Extents can now have a parent specified; then all of its properties | |
| 4759 (except for the buffer it's in and its position in that buffer) come | |
| 4760 from that extent. Hierarchies of such extents can be created. | |
| 4761 | |
| 4762 Extents now have a `detachable' property that controls what happens | |
| 4763 (they either get detached or shrink down to zero-length) when their | |
| 4764 text is deleted. Previously, such extents would always be detached. | |
| 4765 | |
| 4766 The `invisible' property on extents now works. | |
| 4767 | |
| 4768 `map-extents' has three additional parameters that provide more | |
| 4769 control over which extents are mapped. | |
| 4770 | |
| 4771 `map-extents' deals better with changes made to extents in the | |
| 4772 buffer being mapped over. | |
| 4773 | |
| 4774 A new function `mapcar-extents' (an alternative to `map-extents') has | |
| 4775 been provided and should be easier to use than `map-extents'. | |
| 4776 | |
| 4777 | |
| 4778 | |
| 4779 *** Faces | |
| 4780 --------- | |
| 4781 | |
| 4782 Faces can now be buffer-local, window-local, and device-local as well | |
| 4783 as frame-local, and can be further restricted to a particular device | |
| 4784 type or class. The way in which faces can be controlled is now based | |
| 4785 on the general and powerful specifier mechanism; see above. | |
| 4786 | |
| 4787 The new function `set-face-property' generalizes `set-face-font', | |
| 4788 `set-face-foreground', etc. and takes many new optional arguments, in | |
| 4789 accordance with the new specifier mechanism. | |
| 4790 | |
| 4791 The new functions `face-property' and `face-property-instance' | |
| 4792 generalize `face-font', `face-foreground', etc. and take many new | |
| 4793 optional arguments, in accordance with the new specifier mechanism. | |
| 4794 (`face-property' returns the value, if any, that was specified for a | |
| 4795 particular locale, and `face-property-instance' returns the actual | |
| 4796 value that will be used for display. See the section on specifiers.) | |
| 4797 | |
| 4798 The functions `face-font', `face-foreground', `face-background', | |
| 4799 `set-face-font', `set-face-foreground', `set-face-background', | |
| 4800 etc. are now convenience functions, trivially implemented using | |
| 4801 `face-property' and `set-face-property' and take new optioanl | |
| 4802 arguments in accordance with those functions. New convenience | |
| 4803 functions `face-font-instance', `face-foreground-instance', | |
| 4804 `face-background-instance', etc. are provided and are trivially | |
| 4805 implemented using `face-property-instance'. | |
| 4806 | |
| 4807 Inheritance of face properties can now be specified. Each individual | |
| 4808 face property can inherit differently from other properties, or not | |
| 4809 inherit at all. | |
| 4810 | |
| 4811 You can set user-defined properties on faces using | |
| 4812 `set-face-property'. | |
| 4813 | |
| 4814 You can create "temporary" faces, which are faces that disappear | |
| 4815 when they are no longer in use. This is as opposed to normal | |
| 4816 faces, which stay around forever. | |
| 4817 | |
| 4818 The function `make-face' takes a new optional argument specifying | |
| 4819 whether a face should be permanent or temporary, and returns the | |
| 4820 actual face object rather than the face symbol, as in previous | |
| 4821 versions of XEmacs. | |
| 4822 | |
| 4823 The function `face-list' takes a new optional argument specifying | |
| 4824 whether permanent, temporary, or both kinds of faces should be | |
| 4825 returned. | |
| 4826 | |
| 4827 Faces have new TTY-specific properties: `highlight', `reverse', | |
| 4828 `alternate', `blinking', and `dim'. | |
| 4829 | |
| 4830 Redisplay is smarter about dealing with face changes: changes to a | |
| 4831 particular face no longer cause all frames to be cleared and | |
| 4832 redisplayed. | |
| 4833 | |
| 4834 The Edit-Faces package is provided for interactively changing faces. | |
| 4835 A menu item on the options menu is provided for this. | |
| 4836 | |
| 4837 New functions are provided for retrieving the ascent, descent, height, | |
| 4838 and width of a character in a particular face. | |
| 4839 | |
| 4840 | |
| 4841 | |
| 4842 *** Fonts, Colors | |
| 4843 ----------------- | |
| 4844 | |
| 4845 *** INCOMPATIBLE CHANGE **: The old "font" and "pixel" objects are gone. | |
| 4846 In place are new objects "font specifier", "font instance", "color | |
| 4847 specifier", and "color instance". Functions `font-name', `pixel-name' | |
| 4848 (an obsolete alias for `color-name'), etc. are now convenience | |
| 4849 functions for working with font and color specifiers. Old code that | |
| 4850 is not too sophisticated about working with font and pixel objects may | |
| 4851 still work, though. (For example, the idiom `(font-name (face-font | |
| 4852 'default))' still works.) | |
| 4853 | |
| 4854 You can now extract the RGB components of a color-instance object | |
| 4855 (similar to the old pixel object) with the function | |
| 4856 `color-instance-rgb-components'. There is also a convenience function | |
| 4857 `color-rgb-components' for working with color specifiers. | |
| 4858 | |
| 4859 If there are no more colors available in the colormap, the nearest | |
| 4860 existing color will be used when allocating a new color. | |
| 4861 | |
| 4862 | |
| 4863 | |
| 4864 *** Frames | |
| 4865 ---------- | |
| 4866 | |
| 4867 What used to be called "screens" are now called "frames", for clarity | |
| 4868 and consistency with GNU Emacs. Aliases are provided for all the old | |
| 4869 screen functions and variables, to avoid introducing a huge E-Lisp | |
| 4870 incompatibility. | |
| 4871 | |
| 4872 The frame code has been merged with GNU Emacs 19.28, providing | |
| 4873 improved functionality for many functions. | |
| 4874 | |
| 4875 | |
| 4876 | |
| 4877 *** Glyphs, Images, and Pixmaps | |
| 4878 ------------------------------- | |
| 4879 | |
| 4880 Glyphs (used in various places, i.e. as begin-glyphs and end-glyphs | |
| 4881 attached to extents and appearing in a buffer or in marginal | |
| 4882 annotations; as the truncator and continuor glyphs marking line wrap | |
| 4883 or truncation; as an overlay at the beginning of a line; as the | |
| 4884 displayable element in a toolbar button; etc.) can now be | |
| 4885 buffer-local, window-local, frame-local, and device-local, and can be | |
| 4886 further restricted to a particular device type or class. The way in | |
| 4887 which faces can be controlled is now based on the general and powerful | |
| 4888 specifier mechanism; see above. | |
| 4889 | |
| 4890 *** INCOMPATIBLE CHANGE **: The glyph and pixmap API has been completely | |
| 4891 overhauled. A new Lisp object "glyph" is provided and should be used | |
| 4892 where the old "pixmap" object would have been used. The pixmap object | |
| 4893 exists no longer. There are also new Lisp objects "image specifier" | |
| 4894 and "image instance" (an image-instance is the closest equivalent to | |
| 4895 what a pixmap object was). More work on glyphs and images is slated | |
| 4896 for 19.13. The glyph and image docs in the Lisp Reference Manual are | |
| 4897 incomplete and will be finished in 19.13. | |
| 4898 | |
| 4899 The new function `set-glyph-property' allows setting of all the | |
| 4900 glyph properties (`baseline', `contrib-p', etc.). Convenience | |
| 4901 functions for particular properties are also provided, just like | |
| 4902 for faces. | |
| 4903 | |
| 4904 You can set user-defined properties on glyphs using the new function | |
| 4905 `set-glyph-property'. | |
| 4906 | |
| 4907 When displaying pixmaps, existing, closest-matching colors will be | |
| 4908 used if the colormap is full. | |
| 4909 | |
| 4910 If the compface library is compiled into XEmacs, there is built-in | |
| 4911 support for displaying X-Face bitmaps. (These are typically small | |
| 4912 pictures of people's faces, included in a mail message through the | |
| 4913 X-Face: header.) VM and highlight-headers will automatically use the | |
| 4914 built-in X-Face support if it is available. | |
| 4915 | |
| 4916 Annotations in the right margin (as well as the left margin) are now | |
| 4917 implemented. The left and right margin width functions have been | |
| 4918 superseded by the specifier variables `left-margin-width' and | |
| 4919 `right-margin-width', allowing much more flexible control through the | |
| 4920 specifier mechanism. | |
| 4921 | |
| 4922 *** INCOMPATIBLE CHANGE **: The variable `use-left-overflow', | |
| 4923 for controlling annotations in the left margin, is now a specifier | |
| 4924 variable instead of a buffer-local variable. (There is also a new | |
| 4925 variable `use-right-overflow', that is complementary.) | |
| 4926 | |
| 4927 | |
| 4928 | |
| 4929 *** Hashing | |
| 4930 ----------- | |
| 4931 | |
| 4932 Two new types of weak hashtables can be created: key-weak and | |
| 4933 value-weak. In a key-weak hashtable, an entry remains around | |
| 4934 if its key is referenced elsewhere, regardless of whether this | |
| 4935 is also the case for the value. Value-weak hashtables are | |
| 4936 complementary. (This is as opposed to the traditional weak | |
| 4937 hashtables, where an entry remains around only if both the | |
| 4938 key and value are referenced elsewhere.) New functions | |
| 4939 `make-key-weak-hashtable' and `make-value-weak-hashtable' | |
| 4940 are provided for creating these hashtables. | |
| 4941 | |
| 4942 The new function `md5' is provided for performing an MD5 | |
| 4943 hash of an object. MD5 is a secure message digest algorithm | |
| 4944 developed by RSA, inc. | |
| 4945 | |
| 4946 | |
| 4947 | |
| 4948 *** Keymaps | |
| 4949 ----------- | |
| 4950 | |
| 4951 The GNU Emacs concept of `function-key-map' is now partially | |
| 4952 implemented. This allows conversion of function-key escape sequences | |
| 4953 such as `ESC [ 1 1 ~' into an equivalent human-readable keysym such as | |
| 4954 `F1'. This work will be completed in 19.14. The function-key map is | |
| 4955 device-local and controllable through the functions | |
| 4956 `device-function-key-map' and `set-device-function-key-map'. | |
| 4957 | |
| 4958 `where-is-internal' now correctly searches minor-mode keymaps, | |
| 4959 extent-local keymaps, etc. As a side effect of this, menu items will | |
| 4960 now correctly show the keyboard equivalent for commands that are | |
| 4961 available through a minor-mode keymap, extent-local keymap, etc. | |
| 4962 | |
| 4963 *** INCOMPATIBLE CHANGE **: The modifier key "Symbol" has | |
| 4964 been renamed to "Alt", for compatibility with the rest of the world. | |
| 4965 Keep in mind that on many keyboards, the key labelled "Alt" actually | |
| 4966 generates the "Meta" modifier. (On Sun keyboards, however, the key | |
| 4967 labelled "Alt" does indeed generate the "Alt" modifier, and the key | |
| 4968 labelled with a diamond generates the "Meta" modifier.) | |
| 4969 | |
| 4970 | |
| 4971 | |
| 4972 *** Mouse, Active Region | |
| 4973 ------------------------ | |
| 4974 | |
| 4975 The mouse internals in mouse.el have been rewritten. Hooks have been | |
| 4976 provided for easier customization of mouse behavior. For example, you | |
| 4977 can now easily specify an action to be invoked on single-click | |
| 4978 (i.e. down-up without appreciable motion), double-click, drag-up, etc. | |
| 4979 | |
| 4980 Some code from GNU Emacs has been ported over, generalizing some of | |
| 4981 the X-specific mouse stuff. | |
| 4982 | |
| 4983 *** INCOMPATIBLE CHANGE **: The function `set-mouse-position' accepts | |
| 4984 a window instead of a frame. | |
| 4985 | |
| 4986 New function `mouse-position' that obsoletes and is more powerful than | |
| 4987 `read-mouse-position'. | |
| 4988 | |
| 4989 New functions `mouse-pixel-positon' and `set-mouse-pixel-position' for | |
| 4990 working with pixels instead of characters. | |
| 4991 | |
| 4992 The active (Zmacs) region is now highlighted using the `zmacs-region-face' | |
| 4993 instead of the `primary-selection-face'; this generalizes what used | |
| 4994 to be X-specific. | |
| 4995 | |
| 4996 New functions `region-active-p', `region-exists-p', and `activate-region' | |
| 4997 provide a uniform API for dealing with the region irrespective of | |
| 4998 whether the variable `zmacs-regions' is set. | |
| 4999 | |
| 5000 XEmacs is now a better X citizen with respect to the primary selection: | |
| 5001 it does not stomp on the primary selection quite so much. This makes | |
| 5002 things more manageable if you set `zmacs-regions' to nil. | |
| 5003 | |
| 5004 | |
| 5005 | |
| 5006 *** Processes | |
| 5007 ------------- | |
| 5008 | |
| 5009 Various process race conditions and bugs have been fixed. Problems | |
| 5010 with process termination not getting noticed until much later (if at | |
| 5011 all) should be gone now, as well as problems with zombie processes | |
| 5012 under some systems. | |
| 5013 | |
| 5014 SOCKS support is now included. SOCKS is a package that allows hosts | |
| 5015 behind a firewall to gain full access to the Internet without | |
| 5016 requiring direct IP reachability. | |
| 5017 | |
| 5018 | |
| 5019 | |
| 5020 *** Windows | |
| 5021 ----------- | |
| 5022 | |
| 5023 Windows 95 is still not out yet. | |
| 5024 | |
| 5025 *** INCOMPATIBLE CHANGE **: The functions `locate-window-from-coordinates' | |
| 5026 and `window-edges' have been eliminated. It no longer makes sense to | |
| 5027 work with windows in terms of character positions, because windows can | |
| 5028 (and often do) have many differently-sized fonts in them, because the | |
| 5029 3-D modeline is not exactly one line high, etc. | |
| 5030 | |
| 5031 The new functions `window-pixel-edges', `window-highest-p', | |
| 5032 `window-lowest-p', `frame-highest-window', and `frame-lowest-window' | |
| 5033 are provided as substitutes for the above-mentioned, deleted | |
| 5034 functions. | |
| 5035 | |
| 5036 The function `window-end' now takes an optional GUARANTEE argument | |
| 5037 that will ensure that the value is actually correct as of the next | |
| 5038 redisplay. | |
| 5039 | |
| 5040 The window code has been merged with GNU Emacs 19.28, providing | |
| 5041 improved functionality for many functions. | |
| 5042 | |
| 5043 | |
| 5044 | |
| 5045 *** System-Specific Information | |
| 5046 ------------------------------- | |
| 5047 | |
| 5048 Georg Nikodym's dynodump package is provided, for proper unexec()ing | |
| 5049 on Solaris systems. Executables built on Solaris 2.3 can now run on | |
| 5050 Solaris 2.4 without crashing; similarly with executables built on one | |
| 5051 type of Sun machine and run on another. | |
| 5052 | |
| 5053 AIX 4.x is supported. | |
| 5054 | |
| 5055 The NeXTstep operating system is supported in TTY mode (this is still | |
| 5056 in beta). There are plans to port XEmacs to the NeXTstep window | |
| 5057 system, but it may be awhile before this is complete. | |
| 5058 | |
| 5059 Problems with the `round' function causing arithmetic errors on HPUX 9 | |
| 5060 have been fixed. | |
| 5061 | |
| 5062 You can now build XEmacs as an ELF executable on Linux systems that | |
| 5063 support ELF. | |
| 5064 | |
| 5065 Various other new system configurations are supported. | |
| 5066 | |
| 5067 | |
| 5068 | |
| 5069 | |
| 5070 ** Major Differences Between 19.10 and 19.11 | |
| 5071 ============================================ | |
| 5072 | |
| 5073 The name has changed from "Lucid Emacs" to "XEmacs". Along with this is a | |
| 5074 new canonical ftp site: cs.uiuc.edu:/pub/xemacs. | |
| 5075 | |
| 5076 XEmacs now has its very own World Wide Web page! It contains a | |
| 5077 complete list of the FTP distribution sites, the most recent FAQ, | |
| 5078 pointers to Emacs Lisp packages not included with the distribution, and | |
| 5079 other useful stuff. Check it out at http://xemacs.cs.uiuc.edu/. | |
| 5080 | |
| 5081 A preliminary New Users Guide. | |
| 5082 | |
| 5083 cc-mode.el now provides the default C, C++ and Objective-C modes. | |
| 5084 | |
| 5085 The primary goal of this release is stability. Very few new features have | |
| 5086 been introduced but lots of bugs have been fixed. Many of the Emacs Lisp | |
| 5087 packages have been updated. | |
| 5088 | |
| 5089 Some of the new Emacs Lisp packages --- | |
| 5090 | |
| 5091 tcl-mode.el: major mode for editing TCL code | |
| 5092 | |
| 5093 fast-lock.el: saves and restores font-lock highlighting, greatly | |
| 5094 reducing the time necessary for loading a font-lock'ed | |
| 5095 file | |
| 5096 | |
| 5097 ps-print.el: prints buffers to Postscript printers preserving the | |
| 5098 buffer's bold and italic text attributes | |
| 5099 | |
| 5100 toolbar.el: provides a "fake" toolbar for use with XEmacs (an | |
| 5101 integrated one will be included with 19.12) | |
| 5102 | |
| 5103 | |
| 5104 ** Major Differences Between 19.9 and 19.10 | |
| 5105 =========================================== | |
| 5106 | |
| 5107 The GNU `configure' system is now used to build lemacs. | |
| 5108 | |
| 5109 The Emacs Manual and Emacs Lisp Reference Manual now document version 19.10. | |
| 5110 If you notice any errors, please let us know. | |
| 5111 | |
| 5112 When pixmaps are displayed in a buffer, they contribute to the line height - | |
| 5113 that is, if the glyph is taller than the rest of the text on the line, the | |
| 5114 line will be as tall as necessary to display the glyph. | |
| 5115 | |
| 5116 In addition to using arbitrary sound files as emacs beeps, one can control | |
| 5117 the pitch and duration of the standard X beep, on X servers which allow that | |
| 5118 (Note: most don't.) | |
| 5119 | |
| 5120 There is support for playing sounds on systems with NetAudio servers. | |
| 5121 | |
| 5122 Minor modes may have mode-specific key bindings; keymaps may have an arbitrary | |
| 5123 number of parent maps. | |
| 5124 | |
| 5125 Menus can have toggle and radio buttons in them. | |
| 5126 | |
| 5127 There is a font selection menu. | |
| 5128 | |
| 5129 Some default key bindings have changed to match FSF19; the new bindings are | |
| 5130 | |
| 5131 Screen-related commands: | |
| 5132 C-x 5 2 make-screen | |
| 5133 C-x 5 0 delete-screen | |
| 5134 C-x 5 b switch-to-buffer-other-screen | |
| 5135 C-x 5 f find-file-other-screen | |
| 5136 C-x 5 C-f find-file-other-screen | |
| 5137 C-x 5 m mail-other-screen | |
| 5138 C-x 5 o other-screen | |
| 5139 C-x 5 r find-file-read-only-other-screen | |
| 5140 Abbrev-related commands: | |
| 5141 C-x a l add-mode-abbrev | |
| 5142 C-x a C-a add-mode-abbrev | |
| 5143 C-x a g add-global-abbrev | |
| 5144 C-x a + add-mode-abbrev | |
| 5145 C-x a i g inverse-add-global-abbrev | |
| 5146 C-x a i l inverse-add-mode-abbrev | |
| 5147 C-x a - inverse-add-global-abbrev | |
| 5148 C-x a e expand-abbrev | |
| 5149 C-x a ' expand-abbrev | |
| 5150 Register-related commands: | |
| 5151 C-x r C-SPC point-to-register | |
| 5152 C-x r SPC point-to-register | |
| 5153 C-x r j jump-to-register | |
| 5154 C-x r s copy-to-register | |
| 5155 C-x r x copy-to-register | |
| 5156 C-x r i insert-register | |
| 5157 C-x r g insert-register | |
| 5158 C-x r r copy-rectangle-to-register | |
| 5159 C-x r c clear-rectangle | |
| 5160 C-x r k kill-rectangle | |
| 5161 C-x r y yank-rectangle | |
| 5162 C-x r o open-rectangle | |
| 5163 C-x r t string-rectangle | |
| 5164 C-x r w window-configuration-to-register | |
| 5165 Narrowing-related commands: | |
| 5166 C-x n n narrow-to-region | |
| 5167 C-x n w widen | |
| 5168 Other changes: | |
| 5169 C-x 3 split-window-horizontally (was undefined) | |
| 5170 C-x - shrink-window-if-larger-than-buffer | |
| 5171 C-x + balance-windows | |
| 5172 | |
| 5173 The variable allow-deletion-of-last-visible-screen has been removed, since | |
| 5174 it was widely hated. You can now always delete the last visible screen if | |
| 5175 there are other iconified screens in existence. | |
| 5176 | |
| 5177 ToolTalk support is provided. | |
| 5178 | |
| 5179 An Emacs screen can be placed within an "external client widget" managed | |
| 5180 by another application. This allows an application to use an Emacs screen | |
| 5181 as its text pane rather than the standard Text widget that is provided | |
| 5182 with Motif or Athena. | |
| 5183 | |
| 5184 Additional compatibility with Epoch is provided (though this is not yet | |
| 5185 complete.) | |
| 5186 | |
| 5187 | |
| 5188 ** Major Differences Between 19.8 and 19.9 | |
| 5189 ========================================== | |
| 5190 | |
| 5191 Scrollbars! If you have Motif, these are real Motif scrollbars; otherwise, | |
| 5192 Athena scrollbars are used. They obey all the usual resources of their | |
| 5193 respective toolkits. | |
| 5194 | |
| 5195 There is now an implementation of dialog boxes based on the Athena | |
| 5196 widgets, as well as the existing Motif implementation. | |
| 5197 | |
| 5198 This release works with Motif 1.2 as well as 1.1. If you link with Motif, | |
| 5199 you do not also need to link with Athena. | |
| 5200 | |
| 5201 If you compile lwlib with both USE_MOTIF and USE_LUCID defined (which is the | |
| 5202 recommended configuration) then the Lucid menus will draw text using the Motif | |
| 5203 string-drawing library, instead of the Xlib one. The reason for this is that | |
| 5204 one can take advantage of the XmString facilities for including non-Latin1 | |
| 5205 characters in resource specifications. However, this is a user-visible change | |
| 5206 in that, in this configuration, the menubar will use the "*fontList" resource | |
| 5207 in preference to the "*font" resource, if it is set. | |
| 5208 | |
| 5209 It's possible to make extents which are copied/pasted by kill and undo. | |
| 5210 There is an implementation of FSF19-style text properties based on this. | |
| 5211 | |
| 5212 There is a new variable, minibuffer-max-depth, which is intended to circumvent | |
| 5213 a common source of confusion among new Emacs users. Since, under a window | |
| 5214 system, it's easy to jump out of the minibuffer (by doing M-x, then getting | |
| 5215 distracted, and clicking elsewhere) many, many novice users have had the | |
| 5216 problem of having multiple minibuffers build up, even to the point of | |
| 5217 exhausting the lisp stack. So the default behavior is to disallow the | |
| 5218 minibuffer to ever be reinvoked while active; if you attempt to do so, you | |
| 5219 will be prompted about it. | |
| 5220 | |
| 5221 There is a new variable, teach-extended-commands-p, which if set, will cause | |
| 5222 `M-x' to remind you of any key bindings of the command you just invoked the | |
| 5223 "long way." | |
| 5224 | |
| 5225 There are menus in Dired, Tar, Comint, Compile, and Grep modes. | |
| 5226 | |
| 5227 There is a menu of window management commands on the right mouse button over | |
| 5228 the modelines. | |
| 5229 | |
| 5230 Popup menus now have titles at the top; this is controlled by the new | |
| 5231 variable `popup-menu-titles'. | |
| 5232 | |
| 5233 The `Find' key on Sun keyboards will search for the next (or previous) | |
| 5234 occurrence of the selected text, as in OpenWindows programs. | |
| 5235 | |
| 5236 The `timer' package has been renamed to `itimer' to avoid a conflict with | |
| 5237 a different package called `timer'. | |
| 5238 | |
| 5239 VM 5.40 is included. | |
| 5240 | |
| 5241 W3, the emacs interface to the World Wide Web, is included. | |
| 5242 | |
| 5243 Felix Lee's GNUS speedups have been installed, including his new version of | |
| 5244 nntp.el which makes GNUS efficiently utilize the NNTP XOVER command if | |
| 5245 available (which is much faster.) | |
| 5246 | |
| 5247 GNUS should also be much friendlier to new users: it starts up much faster, | |
| 5248 and doesn't (necessarily) subscribe you to every single newsgroup. | |
| 5249 | |
| 5250 The byte-compiler issues a new class of warnings: variables which are | |
| 5251 bound but not used. This is merely an advisory, and does not mean the | |
| 5252 code is incorrect; you can disable these warnings in the usual way with | |
| 5253 the `byte-compiler-options' macro. | |
| 5254 | |
| 5255 the `start-open' and `end-open' extent properties, for specifying whether | |
| 5256 characters inserted exactly at a boundary of an extent should go into the | |
| 5257 extent or out of it, now work correctly. | |
| 5258 | |
| 5259 The `extent-data' slot has been generalized/replaced with a property list, | |
| 5260 so it's easier to attach arbitrary data to extent objects. | |
| 5261 | |
| 5262 The `event-modifiers' and `event-modifier-bits' functions work on motion | |
| 5263 events as well as other mouse and keyboard events. | |
| 5264 | |
| 5265 Forms-mode uses fonts and read-only regions. | |
| 5266 | |
| 5267 The behavior of the -geometry command line option should be correct now. | |
| 5268 | |
| 5269 The `iconic' screen parameter works when passed to x-create-screen. | |
| 5270 | |
| 5271 The user's manual now documents Lucid Emacs 19.9. | |
| 5272 | |
| 5273 The relocating buffer allocator is turned on by default; this means that when | |
| 5274 buffers are killed, their storage will be returned to the operating system, | |
| 5275 and the size of the emacs process will shrink. | |
| 5276 | |
| 5277 CAVEAT: code which contains calls to certain `face' accessor functions will | |
| 5278 need to be recompiled by version 19.9 before it will work. The functions | |
| 5279 whose callers must be recompiled are: face-font, face-foreground, | |
| 5280 face-background, face-background-pixmap, and face-underline-p. The symptom | |
| 5281 of this problem is the error "Wrong type argument, arrayp, #<face ... >". | |
| 5282 The .elc files generated by version 19.9 will work in 19.6 and 19.8, but | |
| 5283 older .elc files which contain calls to these functions will not work in 19.9. | |
| 5284 | |
| 5285 Work In Progress: | |
| 5286 | |
| 5287 - We have been in the process of internationalizing Lucid Emacs. This code is | |
| 5288 ***not*** ready for general use yet. However, the code is included (and | |
| 5289 turned off by default) in this release. | |
| 5290 | |
| 5291 - If you define I18N2 at compile-time, then sorting/collation will be done | |
| 5292 according to the locale returned by setlocale(). | |
| 5293 | |
| 5294 - If you define I18N3 at compile-time, then all messages printed by lemacs | |
| 5295 will be filtered through the gettext() library routine, to enable the use | |
| 5296 of locale-specific translation catalogues. The current implementation of | |
| 5297 this is quite dependent on Solaris 2, and has a very large impact on | |
| 5298 existing code, therefore we are going to be making major changes soon. | |
| 5299 (You'll notice calls to `gettext' and `GETTEXT' scattered around much of | |
| 5300 the lisp and C code; ignore it, this will be going away.) | |
| 5301 | |
| 5302 - If you define I18N4 at compile-time, then lemacs will internally use a | |
| 5303 wide representation of characters, enabling the use of large character | |
| 5304 sets such as Kanji. This code is very OS dependent: it requires X11R5, | |
| 5305 and several OS-supplied library routines for reading and writing wide | |
| 5306 characters (getwc(), putwc(), and a few others.) Performance is also a | |
| 5307 problem. This code is also scheduled for a major overhaul, with the | |
| 5308 intent of improving performance and portability. | |
| 5309 | |
| 5310 Our eventual goal is to merge with MULE, or at least provide the same base | |
| 5311 level of functionality. If you would like to help out with this, let us | |
| 5312 know. | |
| 5313 | |
| 5314 - Other work-in-progress includes Motif drag-and-drop support, ToolTalk | |
| 5315 support, and support for embedding an Emacs widget inside another | |
| 5316 application (where it can function as that other application's text-entry | |
| 5317 area). This code has not been extensively tested, and may (or may not) | |
| 5318 have portability problems, but it's there for the adventurous. Comments, | |
| 5319 suggestions, bug reports, and especially fixes are welcome. But have no | |
| 5320 expectations that this experimental code will work at all. | |
| 5321 | |
| 5322 | |
| 5323 ** Major Differences Between 19.6 and 19.8 | |
| 5324 ========================================== | |
| 5325 | |
| 5326 There were almost no differences between versions 19.6 and 19.7; version 19.7 | |
| 5327 was a bug-fix release that was distributed with Energize 2.1. | |
| 5328 | |
| 5329 Lucid Emacs 19.8 represents the first stage of the Lucid Emacs/Epoch merger. | |
| 5330 The redisplay engine now in lemacs is an improved descendant of the Epoch | |
| 5331 redisplay. As a result, many bugs have been eliminated, and several disabled | |
| 5332 features have been re-enabled. Notably: | |
| 5333 | |
| 5334 Selective display (and outline-mode) work. | |
| 5335 | |
| 5336 Horizontally split windows work. | |
| 5337 | |
| 5338 The height of a line is the height of the tallest font displayed on that line; | |
| 5339 it is possible for a screen to display lines of differing heights. (Previously, | |
| 5340 the height of all lines was the height of the tallest font loaded.) | |
| 5341 | |
| 5342 There is lisp code to scale fonts up and down, for example, to load the next- | |
| 5343 taller version of a font. | |
| 5344 | |
| 5345 There is a new internal representation for lisp objects, giving emacs-lisp 28 | |
| 5346 bit integers and a 28 bit address space, up from the previous maximum of 26. | |
| 5347 We expect eventually to increase this to 30 bit integers and a 32 bit address | |
| 5348 space, eliminating the need for DATA_SEG_BITS on some architectures. (On 64 | |
| 5349 bit machines, add 32 to all of these numbers.) | |
| 5350 | |
| 5351 GC performance is improved. | |
| 5352 | |
| 5353 Various X objects (fonts, colors, cursors, pixmaps) are accessible as first- | |
| 5354 class lisp objects, with finalization. | |
| 5355 | |
| 5356 An alternate interface to embedding images in the text is provided, called | |
| 5357 "annotations." You may create an "annotation margin" which is whitespace at | |
| 5358 the left side of the screen that contains only annotations, not buffer text. | |
| 5359 | |
| 5360 When using XPM files, one can specify the values of logical color names to be | |
| 5361 used when loading the files. | |
| 5362 | |
| 5363 It is possible to resize windows by dragging their modelines up and down. More | |
| 5364 generally, it is possible to add bindings for mouse gestures on the modelines. | |
| 5365 | |
| 5366 There is support for playing sound files on HP machines. | |
| 5367 | |
| 5368 ILISP version 5.5 is included. | |
| 5369 | |
| 5370 The Common Lisp #' read syntax is supported (#' is to "function" as ' is to | |
| 5371 "quote".) | |
| 5372 | |
| 5373 The `active-p' slot of menu items is now evaluated, so one can put arbitrary | |
| 5374 lisp code in a menu to decide whether that item should be selectable, rather | |
| 5375 than doing this with an `activate-menubar-hook'. | |
| 5376 | |
| 5377 The X resource hierarchy has changed slightly, to be more consistent. It used | |
| 5378 to be | |
| 5379 argv[0] SCREEN-NAME pane screen | |
| 5380 ApplicationShell EmacsShell Paned EmacsFrame | |
| 5381 | |
| 5382 now it is | |
| 5383 | |
| 5384 argv[0] shell pane SCREEN-NAME | |
| 5385 ApplicationShell EmacsShell Paned EmacsFrame | |
| 5386 | |
| 5387 The Lucid Emacs sources have been largely merged with FSF version 19; this | |
| 5388 means that the lisp library contains the most recent releases of various | |
| 5389 packages, and many new features of FSF 19 have been incorporated. | |
| 5390 | |
| 5391 Because of this, the lemacs sources should also be substantially more portable. | |
| 5392 | |
| 5393 | |
| 5394 ** Major Differences Between 19.4 and 19.6 | |
| 5395 ========================================== | |
| 5396 | |
| 5397 There were almost no differences between versions 19.4 and 19.5; we fixed | |
| 5398 a few minor bugs and repacked 19.4 as 19.5 for a CD-ROM that we gave away | |
| 5399 as a trade show promotion. | |
| 5400 | |
| 5401 The primary goal of the 19.6 release is stability, rather than improved | |
| 5402 functionality, so there aren't many user-visible changes. The most notable | |
| 5403 changes are: | |
| 5404 | |
| 5405 - The -geometry command-line option now correctly overrides geometry | |
| 5406 specifications in the resource database. | |
| 5407 - The `width' and `height' screen-parameters work. | |
| 5408 - Font-lock-mode considers the comment start and end characters to be | |
| 5409 a part of the comment. | |
| 5410 - The lhilit package has been removed. Use font-lock-mode instead. | |
| 5411 - vm-isearch has been fixed to work with isearch-mode. | |
| 5412 - new versions of ispell and calendar. | |
| 5413 - sccs.el has menus. | |
| 5414 | |
| 5415 Lots of bugs were fixed, including the problem that lemacs occasionally | |
| 5416 grabbed the keyboard focus. | |
| 5417 | |
| 5418 Also, as of Lucid Emacs 19.6 and Energize 2.0 (shipping now) it is possible | |
| 5419 to compile the public release of Lucid Emacs with support for Energize; so | |
| 5420 now Energize users will be able to build their own Energize-aware versions | |
| 5421 of lemacs, and will be able to use newer versions of lemacs as they are | |
| 5422 released to the net. (Of course, this is not behavior covered by your | |
| 5423 Energize support contract; you do it at your own risk.) | |
| 5424 | |
| 5425 I have not incorporated all portability patches that I have been sent since | |
| 5426 19.4; I will try to get to them soon. However, if you need to make any | |
| 5427 changes to lemacs to get it to compile on your system, it would be quite | |
| 5428 helpful if you would send me context diffs (diff -c) against version 19.6. | |
| 5429 | |
| 5430 | |
| 5431 ** Major Differences Between 19.3 and 19.4 | |
| 5432 ========================================== | |
| 5433 | |
| 5434 Prototypes have been added for all functions. Emacs compiles in the strict | |
| 5435 ANSI modes of lcc and gcc, so portability should be vastly improved. | |
| 5436 | |
| 5437 Many many many many core leaks have been plugged, especially in screen | |
| 5438 creation and deletion. | |
| 5439 | |
| 5440 The float support reworked to be more portable and ANSI conformant. This | |
| 5441 resulted in these new configuration parameters: HAVE_INVERSE_HYPERBOLIC, | |
| 5442 HAVE_CBRT, HAVE_RINT, FLOAT_CHECK_ERRNO, FLOAT_CATCH_SIGILL, | |
| 5443 FLOAT_CHECK_DOMAIN. Let us know if you had to change the defaults on your | |
| 5444 architecture. | |
| 5445 | |
| 5446 The SunOS unexec has been rewritten, and now works with either static or | |
| 5447 dynamic libraries, depending on whether -Bstatic or -Bdynamic were specified | |
| 5448 at link-time. | |
| 5449 | |
| 5450 Small (character-sized) bitmaps can be mixed in with buffer text via the new | |
| 5451 functions set-extent-begin-glyph and set-extent-end-glyph. (This is actually | |
| 5452 a piece of functionality that Energize has been using for a while, but we've | |
| 5453 just gotten around to making it possible to use it without Energize. See how | |
| 5454 nice we are? Go buy our product.) | |
| 5455 | |
| 5456 If compiled with Motif support, one can pop up dialog boxes from emacs lisp. | |
| 5457 We encourage someone to contribute Athena an version of this code; it | |
| 5458 shouldn't be much work. | |
| 5459 | |
| 5460 If dialog boxes are available, then y-or-n-p and yes-or-no-p use dialog boxes | |
| 5461 instead of the minibuffer if invoked as a result of a command that was | |
| 5462 executed from a menu instead of from the keyboard. | |
| 5463 | |
| 5464 Multiple screen support works better; check out doc of get-screen-for-buffer. | |
| 5465 | |
| 5466 The default binding of backspace is the same as delete. (C-h is still help.) | |
| 5467 | |
| 5468 A middle click while the minibuffer is active does completion if you click on | |
| 5469 a highlighted completion, otherwise it executes the global binding of button2. | |
| 5470 | |
| 5471 New versions of Barry Warsaw's c++-mode and syntax.c. Font-lock-mode works | |
| 5472 with C++ mode now. | |
| 5473 | |
| 5474 The semantics of activate-menubar-hook has changed; the functions are called | |
| 5475 with no arguments now. | |
| 5476 | |
| 5477 `truename' no longer hacks the automounter; use directory-abbrev-alist instead. | |
| 5478 | |
| 5479 Most minibuffer handling has been reimplemented in emacs-lisp. | |
| 5480 | |
| 5481 There is now a builtin minibuffer history mechanism which replaces gmhist. | |
| 5482 | |
| 5483 | |
| 5484 ** Major Differences Between 19.2 and 19.3 | |
| 5485 ========================================== | |
| 5486 | |
| 5487 The ISO characters have correct case and syntax tables now, so the word-motion | |
| 5488 and case-converting commands work sensibly on them. | |
| 5489 | |
| 5490 If you set ctl-arrow to an integer, you can control exactly which characters | |
| 5491 are printable. (There will be a less crufty way to do this eventually.) | |
| 5492 | |
| 5493 Menubars can now be buffer local; the function set-screen-menubar no longer | |
| 5494 exists. Look at GNUS and VM for examples of how to do this, or read | |
| 5495 menubar.el. | |
| 5496 | |
| 5497 When emacs is reading from the minibuffer with completions, any completions | |
| 5498 which are visible on the screen will highlight when the mouse moves over them; | |
| 5499 clicking middle on a completion is the same as typing it at the minibuffer. | |
| 5500 Some implications of this: The *Completions* buffer is always mousable. If | |
| 5501 you're using the completion feature of find-tag, your source code will be | |
| 5502 mousable when you type M-. Dired buffers will be mousable as soon as you | |
| 5503 type ^X^F. And so on. | |
| 5504 | |
| 5505 The old isearch code has been replaced with a descendant of Dan LaLiberte's | |
| 5506 excellent isearch-mode; it is more customizable, and generally less bogus. | |
| 5507 You can search for "composed" characters. There are new commands, too; see | |
| 5508 the doc for ^S, or the NEWS file. | |
| 5509 | |
| 5510 A patched GNUS 3.14 is included. | |
| 5511 | |
| 5512 The user's manual now documents Lucid Emacs 19.3. | |
| 5513 | |
| 5514 A few more modes have mouse and menu support. | |
| 5515 | |
| 5516 The startup code should be a little more robust, and give you more reasonable | |
| 5517 error messages when things aren't installed quite right (instead of the | |
| 5518 ubiquitous "cannot open DISPLAY"...) | |
| 5519 | |
| 5520 Subdirectories of the lisp directory whose names begin with a hyphen or dot | |
| 5521 are not automatically added to the load-path, so you can use this to avoid | |
| 5522 accidentally inflicting experimental software on your users. | |
| 5523 | |
| 5524 I've tried to incorporate all of the portability patches that were sent to | |
| 5525 me; I tried to solve some of the problems in different ways than the | |
| 5526 patches did, so let me know if I missed something. | |
| 5527 | |
| 5528 Some systems will need to define NEED_STRDUP, NEED_REALPATH, HAVE_DREM, or | |
| 5529 HAVE_REMAINDER in config.h. Really this should be done in the appropriate | |
| 5530 s- or m- files, but I don't know which systems need these and which don't. | |
| 5531 If yours does, let me know which file it should be in. | |
| 5532 | |
| 5533 Check out these new packages: | |
| 5534 | |
| 5535 blink-paren.el: causes the matching parenthesis to flash on and off whenever | |
| 5536 the cursor is sitting on a paren-syntax character. | |
| 5537 | |
| 5538 pending-del.el: Certain commands implicitly delete the highlighted region: | |
| 5539 Typing a character when there is a highlighted region replaces | |
| 5540 that region with the typed character. | |
| 5541 | |
| 5542 font-lock.el: A code-highlighting package, driven off of syntax tables, so | |
| 5543 that it understands block comments, strings, etc. The | |
| 5544 insertion hook is used to fontify text as you type it in. | |
| 5545 | |
| 5546 shell-font.el: Displays your shell-buffer prompt in boldface. | |
| 5547 |