Fix typos in ChangeLogs and NEWS files.
[bpt/emacs.git] / etc / NEWS
index 6717e65..5d1ffac 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1,9 +1,9 @@
 GNU Emacs NEWS -- history of user-visible changes.
 
-Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc.
+Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
 See the end of the file for license conditions.
 
-Please send Emacs bug reports to emacs-pretest-bug@gnu.org.
+Please send Emacs bug reports to bug-gnu-emacs@gnu.org.
 If possible, use M-x report-emacs-bug.
 
 This file is about changes in Emacs version 23.
@@ -26,84 +26,70 @@ 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.
 
-* Startup Changes in Emacs 23.2
-
-** Command-line option -Q (--quick) now also disables loading X resources.
-Note however that this does not affect Lucid or Motif widgets, if you
-are using those toolkits.  On Windows, this option causes Emacs to
-ignore Registry settings, though environment variables set on the
-Registry are still honored.
+** 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.
 
++++
+** New command-line option -mm (--maximized) maximizes the initial frame.
+
 * Changes in Emacs 23.2
 
-** The maximum size of buffers (as well as the largest fixnum) is doubled.
++++
+** The maximum size of buffers (and the largest fixnum) is doubled.
 On typical 32bit systems, buffers can now be up to 512MB.
 
-** Function arguments in *Help* buffers are now in uppercase by default.
-You can customize the new variable `help-downcase-arguments' to change it.
-
-** Unibyte sessions are now considered obsolete.
-I.e. the use of the environment variable EMACS_UNIBYTE, or command line
-arguments --unibyte, --multibyte, --no-multibyte, and --no-unibyte
-is deprecated.  Similarly for custom-izing enable-multibyte-characters, or
-setting default-enable-multibyte-characters.
-
-** The default value of `trash-directory' has changed to nil, which
-means that `move-file-to-trash' trashes files according to
+---
+** 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,
 KDE, and XFCE desktops.  (This change has no effect on Windows, which
 uses `system-move-file-to-trash' for trashing.)
 
-+++
-** Emacs frames can be maximized.
-The command line arguments -mm/--maximized and the value maximized to the
-frame parameter fullscreen makes the Emacs frame maximized.
-
-+++
-** New frame parameter sticky makes Emacs frames sticky in virtual desktops.
-
 ** The pointer now becomes invisible when typing.
-Customize make-pointer-invisible to turn it off.
+Customize `make-pointer-invisible' to disable this feature.
 
-** Emacs can use the system default monospaced font in Gnome.
-The use of the system default font can be turned on or off by customizing
-the variable 'font-use-system-font'.  It is off by default.
-If the system default is changed, Emacs changes also.
-This requires that gconf-support is built in.  If configure finds the
-gconf-libraries, that support is included. Gconf-support can be
-turned off with the configure option --without-gconf.
+** Font changes
 
-** Emacs now reacts to Xft-changes made by configuration tools on X11.
-Changes to antialias, hinting, hintstyle, RGBA, DPI and lcdfilter are
-handeled.  The XSETTINGS mechanism is used to implement this.
+*** Emacs can use the system default monospaced font in Gnome.
+To enable this feature, set `font-use-system-font' to non-nil (it is
+nil by default).  If the system default changes, Emacs changes also.
+This feature requires Gconf support, which is automatically included
+at compile-time if configure detects the gconf libraries (you can
+disable this with the configure option --without-gconf).
 
