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