* bindings.el: Give mode-line-format, mode-line-modes, and
[bpt/emacs.git] / etc / NEWS
index e9ef4b6..3f98684 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -23,6 +23,15 @@ so we will look at it and add it to the manual.
 \f
 * Installation Changes in Emacs 22.1
 
+---
+** Emacs comes with a new set of icons.
+These icons are displayed on the taskbar and/or titlebar when Emacs
+runs in a graphical environment.  Source files for these icons can be
+found in etc/images/icons.  (You can't change the icons displayed by
+Emacs by changing these files directly.  On X, the icon is compiled
+into the Emacs executable; see gnu.h in the source tree.  On MS
+Windows, see nt/icons/emacs.ico.)
+
 ---
 ** Emacs now supports new configure options `--program-prefix',
 `--program-suffix' and `--program-transform-name' that affect the names of
@@ -86,7 +95,6 @@ doesn't automatically select the right one.
 Its name is `pt-br-refcard.tex'.  The corresponding PostScript file is
 also included.
 
-
 ---
 ** A French translation of the `Emacs Survival Guide' is available.
 
@@ -137,6 +145,10 @@ terminfo name, since term.el now supports color.
 ---
 ** Emacs Lisp source files are compressed by default if `gzip' is available.
 
+---
+** All images used in Emacs have been consolidated in etc/images and subdirs.
+See also the changes to `find-image', documented below.
+
 \f
 * Startup Changes in Emacs 22.1
 
@@ -189,6 +201,13 @@ an interactively callable function.
 all frames you create.  A position specified with --geometry only
 affects the initial frame.
 
+---
+** Emacs built for MS-Windows now behaves like Emacs on X does,
+wrt its frame position: if you don't specify a position (in your
+.emacs init file, in the Registry, or with the --geometry command-line
+option), Emacs leaves the frame position to the Windows' window
+manager.
+
 +++
 ** Emacs can now be invoked in full-screen mode on a windowed display.
 When Emacs is invoked on a window system, the new command-line options
@@ -225,6 +244,12 @@ automatically at startup, if it exists.  When Emacs offers to save
 modified buffers, it saves the abbrevs too if they have changed.  It
 can do this either silently or asking for confirmation first,
 according to the value of `save-abbrevs'.
+
++++
+** If the environment variable EMAIL is defined, Emacs now uses its value
+to compute the default value of `user-mail-address', in preference to
+concatenation of `user-login-name' with the name of your host machine.
+
 \f
 * Incompatible Editing Changes in Emacs 22.1
 
@@ -438,6 +463,8 @@ C-h e displays the *Messages* buffer.
 
 C-h d runs apropos-documentation.
 
+C-h r visits the Emacs Manual in Info.
+
 C-h followed by a control character is used for displaying files
     that do not change:
 
@@ -1996,10 +2023,22 @@ discretionary handling of edits of concealed text, undo concerns, etc.
    - repaired retention of topic body hanging indent upon topic depth shifts
    - refuse to create "containment discontinuities", where a
      topic is shifted deeper than the offspring-depth of its' container
+   - auto-fill-mode is now left inactive when allout-mode starts, if it
+     already was inactive.  also, `allout-inhibit-auto-fill' custom
+     configuration variable makes it easy to disable auto fill in allout
+     outlines in general or on a per-buffer basis.
+   - new hook `allout-mode-deactivate-hook', for coordinating with
+     deactivation of allout-mode.
    - bulleting variation is simpler and more accommodating, both in the
      default behavior and in ability to vary when creating new topics
-   - many internal fixes and refinements
-   - many module and function docstring clarifications
+   - mode deactivation now does cleans up effectively, more properly
+     restoring affected variables and hooks to former state, removing
+     overlays, etc.
+   - included a few unit-tests for interior functionality.  developers can
+     have them automatically run at the end of module load by customizing
+     the option `allout-run-unit-tests-on-load'.
+   - many, many minor tweaks and fixes.  many internal fixes and
+     refinements of docstrings.
    - version number incremented to 2.2
 
 ** The variable `woman-topic-at-point' was renamed
@@ -3034,6 +3073,8 @@ specified to etags, variables are tags also.
 The new keywords are def, newcommand, renewcommand, newenvironment and
 renewenvironment.
 
+**** In C and derived languages, etags creates tags for #undef
+
 *** Honor #line directives.
 
 When Etags parses an input file that contains C preprocessor's #line
@@ -3148,7 +3189,7 @@ See the file GNUS-NEWS or the node "Oort Gnus" in the Gnus manual for details.
 ---
 ** MH-E changes.
 
-Upgraded to MH-E version 8.0.1.  There have been major changes since
+Upgraded to MH-E version 8.0.2.  There have been major changes since
 version 5.0.2; see MH-E-NEWS for details.
 
 ** Calendar changes:
@@ -3494,6 +3535,15 @@ For example, these two sequences of expressions behave identically:
 (defun PP (data) (insert (format "%S\n" data)))
 (ewoc-create 'PP "start\n\n" "\n" t)
 
+** Locate changes
+
+---
+*** By default, reverting the *Locate* buffer now just runs the last
+`locate' command back over again without offering to update the locate
+database (which normally only works if you have root privileges).  If
+you prefer the old behavior, set the new customizable option
+`locate-update-when-revert' to t.
+
 \f
 * Changes in Emacs 22.1 on non-free operating systems
 
@@ -3611,8 +3661,10 @@ w32-use-full-screen-buffer to t.
 \f
 * Incompatible Lisp Changes in Emacs 22.1
 
-** The function find-operation-coding-system accepts a cons (FILENAME
-. BUFFER) in an argument correponding to the target.
+** The function find-operation-coding-system may be called with a cons
+(FILENAME . BUFFER) in the second argument if the first argument
+OPERATION is `insert-file-contents', and thus a function registered in
+`file-coding-system-alist' is also called with such an argument.
 
 ---
 ** The variables post-command-idle-hook and post-command-idle-delay have
@@ -3645,6 +3697,8 @@ deleting the part of subprocess output that matches the input.
 ** The variable `memory-full' now remains t until
 there is no longer a shortage of memory.
 