-** Killing a buffer with a running process now asks for confirmation.
-You can remove this query in two ways: either remove
-`process-kill-buffer-query-function' from `kill-buffer-query-functions',
-or set the appropriate process flag with `set-process-query-on-exit-flag'.
+*** On X11, Emacs reacts to Xft changes made by configuration tools,
+via the XSETTINGS mechanism.  This includes antialias, hinting,
+hintstyle, RGBA, DPI and lcdfilter changes.
 
-** The variable `load-in-progress' won't get corrupted by binding it
-with `let'.  In certain situations, loading an Emacs Lisp file from
-source while in the midst of loading another file (e.g., with
-`require' or `autoload') could cause the value of `load-in-progress'
-to be corrupted once the outer load completed.  Most code doesn't care
-about this, but some (like c-mode) may check it.
++++
+** 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.
@@ -120,72 +106,113 @@ and copying them to and from file-local variable lists:
 `copy-dir-locals-to-file-locals-prop-line' and
 `copy-file-locals-to-dir-locals'.
 
-** New coding system `utf-8-hfs' is available in
-international/ucs-normalize.el.  It is suitable for
-default-file-name-coding-system on Mac OS X.
+** 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.
+
+** Delete Auto Composition Mode.  Now the variable
+`auto-composition-mode' is simply a buffer local variable.  The
+commands `auto-composition-mode' and `global-auto-composition-mode'
+still works as before.
 
 \f
 * Editing Changes in Emacs 23.2
 
-** Selection changes
+** Kill-ring and selection changes
 +++
 *** If `select-active-regions' is t, any active region automatically
 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'.
 
-*** When `save-interprogram-paste-before-kill' is non-nil, emacs will
-not clobber the the interprogram paste when something is killed in it
-by saving the former in the `kill-ring' before the latter.
+** Completion changes
 
-** When `kill-do-not-save-duplicates' is non-nil, identical 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 default value for `blink-matching-paren-distance' has been increased.
-
-** The new completion-style `initials' is available.
+*** The new completion-style `initials' is available.
 For instance, this can complete M-x lch to list-command-history.
 
-** Completions in the *Completions* buffer are sorted vertically
-when the value of the new variable `completions-format' is `vertical'.
+*** The new variable `completions-format' determines how completions
+are displayed in the *Completions* buffer.  If you set it to
+`vertical', completions are sorted vertically in columns.
 
-** M-n provides more default values in the minibuffer of commands that
-read a file and directory name: a file name at point (when ffap is loaded
-without ffap-bindings), a file name on the current line in the Dired buffer,
-a directory name of adjacent Dired windows for Dired commands that can
-operate on several directories (copy, rename, diff).
++++
+** The default value of `blink-matching-paren-distance' is increased.
 
-** M-r is bound to the new `move-to-window-line-top-bottom'
-to mirror the new behavior of C-l in Emacs-23.1.
+---
+** 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
+(in Dired buffers), and the directory names of adjacent Dired windows
+(for Dired commands that operate on several directories, such as copy,
+rename, or diff).
 
-** `recenter-positions' can redefine the default cycling order
-of `recenter-top-bottom'.
++++
+** 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.
 \f
 * Changes in Specialized Modes and Packages in Emacs 23.2
 
 ** The bookmark menu has a narrowing search via bookmark-bmenu-search.
 
-** LaTeX mode now provides completion via latex-complete and
-latex-indent-or-complete.
+** LaTeX mode now provides completion (via completion-at-point).
+
+** sym-comp.el is now declared obsolete, superceded by completion-at-point.
 
 ** lucid.el and levents.el are now declared obsolete.
 
 ** 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
 
++++
 *** Fancy diary display is now the default.
 If you prefer the simple display, customize `diary-display-function'.
 
++++
 *** The diary's fancy display now enables view-mode.
 
 ---
@@ -201,19 +228,25 @@ effective for buffers that have no associated file.  If you want to
 exempt buffers that do correspond to files, customize the value of
 `desktop-files-not-to-save' instead.
 
+** Dired
+
+*** The new variable `dired-auto-revert-buffer' allows to revert
+dired buffers automatically on revisiting.
+
 ** DocView
 
 *** When `doc-view-continuous' is non-nil, scrolling a line
 on the page edge advances to the next/previous page.
 
-** FIXME mail-user-agent change
-This probably affects a lot of documentation.
+** GDB-UI
 
-** FIXME gdb-mi
+*** Toolbar functionality for reverse debugging.  Display of STL
+collections as 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
 
@@ -224,14 +257,36 @@ matched topics found in the index.
 manual that generates an Info file which gives the same information
 through a menu structure.
 
