* window.c (Vwindow_point_insertion_type): New var.
[bpt/emacs.git] / etc / NEWS
index 9acc5be..18ef4d6 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -34,9 +34,7 @@ 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).
+(e.g. monospace-12) are accepted.
 
 ** The new configuration option "--with-dbus" enables D-Bus language
 bindings for Emacs.
@@ -65,7 +63,17 @@ default toolkit, but you can use --with-x-toolkit=gtk if necessary.
 \f
 * Changes in Emacs 23.1
 
-** `completion-auto-help' can be set to `lazy' to list the completions only
+** Apropos
+*** `apropos-library' describes the elements defined in a given library.
+*** Set `apropos-compact-layout' is you want a more compact (but wider) layout.
+
+** scroll-preserve-screen-position also preserves the column position.
+** Completion.
+*** `completion-styles' can be customized to choose your favorite completion.
+*** 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'.
 
@@ -118,6 +126,26 @@ You can embed Emacs in another application on X11.  The new command line option
 http://standards.freedesktop.org/xembed-spec/xembed-spec-latest.html
 for details about XEmbed.
 
+** Controlling the frame opacity
+The opacity of a frame can now be controlled by setting
+the `alpha' frame parameter, on a compositing window manager
+(e.g. Compiz, Beryl and Compiz Fusion) for the X Window System.
+
+The alpha parameter should be an integer between 0 (transparent) and
+100 (opaque) or a float number between 0.0 and 1.0.  Optionally, the
+opacity can be set by a cons cell; the first item controls the
+opacity of an active frame, and the second item controls that of
+non-active frames.
+
+ (set-frame-parameter nil 'alpha 80)
+ (set-frame-parameter nil 'alpha 0.8)
+ (set-frame-parameter nil 'alpha '(100 70)) ; (<active> [<inactive>])
+ (set-frame-parameter nil 'alpha nil)
+
+Note that the threshold opacity of a frame is defined by the variable
+`frame-alpha-lower-limit' (default 20), so that the user may not lose
+control of the frame.
+
 ** 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.
@@ -129,8 +157,13 @@ 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.
+** 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.
 
 ** Emacsclient has been extended to support opening a new terminal
 frame.  Its behavior has been changed to open a new Emacs frame by
@@ -180,6 +213,9 @@ run processes remotely.
 ** The new command `display-time-world' starts an updating time display
 using several time zones, in a buffer.
 
+** Directory-local variables are now found in .dir-settings.el.  See
+also `set-directory-project' and `define-project-bindings'.
+
 ** The new function `format-seconds' converts a number of seconds into a
 readable string of days, hours, etc.
 
@@ -194,6 +230,9 @@ Emacs initialization.
 ** The minor modes unify-8859-on-encoding-mode, unify-8859-on-decoding-mode
 are obsolete.
 
+** The new commands `pp-macroexpand-expression' and `pp-macroexpand-last-sexp'
+pretty-print macro expansions.
+
 \f
 * Startup Changes in Emacs 23.1
 
@@ -212,10 +251,6 @@ This is a convenience alias, so that one can write `(pop argv)'
 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
@@ -225,6 +260,13 @@ Emacs was compiled without font-backend support.
 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,
+norwegian-alt-postfix, scandinavian-alt-postfix, spanish-alt-postfix,
+and swedish-alt-postfix.  Use the versions without "alt-", which are
+identical.
+
 \f
 * Editing Changes in Emacs 23.1
 
@@ -309,8 +351,12 @@ searching minibuffer completion items.
 *** In C-x d, if you type M-n you get the visited file name of the
 current buffer.
 
-*** In Dired, a list of commands for ! extracted from mailcap according to
-file extensions are added to the default list accessible by M-n.
+*** 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.
 
 *** 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
@@ -335,6 +381,8 @@ for example while waiting for a VC command to finish.
 *** The new function `face-all-attributes' returns an alist describing
 all the basic attributes of a given face.
 
+*** FIXME face-remap
+
 \f
 * New Modes and Packages in Emacs 23.1
 
@@ -400,19 +448,20 @@ 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
 
+** Icomplete: `icomplete-prospects-height' supercedes `icomplete-prospects-length'.
+
 ** 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...]
 
-** 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.
-
 ** abbrev was rewritten in Elisp and extended with more flexibility.
 *** New functions: abbrev-get, abbrev-put, abbrev-table-get, abbrev-table-put,
-    abbrev-table-p.
+    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.
@@ -450,18 +499,11 @@ This is enabled if isearch-buffers-multi is non-nil.
 *** The part of an isearch that failed to match is highlighted in `isearch-fail'
 face.
 
-** smerge-refine highlights word-level details of changes in conflict.
-It's used automatically as you move through conflicts, see smerge-auto-refine.
-
-** Diff mode
-
-*** 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'.
-
-*** 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'.
+*** `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.
 
 ** archive-mode has basic support to browse Rar archives.
 
@@ -480,6 +522,9 @@ the first error encountered during compilations.
 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'.
 
@@ -504,8 +549,8 @@ 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.
 
-*** vc-status is a new command that displays file names and their VC
-status.  It allows to apply various VC operations to apply a file or a
+*** 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.
 
 *** Clicking on the VC mode-line entry now pops the VC menu.
@@ -527,9 +572,28 @@ active.
 For now only CVS, RCS, SCCS and SVN support this functionality.
 This is done by the `modify-change-comment' backend function.
 
+*** VC Support for Meta-CVS has been removed for lack of maintainer able
+to update it to the new VC.
+
+** smerge-refine highlights word-level details of changes in conflict.
+It's used automatically as you move through conflicts, see smerge-auto-refine.
+
+** Diff mode
+
+*** 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'.
+
+*** 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'.
+
 ** log-edit now has a command bound to C-c C-d to show the diff for
 the files involved.
 
+** 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.
+
 ** sgml-electric-tag-pair-mode lets you simultaneously edit matched tag pairs.
 
 ** The appearance of superscript and subscript in TeX is more customizable.
@@ -594,6 +658,12 @@ 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 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).
+
 ** Miscellaneous programming mode changes
 
 *** The file etc/emacs.py now supports both Python 2 and 3, meaning
@@ -627,6 +697,9 @@ See the file GNUS-NEWS or the node "No Gnus" in the Gnus manual for details.
 
 ** 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.
@@ -651,17 +724,30 @@ It is used to configure wireless interfaces.
 \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
-of Windows with third party IPv6 stacks installed.  Previously IPv6 was
+of Windows with third party IPv6 stacks installed.  In Emacs 22, IPv6 was
 supported on other platforms, but not on Windows due to using the winsock
 1.1 header file, even though Emacs was linking to the winsock 2 library.
 
 ---
 ** Busy cursor (hourglass) now displays on MS-Windows.
 When Emacs is busy, an hourglass mouse cursor is displayed on Windows.
-Previously only X supported the busy cursor.
+In Emacs 22 only X supported the busy cursor.
+
+---
+** Battery status is available on MS-Windows
+Emacs can now display the battery status in the mode-line when enabled with
+display-battery-mode or from the Options menu.  More verbose battery
+information is also available with the command `battery'.  In Emacs 22
+battery status was supported only on GNU/Linux and Mac.
 
 ** More keys available on MS-Windows.
 Keys normally associated with IMEs, and some exotic keys not normally found
@@ -675,9 +761,17 @@ by default, since enabling them prevents their system-wide use when
 Emacs has focus.  To enable them, set the variable
 w32-pass-multimedia-buttons to nil.  See the doc string of that variable
 for the list of extra keys that are available.
+
 \f
 * Incompatible Lisp Changes in Emacs 23.1
 
+** Variables cannot be both buffer-local and frame-local any more.
+** 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.
+
 ** `functionp' returns nil for special forms.
 I.e., it only returns t for objects that can be passed to `funcall'.
 
@@ -732,6 +826,19 @@ functions and variables (formerly used for Tamil script).
 \f
 * Lisp Changes in Emacs 23.1
 
+** The variable window-point-insertion-type determines the insertion-type
+of the marker used for window-point.
+
+** 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.
+
+** New function `apply-partially' for curried application.
+
 ** `fill-forward-paragraph-function' specifies which function the filling
 code should use to find paragraph boundaries.
 
@@ -743,7 +850,8 @@ shift-translation.
 handle-shift-selection if shift-select-mode is non-nil, before reading
 the command arguments.
 
-** When deleting a terminal, run the special hook `delete-terminal-functions'.
+** When deleting a terminal, the special hook `delete-terminal-functions'
+is run.
 
 ** The `read-shell-command' function does what its name says, with completion.
 It uses the minibuffer-local-shell-command-map for that.
@@ -765,6 +873,14 @@ search and match primitives from changing the match data.
 ** 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'.
+
 ** 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
@@ -807,6 +923,8 @@ undefined functions.  The new `check-declare' package verifies that such
 statements are accurate (i.e. the functions are actually defined in
 the specified files).
 
+** `ignore-errors' is now a standard macro (does not require the CL package).
+
 ** The new function `read-color' reads a color name using the minibuffer.
 
 ** `interprogram-paste-function' can now return one string or a list
@@ -880,6 +998,8 @@ character is printable or not.
 *** 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.
 
 ** Code conversion changes
 
@@ -1081,6 +1201,8 @@ forms to subroutines.
 \f
 * New Packages for Lisp Programming in Emacs 23.1
 
+** 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
@@ -1093,10 +1215,10 @@ to get the next buffer to search in the series of multiple buffers.
 ----------------------------------------------------------------------
 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
@@ -1104,9 +1226,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 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: