[Emacs-diffs] /srv/bzr/emacs/trunk r107775: * doc/lispref/anti.texi (Antinews): Rewrite for Emacs 23.

[Chong Yidong]

------------------------------------------------------------
revno: 107775
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Thu 2012-04-05 22:47:41 +0800
message:
  * doc/lispref/anti.texi (Antinews): Rewrite for Emacs 23.
  
  * etc/NEWS: Some minor rearrangement.
modified:
  doc/lispref/ChangeLog
  doc/lispref/anti.texi
  etc/NEWS

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-04-04 10:32:35 +0000
+++ b/doc/lispref/ChangeLog     2012-04-05 14:47:41 +0000
@@ -1,3 +1,9 @@
+2012-04-05  Chong Yidong  <address@hidden>
+
+       * anti.texi (Antinews): Rewrite for Emacs 23.
+
+       * minibuf.texi (Programmed Completion): Document metadata method.
+
 2012-04-04  Chong Yidong  <address@hidden>
 
        * minibuf.texi (Programmed Completion): Remove obsolete variable

=== modified file 'doc/lispref/anti.texi'
--- a/doc/lispref/anti.texi     2012-03-04 06:50:18 +0000
+++ b/doc/lispref/anti.texi     2012-04-05 14:47:41 +0000
@@ -11,145 +11,129 @@
 @c with the above version number.
 
 For those users who live backwards in time, here is information about
-downgrading to Emacs version 22.3.  We hope you will enjoy the greater
+downgrading to Emacs version 23.4.  We hope you will enjoy the greater
 simplicity that results from the absence of many Emacs @value{EMACSVER}
 features.
 
address@hidden Old Lisp Features in Emacs 22
address@hidden Old Lisp Features in Emacs 23
 
 @itemize @bullet
 @item
