* doc/emacs/misc.texi (Shell): Document async-shell-command.

* doc/emacs/building.texi (Grep Searching): Document zrgrep.

* doc/emacs/mini.texi (Completion Options):
* doc/lispref/minibuf.texi (Completion Styles): Document `initials' style.

1 files changed, 39 insertions, 18 deletions

diff --git a/etc/NEWS b/etc/NEWS
index b687d397581..4117e95259e 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -26,27 +26,27 @@ so we will look at it and add it to the manual.
 
 ** New configure options for Emacs developers
 These are not new features; only the configure flags are new.
-
+---
 *** --enable-profiling builds Emacs with profiling enabled.
 This might not work on all platforms.
-
+---
 *** --enable-checking[=OPTIONS] builds emacs with extra runtime checks.
 
 ---
 ** `make install' now consistently ignores umask, creating a
 world-readable install.
 
-** Emacs compiles with Gconf support by default, if it is detected.
+** Emacs compiles with Gconf support, if it is detected.
 Use the configure option --without-gconf to disable this.
 
 * Startup Changes in Emacs 23.2
-
++++
 ** The command-line option -Q (--quick) also inhibits loading X resources.
 However, if Emacs is compiled with the Lucid or Motif toolkit, X
 resource settings for the graphical widgets are still applied.
 On Windows, the -Q option causes Emacs to ignore Registry settings,
 but environment variables set on the Registry are still honored.
-
++++
 *** The new variable `inhibit-x-resources' shows whether X resources
 were loaded.
 
@@ -55,9 +55,11 @@ were loaded.
 
 * Changes in Emacs 23.2
 
++++
 ** The maximum size of buffers (and the largest fixnum) is doubled.
 On typical 32bit systems, buffers can now be up to 512MB.
 
+---
 ** The default value of `trash-directory' is now nil.
 This means that `move-file-to-trash' trashes files according to
 freedesktop.org specifications, the same method used by the Gnome,
@@ -80,13 +82,14 @@ disable this with the configure option --without-gconf).
 via the XSETTINGS mechanism.  This includes antialias, hinting,
 hintstyle, RGBA, DPI and lcdfilter changes.
 
++++
 ** Killing a buffer with a running process now asks for confirmation.
 To remove this query, remove `process-kill-buffer-query-function' from
 `kill-buffer-query-functions', or set the appropriate process flag
 with `set-process-query-on-exit-flag'.
 
 ** File-local variable changes
-
++++
 *** Specifying a minor mode as a local variables enables that mode,
 unconditionally.  The previous behavior, toggling the mode, was
 neither reliable nor generally desirable.
@@ -104,17 +107,18 @@ and copying them to and from file-local variable lists:
 `copy-file-locals-to-dir-locals'.
 
 ** Internationalization changes
-
++++
 *** Unibyte sessions are now considered obsolete.
 This refers to the EMACS_UNIBYTE environment variable as well as the
 --unibyte, --multibyte, --no-multibyte, and --no-unibyte command line
 arguments.  Customizing enable-multibyte-characters and setting
 default-enable-multibyte-characters are also deprecated.
-
+---
 *** New coding system `utf-8-hfs'.
 This is suitable for default-file-name-coding-system on Mac OS X; see
 international/ucs-normalize.el.
 
+---
 ** Function arguments in *Help* buffers are now shown in upper-case.
 Customize `help-downcase-arguments' to t to show them in lower-case.
 
@@ -127,11 +131,11 @@ Customize `help-downcase-arguments' to t to show them in lower-case.
 becomes the primary selection (for interaction with other window
 applications).  If you enable this, you might want to bind
 `mouse-yank-primary' to Mouse-2.
-
++++
 *** When `save-interprogram-paste-before-kill' is non-nil, the kill
 commands save the interprogram-paste selection into the kill ring
 before doing anything else.  This avoids losing the selection.
-
++++
 *** When `kill-do-not-save-duplicates' is non-nil, identical
 subsequent kills are not duplicated in the `kill-ring'.
 
@@ -140,7 +144,7 @@ subsequent kills are not duplicated in the `kill-ring'.
 *** The new command `completion-at-point' provides mode-sensitive completion.
 
 *** tab-always-indent set to `complete' lets TAB do completion as well.
-
++++
 *** The new completion-style `initials' is available.
 For instance, this can complete M-x lch to list-command-history.
 