+** When Emacs receives a USR1 or USR2 signal, this generates
+an input event: usr1-signal or usr2-signal.
 \f
 * Lisp Changes in Emacs 22.1
 
@@ -3800,6 +3854,12 @@ If it is non-nil, the function lists only faces matching this regexp.
 `string-or-null-p' returns non-nil iff OBJECT is a string or nil.
 `booleanp' returns non-nil iff OBJECT is a t or nil.
 
++++
+*** New hook `command-error-function'.
+
+By setting this variable to a function, you can control
+how the editor command loop shows the user an error message.
+
 ** Lisp code indentation features:
 
 +++
@@ -4357,6 +4417,12 @@ name handlers.  This will be exploited for remote files mainly.
 
 ** Input changes:
 
++++
+*** The functions `read-event', `read-char', and `read-char-exclusive'
+have a new optional argument SECONDS.  If non-nil, this specifies a
+maximum time to wait for input, in seconds.  If no input arrives after
+this time elapses, the functions stop waiting and return nil.
+
 +++
 *** An interactive specification can now use the code letter 'U' to get
 the up-event that was discarded in case the last key sequence read for a
@@ -4478,6 +4544,8 @@ example,
 
 (kbd "C-x C-f") => "\^x\^f"
 
+Actually, this format has existed since Emacs 20.1.
+
 *** Interactive commands can be remapped through keymaps.
 
 This is an alternative to using `defadvice' or `substitute-key-definition'
@@ -4564,6 +4632,8 @@ Lisp packages using many minor mode keymaps can now maintain their own
 keymap alist separate from `minor-mode-map-alist' by adding their
 keymap alist to this list.
 
+*** The definition of a key-binding passed to define-key can use XEmacs-style
+key-sequences, such as [(control a)].
 ** Abbrev changes:
 
 +++
@@ -4874,8 +4944,12 @@ of the display margins.
 *** `sit-for' can now be called with args (SECONDS &optional NODISP).
 
 +++
-*** `sit-for' called with a negative SECONDS value now forces an
-immediate redisplay even if input is pending.
+*** Iconifying or deiconifying a frame no longer makes sit-for return.
+
++++
+*** New function `redisplay' causes an immediate redisplay if no input is
+available, equivalent to (sit-for 0).  The call (redisplay t) forces
+an immediate redisplay even if input is pending.
 
 +++
 *** New function `force-window-update' can initiate a full redisplay of
@@ -5171,6 +5245,12 @@ property names as argument rather than a property list.
 
 ** Face changes
 
++++
+*** The variable `facemenu-unlisted-faces' has been removed.
+Emacs has a lot more faces than in the past, and nearly all of them
+needed to be excluded.  The new variable `facemenu-listed-faces' lists
+the faces to include in the face menu.
+
 +++
 *** The new face attribute condition `min-colors' can be used to tailor
 the face color to the number of colors supported by a display, and
@@ -5283,6 +5363,11 @@ text to being a piece of code, so you'd put a `jit-lock-defer-multiline'
 property over the second half of the command to force (deferred)
 refontification of `bar' whenever the `e' is added/removed.
 
+*** `font-lock-extend-region-functions' makes it possible to alter the way
+the fontification region is chosen.  This can be used to prevent rounding
+up to whole lines, or to extend the region to include all related lines
+of multiline constructs so that such constructs get properly recognized.
+
 ** Major mode mechanism changes:
 
 +++