-+++
-** New connection methods in Tramp.
-The new connection methods "rsyncc", "imap" and "imaps" have been
-introduced.  On systems which support GVFS-Fuse, Tramp offers also the
-new connection methods "dav", "davs", "obex" and "synce".
+** Message mode is now the default mode for composing mail.
+
+The default for `mail-user-agent' is now message-user-agent, so the
+C-x m (`compose-mail') command uses Message mode instead of Mail mode.
+
+Message mode has been included in Emacs, as part of the Gnus package,
+for several years.  It provides several features that are absent in
+Mail mode, such as MIME handling.
+
+*** If the user has not customized mail-user-agent, `compose-mail'
+checks for Mail mode customizations, and issues a warning if these
+customizations are found.  This alerts users who may otherwise be
+unaware that their mail configuration has changed.
+
+To disable this check, set compose-mail-user-agent-warnings to nil.
 
 ** nXML mode is now the default for editing XML files.
 
+** Shell
+
+*** ansi-color is now enabled by default.
+To disable it, set ansi-color-for-comint-mode to nil.
+
++++
+** Tramp
+
+*** New connection methods "rsyncc", "imap" and "imaps".
+On systems which support GVFS-Fuse, Tramp offers also the new
+connection methods "dav", "davs", "obex" and "synce".
+
 ** VC and related modes
 
 *** When using C-x v v or C-x v i on a unregistered file that is in a
@@ -247,19 +302,26 @@ by default anymore.  The number of entries shown can be chosen
 interactively with a prefix argument, by customizing
 vc-log-show-limit.  The log buffer display buttons that can be used
 to change the number of entries shown.
-RCS, SCCS, CVS and Git do not support this feature.
+RCS, SCCS, CVS do not support this feature.
 
 *** vc-annotate supports annotations through file copies and renames,
 it displays the old names for the files and it can show logs/diffs for
 the corresponding lines.  Currently only Git and Mercurial take
 advantage of this feature.
 
+*** The log command in vc-annotate can display a single log entry
+instead of redisplaying the full log.  The RCS, CVS and SCCS VC
+backends do not support this.
+
 *** When a file is not found, VC will not try to check it out of RCS anymore.
 
 *** Diff and log operations can be used from dired buffers.
 
 *** vc-git changes
 
+**** The short log format for git makes use of the graph display, so
+it's not supported on git versions earlier than 1.5.
+
 **** The new variable vc-git-add-signoff can be used to add a
 Signed-off-by line when committing.
 
@@ -318,18 +380,50 @@ search in file buffers whose file names match the specified wildcard.
 +++
 *** Autorevert Tail mode now works also for remote files.
 
-*** The new commands `eshell/su' and `eshell/sudo' support Tramp.
++++
+*** The new built-in commands `su' and `sudo' support Tramp.
 That means, they change `default-directory' to the new users value,
 and let commands run under that user permissions.  It works even when
-`default-directory' is already remote.
+`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
+consider the background light).
 
 \f
 * New Modes and Packages in Emacs 23.2
 
+** CEDET (the Collection of Emacs Development Tools) is now in Emacs.
+This is a collection of packages to aid with using Emacs as an IDE
+(integrated development environment):
+
+*** The Semantic package allows the use of parsers to intelligently
+edit and navigate source code.  Parsers for C/C++, Java, Javascript,
+and several other languages are included by default, and Semantic can
+also interface with external tools such as GNU Global and GNU Idutils.
+
+To enable Semantic, use the global minor mode `semantic-mode'.
+See the Semantic manual for details.
+
+*** EDE (Emacs Development Environment) is a package for managing code
+projects, including features such as automatic Makefile generation.
+
+To enable EDE, use the minor mode `global-ede-mode'.
+See the EDE manual for details.
+
+*** SRecode is a library for recoding Semantic tags back into source
+code.  It is currently used by some parts of Semantic and EDE; in the
+future, it may be used for code generation features.
+
+*** The EIEIO library implements a subset of the Common Lisp Object
+System (CLOS).  It is used by the other CEDET packages.
+
 ** mpc.el is a front end for the Music Player Daemon.  Run it with M-x mpc.
-** htmlfontify.el turns a fontified Emacs buffer into an HTML page.
 
-** FIXME CEDET
+** htmlfontify.el turns a fontified Emacs buffer into an HTML page.
 
 ** js.el is a new major mode for JavaScript files.
 
@@ -351,19 +445,45 @@ be in use:
 ** Support for generating Emacs 18 compatible bytecode (by setting
 the variable `byte-compile-compatibility') has been removed.
 