-The internal character representation used by Emacs is not longer
-based on Unicode.  In this representation, called @code{emacs-mule},
-each character belongs to one and only one script.  Emacs makes no
-attempt to distinguish between ``similar'' characters occurring in
-different scripts.
-
address@hidden
-The @code{^} interactive spec code, the function
address@hidden, and the variable
address@hidden have all been removed.
-Shift-translated keys are no longer treated specially, making Emacs's
-handling of keybindings much more consistent.
-
address@hidden
-Temporarily-active regions are not created by giving the variable
address@hidden values of the form @code{(only
-. @var{oldvar})}.  We instead use a more complicated scheme:
-setting @code{transient-mark-mode} to @code{only} enables Transient
-Mark mode for the following command only, during which the value of
address@hidden is set to @code{identity}; if it is still
address@hidden at the end of the command, Transient Mark mode is
-disabled.
-
address@hidden
-Many minibuffer functions, such as @code{read-file-name} and
address@hidden, have been rewritten in C for greater
-speed.  The completion code has been considerably simplified; the
-completion style can no longer be changed via
address@hidden, and @code{completing-read} no longer
-recognizes the special values @code{confirm-only} and
address@hidden for its @var{require-match} argument.
-
address@hidden
-Emacs no longer supports explicitly-numbered groups in regular
-expressions.
-
address@hidden
-The @code{permanent-local-hook} function property has no special
-meaning.
-
address@hidden
-The @code{functionp} function now returns @code{t} for special forms.
-
address@hidden
-The @code{interactive-form} symbol property has no special meaning.
-Once you supply a function with an interactive form, the only way to
-change it is to redefine the function.
-
address@hidden
-The @code{ignore-errors} macro has been moved into the @code{cl}
-package.
-
address@hidden
-Variables can now be both buffer-local and frame-local; buffer-local
-bindings take precedence over frame-local bindings.
-
address@hidden
-Faces can no longer be remapped.
-
address@hidden
-Lisp programs now specify fonts by their names, which are strings
-following the XLFD (X logical font descriptor) format.  Fonts are no
-longer represented using a special set of ``font'' data types.  The
-various functions that act on these data types, such as @code{fontp},
address@hidden, and @code{list-fonts}, have all been deleted.
-
address@hidden
-Emacs does not recognize the @code{FontBackend} X resource and the
address@hidden frame parameter.  On the X Window System, fonts
-are always drawn using the X core font driver.
-
address@hidden
-Display terminals are no longer represented using a ``terminal'' data
-type; this is not necessary, because we have removed the ability to
-display on graphical and text terminals simultaneously.  For the same
-reason, the @code{window-system} variable is no longer frame-local,
-and the @code{window-system} function has been removed.
-
address@hidden
-The functions @code{list-system-processes} and
address@hidden have been removed.  To get information about
-system processes, call an external program, such as @command{ps}.
-
address@hidden
-The function @code{locate-user-emacs-file} and the variable
address@hidden have been removed.  Instead, use
-hard-coded values pointing to @file{~/.emacs.d}.
-
address@hidden
address@hidden can no longer be told to move to a specific
-column; it always puts point on the first column of a line.
-
address@hidden
-Windows no longer have parameters.
-
address@hidden
-The @code{display-buffer} function has been rewritten in C.  Its
-window-splitting heuristics are a little less sophisticated, and a
-little less documented.  Window-splitting is handled internally,
-instead of using @code{split-window-preferred-function} (which has
-been removed).  Windows are never split horizontally; the variable
address@hidden has been removed.
-
address@hidden
-The @code{mode-name} variable now accepts only string values, and
-cannot take the form of a mode-line construct.
-
address@hidden
-The behavior of @code{map-char-table} has changed.  It calls the
-mapping function for every single character in the table, instead of
-using cons cells to represent contiguous character code ranges.
-
address@hidden
-Several keymaps have been eliminated: @code{input-decode-map},
address@hidden, @code{search-map},
address@hidden, and
address@hidden
-
address@hidden
-Many functions have been removed, including: @code{buffer-swap-text},
address@hidden, @code{emacs-uptime}, @code{use-region-p},
address@hidden, @code{start-file-process},
address@hidden, @code{image-refresh},
address@hidden, @code{word-search-forward-lax},
-and @code{word-search-backward-lax}.
-
address@hidden
-Many variables have been removed, including @code{read-circle},
address@hidden and @code{before-init-time},
address@hidden, @code{file-local-variables-alist},
address@hidden and @code{replace-re-search-function},
address@hidden, @code{wrap-prefix}, and
address@hidden,
+Support for lexical scoping has been removed; all variables are
+dynamically scoped.  The @code{lexical-binding} variable has been
+removed, and so has the @var{lexical} argument to @code{eval}.  The
address@hidden and @code{defconst} forms no longer mark variables as
+dynamic, since all variables are dynamic.
+
+Having only dynamic binding follows the spirit of Emacs extensibility,
+for it allows any Emacs code to access any defined variable with a
+minimum of fuss.  But @xref{Dynamic Binding Tips}, for tips to avoid
+making your programs hard to understand.
+
address@hidden
+Calling a minor mode function from Lisp with a nil or omitted argument
+does not enable the minor mode unconditionally; instead, it toggles
+the minor mode---which is the straightforward thing to do, since that
+is the behavior when invoked interactively.  One downside is that it
+is more troublesome to enable minor modes from hooks; you have to do
+something like
+
address@hidden
+(add-hook 'foo-hook (lambda () (bar-mode 1)))
address@hidden example
+
address@hidden
+or define @code{turn-on-bar-mode} and call that from the hook.
+
address@hidden
+The @code{prog-mode} dummy major mode has been removed.  Instead of
+using it as a crutch to meet programming mode conventions, you should
+explicitly ensure that your mode follows those conventions.
address@hidden Mode Conventions}.
+
address@hidden
+Emacs no longer supports bidirectional display and editing.  Since
+there is no need to worry about the insertion of right-to-left text
+messing up how lines and paragraphs are displayed, the function
address@hidden has been removed; so have many
+other functions and variables related to bidirectional display.
+Unicode directionality characters like @code{U+200E} ("left-to-right
+mark") have no special effect on display.
+
address@hidden
+Emacs windows now have most of their internal state hidden from Lisp.
+Internal windows are no longer visible to Lisp; functions such as
address@hidden, window parameters related to window arrangement,
+and window-local buffer lists have all been removed.  Functions for
+resizing windows can delete windows if when they become too small.
+
+The @dfn{action function} feature for controlling buffer display has
+been removed, including @code{display-buffer-overriding-action} and
+related variables, as well as the @var{action} argument to
address@hidden and other functions.  The way to
+programmatically control how Emacs chooses a window to display a
+buffer is to bind the right combination of
address@hidden, @code{pop-up-frames}, and other
+variables.
+
address@hidden
+The standard completion interface has been simplified, eliminating the
address@hidden variable, the @code{metadata}
+action flag for completion functions, and the concept of
address@hidden categories}.  Lisp programmers may now find the choice
+of methods for tuning completion less bewildering, but if a package
+finds the streamlined interface insufficient for its needs, it must
+implement its own specialized completion feature.
+
address@hidden
address@hidden now behaves the same whether or not the
+destination is an existing directory: if the destination exists, the
address@hidden of the first directory are copied into it (with
+subdirectories handled recursively), rather than copying the first
+directory into a subdirectory.
+
address@hidden
+The @var{trash} arguments for @code{delete-file} and
address@hidden have been removed.  The variable
address@hidden must now be used with care; whenever
+it is address@hidden, all calls to @code{delete-file} or
address@hidden use the trash.
+
address@hidden
+Because Emacs no longer supports SELinux file contexts, the
address@hidden argument to @code{copy-file} has been
+removed.  The return value of @code{backup-buffer} no longer has an
+entry for the SELinux file context.
+
address@hidden
+For mouse click input events in the text area, the Y pixel coordinate
+in the @var{position} list (@pxref{Click Events}) now counts from the
+top of the header line, if there is one, rather than the top of the
+text area.
+
address@hidden
+Bindings in menu keymaps (@pxref{Format of Keymaps}) now sometimes get
+an additional @var{cache} entry in their definitions, like this:
+
address@hidden
+(@var{type} @var{item-name} @var{cache} . @var{binding})
address@hidden example
+
address@hidden
+The @var{cache} entry is used internally by Emacs to record equivalent
+keyboard key sequences for invoking the same command; Lisp programs
+should never use it.
+
address@hidden
+The @code{open-network-stream} function has been removed, and so has
+the @code{gnutls} library.  Lisp programs that want an encrypted
+network connection must now call external utilities such as
address@hidden or @command{gnutls-cli}.
+
address@hidden
+Tool bars can no longer display separators, which frees up several
+pixels of space on each graphical frame.
+
address@hidden
+Many other functions and variables have been eliminated.
 @end itemize

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-04-05 06:54:40 +0000
+++ b/etc/NEWS  2012-04-05 14:47:41 +0000
@@ -82,8 +82,6 @@
 
 ** Completion
 