@@ -151,6 +155,7 @@ are displayed in the *Completions* buffer.  If you set it to
 +++
 ** The default value of `blink-matching-paren-distance' is increased.
 
+---
 ** M-n provides more default values in the minibuffer for commands
 that read file names.  These include the file name at point (when ffap
 is loaded without ffap-bindings), the file name on the current line
@@ -158,14 +163,20 @@ is loaded without ffap-bindings), the file name on the current line
 (for Dired commands that operate on several directories, such as copy,
 rename, or diff).
 
++++
 ** M-r is bound to the new `move-to-window-line-top-bottom'.
 This moves point to the window center, top and bottom on successive
 invocations, in the same spirit as the C-l (recenter-top-bottom)
 command.
 
++++
 ** The new variable `recenter-positions' determines the default
 cycling order of C-l (`recenter-top-bottom').
 
++++
+** The abbrevs file is now a file named abbrev_defs in
+user-emacs-directory; but the old location, ~/.abbrev_defs, is used if
+that file exists.
 
 * Changes in Specialized Modes and Packages in Emacs 23.2
 
@@ -180,11 +191,15 @@ cycling order of C-l (`recenter-top-bottom').
 ** pcomplete provides a new command `pcomplete-std-completion' which
 is similar to `pcomplete' but using the standard completion UI code.
 
-** .calc.el and .abbrev_defs obey user-emacs-directory.
+** Calc
++++
+*** The Calc settings file is now a file named calc.el in
+user-emacs-directory; but the old location, ~/.calc.el, is used if
+that file exists.
 
-** Calc graphing commands (`g f' etc.) now work on MS-Windows,
-if you have the native Windows port of Gnuplot version 3.8 or later
-installed.
+---
+*** Graphing commands (`g f' etc.) now work on MS-Windows, if you have
+the native Windows port of Gnuplot version 3.8 or later installed.
 
 ** Calendar and diary
 
@@ -224,8 +239,8 @@ on the page edge advances to the next/previous page.
     watch expressions.  These features require GDB 7.0 or later.
 
 ** Grep
-
-A new command `zrgrep' searches recursively in gzipped files.
++++
+*** A new command `zrgrep' searches recursively in gzipped files.
 
 ** Info
 
@@ -366,6 +381,7 @@ and let commands run under that user permissions.  It works even when
 `default-directory' is already remote.  Calling the external commands
 is possible by `*su' or `*sudo', repectively.
 
+---
 *** When running in a new enough xterm (newer than version 242), emacs
 asks xterm what the background color is and it sets up faces
 accordingly for a dark background if needed (the current default is to
@@ -442,8 +458,10 @@ mode from `auto-mode-alist' (or Fundamental mode) and `image-minor-mode'.
 ** New function `completion-in-region' to use the standard completion
 facilities on a particular region of text.
 
++++
 ** The 4th arg to all-completions (aka hide-spaces) is declared obsolete.
 
+---
 ** read-file-name-predicate is obsolete.  It was used to pass the predicate
 to read-file-name-internal because read-file-name-internal abused its `pred'
 argument to pass the current directory, but this hack is not needed
@@ -451,6 +469,7 @@ any more.
 
 ** Frame parameter changes
 
++++
 *** You can give the `fullscreen' frame parameter the value `maximized'.
 This maximizes the frame.
 
@@ -458,6 +477,7 @@ This maximizes the frame.
 *** The new frame parameter `sticky' makes Emacs frames sticky in
 virtual desktops.
 
+---
 ** completion-base-size is obsoleted by completion-base-position.
 This change causes a few backward incompatibilities, mostly with
 choose-completion-string-functions where the `mini-p' argument has
@@ -491,11 +511,12 @@ now only take a single `command' argument.
 a `process-file' call does not change a remote file.  By this, file
 name handlers like Tramp can apply optimizations.
 
++++
 ** Hash tables have a new printed representation that is readable.
 The feature `hashtable-print-readable' identifies this new
 functionality.
 
-** Functions performing Unicode normalization are added.  They are:
+** New functions performing Unicode normalization are added:
 ucs-normalize-NFD-region, ucs-normalize-NFD-string,
 ucs-normalize-NFC-region, ucs-normalize-NFC-string,
 ucs-normalize-NFKD-region, ucs-normalize-NFKD-string,