+** In image-mode.el `image-mode-maybe' is obsolete.  Instead, you can
+either use `image-mode' that displays an image file as the actual image
+inititally, or `image-mode-as-text' when you want to display an image file
+as text inititally.  `image-mode-as-text' is a combination of a non-image
+mode from `auto-mode-alist' (or Fundamental mode) and `image-minor-mode'.
+`image-minor-mode' provides `C-c C-c' key binding to toggle image display.
+`image-toggle-display-text' removes image properties.
+`image-toggle-display-image' adds image properties.
+`image-toggle-display' toggles between `image-mode-as-text' and
+`image-mode'.
+
 \f
 * Lisp changes in Emacs 23.2
 
+** make-network-socket can now also create `seqpacket' Unix sockets.
+
 ** 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
 any more.
 
+** Frame parameter changes
+
++++
+*** You can give the `fullscreen' frame parameter the value `maximized'.
+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
@@ -397,11 +517,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,
@@ -422,7 +543,7 @@ the function `byte-compile-dest-file' before loading bytecomp.el is obsolete.
 Instead, customize byte-compile-dest-file-function.
 
 ---
-** `byte-compile-warnings' can have a new member, `constants'.
+** `byte-compile-warnings' has new members, `constants' and `suspicious'.
 
 ** `delete-directory' has an optional parameter RECURSIVE.
 
@@ -471,7 +592,7 @@ a GIF library.
 
 *** Emacs now supports multi-page TIFF images.
 
-** New NeXTSTEP-based port
+** New NeXTSTEP-based port.
 This provides support for GNUstep (via the GNUstep libraries) and Mac
 OS X (via the Cocoa libraries).
 
@@ -502,7 +623,7 @@ emacs-devel@gnu.org to inform the Emacs developers.
 *** Old GNU/Linux systems based on libc version 5.
 
 *** Old FreeBSD, NetBSD, and OpenBSD systems based on the COFF
-    executable format.
+executable format.
 
 *** Solaris versions 2.6 and below.
 
@@ -1072,23 +1193,23 @@ specifies what to do when a buffer is visited, killed, or written.
 ** Abbrev has been rewritten in Elisp and extended with more flexibility.
 
 *** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
-    abbrev-table-p, abbrev-insert, abbrev-table-menu.
+abbrev-table-p, abbrev-insert, abbrev-table-menu.
 
 *** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
 
 *** `make-abbrev-table', `define-abbrev', `define-abbrev-table' all take
-    extra arguments for arbitrary properties.
+extra arguments for arbitrary properties.
 
 *** New variable `abbrev-minor-mode-table-alist'.
 
 *** `local-abbrev-table' can hold a list of abbrev-tables.
 
 *** Abbrevs have now the following special properties:
-    `:count', `:system', `:enable-function', `:case-fixed'.
+`:count', `:system', `:enable-function', `:case-fixed'.
 
 *** Abbrev-tables have now the following special properties:
-    `:parents', `:case-fixed', `:enable-function', `:regexp',
-    `abbrev-table-modiff'.
+`:parents', `:case-fixed', `:enable-function', `:regexp',
+`abbrev-table-modiff'.
 
 ** Apropos
 
@@ -2034,7 +2155,6 @@ ordered by their priorities.
 **** `coding-system-from-name' returns a coding system matching with
 the argument name.
 
-
 ** There is a new input method, Robin, different from Quail.
 It has three functionalities:
  i) a simple input method (converts an ASCII sequence into a string).