-*** Shell mode uses pcomplete rules, with the standard completion UI.
-
 *** Many packages now use the `completion-at-point' command,
 rather than implementing separate completion commands.
 
@@ -313,6 +311,9 @@
 
 ** Window changes
 
+*** The `quit-window' command now restores the last buffer displayed
+in the quitted window.
+
 *** Resizing an Emacs frame now preserves proportional window sizes,
 modulo restrictions like window minimum sizes and fixed-size windows.
 
@@ -339,6 +340,10 @@
 other windows in the same combination.  Subsequent resizing or deletion
 of the window will resize all windows in the same combination as well.
 
+*** New option `frame-auto-hide-function' lets you choose between
+iconifying or deleting a frame when burying a buffer in a dedicated
+frame, or quitting a window showing a buffer in a frame of its own.
+
 *** New commands `maximize-window' and `minimize-window'.
 These maximize and minimize the size of a window within its frame.
 
@@ -1149,14 +1154,6 @@
 
 See the docstring of `display-buffer' for details.
 
-*** New behavior of `quit-window'.
-The behavior of `quit-window' has been changed in order to restore the
-state before the last buffer display operation in that window.
-
-*** The new option `frame-auto-hide-function' lets you choose between
-iconifying or deleting a frame when burying a buffer shown in a dedicated
-frame or quitting a window showing a buffer in a frame of its own.
-
 *** New functions `window-state-get' and `window-state-put'.
 These functions allow to save and restore the state of an arbitrary
 frame or window as an Elisp object.