* Installation Changes in Emacs 23.1
** The default X toolkit is now Gtk+, rather than Lucid.
+The configure option `--with-gtk' has been removed. Gtk is now the
+default toolkit, but you can use --with-x-toolkit=gtk if necessary.
-** Fonts are handled by new code capable of dealing with multiple font
-backends. This requires the freetype and fontconfig libraries, and
-supports local fonts (fonts installed on the machine where Emacs is
-running). Additionally, the Xft library can be used for antialiasing
-support, the otf library for complex text layout by OpenType fonts,
-and the m17n library for text shaping. Fontconfig-like font names
-(e.g. monospace-12) are accepted. The old font handling code can
-be used by passing the configure option `--disable-font-backend'
-(also available as a run-time option).
+** New font code.
+Fonts are handled by new code capable of dealing with multiple font
+backends. This uses the freetype and fontconfig libraries.
-** The new configuration option "--with-dbus" enables D-Bus language
-bindings for Emacs.
+*** Emacs now accepts font names supplied in the fontconfig format
+(e.g. "monospace-12:bold") and GTK format (e.g. "Monospace Bold 12").
+
+*** Added support for local fonts (fonts installed on the machine
+where Emacs is running).
+
+*** Added support for the Xft library for antialiasing.
-** The Mac Carbon port is no longer supported.
-Instead, use... [FIXME what?]
+*** Added support for the otf library for complex text layout by
+OpenType fonts.
-** configure now checks for libgif before libungif when searching for
+*** Added support for the m17n library for text shaping.
+
+** Changes to image support
+---
+*** configure now checks for libgif before libungif when searching for
a GIF library.
++++
+*** Emacs now supports the SVG image format through librsvg2.
-** Support for systems without alloca has been removed.
+** New NeXTSTEP-based port
+This provides support for GNUStep (via the GNUStep libraries) and Mac
+OS X (via the Cocoa libraries). See nextstep/README and
+nextstep/INSTALL in the Emacs source directory.
-** Support for Sun windows has been removed.
+** Mac OS X is no longer supported via Carbon.
+Use the NeXTSTEP port, described above.
+
+** The new configuration option "--with-dbus" enables D-Bus language
+bindings for Emacs.
** Support for many obsolete platforms has been removed.
See the list at the end of etc/MACHINES for details.
+---
+*** Support for systems without alloca has been removed.
+---
+*** Support for Sun windows has been removed.
+---
+*** The `emacstool' utility has been removed.
+
+** The following platforms will be removed in a future Emacs version:
+
+*** Libc version 5 on GNU/Linux.
+
+*** Old FreeBSD and NetBSD systems based on the COFF executable
+ format.
+
+*** Solaris versions 2.6 and below.
+
+*** Solaris on IBM RS6000 machines.
+
+*** UNIX System V (the original SysV, not later platforms based on it).
-** The `emacstool' utility has been removed.
+*** Platforms not supporting shared libraries (i.e., requiring the
+NO_SHARED_LIBS compilation flag).
+---
** The configure options `--with-gcc', `--without-gcc' have been removed.
Configure will use gcc by default. Set the CC environment variable if
you need control over which C compiler is used.
-** The configure option `--with-gtk' has been removed. Gtk is now the
-default toolkit, but you can use --with-x-toolkit=gtk if necessary.
+** The refcards are now shipped as PDF files.
+
+---
+** Emacs 23 comes with a new set of default icons.
+Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
+The Emacs 22 icon is available as `emacs22.png' in the same location.
\f
* Changes in Emacs 23.1
-** Completion.
-*** `completion-style' can be customized to choose your favorite completion.
-*** `completion-auto-help' can be set to `lazy' to list the completions only
-if you repeat the completion. This was already supported in
-`partial-completion-mode'.
-
-** Emacs now supports using both X displays and ttys in one session.
-Start the server (M-x server-start). Then `emacsclient -t' creates a
-tty frame connected to the running emacs server. You can also use any
-number of different ttys. `emacsclient -c' creates a new X11 frame on
-the current $DISPLAY or a tty frame if $DISPLAY is not set.
+** Emacs can now be built under the Cocoa libraries on Mac OS X and GNUstep
+ libraries on other machines. Specify --with-ns to configure for this. By
+ default a self-contained app will be built (containing all lisp). To
+ install/share lisp with other emacsen (e.g. X11 build) use
+ --disable-ns-self-contained. Use 'info-ns-emacs' or first entry under Help
+ menu when running for more information.
-You can test for the presence of this feature in your Lisp code by
-testing for the `multi-tty' feature.
+** `where-is-preferred-modifier' can specify your favorite modifier.
-** The Emacs character set is now a superset of Unicode.
-(It has about four times the code space, which should be plenty).
+** Improved X Window System support
-The internal encoding used for buffers and strings is now
-Unicode-based and called `utf-8-emacs'. utf-8-emacs is backwards
-compatible with the UTF-8 encoding of Unicode. The `emacs-mule'
-coding system can still read and write data in the old internal encoding.
-
-Since the internal encoding is also used by default for byte-compiled
-files -- i.e. the normal coding system for byte-compiled Lisp files is
-now utf-8-Emacs -- Lisp containing non-ASCII characters which is
-compiled by Emacs 23 can't be read by earlier versions of Emacs. Files
-compiled by Emacs 20, 21, or 22 are loaded correctly as emacs-mule
-(whether or not they contain multibyte characters), which makes loading
-them somewhat slower than Emacs 23-compiled files. Thus it may be worth
-recompiling existing .elc files which don't need to be shared with older
-Emacsen.
-
-** There are assorted new coding systems/aliases -- see M-x list-coding-systems.
-
-** There is a new charset implementation with many new charsets.
-See M-x list-character-sets. New charsets can be defined conveniently
-as tables of unicodes.
+*** Emacs now supports using both X displays and ttys in one session.
+With an Emacs server active (M-x server-start), `emacsclient -t'
+creates a tty frame connected to the running emacs server. You can
+use any number of different ttys. `emacsclient -c' creates a new X11
+frame on the current $DISPLAY (or a tty frame if $DISPLAY is not set).
-The dimension of a charset is now 1, 2, 3, or 4, and the size of each
-dimension is no longer limited to 94 or 96.
+You can test for the presence of this feature in your Lisp code by
+testing for the `multi-tty' feature.
-A dynamic charset priority list is used to infer the charset of
-characters for display.
+**** Emacsclient can now open new terminal frames.
+Now, the default behavior is to open a new Emacs frame by default.
+Use the -c option to get the old behavior of opening files in the
+currently selected Emacs frame.
-** There are new Chinese-GBK, Chinese-GB18030, Khmer, Bengali,
-Punjabi, Gujarati, Oriya, Telugu, Sinhala, and TaiViet language
-environments.
+*** The new command close-display-connection closes a connection to a
+remote display.
-** Emacs now supports the XEmbed specification.
-You can embed Emacs in another application on X11. The new command line option
---parent-id is used to pass the parent window id to Emacs. See
+*** Emacs now supports the XEmbed specification.
+You can embed Emacs in another application on X11. The new command line
+option --parent-id is used to pass the parent window id to Emacs. See
http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
for details about XEmbed.
-** Emacs comes with a new set of default icons.
-Various resolutions are available as etc/images/icons/hicolor/*/apps/emacs.png.
-The Emacs 22 icon is available as `emacs22.png' in the same location.
-
-** Built-in functions (subr) can now have an interactive specification
-that is not a prompt string. If the `intspec' parameter of a `DEFUN'
-starts with a `(', the string is evaluated as a Lisp form.
-
-** set-file-modes is now interactive and can take the mode value in
-symbolic notation thanks to auxiliary functions.
-
-** split-window-preferred-function specifies whether display-buffer should
-split windows vertically or horizontally.
-
-** Emacsclient has been extended to support opening a new terminal
-frame. Its behavior has been changed to open a new Emacs frame by
-default. Use the -c option to get the old behavior of opening files in
-the currently selected Emacs frame.
+*** Emacs can now set the frame opacity.
+The opacity of a frame can be controlled by setting the `alpha' frame
+parameter. This only takes effect on a compositing window manager for
+the X Window System, such as Compiz, Beryl and Compiz Fusion, or on
+Windows 2000 and later versions of Windows.
-** The refcards are now shipped as PDF files.
-
-** Emacs now supports the SVG image format through librsvg2.
+The alpha parameter should be an integer between 0 (transparent) and
+100 (opaque), or a float number between 0.0 and 1.0. It can also be a
+cons cell (ACTIVE . INACTIVE), where ACTIVE is the opacity of an
+active frame and INACTIVE is the opactity of non-active frames.
-** If you set find-file-confirm-nonexistent-file to t, then C-x C-f
-requires confirmation before opening a non-existent file.
+The variable `frame-alpha-lower-limit' defines a lower bound for the
+opacity; the default is 20.
-** If the gpm mouse server is running and t-mouse-mode enabled, Emacs uses a
-Unix socket in a GNU/Linux console to talk to server, rather than faking events
-using the client program mev. This C level approach provides mouse
-highlighting, and help echoing in the minibuffer.
+** Internationalization changes
-** Recentering changes
+*** The Emacs character set is now a superset of Unicode.
+(It has about four times the code space, which should be plenty).
-*** The new variable next-error-recenter specifies how next-error should
-recenter the visited source file. Its value can be a number (for example,
-0 for top line, -1 for bottom line), or nil for no recentering.
+The internal encoding used for buffers and strings is now
+Unicode-based and called `utf-8-emacs'. This encoding is backwards
+compatible with Unicode's UTF-8 encoding. The internal encoding
+previously used by Emacs, `emacs-mule', is still available.
-*** New command recenter-top-bottom moves the current line to window
-center, top and bottom on successive invokations.
+During byte-compilation, Emacs 23 uses `utf-8-emacs' to write files.
+As a result, byte-compiled files containing non-ASCII characters can't
+be read by earlier versions of Emacs. Files compiled by Emacs 20, 21,
+or 22 are loaded correctly as emacs-mule (whether or not they contain
+multibyte characters). This takes somewhat more time, so it may be
+worth recompiling existing .elc files which don't need to be shared
+with older Emacsen.
-*** C-l is bound to the new command recenter-top-bottom, rather than recenter.
+*** There are new coding systems/aliases; see M-x list-coding-systems.
-** The mode-line displays a `@' if the default-directory for the current buffer
-is on a remote machine, or a hyphen otherwise.
+*** There is a new charset implementation with many new charsets.
+See M-x list-character-sets. New charsets can be defined conveniently
+as tables of unicodes.
-** The mode-line displays a mode menu when mouse-1 is clicked on a minor mode,
-in the same way as it already did for major modes.
+**** The dimension of a charset is now 1, 2, 3, or 4, and the size of
+each dimension is no longer limited to 94 or 96.
-** The new command balance-windows-area balances windows both vertically
-and horizontally.
+**** A dynamic charset priority list is used to infer the charset of
+characters for display.
-** The new command close-display-connection can be used to close a connection
-to a remote display, e.g. because the display is about to become unreachable.
+*** There are new language environments for Chinese-GBK,
+Chinese-GB18030, Khmer, Bengali, Punjabi, Gujarati, Oriya, Telugu,
+Sinhala, and TaiViet.
-** The command shell prompts for the default directory, when it is
-called with a prefix, and the default directory is a remote file name.
-This is because some file name handlers (like ange-ftp) are not able to
-run processes remotely.
+*** The minor modes unify-8859-on-encoding-mode and
+unify-8859-on-decoding-mode are obsolete.
-** The new command `display-time-world' starts an updating time display
-using several time zones, in a buffer.
+** Emacs now supports serial port access on GNU/Linux, Unix, and
+Windows. The new command `serial-term' starts an interactive terminal
+on a serial port. The serial port can be configured at runtime with
+the mode-line mouse menu.
-** The new function `format-seconds' converts a number of seconds into a
-readable string of days, hours, etc.
+** Menu Bar changes
+---
+*** In the Options menu, the "Set Default Font" item applies the
+selected font to the `default' face on all frames, not just the
+current frame. Furthermore, if Emacs is compiled with both GTK and
+Fontconfig support, the "Set Default Font" item uses the GTK font
+selection dialog instead of an Emacs pop-up menu.
+---
+*** The font setting chosen by "Set Default Font" is saved if the
+"Save Options" item is used.
-** The new variables `before-init-time' and `after-init-time' record the
-value of `current-time' before and after Emacs loads the init files.
+*** The Tools menu contains a new Encryption/Decryption submenu.
+This contains commands provided by EasyPG, the newly-included
+interface to GnuPG (see New Modes and Packages).
+---
+*** In the Options menu, the "Truncate Long Lines in the Buffer" entry
+has been replaced with a submenu offering three different ways to
+handle long lines: truncation, continuation at the window edge, and
+the new word wrapping option (see Editing Changes, below).
-** The new function `emacs-uptime' returns the uptime of an Emacs instance.
+** Mode-line changes
++++
+*** The mode-line displays a `@', instead of `-', if the
+default-directory for the current buffer is on a remote machine.
-** The new function `emacs-init-time' returns the duration of the
-Emacs initialization.
+*** The mode-line displays a mode menu when mouse-1 is clicked on a
+minor mode, in the same way as it already did for major modes.
-** The minor modes unify-8859-on-encoding-mode, unify-8859-on-decoding-mode
-are obsolete.
+*** The `mode-line-emphasis' face is used to highlight certain
+mode-line information (e.g. waiting for a VC command to finish).
-** The new commands `pp-macroexpand-expression' and `pp-macroexpand-last-sexp'
-pretty-print macro expansions.
+** Directory-local variables can now be defined.
+By default, Emacs looks in .dir-settings.el for directory-local
+variables. For more information, see `set-directory-project' and
+`define-project-bindings'.
\f
* Startup Changes in Emacs 23.1
++++
** The option `inhibit-startup-screen' (with aliases to old names
`inhibit-splash-screen' and `inhibit-startup-message') doesn't inhibit
display of the initial message in the *scratch* buffer. If you don't
inside of --eval command line arguments in order to access
following arguments.
-** The new command-line option `--disable-font-backend' disables the
-new font backend code at runtime. This option is not available if
-Emacs was compiled without font-backend support.
-
** The abbrev file is no longer read at startup in batch mode.
\f
* Incompatible Editing Changes in Emacs 23.1
list accessible by M-n instead of pushing all guesses temporarily into
the history list.
+---
** The following input methods were removed in Emacs 22.2, but this was
not advertised: danish-alt-postfix, esperanto-alt-postfix,
finnish-alt-postfix, german-alt-postfix, icelandic-alt-postfix,
\f
* Editing Changes in Emacs 23.1
-** Mark changes
+** The C-n and C-p line-motion commands now move by screen lines,
+taking continued lines and variable-width characters into account.
+Setting `line-move-visual' to nil reverts this to the previous
+behavior (motion by logical lines based on buffer contents alone).
+
+** C-x C-c now invokes `save-buffers-kill-terminal', and C-z now
+invokes `suspend-frame'. This change is for compatibility with the
+new multi-tty support (see `Improved X Window System support' above).
+** Mark changes
+++
*** Transient Mark mode is now on by default.
-
+++
*** mark-even-if-inactive now defaults to t
-
+++
-*** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without activating it.
-
+*** When Transient Mark mode is on, C-SPC C-SPC pushes a mark without
+activating it.
+++
*** When Transient Mark mode is on, M-q now fills the region if the
region is active. Otherwise, it fills the current paragraph.
-
+++
*** When Transient Mark mode is on, M-$ now checks spelling of the
region if the region is active. Otherwise, it checks spelling of the
word at point.
-
*** When Transient Mark mode is on, TAB now indents the region if the
region is active.
-
*** `use-empty-active-region' controls whether an empty active region
in Transient Mark mode should make commands operate on that empty
region.
** Temporarily active regions
-
++++
*** The new variable shift-select-mode, non-nil by default, controls
shift-selection. When Shift Select mode is on, shift-translated
motion keys (e.g. S-left and S-down) activate and extend a temporary
region, similar to mouse-selection.
-
++++
*** Temporarily active regions, created using shift-selection or
mouse-selection, are not necessarily deactivated in the next command.
They are only deactivated after point motion commands that are not
the mark in Transient Mark mode (e.g., any command that modifies the
buffer).
-+++
-** C-M-% now shows replacement as it would look in the buffer, with
-`\N' and `\&' substituted according to the match. Old behavior can be
-restored by customizing `query-replace-show-replacement'.
-
-** C-z now invokes `suspend-frame', C-x C-c now invokes
-`save-buffers-kill-terminal'.
-
-** New command kill-matching-buffers kills buffers whose name matches a regexp.
-
-** You can disable kill ring commands from accessing the primary selection
-by setting `x-select-enable-primary' to nil.
-
-** If `select-active-regions' is t, setting the mark automatically
-makes the new region into the primary selection (for interaction with
-other window applications). If you enable this, you might want to bind
-`mouse-yank-primary' to Mouse-2.
-
-** If `yank-pop-change-selection' is t, rotating the kill ring
-also updates the selection or clipboard to the current yank,
-just as M-w would do so with the text it copies to the kill ring.
-
** Minibuffer changes
-*** Minibuffer input of shell commands now comes with completion.
-
-*** Operations like C-x b and C-x C-f which use switch-to-buffer do not fail
-any more when used in a minibuffer or a dedicated window. Instead, they
-fallback on using pop-to-buffer which will use some other window.
+*** Operations like C-x b and C-x C-f, which use switch-to-buffer, do
+not fail any more when used in a minibuffer or a dedicated window.
+Instead, they fallback on using pop-to-buffer, which will use some
+other window.
*** When M-n in the minibuffer reaches the end of the list of defaults,
it adds the completion list to the end, so next M-n continues putting
the default values and after the end of defaults they continue
searching minibuffer completion items.
-*** In C-x d, if you type M-n you get the visited file name of the
-current buffer.
+*** Minibuffer input of shell commands now comes with completion.
+
+*** In the `C-x d' (Dired) prompt, typing M-n gives the visited file
+name of the current buffer.
-*** A list of default commands extracted from mailcap according to
-file extensions are available in the list of default values
-accessible by M-n in the minibuffer that reads a shell command
-for M-! (shell-command) and fills a list of commands for the current
-file, and in Dired for ! (dired-do-shell-command) that fills a list of
-commands for the intersection of file types of marked Dired files.
+*** In the M-! (shell-command) prompt, M-n provides some default commands.
+These are guessed using the file extension of the current file, based
+on the file-handlers specified in the operating system's `mailcap'
+file. The ! command in Dired (dired-do-shell-command) works
+similarly, using the file displayed on the current line.
*** A list of regexp default values is available via M-n for `occur',
`keep-lines', `flush-lines' and `how-many'. This list includes the active
wraps to the first history element. When the search is terminated, the
history element containing the search string becomes the current.
-** New faces
+** Face changes
-*** `mode-line-emphasis' is used to highlight certain mode-line information;
-for example while waiting for a VC command to finish.
+*** S-down-mouse-1 now pops up a menu for changing the font and text
+size of the default face in the current buffer. The face is changed
+via face remapping (see below).
-** Face changes
+*** FIXME face-remap
+
+** Primary selection changes
+
+*** If `select-active-regions' is t, setting the mark automatically
+makes the new region into the primary selection (for interaction with
+other window applications). If you enable this, you might want to
+bind `mouse-yank-primary' to Mouse-2.
+
+*** You can disable kill ring commands from accessing the primary
+selection by setting `x-select-enable-primary' to nil.
+
+** Completion changes
+
+*** `completion-styles' can be customized to choose your favorite
+completion style.
+
+*** The default completion styles include a form of partial-completion.
+
+*** The new command `minibuffer-force-complete' chooses one of the
+possible completions, rather than stopping at the common prefix.
+
+*** `completion-auto-help' can be set to `lazy' to list the
+completions only if you repeat the completion. This was already
+supported in `partial-completion-mode'.
+
+** Continuation lines can be wrapped at word boundaries
+(word-wrapping) instead of the right window edge. The new per-buffer
+variable `word-wrap', if non-nil turns on word-wrapping. Word
+wrapping does not take place if continuation lines are not shown,
+e.g. if truncate-lines is non-nil.
+
+** Window management changes
+
+*** truncate-partial-width-windows now accepts integer values, which
+specify a minimum window width for partial-width windows, below which
+lines are truncated. The default has been changed to 30.
+
+*** The new command balance-windows-area balances windows both
+vertically and horizontally.
+
+** Miscellaneous changes:
+
+*** New keymap `search-map' bound to `M-s' provides global bindings
+for search related commands: `M-s o' for `occur', `M-s h r' for
+`highlight-regexp' and other hi-lock commands on the `M-s h' prefix.
+
+*** C-l is bound to the new command recenter-top-bottom, rather than recenter.
+This moves the current line to window center, top and bottom on
+successive invokations.
+
+*** scroll-preserve-screen-position also preserves the column position.
+
+*** If `yank-pop-change-selection' is t, rotating the kill ring also
+updates the selection or clipboard to the current yank, just as M-w
+would do so with the text it copies to the kill ring.
+
++++
+*** C-M-% now shows replacement as it would look in the buffer, with
+`\N' and `\&' substituted according to the match. Old behavior can be
+restored by customizing `query-replace-show-replacement'.
+
+*** The command shell prompts for the default directory, when it is
+called with a prefix and the default directory is a remote file name.
+This is because some file name handlers (like ange-ftp) are not able to
+run processes remotely.
+
+*** The new command kill-matching-buffers kills buffers whose name
+matches a regexp.
-*** The new function `face-all-attributes' returns an alist describing
-all the basic attributes of a given face.
+*** The new commands `pp-macroexpand-expression' and
+`pp-macroexpand-last-sexp' pretty-print macro expansions.
\f
* New Modes and Packages in Emacs 23.1
** FIXME add details of new packages imported from lisp/gnus.
[Maybe some information from doc/misc/gnus-coding.texi can be reused]
-** The package doc-view.el has been added. It supports viewing of PDF,
-PostScript and DVI documents inside an Emacs buffer by converting the
-document to a set of PNG images first. One can also search for a
-regular expression in the document. The commentary of the file explains
-its usage.
+** Auto Composition Mode is a minor mode that composes characters
+automatically when they are displayed. It is globally on by default.
+It uses `auto-composition-function' (default `auto-compose-chars').
+
+** Bubbles, a new game, is similar to SameGame.
+
+** bug-reference.el provides clickable links to bug reports.
+
+** copyright.el provides utilities for updating copyright notices in files.
+
+** dbus.el provides D-Bus language bindings.
+D-Bus is an inter-process communication mechanism for applications
+residing on the same host. See the manual for details.
-** The nXML package has been added. It is a new mode for editing XML
-documents. nXML mode allows a schema to be associated with the XML
-document being edited. nXML mode uses Relax NG as its schema
-language. The schema is used to provide two key features:
+** Doc View Mode allows viewing of PDF, PostScript and DVI documents.
+One can also search for a regular expression in the document. For
+details, see the commentary in doc-view.el.
+
+** EasyPG provides an interface to the GNU Privacy Guard (GnuPG).
+It includes a GnuPG keyring browser, cryptographic operations on
+regions and files, and automatic encryption of *.gpg files. For
+details, see the EasyPG Assistant User's Manual.
+
+** json.el is a library for parsing and generating JSON
+(JavaScript Object Notation), a lightweight data-interchange format.
+
+** linum.el is a new minor mode to display line numbers for the
+current buffer.
+
+** minibuffer-indicate-depth-mode shows the minibuffer depth in the prompt.
+
+** nXML Mode
+This is a new mode for editing XML documents. It allows a schema to
+be associated with the XML document being edited, using Relax NG as
+the schema language. The schema is used to provide two key features:
*** Continuous validation. nXML validates as you type, highlighting
any invalid parts of your document.
attribute name or data value by using information about what is
allowed by the schema in that context.
-** A new game called `bubbles' has been added. This is a version of
-the "Same Game" with configurable difficulty level.
+** proced.el provides a Dired-like interface for operating on processes.
+Proced makes an Emacs buffer containing a listing of the current
+processes (using ps(1)). You can use the normal Emacs commands to
+move around in this buffer, and special Proced commands to operate on
+the processes listed.
-** minibuffer-indicate-depth-mode shows the minibuffer depth in the prompt.
+** Remember Mode is a mode for jotting down things to remember.
+Notes can be saved to a Diary file. For details, see the Remember
+Manual.
-** Remember Mode (remember.el) is now included with Emacs. It is a
-mode for quickly jotting down things to remember. Included with
-remember.el is a backend that can save notes to a Diary file. Please
-consult the Remember Manual for usage details.
+** RST mode is a major mode for editing ReSTructured-Text files.
-** D-Bus language bindings for Elisp are provided by the package
-dbus.el and by extensions to the C modules of Emacs. D-Bus is an
-inter-process communication mechanism for applications residing on the
-same host, based on messages. See the manual for further details.
+** Visual Line mode provides support for editing by visual lines.
+It turns on word-wrapping in the current buffer, and rebinds C-a, C-e,
+and C-k to commands that operate by visual lines instead of logical
+lines. This is a more reliable replacement for longlines-mode.
+
+** A new `whitespace' package has been installed, and the pre-existing one
+renamed to `old-whitespace'.
+[FIXME someone explain why this is good, if it is...]
** zeroconf.el offers service discovery and service publishing
interfaces according to the zeroconf specification. It communicates
with Avahi, a zeroconf implementation, via D-Bus messages on systems
which have installed this software.
-** EasyPG is now part of the Emacs distribution. It is an all-in-one
-GnuPG interface which includes GnuPG keyring browser, cryptographic
-operations on regions and files, and automatic encryption of *.gpg
-files. See the EasyPG Assistant User's Manual for further details.
-
-** json.el is now included with Emacs. It is a library for parsing
-and generating JSON (JavaScript Object Notation). JSON is a
-lightweight data-interchange format.
-
-** Auto Composition Mode is a minor mode that composes characters
-automatically when they are displayed. It is globally on by default.
-It uses `auto-composition-function' (default `auto-compose-chars').
-
-** The package linum.el is now included with Emacs. It it a new minor
-mode to display line numbers for the current buffer.
-
-** proced.el has been added. It operates on processes like dired.
-Proced makes an Emacs buffer containing a listing of the current processes
-(using ps(1)). You can use the normal Emacs commands to move around in
-this buffer, and special Proced commands to operate on the processes listed.
-
-** bug-reference.el provides clickable links to bug reports.
-
\f
* Changes in Specialized Modes and Packages in Emacs 23.1
-** A new `whitespace' package has been installed, and the pre-existing one
-renamed to `old-whitespace'.
-[FIXME someone explain why this is good, if it is...]
-
-** abbrev was rewritten in Elisp and extended with more flexibility.
+** 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.
*** Special hook `abbrev-expand-functions' obsoletes `pre-abbrev-expand-hook'.
`:parents', `:case-fixed', `:enable-function', `:regexp',
`abbrev-table-modiff'.
-** Help mode
-*** New macro `with-help-window' should set up help windows better
-than `with-output-to-temp-buffer' with `print-help-return-message'.
-*** New option `help-window-select' permits to customize whether help
-window shall be automatically selected when invoking help.
-*** New variable `help-window-point-marker' permits to specify new
-position of point in help window (for example in `view-lossage').
+** Apropos
+*** `apropos-library' describes the elements defined in a given library.
+*** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
-** view-remove-frame-by-deleting is now by default t
-since users found iconification of view-mode frames distracting.
+** Archive Mode has basic support to browse Rar archives.
-** Isearch mode
+** BibTeX mode
-*** New command `isearch-occur' bound to `M-s o' in isearch mode
-runs `occur' with the current search string.
+*** New command `bibtex-initialize' (re)initializes BibTeX buffers.
-*** isearch can now search through multiple ChangeLog files.
-When running isearch in a ChangeLog file, if the search fails,
-then another C-s tries searching the previous ChangeLog,
-if there is one (e.g. go from ChangeLog to ChangeLog.12).
+*** New `bibtex-entry-format' options `whitespace', `braces', and
+`string', disabled by default.
-This is enabled if isearch-buffers-multi is non-nil.
+*** New variable `bibtex-cite-matcher-alist' contains rules to
+identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
-*** The part of an isearch that failed to match is highlighted in `isearch-fail'
-face.
+*** Command `bibtex-url' allows multiple URLs per entry.
-*** `C-h C-h' in isearch mode displays isearch-specific Help screen,
-`C-h b' displays all isearch key bindings, `C-h k' displays the full
-documentation of the given isearch key sequence, `C-h m' displays
-documentation of isearch mode. All the rest Help commands exit isearch mode
-and execute their global definitions.
+** Calendar and diary
+
++++
+*** There is a new date style, `iso', essentially year/month/day.
+The variable `european-calendar-style' is obsolete - use `calendar-date-style'.
+Similarly, the commands `american-calendar' and `european-calendar'
+should be replaced by `calendar-set-date-style'.
+
++++
+*** The calendar namespace has been rationalized.
+All functions and variables now begin with a `calendar-', `diary-', or
+`holiday-' prefix. The various calendar systems have secondary
+prefixes, eg `calendar-french-'. The old names you are likely to use
+directly still exist, for the time being, as aliases, but please start
+using the new names.
+
+*** The whitespace in the calendar layout can be customized.
+See the variables:
+calendar-left-margin, calendar-intermonth-spacing, calendar-column-width,
+calendar-day-header-width, and calendar-day-digit-width.
-** archive-mode has basic support to browse Rar archives.
+*** Text (e.g. ISO weeks) can be displayed between the calendar months.
+See the variables calendar-intermonth-header and calendar-intermonth-text.
-** talk.el has been extended for multiple tty support.
+*** The function `holiday-chinese' computes holidays on the Chinese calendar.
+It has been used to add items to the list `holiday-oriental-holidays'.
+
+*** `diary-remind' accepts a negative number -DAYS as a shorthand for
+the list (1 2 ... DAYS).
+
+** Change Log mode
+
+*** The new command C-c C-f (change-log-find-file) finds the file
+associated with the current log entry.
+
+*** The new command C-c C-c (change-log-goto-source) goes to the
+source code associated with a log entry.
** Compile and grep modes
*** compilation-auto-jump-to-first-error tells `compile' to jump to
the first error encountered during compilations.
-** In the `copyright' package, you can specify your copyright holders' names.
-Only copyright lines with holders matching copyright-names-regexp will be
-considered for update.
-
-** The `copyright' package looks for copyright at the end of the buffer
-if `copyright-at-end-flag' is non-nil (change-log-mode sets this).
-
-** eldoc highlights the function argument under point
-with the face `eldoc-highlight-function-argument'.
-
-** hide-ifdef-mode permits to shadow ifdef-blocks instead of hiding them.
-See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.
+*** The `cc' alias for C++ files in `grep-file-aliases' has been
+improved. `hh' can be used to match C++ header files and `cchh' both
+C++ sources and headers.
+** Custom
+++
-** defcustom accepts new keyword arguments, `:safe' and `:risky', which
+*** defcustom accepts new keyword arguments, `:safe' and `:risky', which
set a variable's `safe-local-variable' and `risky-local-variable' property.
-** Etags changes
-*** The --members option is now the default.
+** Diff mode
-Use --no-members if you want the old default behaviour of not tagging
-struct members in C, members variables in C++ and variables in PHP.
+*** diff-refine-hunk highlights word-level details of changes in a diff hunk.
+It's used automatically as you move through hunks, see
+diff-auto-refine-mode. It is bound to `C-c C-b'.
-** VC
+*** diff-add-change-log-entries-other-window iterates through the diff
+buffer and tries to create ChangeLog entries for each change.
+It is bound to `C-x 4 A'.
-*** VC now supports applying VC operations to a set of files at a time.
-This enables VC to work much more effectively with changeset-oriented
-version-control systems such as Subversion, GNU Arch, Mercurial, Git
-and Bzr. VC will now pass a multiple-file commit to these systems as
-a single changeset.
+** Dired
-*** vc-dir is a new command that displays file names and their VC
-status. It allows to apply various VC operations to a file or a
-set of files.
+*** In Dired, C-x C-q now runs the command wdired-change-to-wdired-mode,
+and C-x C-q in wdired-mode exits it with asking a question about
+saving changes.
-*** Clicking on the VC mode-line entry now pops the VC menu.
+*** `Q' in Dired provides two new keys for multi-file replacement.
+The upper case key `Y' replaces all remaining matches in all remaining files
+with no more questions. The upper case key `N' stops doing replacements
+in the current file and skips to the next file. These multi-file keys
+are available for all commands that use `tags-query-replace'
+including `dired-do-query-replace-regexp', `vc-dir-query-replace-regexp',
+`reftex-query-replace-document'.
-*** The VC mode-line entry now has a tooltip that explains the VC file status.
+** Fortran
+*** The variable `fortran-line-length' can change the fixed-form line-length.
-*** In VC Annotate mode, you can type V to toggle the annotation visibility.
+*** In Fortran mode, M-; is now bound to the standard comment-dwim,
+rather than fortran-indent-comment.
-*** In VC Annotate mode, you can type f to show the file revision on
-the current line.
++++
+*** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
-*** vc-git supports the "git grep" command.
+** Gnus
-*** Asynchronous VC commands display [Waiting...] in the mode-line
-of the corresponding buffer as long as the asynchronous process is
-active.
-
-*** Log entries can be modified using the key "e" in log-view.
-For now only CVS, RCS, SCCS and SVN support this functionality.
-This is done by the `modify-change-comment' backend function.
+*** The Gnus package has been updated
+There are many news features, bug fixes and improvements; see the file
+GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
-*** VC Support for Meta-CVS has been removed for lack of maintainer able
-to update it to the new VC.
+*** In Emacs 23, Gnus uses Emacs' new internal coding system `utf-8-emacs' for
+saving articles drafts and ~/.newsrc.eld. These file may not be read
+correctly in Emacs 22 and below. If you want to Gnus across different Emacs
+versions, you may set `mm-auto-save-coding-system' to `emacs-mule'.
-** smerge-refine highlights word-level details of changes in conflict.
-It's used automatically as you move through conflicts, see smerge-auto-refine.
+** Help mode
+*** New macro `with-help-window' should set up help windows better
+than `with-output-to-temp-buffer' with `print-help-return-message'.
+*** New option `help-window-select' permits to customize whether help
+window shall be automatically selected when invoking help.
+*** New variable `help-window-point-marker' permits to specify new
+position of point in help window (for example in `view-lossage').
-** Diff mode
+** Isearch
-*** diff-refine-hunk highlights word-level details of changes in a diff hunk.
-It's used automatically as you move through hunks, see
-diff-auto-refine. It is bound to `C-c C-b'.
+*** New command `isearch-highlight-regexp' bound to `M-s h r'
+in isearch mode runs `highlight-regexp' (`hi-lock-face-buffer')
+with the current search string as its regexp argument.
-*** diff-add-change-log-entries-other-window iterates through the diff
-buffer and tries to create ChangeLog entries for each change.
-It is bound to `C-x 4 A'.
+*** New command `isearch-occur' bound to `M-s o' in isearch mode
+runs `occur' with the current search string.
-** log-edit now has a command bound to C-c C-d to show the diff for
-the files involved.
+*** isearch can now search through multiple ChangeLog files.
+When running isearch in a ChangeLog file, if the search fails,
+then another C-s tries searching the previous ChangeLog,
+if there is one (e.g. go from ChangeLog to ChangeLog.12).
+This is enabled if multi-isearch-search is non-nil.
-** In Change Log mode, the new function `change-log-find-file', bound to
-C-c C-f, finds the file associated with the current log entry.
+*** Two new commands to start Isearch on a list of marked buffers
+for buff-menu.el and ibuffer.el are bound to the keys "M-s a C-s" and
+"M-s a M-C-s".
-** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
+*** The part of an isearch that failed to match is highlighted in `isearch-fail'
+face.
-** The appearance of superscript and subscript in TeX is more customizable.
-See the documentation of the variables: tex-fontify-script,
-tex-font-script-display, tex-suscript-height-ratio, and
-tex-suscript-height-minimum.
+*** `C-h C-h' in isearch mode displays isearch-specific Help screen,
+`C-h b' displays all isearch key bindings, `C-h k' displays the full
+documentation of the given isearch key sequence, `C-h m' displays
+documentation of isearch mode. All the rest Help commands exit isearch mode
+and execute their global definitions.
-** BibTeX mode
+*** When started in the minibuffer, Isearch searches in the minibuffer
+history. See `Minibuffer changes', above.
-*** New command `bibtex-initialize' (re)initializes BibTeX buffers.
+** Python
+*** The file etc/emacs.py now supports both Python 2 and 3, meaning
+that either version can be used as inferior Python by python.el.
-*** New `bibtex-entry-format' options `whitespace', `braces', and
-`string', disabled by default.
+*** Python mode now has `pdbtrack' functionality. When using pdb to
+debug a Python program, pdbtrack notices the pdb prompt and displays
+the source file and line that the program is stopped at, much the same
+way as gud-mode does for debugging C programs with gdb.
-*** New variable `bibtex-cite-matcher-alist' contains rules to
-identify cited keys in BibTeX entries, used by `bibtex-find-crossref'.
+** T-mouse Mode
-*** Command `bibtex-url' allows multiple URLs per entry.
+*** If the gpm mouse server is running and t-mouse-mode is enabled,
+Emacs uses a Unix socket in a GNU/Linux console to talk to server,
+rather than faking events using the client program mev. This C level
+approach provides mouse highlighting and help echoing in the
+minibuffer.
+++
** Tramp
When the variable `file-precious-flag' is set, the success of a remote
file copy is checked via the file's checksum.
-** Calendar and diary
+*** Passwords can be read from an authentification file.
+Tramp uses the package `auth-source' to read passwords from a file, if
+necessary.
-+++
-*** There is a new date style, `iso', essentially year/month/day.
-The variable `european-calendar-style' is obsolete - use `calendar-date-style'.
-Similarly, the commands `american-calendar' and `european-calendar'
-should be replaced by `calendar-set-date-style'.
+** VC and related modes
-+++
-*** The calendar namespace has been rationalized.
-All functions and variables now begin with a `calendar-', `diary-', or
-`holiday-' prefix. The various calendar systems have secondary
-prefixes, eg `calendar-french-'. The old names you are likely to use
-directly still exist, for the time being, as aliases, but please start
-using the new names.
+*** VC now supports applying VC operations to a set of files at a time.
+This enables VC to work much more effectively with changeset-oriented
+version-control systems such as Subversion, GNU Arch, Mercurial, Git
+and Bzr. VC will now pass a multiple-file commit to these systems as
+a single changeset.
-*** The function `holiday-chinese' computes holidays on the Chinese calendar.
-It has been used to add items to the list `holiday-oriental-holidays'.
+*** vc-dir is a new command that displays file names and their VC
+status. It allows to apply various VC operations to a file, a
+directory or a set of files/directories.
-*** `diary-remind' accepts a negative number -DAYS as a shorthand for
-the list (1 2 ... DAYS).
+*** Clicking on the VC mode-line entry now pops the VC menu.
-** Miscellaneous programming mode changes
+*** The VC mode-line entry now has a tooltip that explains the VC file status.
-*** The file etc/emacs.py now supports both Python 2 and 3, meaning
-that either version can be used as inferior Python by python.el.
+*** In VC Annotate mode, for VC systems that support changesets, you can
+see the diff for the whole changeset (not only for the current file)
+by typing the D key.
-*** Python mode now has `pdbtrack' functionality. When using pdb to
-debug a Python program, pdbtrack notices the pdb prompt and displays
-the source file and line that the program is stopped at, much the same
-way as gud-mode does for debugging C programs with gdb.
+*** In VC Annotate mode, you can type v to toggle the annotation visibility.
-*** The variable `fortran-line-length' can change the fixed-form line-length.
+*** In VC Annotate mode, you can type f to show the file revision on
+the current line.
-*** In Fortran mode, M-; is now bound to the standard comment-dwim,
-rather than fortran-indent-comment.
+*** In VC Annotate mode, for VC systems that support changesets, you
+can see the diff for the whole changeset (not only for the current
+file) by typing the D key or using the "Show changeset diff of
+revision at line" menu entry.
-+++
-*** (The increasingly misnamed) F90 mode supports Fortran 2003 syntax.
+*** Asynchronous VC commands display [Waiting...] in the mode-line
+of the corresponding buffer as long as the asynchronous process is
+active.
-** Gnus package
+*** Log entries can be modified using the key "e" in log-view.
+For now only CVS, RCS, SCCS and SVN support this functionality.
+This is done by the `modify-change-comment' backend function.
-*** The Gnus package has been updated
+*** In log-view-mode, for VC systems that support changesets, you can
+see the diff for the whole changeset (not only for the current file)
+by typing the D key or using the "Changeset Diff" menu entry.
-*** In Emacs 23, Gnus uses Emacs' new internal coding system `utf-8-emacs' for
-saving articles drafts and ~/.newsrc.eld. These file may not be read
-correctly in Emacs 22 and below. If you want to Gnus across different Emacs
-versions, you may set `mm-auto-save-coding-system' to `emacs-mule'.
+*** In Log Edit mode, C-c C-d now shows the diff for the files involved.
-*** There are many news features, bug fixes and improvements.
+*** vc-git supports the "git grep" command.
-See the file GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
+*** VC Support for Meta-CVS has been removed for lack of maintainer able
+to update it to the new VC.
** Miscellaneous
-*** goto-address.el provides two new minor modes, goto-address-mode and
-goto-address-prog-mode, which buttonize URLS and email addresses.
-
*** comint-mode uses `start-file-process' now (see Lisp Changes).
If `default-directory' is a remote file name, subprocesses are started
on the corresponding remote system.
-*** C-x C-q in dired-mode now runs the command wdired-change-to-wdired-mode,
-and C-x C-q in wdired-mode exits it with asking a question about
-saving changes.
+*** Eldoc highlights the function argument under point
+with the face `eldoc-highlight-function-argument'.
-*** The new command `eshell/info' runs info in an eshell buffer.
+*** In Etags, the --members option is now the default.
+Use --no-members if you want the old default behavior of not tagging
+struct members in C, members variables in C++ and variables in PHP.
-*** The pcmpl-unix package supports hostname completion for ssh and scp.
+*** The `gdb' command only works with the graphical interface now.
+Use `gud-gdb' if you want the (old) text command mode.
-*** WoMan tries to add locale-specific manual page directories to the
-search path. This can be disabled by setting `woman-locale' to nil.
+*** goto-address.el provides two new minor modes, goto-address-mode and
+goto-address-prog-mode, which buttonize URLS and email addresses.
+
+*** The new command `eshell/info' runs info in an eshell buffer.
*** The new variable `ffap-rfc-directories' specifies a list of local
directories in which `ffap-rfc' will first search for RFCs.
+*** hide-ifdef-mode allows shadowing ifdef-blocks instead of hiding them.
+See option `hide-ifdef-shadow' and function `hide-ifdef-toggle-shadowing'.
+
+*** `icomplete-prospects-height' now supercedes `icomplete-prospects-length'.
+
+*** Info displays breadcrumbs in the header of the page.
+See Info-breadcrumbs-depth to control it.
+
*** net-utils has an `iwconfig' command, similar to the existing `ifconfig'.
It is used to configure wireless interfaces.
+*** The pcmpl-unix package supports hostname completion for ssh and scp.
+
+*** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
+
+*** smerge-refine highlights word-level details of changes in conflict.
+It's used automatically as you move through conflicts, see
+smerge-auto-refine-mode.
+
+*** talk.el has been extended for multiple tty support.
+
+*** A new command `display-time-world' has been added to the Time
+package. It creates a buffer with an updating time display using
+several time zones.
+
+*** The appearance of superscript and subscript in TeX is more customizable.
+See the documentation of the variables: tex-fontify-script,
+tex-font-script-display, tex-suscript-height-ratio, and
+tex-suscript-height-minimum.
+
+*** view-remove-frame-by-deleting is now by default t
+since users found iconification of view-mode frames distracting.
+
+*** WoMan tries to add locale-specific manual page directories to the
+search path. This can be disabled by setting `woman-locale' to nil.
+
\f
* Changes in Emacs 23.1 on non-free operating systems
+** Case is now considered significant in completion on MS-Windows.
+The default value of `completion-ignore-case' is now nil on
+MS-Windows, the same as it is for other operating systems. The
+variable doesn't apply to reading a file name -- in that case Emacs
+heeds `read-file-name-completion-ignore-case' instead.
+
---
** IPv6 is supported on MS-Windows.
Emacs now supports IPv6 on Windows XP and later, and earlier versions
\f
* Incompatible Lisp Changes in Emacs 23.1
-** The argument DEFAULT of minibuffer input functions `read-from-minibuffer',
-`read-string', `completing-read', `read-buffer', `read-command',
-`read-variable' now can be a list of default values. The elements of
-this list are available for inserting to the minibuffer with `M-n'.
-If the user enters empty input, the first element is used as the default.
+** Variables cannot be both buffer-local and frame-local any more.
** `functionp' returns nil for special forms.
I.e., it only returns t for objects that can be passed to `funcall'.
-+++
-** The multibyteness of process filters is determined by the coding-system
-used for decoding. The functions `process-filter-multibyte-p' and
-`set-process-filter-multibyte' are obsolete.
-
** The behavior of map-char-table has changed. It may call the
specified function with a cons (FROM . TO) as a key if characters in
that range have the same value.
-** The value of the function `charset-id' is now always 0.
-
-** The functions `register-char-codings' and `coding-system-spec'
-have been removed.
-
-** The cpXXX coding systems are now supported automatically. The
-functions cp-...-codepage, which you had to use in Emacs 22 to enable
-support for these coding systems, have been deleted.
-
+** Process changes
+++
-** The function `dired-call-process' has been removed.
+*** The function `dired-call-process' has been removed.
++++
+*** The multibyteness of process filters is now determined by the
+coding-system used for decoding. The functions
+`process-filter-multibyte-p' and `set-process-filter-multibyte' are
+obsolete.
** The variable `byte-compile-warnings' can now be a list starting with `not',
meaning to disable the specified warnings. The meaning of this list
** `mode-name' is no longer guaranteed to be a string.
Use `(format-mode-line mode-name)' to ensure a string value.
-** The following features have been removed. They were used for
+** Internationalization changes
+
+*** The value of the function `charset-id' is now always 0.
+
+*** The functions `register-char-codings' and `coding-system-spec'
+have been removed.
+
+*** The cpXXX coding systems are now supported automatically.
+The functions cp-...-codepage, which you had to use in Emacs 22 to
+enable support for these coding systems, have been deleted.
+
+*** The following features have been removed. They were used for
displaying various scripts with specific fonts, and are no longer
needed now that OpenType font support is available:
-*** `devanagari' and `devan-util', and all associated devanagari-* and
+**** `devanagari' and `devan-util', and all associated devanagari-* and
dev-* functions and variables (formerly used for Devanagari script).
-*** `kannada' and `knd-util', and all associated kannada-* and knd-*
+**** `kannada' and `knd-util', and all associated kannada-* and knd-*
functions and variables (formerly used for Kannada script).
-*** `malayalam' and `mlm-util', and all associated malayalam-* and
+**** `malayalam' and `mlm-util', and all associated malayalam-* and
mlm-* functions and variables (formerly used for Malayalam script).
-*** `tamil' and `tml-util, and all associated tamil-* and tml-*
+**** `tamil' and `tml-util, and all associated tamil-* and tml-*
functions and variables (formerly used for Tamil script).
\f
* Lisp Changes in Emacs 23.1
-** `all-completions' may now return the base size in the last cdr.
-Since this means the returned list is not properly nil-terminated, this
-is an incompatible change and is thus enabled by the new variable
-completion-all-completions-with-base-size.
-
-** New function `apply-partially' for curried application.
++++
+** New variable `user-emacs-directory'.
+Use this instead of "~/.emacs.d".
-** `fill-forward-paragraph-function' specifies which function the filling
-code should use to find paragraph boundaries.
+** If a local hook function has a non-nil `permanent-local-hook'
+property, `kill-all-local-variables' does not remove it from the local
+value of the hook variable; it remains even if you change major modes.
-** The variable `this-command-keys-shift-translated' is non-nil if the
-key sequence invoking the current command was found by
-shift-translation.
+** `frame-inherited-parameters' lets new frames inherit parameters from
+the selected frame.
-** The new interactive spec code ^ says to first call
-handle-shift-selection if shift-select-mode is non-nil, before reading
-the command arguments.
+** New keymap `input-decode-map' overrides like key-translation-map, but
+applies before function-key-map. Also it is terminal-local contrary to
+key-translation-map. Terminal-specific key-sequences are generally added to
+this map rather than to function-key-map now.
-** When deleting a terminal, the special hook `delete-terminal-functions'
-is run.
+** `ignore-errors' is now a standard macro (does not require the CL package).
-** The `read-shell-command' function does what its name says, with completion.
-It uses the minibuffer-local-shell-command-map for that.
+** `interprogram-paste-function' can now return one string or a list
+of strings. In the latter case, Emacs puts the second and following
+strings on the kill ring.
-** The `buffer-swap-text' function can swap the text between two buffers.
-This can be useful for modes such as tar-mode, archive-mode, RMAIL.
++++
+** In `condition-case', a handler can specify "let the debugger run first".
+You do this by writing `debug' in the list of conditions to be handled,
+like this:
-** `clear-image-cache' can be told to flush only images of a specific file.
+ (condition-case nil
+ (foo bar)
+ ((debug error) nil))
** clone-indirect-buffer now runs the clone-indirect-buffer-hook.
** `beginning-of-defun-function' now takes one argument, the count
- given to `beginning-of-defun'.
-
-** The variable `inhibit-changing-match-data', if non-nil, prevents the
-search and match primitives from changing the match data.
+given to `beginning-of-defun'.
+++
-** New function `match-substitute-replacement' returns the result of
-`replace-match' without actually using it in the buffer.
+** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
+IDENTIFICATION specifies which part of the remote identifier has to be
+returned. With CONNECTED passed non-nil, it is checked whether a
+remote connection has been established already.
-** If a local hook function has a non-nil `permanent-local-hook'
-property, then `kill-all-local-variables' does not remove it from
-the local value of the hook variable. This means it remains
-even if you change major modes.
+** The new macro `declare-function' suppresses compiler warnings about
+undefined functions.
-+++
-** A list of default values can be specified for the DEFAULT argument of
-functions `read-from-minibuffer', `read-string', `read-command',
-`read-variable', `read-buffer', `completing-read'. Elements of this list
-are available for inserting into the minibuffer by typing `M-n'.
-For empty input these functions return the first element of this list.
+** Changes to interactive function handling
-** `custom-note-var-changed' tells Custom to treat the change in a certain
-variable as having been made within Custom.
+*** The new interactive spec code ^ says to first call
+handle-shift-selection if shift-select-mode is non-nil, before reading
+the command arguments. This is used for shift-selection (see above).
-** `frame-inherited-parameters' lets new frames inherit parameters from
-the selected frame.
+*** Built-in functions can now have an interactive specification that
+is not a prompt string. If the `intspec' parameter of a `DEFUN'
+starts with a `(', the string is evaluated as a Lisp form.
+
+*** The interactive-form of a function can be added post-facto via the
+`interactive-form' symbol property. Mostly useful to add complex
+interactive forms to subroutines.
-** Commands should use `use-region-p' to test whether there is
+** Region changes
+
+*** Commands should use `use-region-p' to test whether there is
an active region that they should operate on.
-** `region-active-p' returns non-nil when Transient Mark mode
-is enabled and there is an active region. This is NOT the best function
+*** `region-active-p' returns non-nil when Transient Mark mode is
+enabled and there is an active region. This is NOT the best function
to use to test whether a command should operate on the region instead
of the usual behavior -- for that, use `use-region-p'.
-** If a command sets `transient-mark-mode' to (only . OLDVAL), that
+*** If a command sets `transient-mark-mode' to (only . OLDVAL), that
means to activate transient-mark-mode temporarily, until the next
unshifted point motion command or mark deactivation. Afterwards,
reset transient-mark-mode to the value OLDVAL. The values `only' and
`identity', introduced in Emacs 22, are now deprecated.
-** New keymap `input-decode-map' overrides like key-translation-map, but
-applies before function-key-map. Also it is terminal-local contrary to
-key-translation-map. Terminal-specific key-sequences are generally added to
-this map rather than to function-key-map now.
+** Emacs session information
-** The new macro `declare-function' suppresses compiler warnings about
-undefined functions. The new `check-declare' package verifies that such
-statements are accurate (i.e. the functions are actually defined in
-the specified files).
+*** The new variables `before-init-time' and `after-init-time' record the
+value of `current-time' before and after Emacs loads the init files.
-** `ignore-errors' is now a standard macro (does not require the CL package).
+*** The new function `emacs-uptime' returns the uptime of an Emacs instance.
-** The new function `read-color' reads a color name using the minibuffer.
+*** The new function `emacs-init-time' returns the duration of the
+Emacs initialization.
-** `interprogram-paste-function' can now return one string or a list
-of strings. In the latter case, Emacs puts the second and following
-strings on the kill ring.
+** Changes affecting display-buffer
+
+*** New value nil for split-height-threshold inhibits vertical splitting
+unless there's no other window.
+
+*** New option split-width-threshold controls horizontal splitting.
+
+*** A window can be split horizontally even when it's not full-width.
+
+*** New option split-window-preferred-function can be set to a function
+to override the default splitting mechanism of display-buffer.
+
+** Minibuffer and completion changes
++++
+*** A list of default values can be specified for the DEFAULT argument of
+functions `read-from-minibuffer', `read-string', `read-command',
+`read-variable', `read-buffer', `completing-read'. Elements of this list
+are available for inserting into the minibuffer by typing `M-n'.
+For empty input these functions return the first element of this list.
+
+*** New function `read-regexp' uses the regexp history and some useful
+regexp defaults (string at point, last isearch/replacement regexp/string)
+via M-n when reading a regexp in the minibuffer.
+
+*** minibuffer-local-must-match-filename-map is now named
+minibuffer-local-filename-must-match-map.
+
+*** `all-completions' may now return the base size in the last cdr.
+Since this means the returned list is not properly nil-terminated, this
+is an incompatible change and is thus enabled by the new variable
+completion-all-completions-with-base-size.
+
+*** The `require-match' argument to `completing-read' accepts a new value
+`confirm-only'.
+
+** Search and replacement changes
++++
+*** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
++++
+*** New function `match-substitute-replacement' returns the result of
+`replace-match' without actually using it in the buffer.
+
+*** The new variable `replace-search-function' determines the function
+to use for searching in query-replace and replace-string.
+
+*** The new variable `replace-re-search-function' determines the
+function to use for searching in `query-replace-regexp',
+`replace-regexp', `query-replace-regexp-eval', and
+`map-query-replace-regexp'.
+
+*** The new keymap `multi-query-replace-map' contains additonal keys bound
+to `automatic-all' and `exit-current' for multi-buffer interactive replacement.
+
+*** The variable `inhibit-changing-match-data', if non-nil, prevents
+the search and match primitives from changing the match data.
+
+** File handling changes
+
+*** set-file-modes is now interactive and can take the mode value in
+symbolic notation thanks to auxiliary functions.
+
+*** If you set find-file-confirm-nonexistent-file to t, then C-x C-f
+requires confirmation before opening a non-existent file.
+
+** Process changes
++++
+*** The new function `start-file-process' is similar to `start-process',
+but obeys file handlers. The file handler is chosen based on
+`default-directory'. The functions `start-file-process-shell-command'
+and `process-file-shell-command' are also new; they call internally
+`start-file-process' and `process-file', respectively.
+
+*** The new function `process-lines' executes an external program and
+returns its output as a list of lines.
** Character code, representation, and charset changes.
Generic characters no longer exist.
-In buffer and string, characters are represented by UTF-8 byte
-sequence in a multibyte buffer/string.
-
-The concept of a charset has changed. A single character may belong to
-multiple charsets (e.g. a-grave, U+00E0, belongs to charsets unicode,
-iso-8859-1, iso-8859-3, etc).
+In buffers and strings, characters are represented by UTF-8 byte
+sequences in a multibyte buffer/string.
-*** The new function `characterp' returns t if and only if the argument
-is a character. This replaces `char-valid-p', which is now obsolete.
-
-*** The new function `max-char' returns the maximum character code
-(currently it is #x3FFFFF).
+The concept of a charset has changed. A single character may belong
+to multiple charsets (e.g. a-grave, U+00E0, belongs to charsets
+unicode, iso-8859-1, iso-8859-3, etc).
*** The functions `encode-char' and `decode-char' now accept any character sets.
*** The function `define-charset' now accepts a completely different
form of arguments (old-style arguments still work).
-*** The new function `define-charset-alias' defines an alias of a charset.
-
*** The value of the function `char-charset' depends on the current
priorities of charsets.
-*** The new function `charset-priority-list' returns the list of
-charsets ordered by priority.
-
-*** The new function `set-charset-priority' sets priorities of charsets.
-
-*** The new function `unibyte-string' make a unibyte string from bytes.
-
-*** The new function `define-char-code-property' defines a character
-code property.
-
-*** The new function `char-code-property-description' returns the
-description string of a character code property.
-
*** The function get-char-code-property now accepts many Unicode base
character properties. They are `name', `general-category',
`canonical-combining-class', `bidi-class', `decomposition',
`old-name', `iso-10646-comment', `uppercase', `lowercase', and
`titlecase'.
-*** The new variable `find-word-boundary-function-table' is a
-char-table of functions to search for a word boundary.
+*** The functions `modify-syntax-entry' and `modify-category-entry' now
+accept a cons of characters as the first argument, and modify all
+entries in that range of characters.
-*** The new variable `char-script-table' is a char-table of script names.
++++
+*** `translation-table-for-input' is now obsolete.
-*** The new variable `char-width-table' is a char-table of character widths.
+*** New functions:
-*** The new variable `print-charset-text-property' controls how to
-handle `charset' text property on printing a string.
+**** `characterp' returns t if and only if the argument is a character.
+This replaces `char-valid-p', which is now obsolete.
-*** The new variable `printable-chars' is a char-table defining if a
-character is printable or not.
+**** `max-char' returns the maximum character code (currently #x3FFFFF).
-*** The functions `modify-syntax-entry' and `modify-category-entry' now
-accepts a cons of characters as the first argument, and modify all
-entries in that range of characters.
-+++
-*** `translation-table-for-input' is now obsolete.
+**** `define-charset-alias' defines an alias of a charset.
+
+**** `set-charset-priority' sets priorities of charsets.
+
+**** `charset-priority-list' returns a prioritized list of charsets.
+
+**** `unibyte-string' makes a unibyte string from bytes.
+
+**** `define-char-code-property' defines a character code property.
+
+**** `char-code-property-description' returns the description string of
+a character code property.
+
+*** New variables:
+
+**** `find-word-boundary-function-table' is a char-table of functions to
+search for a word boundary.
+
+**** `char-script-table' is a char-table of script names.
+
+**** `char-width-table' is a char-table of character widths.
+
+**** `print-charset-text-property' controls how to handle `charset' text
+property on printing a string.
+
+**** `printable-chars' is a char-table of printable characters.
** Code conversion changes
have an optional 4th argument specifying a buffer to store the result
of conversion.
-*** The new function `with-coding-priority' executes the body part with
-the specified coding system priority order.
+*** The functions `set-coding-priority' and `make-coding-system' are obsolete.
-*** The new function `check-coding-systems-region' checks if the text
-in the region is encodable by the specified coding systems.
+*** New functions:
-*** The new function `coding-system-aliases' returns a list of aliases
-of a coding system.
+**** `with-coding-priority' executes Lisp code using the specified
+coding system priority order.
-*** The new function `coding-system-charset-list' returns a list of
-charsets supported by a coding system.
+**** `check-coding-systems-region' checks if the text in the region is
+encodable by the specified coding systems.
-*** The new function `coding-system-priority-list' returns a list of
-coding systems ordered by their priorities.
+**** `coding-system-aliases' returns a list of aliases of a coding system.
-*** The new function `set-coding-system-priority' sets priorities of
-coding systems.
+**** `coding-system-charset-list' returns a list of charsets supported
+by a coding system.
-*** The functions `set-coding-priority' and `make-coding-system' are obsolete.
+**** `coding-system-priority-list' returns a list of coding systems
+ordered by their priorities.
+
+**** `set-coding-system-priority' sets priorities of coding systems.
** There is a new input method, Robin, different from Quail.
It has three functionalities:
*** The new function `robin-use-package' starts using a Robin package
as an input method.
+*** The new function `string-to-unibyte' is like `string-as-unibyte'
+but signals an error if STRING contains a non-ASCII, non-eight-bit
+character.
+
** Changes related to the new font backend
Which font backends to use can be specified by the X resource "FontBackend".
font-backends supported by the frame's graphic device. On X, they are
currently `x' and `xft'.
-*** New function `fontp' checks if the argument is a font-spec or font-entity.
+*** The function `set-fontset-font' now accepts a script name as the
+second argument, and has an optional 5th argument to control how to
+set the font.
-*** New function `font-spec' creates a new font-spec object.
+*** New functions:
-*** New function `font-get' returns a font property value.
+**** `fontp' checks if the argument is a font-spec or font-entity.
-*** New function `font-put' sets a font property value.
+**** `font-spec' creates a new font-spec object.
-*** New function `list-fonts' returns a list of font-entities matching
-the given specification.
+**** `font-get' returns a font property value.
-*** New function `list-families' returns a list of family names of
-available fonts.
+**** `font-put' sets a font property value.
-*** New function `font-font' returns a font-entity best matching with
-the given specification.
+**** `font-face-attributes' returns a plist of face attributes set by a font.
-*** New function `font-xlfd-name' returns an XLFD name of a given font
-(font-spec, font-entity, or font-object).
+**** `list-fonts' returns a list of font-entities matching a font spec.
-*** New function `clear-font-cache' clears all font caches.
+**** `font-font' returns the font-entity best matching the given font spec.
-*** The function `set-fontset-font' now accepts a script name as the
-second argument, and has an optional 5th argument to control how to
-set the font.
+**** `list-families' returns a list of family names of available fonts.
+
+**** `font-xlfd-name' returns an XLFD name of a given font spec, font
+entity, or font object.
+
+**** `clear-font-cache' clears all font caches.
-** Changes related to multiple tty support
+** Changes related to multiple-terminal (multi-tty) support
*** $TERM is now set to `dumb' for subprocesses. If you want to know the
$TERM inherited by Emacs you will have to look inside initial-environment.
*** $DISPLAY is now dynamically inherited from the frame's `display'.
-*** The `window-system' variable has been made frame-local. The new
+*** The `window-system' variable is now frame-local. The new
`initial-window-system' variable contains the `window-system' value
for the first frame. `window-system' is also now a function that
takes a frame argument.
+*** The `keyboard-translate-table' variable and the terminal and
+keyboard coding systems are now terminal-local.
+
*** You can specify a terminal device (`tty' parameter) and a terminal
type (`tty-type' parameter) to `make-terminal-frame'.
-*** The new function `make-frame-on-tty' allows you to create a new
-frame on another tty device interactively.
-
*** The function `make-frame-on-display' now works during a tty
session, and `make-frame-on-tty' works during a graphical session.
-*** New functions: `delete-tty', `suspend-tty', `resume-tty'.
-
*** A new data type for terminals with functions: `get-device-terminal',
`terminal-parameters', `terminal-parameter', `set-terminal-parameter'.
-*** New hooks: `suspend-tty-functions' and `resume-tty-functions'
-are called after a tty frame has been suspended or resumed,
-respectively. The functions are called with the terminal id of the frame
-being suspended/resumed as a parameter.
+*** Function key sequences are now mapped using `local-function-key-map',
+a new variable. This inherits from the global variable function-key-map,
+which is not used directly any more.
-*** New function: `environment'.
+*** New hooks:
-*** New variable: `local-function-key-map'.
-This in addition to the global function-key-map variable that
-already existed. The global variable is not used directly any more;
-instead, the local-function-key-map is initialized so as to inherit from
-function-key-map.
+**** `suspend-tty-functions' and `resume-tty-functions' are called
+after a tty frame has been suspended or resumed, respectively. The
+functions are called with the terminal id of the frame being
+suspended/resumed as a parameter.
-*** `initial-environment' holds the environment inherited from Emacs's parent.
+**** The special hook `delete-terminal-functions' is called before
+deleting a terminal.
-*** The `keyboard-translate-table' variable and the terminal and
-keyboard coding systems have been made terminal-local.
+*** New functions:
+
+**** `environment'
+
+**** `make-frame-on-tty' creates a new frame on another tty device.
-*** In addition to the global function-key-map, Emacs has terminal-local
-local-function-key-map variables, and uses them instead of the
-global keymaps to set up translations and function key sequences
-relevant to a specific terminal device.
+**** `delete-tty'
+**** `suspend-tty'
-** You can now also pass the value of the `invisible' property to invisible-p
-to check whether it would cause the text to be invisible. Convenient when
-checking invisibility of text which has no buffer position
+**** `resume-tty'.
+
+*** `initial-environment' holds the environment inherited from Emacs's parent.
+
+** Redisplay changes
+
+*** For underlined characters, the distance between the underline and
+the baseline is controlled by a new variable, `underline-minimum-offset'.
+
+*** You can now pass the value of the `invisible' property to
+invisible-p to check whether it would cause the text to be invisible.
+Convenient when checking invisibility of text with no buffer position
(e.g. in before/after-strings).
-** Non-breaking space now acts as whitespace.
+*** Non-breaking space is now displayed as whitespace.
-+++
-** In `condition-case', a handler can specify "let the debugger run first".
+*** `clear-image-cache' can be told to flush only images of a specific file.
-You do this by writing `debug' in the list of conditions to be handled,
-like this:
+*** `vertical-motion' can now be given a goal column.
+It now accepts a cons cell (COLS . LINES) in its first argument, which
+says to stop, where possible, at a pixel x-position equal to COLS
+times the default column width.
- (condition-case nil
- (foo bar)
- ((debug error) nil))
+** Miscellaneous new functions
-** The `require-match' argument to `completing-read' accepts a new value
-`confirm-only'.
+*** `format-seconds' converts a number of seconds into a readable
+string of days, hours, etc.
-+++
-** The regexp form \(?<num>:<regexp>\) specifies the group number explicitly.
+*** `apply-partially' performs a "curried" application of a function.
-** New function `window-full-width-p' returns t if a window is as wide
-as its frame.
+*** `read-shell-command' does what its name says, with completion. It
+uses the minibuffer-local-shell-command-map for that.
-** The new function `split-string-and-unquote' does (what?)
+*** `buffer-swap-text' swaps text between two buffers. This can be
+useful for modes such as tar-mode, archive-mode, RMAIL.
-** The new function `combine-and-quote-strings' does (what?)
+*** `read-color' reads a color name using the minibuffer.
-** The new function `image-refresh' refreshes all images associated
-with a given image specification.
+*** `face-all-attributes' returns an alist describing all the basic
+attributes of a given face.
-+++
-** New variable `user-emacs-directory'.
-Use this instead of "~/.emacs.d".
+*** `window-full-width-p' returns t if a window is as wide as its
+frame.
-+++
-** The new function `start-file-process' is similar to `start-process',
-but obeys file handlers. The file handler is chosen based on
-`default-directory'. The functions `start-file-process-shell-command'
-and `process-file-shell-command' are also new; they call internally
-`start-file-process' and `process-file', respectively.
+*** `split-string-and-unquote' does (what?)
-** The new function `process-lines' executes an external program and
-returns its output as a list of lines.
+*** `combine-and-quote-strings' does (what?)
-+++
-** `file-remote-p' has new optional parameters IDENTIFICATION and CONNECTED.
-IDENTIFICATION specifies which part of the remote identifier has to be
-returned. With CONNECTED passed non-nil, it is checked whether a
-remote connection has been established already.
+*** `image-refresh' refreshes all images associated with a given image
+specification.
-** The two new functions `looking-at-p' and `string-match-p' can do
+*** The two new functions `looking-at-p' and `string-match-p' can do
the same matching as `looking-at' and `string-match' without changing
the match data.
-** The interactive-form of a function can be added post-facto via the
-`interactive-form' symbol property. Mostly useful to add complex interactive
-forms to subroutines.
+*** The two new functions `make-serial-process' and
+`serial-process-configure' provide a Lisp interface to the new serial
+port support (see Emacs changes, above).
+
+** Miscellaneous new variables
+
+*** `this-command-keys-shift-translated' is non-nil if the key
+sequence invoking the current command was found by shift-translation.
+
+*** `window-point-insertion-type' determines the insertion-type of the
+marker used for window-point.
+
+*** bookmark provides `bookmark-make-record-function' so special major
+modes like Info can teach bookmark.el how to save and restore the
+relevant data.
+
+*** `next-error-recenter' specifies how next-error should recenter the
+visited source file. Its value can be a number (for example, 0 for
+top line, -1 for bottom line), or nil for no recentering.
+
+*** `fill-forward-paragraph-function' specifies which function the
+filling code should use to find paragraph boundaries.
+
+*** `custom-note-var-changed' tells Custom to treat the change in a
+certain variable as having been made within Custom.
+
\f
* New Packages for Lisp Programming in Emacs 23.1
+** The new package avl-tree.el deals with the AVL tree data structure.
+
+** The new package check-declare.el verifies the accuracy of
+declare-function macros (see Lisp Changes, above).
+
** find-cmd.el can build `find' commands using lisp syntax.
-** The package isearch-multi.el has been added. It implements a new mode
-`isearch-buffers-minor-mode' that allows isearch to search through
-multiple buffers. In this mode a new variable
-`isearch-buffers-next-buffer-function' defines the function to call
-to get the next buffer to search in the series of multiple buffers.
+** The package misearch.el has been added. It allows Isearch to search
+through multiple buffers. A variable `multi-isearch-next-buffer-function'
+defines the function to call to get the next buffer to search in the series
+of multiple buffers. Top-level commands `multi-isearch-buffers',
+`multi-isearch-buffers-regexp', `multi-isearch-files' and
+`multi-isearch-files-regexp' accept a single argument that specifies
+a list of buffers/files to search for a string/regexp.
-** The new package avl-tree.el deals with the AVL tree data structure.
+** The new major mode `special-mode' is intended as a parent for
+major modes such as those that set the "'mode-class 'special" property.
\f
----------------------------------------------------------------------
This file is part of GNU Emacs.
-GNU Emacs is free software; you can redistribute it and/or modify
+GNU Emacs is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 3, or (at your option)
-any later version.
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
-along with GNU Emacs; see the file COPYING. If not, write to the
-Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
-Boston, MA 02110-1301, USA.
+along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
\f
Local variables: