[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/trunk r110684: More Emacs 24.3 documentatio
|
From: |
Chong Yidong |
|
Subject: |
[Emacs-diffs] /srv/bzr/emacs/trunk r110684: More Emacs 24.3 documentation updates. |
|
Date: |
Sat, 27 Oct 2012 13:03:52 +0800 |
|
User-agent: |
Bazaar (2.5.0) |
------------------------------------------------------------
revno: 110684
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sat 2012-10-27 13:03:52 +0800
message:
More Emacs 24.3 documentation updates.
* doc/emacs/building.texi (Compilation): Document compilation-always-kill.
* doc/emacs/files.texi (Misc File Ops): Symbolic links on Windows only work
on Vista and later.
* doc/emacs/frames.texi (Mouse Avoidance): Mention new variable
mouse-avoidance-banish-position.
* doc/emacs/mule.texi (Recognize Coding): Remove an unreferenced vindex.
* doc/emacs/package.texi (Package Menu): Document the "new" status.
* doc/emacs/programs.texi (Which Function): Which Function mode now works in
all major modes by default.
* doc/emacs/search.texi (Symbol Search): New node.
* doc/emacs/windows.texi (Window Choice): Don't refer to the obsolete
special-display feature.
* commands.texi (Event Input Misc): Remove last-input-char.
(Command Loop Info): Remove last-command-char.
* display.texi (Fringe Bitmaps): Add exclamation-mark bitmap.
* frames.texi (Initial Parameters): Don't mention the obsolete
special-display feature.
* hooks.texi (Standard Hooks): Remove obsolete hooks.
* markers.texi (Information from Markers): Remove obsolete
function buffer-has-markers-at.
* minibuf.texi (High-Level Completion): Don't mention removed
function iswitchb-read-buffer.
* text.texi (Yanking): Document yank-handled-properties.
* windows.texi (Choosing Window): Don't mention the obsolete
special display feature.
(Choosing Window Options): Remove obsolete special-display
variables, and the functions special-display-p and
special-display-popup-frame.
* subr.el (insert-buffer-substring-as-yank): Doc fix.
modified:
doc/emacs/ChangeLog
doc/emacs/building.texi
doc/emacs/emacs.texi
doc/emacs/files.texi
doc/emacs/frames.texi
doc/emacs/mule.texi
doc/emacs/package.texi
doc/emacs/programs.texi
doc/emacs/search.texi
doc/emacs/windows.texi
doc/lispref/ChangeLog
doc/lispref/anti.texi
doc/lispref/commands.texi
doc/lispref/display.texi
doc/lispref/frames.texi
doc/lispref/hooks.texi
doc/lispref/markers.texi
doc/lispref/minibuf.texi
doc/lispref/text.texi
doc/lispref/windows.texi
etc/NEWS
lisp/ChangeLog
lisp/subr.el
=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog 2012-10-24 14:38:49 +0000
+++ b/doc/emacs/ChangeLog 2012-10-27 05:03:52 +0000
@@ -1,3 +1,25 @@
+2012-10-27 Chong Yidong <address@hidden>
+
+ * frames.texi (Mouse Avoidance): Mention new variable
+ mouse-avoidance-banish-position.
+
+ * programs.texi (Which Function): Which Function mode now works in
+ all major modes by default.
+
+ * mule.texi (Recognize Coding): Remove an unreferenced vindex.
+
+ * files.texi (Misc File Ops): Symbolic links on Windows only work
+ on Vista and later.
+
+ * building.texi (Compilation): Document compilation-always-kill.
+
+ * search.texi (Symbol Search): New node.
+
+ * package.texi (Package Menu): Document the "new" status.
+
+ * windows.texi (Window Choice): Don't refer to the obsolete
+ special-display feature.
+
2012-10-24 Chong Yidong <address@hidden>
* mule.texi (Text Coding): set-buffer-file-coding-system can now
=== modified file 'doc/emacs/building.texi'
--- a/doc/emacs/building.texi 2012-09-30 09:18:38 +0000
+++ b/doc/emacs/building.texi 2012-10-27 05:03:52 +0000
@@ -108,11 +108,14 @@
was started.
@findex kill-compilation
address@hidden compilation-always-kill
Starting a new compilation also kills any compilation already
running in @file{*compilation*}, as the buffer can only handle one
compilation at any time. However, @kbd{M-x compile} asks for
-confirmation before actually killing a compilation that is running.
-You can also kill the compilation process with @kbd{M-x
+confirmation before actually killing a compilation that is running; to
+always automatically kill the compilation without asking, change the
+variable @code{compilation-always-kill} to @code{t}. You can also
+kill a compilation process with the command @kbd{M-x
kill-compilation}.
To run two compilations at once, start the first one, then rename
=== modified file 'doc/emacs/emacs.texi'
--- a/doc/emacs/emacs.texi 2012-09-30 09:18:38 +0000
+++ b/doc/emacs/emacs.texi 2012-10-27 05:03:52 +0000
@@ -373,6 +373,7 @@
* Incremental Search:: Search happens as you type the string.
* Nonincremental Search:: Specify entire string and then search.
* Word Search:: Search for sequence of words.
+* Symbol Search:: Search for a source code symbol.
* Regexp Search:: Search for match for a regexp.
* Regexps:: Syntax of regular expressions.
* Regexp Backslash:: Regular expression constructs starting with `\'.
=== modified file 'doc/emacs/files.texi'
--- a/doc/emacs/files.texi 2012-10-13 01:18:52 +0000
+++ b/doc/emacs/files.texi 2012-10-27 05:03:52 +0000
@@ -1564,9 +1564,8 @@
@var{target} at the time the opening is done, or will get an error if
the name @var{target} is nonexistent at that time. This command does
not expand the argument @var{target}, so that it allows you to specify
-a relative name as the target of the link. Not all systems support
-symbolic links; on systems that don't support them, this command is
-not defined.
+a relative name as the target of the link. On MS-Windows, this
+command works only on MS Windows Vista and later.
@kindex C-x i
@findex insert-file
=== modified file 'doc/emacs/frames.texi'
--- a/doc/emacs/frames.texi 2012-07-28 15:12:12 +0000
+++ b/doc/emacs/frames.texi 2012-10-27 05:03:52 +0000
@@ -1092,17 +1092,19 @@
@table @code
@item banish
-Move the mouse to the upper-right corner on any key-press;
+Move the pointer to a corner of the frame on any key-press. You can
+customize the variable @code{mouse-avoidance-banish-position} to
+specify where the pointer goes when it is banished.
@item exile
-Move the mouse to the corner only if the cursor gets too close,
-and allow it to return once the cursor is out of the way;
+Banish the pointer only if the cursor gets too close, and allow it to
+return once the cursor is out of the way.
@item jump
-If the cursor gets too close to the mouse, displace the mouse
-a random distance & direction;
+If the cursor gets too close to the pointer, displace the pointer by a
+random distance and direction.
@item animate
-As @code{jump}, but shows steps along the way for illusion of motion;
+As @code{jump}, but shows steps along the way for illusion of motion.
@item cat-and-mouse
-The same as @code{animate};
+The same as @code{animate}.
@item proteus
As @code{animate}, but changes the shape of the mouse pointer too.
@end table
=== modified file 'doc/emacs/mule.texi'
--- a/doc/emacs/mule.texi 2012-10-24 14:38:49 +0000
+++ b/doc/emacs/mule.texi 2012-10-27 05:03:52 +0000
@@ -920,7 +920,6 @@
@samp{-*-coding:-*-} tag.
@c FIXME? This seems somewhat out of place. Move to the Rmail section?
address@hidden rmail-decode-mime-charset
@vindex rmail-file-coding-system
When you get new mail in Rmail, each message is translated
automatically from the coding system it is written in, as if it were a
=== modified file 'doc/emacs/package.texi'
--- a/doc/emacs/package.texi 2012-04-10 06:54:43 +0000
+++ b/doc/emacs/package.texi 2012-10-27 05:03:52 +0000
@@ -62,8 +62,12 @@
downloaded from the package archive), @samp{installed}, or
@samp{built-in} (included in Emacs by default).
-In some instances, the status can be @samp{held}, @samp{disabled}, or
address@hidden @xref{Package Installation}.
+The status can also be @samp{new}. This is equivalent to
address@hidden, except that it means the package became newly
+available on the package archive after your last invocation of
address@hidden list-packages}. In other instances, a package may have the
+status @samp{held}, @samp{disabled}, or @samp{obsolete}.
address@hidden Installation}.
@item
A short description of the package.
=== modified file 'doc/emacs/programs.texi'
--- a/doc/emacs/programs.texi 2012-06-17 05:13:40 +0000
+++ b/doc/emacs/programs.texi 2012-10-27 05:03:52 +0000
@@ -326,12 +326,13 @@
@findex which-function-mode
@vindex which-func-modes
To either enable or disable Which Function mode, use the command
address@hidden which-function-mode}. Although Which Function mode is a
-global minor mode, it takes effect only in certain major modes: those
-listed in the variable @code{which-func-modes}. If the value of
address@hidden is @code{t} rather than a list of modes, then
-Which Function mode applies to all major modes that know how to
-support it---in other words, all the major modes that support Imenu.
address@hidden which-function-mode}. Which Function mode is a global minor
+mode. By default, it takes effect in all major modes major modes that
+know how to support it (i.e.@: all the major modes that support
+Imenu). You can restrict it to a specific list of major modes by
+changing the value of the variable @code{which-func-modes} from
address@hidden (which means to support all available major modes) to a list
+of major mode names.
@node Program Indent
@section Indentation for Programs
=== modified file 'doc/emacs/search.texi'
--- a/doc/emacs/search.texi 2012-10-16 23:27:40 +0000
+++ b/doc/emacs/search.texi 2012-10-27 05:03:52 +0000
@@ -21,6 +21,7 @@
* Incremental Search:: Search happens as you type the string.
* Nonincremental Search:: Specify entire string and then search.
* Word Search:: Search for sequence of words.
+* Symbol Search:: Search for a source code symbol.
* Regexp Search:: Search for match for a regexp.
* Regexps:: Syntax of regular expressions.
* Regexp Backslash:: Regular expression constructs starting with `\'.
@@ -467,6 +468,47 @@
proceeds incrementally as you type. This additional laxity does not
apply to the lazy highlight, which always matches whole words.
address@hidden Symbol Search
address@hidden Symbol Search
address@hidden symbol search
+
+ A @dfn{symbol search} is much like an ordinary search, except that
+the boundaries of the search must match the boundaries of a symbol.
+The meaning of @dfn{symbol} in this context depends on the major mode,
+and usually refers to a source code token, such as a Lisp symbol in
+Emacs Lisp mode. For instance, if you perform an incremental symbol
+search for the Lisp symbol @code{forward-word}, it would not match
address@hidden This feature is thus mainly useful for
+searching source code.
+
address@hidden @kbd
address@hidden M-s _
+If incremental search is active, toggle symbol search mode
+(@code{isearch-toggle-symbol}); otherwise, begin an incremental
+forward symbol search (@code{isearch-forward-symbol}).
address@hidden M-s _ @key{RET} @var{symbol} @key{RET}
+Search forward for @var{symbol}, nonincrementally.
address@hidden M-s _ C-r @key{RET} @var{symbol} @key{RET}
+Search backward for @var{symbol}, nonincrementally.
address@hidden table
+
address@hidden M-s _
address@hidden isearch-forward-symbol
+ To begin a forward incremental symbol search, type @kbd{M-s _}. If
+incremental search is not already active, this runs the command
address@hidden If incremental search is already
+active, @kbd{M-s _} switches to a symbol search, preserving the
+direction of the search and the current search string; you can disable
+symbol search by typing @kbd{M-s _} again. In incremental symbol
+search, only the beginning of the search string is required to match
+the beginning of a symbol.
+
+ To begin a nonincremental symbol search, type @kbd{M-s _ @key{RET}}
+for a forward search, or @kbd{M-s _ C-r @key{RET}} or a backward
+search. In nonincremental symbol searches, the beginning and end of
+the search string are required to match the beginning and end of a
+symbol, respectively.
+
@node Regexp Search
@section Regular Expression Search
@cindex regexp search
=== modified file 'doc/emacs/windows.texi'
--- a/doc/emacs/windows.texi 2012-09-07 10:27:11 +0000
+++ b/doc/emacs/windows.texi 2012-10-27 05:03:52 +0000
@@ -384,12 +384,6 @@
are considered, but windows on other frames are also reusable if you
change @code{pop-up-frames} (see below) to @code{t}.
address@hidden
-Otherwise, if you specified that the buffer should be displayed in a
-special frame by customizing @code{special-display-buffer-names} or
address@hidden, do so. @xref{Choosing Window
-Options,,, elisp, The Emacs Lisp Reference Manual}.
-
@vindex pop-up-frames
@item
Otherwise, optionally create a new frame and display the buffer there.
=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog 2012-10-24 14:38:49 +0000
+++ b/doc/lispref/ChangeLog 2012-10-27 05:03:52 +0000
@@ -1,3 +1,29 @@
+2012-10-27 Chong Yidong <address@hidden>
+
+ * minibuf.texi (High-Level Completion): Don't mention removed
+ function iswitchb-read-buffer.
+
+ * commands.texi (Event Input Misc): Remove last-input-char.
+ (Command Loop Info): Remove last-command-char.
+
+ * frames.texi (Initial Parameters): Don't mention the obsolete
+ special-display feature.
+
+ * windows.texi (Choosing Window): Don't mention the obsolete
+ special display feature.
+ (Choosing Window Options): Remove obsolete special-display
+ variables, and the functions special-display-p and
+ special-display-popup-frame.
+
+ * display.texi (Fringe Bitmaps): Add exclamation-mark bitmap.
+
+ * hooks.texi (Standard Hooks): Remove obsolete hooks.
+
+ * markers.texi (Information from Markers): Remove obsolete
+ function buffer-has-markers-at.
+
+ * text.texi (Yanking): Document yank-handled-properties.
+
2012-10-24 Paul Eggert <address@hidden>
Update manual for new time stamp format (Bug#12706).
=== modified file 'doc/lispref/anti.texi'
--- a/doc/lispref/anti.texi 2012-05-27 01:34:14 +0000
+++ b/doc/lispref/anti.texi 2012-10-27 05:03:52 +0000
@@ -71,9 +71,8 @@
related variables, as well as the @var{action} argument to
@code{display-buffer} 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.
+buffer is to bind the right combination of @code{pop-up-frames} and
+other variables.
@item
The standard completion interface has been simplified, eliminating the
=== modified file 'doc/lispref/commands.texi'
--- a/doc/lispref/commands.texi 2012-10-05 05:57:24 +0000
+++ b/doc/lispref/commands.texi 2012-10-27 05:03:52 +0000
@@ -186,7 +186,6 @@
the name of an existing buffer, which becomes the second and final
argument.
address@hidden Emacs 19 feature
The prompt string can use @samp{%} to include previous argument values
(starting with the first argument) in the prompt. This is done using
@code{format} (@pxref{Formatting Strings}). For example, here is how
@@ -205,7 +204,6 @@
signaled if the buffer is read-only.
@cindex @samp{@@} in @code{interactive}
address@hidden Emacs 19 feature
If @samp{@@} appears at the beginning of the string, and if the key
sequence used to invoke the command includes any mouse events, then
the window associated with the first of those events is selected
@@ -910,7 +908,6 @@
@end defvar
@defvar last-command-event
address@hidden last-command-char
This variable is set to the last input event that was read by the
command loop as part of a command. The principal use of this variable
is in @code{self-insert-command}, which uses it to decide which
@@ -926,11 +923,8 @@
@noindent
The value is 5 because that is the @acronym{ASCII} code for @kbd{C-e}.
-
-The alias @code{last-command-char} is obsolete.
@end defvar
address@hidden Emacs 19 feature
@defvar last-event-frame
This variable records which frame the last input event was directed to.
Usually this is the frame that was selected when the event was
@@ -2386,7 +2380,6 @@
@end example
@defvar num-input-keys
address@hidden Emacs 19 feature
This variable's value is the number of key sequences processed so far in
this Emacs session. This includes key sequences read from the terminal
and key sequences read from keyboard macros being executed.
@@ -2539,7 +2532,6 @@
@code{keyboard-translate-table} (if applicable), before returning it
from @code{read-event}.
address@hidden Emacs 19 feature
@defvar extra-keyboard-modifiers
This variable lets Lisp programs ``press'' the modifier keys on the
keyboard. The value is a character. Only the modifiers of the
@@ -2755,7 +2747,6 @@
@end defun
@defvar last-input-event
address@hidden last-input-char
This variable records the last terminal input event read, whether
as part of a command or explicitly by a Lisp program.
@@ -2774,8 +2765,6 @@
@result{} 49
@end group
@end example
-
-The alias @code{last-input-char} is obsolete.
@end defvar
@defmac while-no-input address@hidden
=== modified file 'doc/lispref/display.texi'
--- a/doc/lispref/display.texi 2012-10-23 02:39:13 +0000
+++ b/doc/lispref/display.texi 2012-10-27 05:03:52 +0000
@@ -3550,8 +3550,8 @@
@itemx @code{vertical-bar}, @code{horizontal-bar}
Used for different types of fringe cursors.
address@hidden @code{empty-line}, @code{question-mark}, @code{exclamation-mark}
-Unused.
address@hidden @code{empty-line}, @code{exclamation-mark},
@code{question-mark}, @code{exclamation-mark}
+Not used by core Emacs features.
@end table
@noindent
=== modified file 'doc/lispref/frames.texi'
--- a/doc/lispref/frames.texi 2012-09-30 09:18:38 +0000
+++ b/doc/lispref/frames.texi 2012-10-27 05:03:52 +0000
@@ -437,13 +437,11 @@
Window System, you can get the same results by means of X resources
in many cases.
-Setting this variable does not affect existing frames.
+Setting this variable does not affect existing frames. Furthermore,
+functions that display a buffer in a separate frame may override the
+default parameters by supplying their own parameters.
@end defopt
-Functions that display a buffer in a separate frame can override the
-default parameters by supplying their own parameters. @xref{Definition
-of special-display-frame-alist}.
-
If you invoke Emacs with command-line options that specify frame
appearance, those options take effect by adding elements to either
@code{initial-frame-alist} or @code{default-frame-alist}. Options
=== modified file 'doc/lispref/hooks.texi'
--- a/doc/lispref/hooks.texi 2012-10-23 15:06:07 +0000
+++ b/doc/lispref/hooks.texi 2012-10-27 05:03:52 +0000
@@ -120,14 +120,7 @@
@item delete-terminal-functions
@xref{Multiple Terminals}.
address@hidden
address@hidden disabled-command-function
address@hidden Commands}.
address@hidden ignore
-
address@hidden display-buffer-function
@itemx pop-up-frame-function
address@hidden special-display-function
@itemx split-window-preferred-function
@xref{Choosing Window Options}.
@@ -272,7 +265,6 @@
input-method-function
load-read-function
load-source-file-function
-macro-declaration-function
read-buffer-function
ring-bell-function
select-safe-coding-system-function
=== modified file 'doc/lispref/markers.texi'
--- a/doc/lispref/markers.texi 2012-09-07 04:51:26 +0000
+++ b/doc/lispref/markers.texi 2012-10-27 05:03:52 +0000
@@ -307,11 +307,6 @@
@end example
@end defun
address@hidden buffer-has-markers-at position
-This function returns @code{t} if one or more markers
-point at position @var{position} in the current buffer.
address@hidden defun
-
@node Marker Insertion Types
@section Marker Insertion Types
=== modified file 'doc/lispref/minibuf.texi'
--- a/doc/lispref/minibuf.texi 2012-10-24 14:38:49 +0000
+++ b/doc/lispref/minibuf.texi 2012-10-27 05:03:52 +0000
@@ -1218,11 +1218,9 @@
@end defun
@defopt read-buffer-function
-This variable specifies how to read buffer names. The function is
-called with the arguments passed to @code{read-buffer}. For example,
-if you set this variable to @code{iswitchb-read-buffer}, all Emacs
-commands that call @code{read-buffer} to read a buffer name will
-actually use the @code{iswitchb} package to read it.
+This variable, if address@hidden, specifies a function for reading
+buffer names. @code{read-buffer} calls this function instead of doing
+its usual work, with the same arguments passed to @code{read-buffer}.
@end defopt
@defopt read-buffer-completion-ignore-case
=== modified file 'doc/lispref/text.texi'
--- a/doc/lispref/text.texi 2012-10-23 07:57:42 +0000
+++ b/doc/lispref/text.texi 2012-10-27 05:03:52 +0000
@@ -899,31 +899,34 @@
@node Yanking
@subsection Yanking
- Yanking means inserting text from the kill ring, but it does
-not insert the text blindly. Yank commands and some other commands
-use @code{insert-for-yank} to perform special processing on the
-text that they copy into the buffer.
+ Yanking means inserting text from the kill ring, but it does not
+insert the text blindly. The @code{yank} command, and related
+commands, use @code{insert-for-yank} to perform special processing on
+the text before it is inserted.
@defun insert-for-yank string
-This function normally works like @code{insert} except that it doesn't
-insert the text properties (@pxref{Text Properties}) in the list
-variable @code{yank-excluded-properties}. However, if any part of
address@hidden has a address@hidden @code{yank-handler} text property,
-that property can do various special processing on that part of the
-text being inserted.
+This function works like @code{insert}, except that it processes the
+text in @var{string} according to the @code{yank-handler} text
+property, as well as the variables @code{yank-handled-properties} and
address@hidden (see below), before inserting the
+result into the current buffer.
@end defun
@defun insert-buffer-substring-as-yank buf &optional start end
-This function resembles @code{insert-buffer-substring} except that it
-doesn't insert the text properties in the
address@hidden list.
+This function resembles @code{insert-buffer-substring}, except that it
+processes the text according to @code{yank-handled-properties} and
address@hidden (It does not handle the
address@hidden property, which does not normally occur in buffer
+text anyway.)
@end defun
- You can put a @code{yank-handler} text property on all or part of
-the text to control how it will be inserted if it is yanked. The
address@hidden function looks for that property. The property
-value must be a list of one to four elements, with the following
-format (where elements after the first may be omitted):
+ If you put a @code{yank-handler} text property on all or part of a
+string, that alters how @code{insert-for-yank} inserts the string. If
+different parts of the string have different @code{yank-handler}
+values (comparison being done with @code{eq}), each substring is
+handled separately. The property value must be a list of one to four
+elements, with the following format (where elements after the first
+may be omitted):
@example
(@var{function} @var{param} @var{noexclude} @var{undo})
@@ -933,22 +936,21 @@
@table @var
@item function
-When @var{function} is present and address@hidden, it is called instead of
address@hidden to insert the string. @var{function} takes one
-argument---the string to insert.
+When @var{function} is address@hidden, it is called instead of
address@hidden to insert the string, with one argument---the string to
+insert.
@item param
If @var{param} is present and address@hidden, it replaces @var{string}
-(or the part of @var{string} being processed) as the object passed to
address@hidden (or @code{insert}); for example, if @var{function} is
address@hidden, @var{param} should be a list of strings to
-insert as a rectangle.
+(or the substring of @var{string} being processed) as the object
+passed to @var{function} (or @code{insert}). For example, if
address@hidden is @code{yank-rectangle}, @var{param} should be a list
+of strings to insert as a rectangle.
@item noexclude
-If @var{noexclude} is present and address@hidden, the normal removal of the
-yank-excluded-properties is not performed; instead @var{function} is
-responsible for removing those properties. This may be necessary
-if @var{function} adjusts point before or after inserting the object.
+If @var{noexclude} is present and address@hidden, that disables the
+normal action of @code{yank-handled-properties} and
address@hidden on the inserted string.
@item undo
If @var{undo} is present and address@hidden, it is a function that will be
@@ -959,14 +961,29 @@
@end table
@cindex yanking and text properties
address@hidden yank-handled-properties
+This variable specifies special text property handling conditions for
+yanked text. It takes effect after the text has been inserted (either
+normally, or via the @code{yank-handler} property), and prior to
address@hidden taking effect.
+
+The value should be an alist of elements @code{(@var{prop}
+. @var{fun})}. Each alist element is handled in order. The inserted
+text is scanned for stretches of text having text properties @code{eq}
+to @var{prop}; for each such stretch, @var{fun} is called with three
+arguments: the value of the property, and the start and end positions
+of the text.
address@hidden defopt
+
@defopt yank-excluded-properties
-Yanking discards certain text properties from the yanked text, as
-described above. The value of this variable is the list of properties
-to discard. Its default value contains properties that might lead to
-annoying results, such as causing the text to respond to the mouse or
-specifying key bindings.
+The value of this variable is the list of properties to remove from
+inserted text. Its default value contains properties that might lead
+to annoying results, such as causing the text to respond to the mouse
+or specifying key bindings. It takes effect after
address@hidden
@end defopt
+
@node Yank Commands
@subsection Functions for Yanking
=== modified file 'doc/lispref/windows.texi'
--- a/doc/lispref/windows.texi 2012-09-07 13:53:21 +0000
+++ b/doc/lispref/windows.texi 2012-10-27 05:03:52 +0000
@@ -1632,11 +1632,6 @@
The user option @code{display-buffer-alist}.
@item
-A special action for handling @code{special-display-buffer-names} and
address@hidden, if either of those variables is
address@hidden @xref{Choosing Window Options}.
-
address@hidden
The @var{action} argument.
@item
@@ -1864,91 +1859,6 @@
@code{nil}.
@end defopt
address@hidden special-display-buffer-names
-A list of buffer names identifying buffers that should be displayed
-specially. If the name of @var{buffer-or-name} is in this list,
address@hidden handles the buffer specially. By default, special
-display means to give the buffer a dedicated frame.
-
-If an element is a list, instead of a string, then the @sc{car} of that
-list is the buffer name, and the rest of that list says how to create
-the frame. There are two possibilities for the rest of that list (its
address@hidden): It can be an alist, specifying frame parameters, or it can
-contain a function and arguments to give to it. (The function's first
-argument is always the buffer to be displayed; the arguments from the
-list come after that.)
-
-For example:
-
address@hidden
-(("myfile" (minibuffer) (menu-bar-lines . 0)))
address@hidden example
-
address@hidden
-specifies to display a buffer named @samp{myfile} in a dedicated frame
-with specified @code{minibuffer} and @code{menu-bar-lines} parameters.
-
-The list of frame parameters can also use the phony frame parameters
address@hidden and @code{same-window}. If the specified frame
-parameters include @code{(same-window . @var{value})} and @var{value}
-is address@hidden, that means to display the buffer in the current
-selected window. Otherwise, if they include @code{(same-frame .
address@hidden)} and @var{value} is address@hidden, that means to display
-the buffer in a new window in the currently selected frame.
address@hidden defopt
-
address@hidden special-display-regexps
-A list of regular expressions specifying buffers that should be
-displayed specially. If the buffer's name matches any of the regular
-expressions in this list, @code{display-buffer} handles the buffer
-specially. By default, special display means to give the buffer a
-dedicated frame.
-
-If an element is a list, instead of a string, then the @sc{car} of the
-list is the regular expression, and the rest of the list says how to
-create the frame. See @code{special-display-buffer-names} above.
address@hidden defopt
-
address@hidden special-display-p buffer-name
-This function returns address@hidden if displaying a buffer
-named @var{buffer-name} with @code{display-buffer} would
-create a special frame. The value is @code{t} if it would
-use the default frame parameters, or else the specified list
-of frame parameters.
address@hidden defun
-
address@hidden special-display-function
-This variable holds the function to call to display a buffer specially.
-It receives the buffer as an argument, and should return the window in
-which it is displayed. The default value of this variable is
address@hidden, see below.
address@hidden defopt
-
address@hidden special-display-popup-frame buffer &optional args
-This function tries to make @var{buffer} visible in a frame of its own.
-If @var{buffer} is already displayed in some window, it makes that
-window's frame visible and raises it. Otherwise, it creates a frame
-that is dedicated to @var{buffer}. The return value is the window used
-to display @var{buffer}.
-
-If @var{args} is an alist, it specifies frame parameters for the new
-frame. If @var{args} is a list whose @sc{car} is a symbol, then
address@hidden(car @var{args})} is a function to actually create and
-set up the frame; it is called with @var{buffer} as first argument, and
address@hidden(cdr @var{args})} as additional arguments.
-
-This function always uses an existing window displaying @var{buffer},
-whether or not it is in a frame of its own; but if you set up the above
-variables in your init file, before @var{buffer} was created, then
-presumably the window was previously made by this function.
address@hidden defun
-
address@hidden special-display-frame-alist
address@hidden of special-display-frame-alist}
-This variable holds frame parameters for
address@hidden to use when it creates a frame.
address@hidden defopt
-
@defopt same-window-buffer-names
A list of buffer names for buffers that should be displayed in the
selected window. If a buffer's name is in this list,
@@ -1969,19 +1879,6 @@
put it in the selected window.
@end defun
address@hidden Emacs 19 feature
address@hidden display-buffer-function
-This variable is the most flexible way to customize the behavior of
address@hidden If it is address@hidden, it should be a function
-that @code{display-buffer} calls to do the work. The function should
-accept two arguments, the first two arguments that @code{display-buffer}
-received. It should choose or create a window, display the specified
-buffer in it, and then return the window.
-
-This variable takes precedence over all the other options described
-above.
address@hidden defopt
-
@node Window History
@section Window History
@cindex window history
=== modified file 'etc/NEWS'
--- a/etc/NEWS 2012-10-25 01:24:21 +0000
+++ b/etc/NEWS 2012-10-27 05:03:52 +0000
@@ -157,6 +157,7 @@
---
*** New option `server-auth-key' specifies a shared server key.
++++
** In the Package Menu, newly-available packages are listed as "new",
and sorted above the other "available" packages by default.
@@ -229,7 +230,7 @@
*** New option `replace-lax-whitespace'.
If non-nil, `query-replace' uses flexible whitespace matching too.
The default is nil.
-
++++
*** Global `M-s _' starts a symbol (identifier) incremental search,
and `M-s _' in Isearch toggles symbol search mode.
`M-s c' in Isearch toggles search case-sensitivity.
@@ -263,6 +264,7 @@
** New command `C-x r M-w' (copy-rectangle-as-kill).
It copies the region-rectangle as the last rectangle kill.
++++
** New option `yank-handled-properties' allows processing of text
properties on yanked text, in more ways that are more general than
just removing them, as done by `yank-excluded-properties'.
@@ -327,7 +329,7 @@
rather than making them unbound.
** Compilation mode
-
++++
*** New option `compilation-always-kill'.
** Customize
@@ -441,9 +443,9 @@
The old binding for `/ M' (filter by used-mode) is now bound to `/ m'.
** Mouse Avoidance mode
-
-The new variable `mouse-avoidance-banish-position' can now be used to
-customize Mouse Avoidance mode further.
++++
+*** New variable `mouse-avoidance-banish-position' specifies where the
+`banish' mouse avoidance setting moves the mouse.
+++
** notifications.el supports now version 1.2 of the Notifications API.
@@ -595,6 +597,7 @@
The `url-retrieve' function now uses this to encode its URL argument,
in case that is not properly encoded.
+---
** VHDL mode
*** The free software compiler GHDL is supported (and now the default).
@@ -605,7 +608,10 @@
*** Accepts \r and \f as whitespace.
-** which-function-mode now applies to all applicable major modes by default.
+** Which Function mode
++++
+*** `which-func-modes' now defaults to t, so Which Function mode, when
+enabled, applies to all applicable major modes.
---
** winner-mode-hook now runs when the mode is disabled, as well as when it is
@@ -708,6 +714,7 @@
Some Lisp symbols have been renamed to avoid problems with spelling
that is incorrect or inconsistent with how Emacs normally spells a word.
+---
*** Renamed functions
**** hangul-input-method-inactivate -> hangul-input-method-deactivate
@@ -719,22 +726,22 @@
viper-deactivate-input-method-action
**** ucs-input-inactivate -> ucs-input-deactivate
+---
*** Renamed hooks
The old hooks are still supported for backward compatibility, but they
are deprecated and will be removed eventually.
-
**** input-method-inactivate-hook -> input-method-deactivate-hook
**** robin-inactivate-hook -> robin-deactivate-hook
**** quail-inactivate-hook -> quail-deactivate-hook
+---
*** Renamed Lisp variables
-
**** follow-deactive-menu -> follow-inactive-menu
**** inactivate-current-input-method-function ->
deactivate-current-input-method-function
++++
** Some obsolete functions, variables, and faces were removed:
-
*** `facemenu-unlisted-faces'
*** `rmail-decode-mime-charset'
*** `last-input-char', `last-command-char', `unread-command-char'.
@@ -835,11 +842,17 @@
in Emacs 24.1:
+++
**** `display-buffer-reuse-frames'
++++
**** `special-display-regexps'
++++
**** `special-display-frame-alist'
++++
**** `special-display-buffer-names'
++++
**** `special-display-function'
++++
**** `display-buffer-function'
+---
**** `dired-shrink-to-fit'
** Time
@@ -897,19 +910,26 @@
** New macros `setq-local' and `defvar-local'.
++++
** New fringe bitmap `exclamation-mark'.
** Face underlining can now use a wave.
See the "Face Attributes" section of the Elisp manual.
** The following functions and variables are obsolete:
-
+---
*** `automount-dir-prefix'
++++
*** `buffer-has-markers-at'
+---
*** `macro-declaration-function' (use `macro-declarations-alist')
+---
*** `window-system-version'
+---
*** `dired-pop-to-buffer' (use `dired-mark-pop-up')
+---
*** `query-replace-interactive'
+---
*** `font-list-limit' (has had no effect since Emacs < 23)
@@ -928,6 +948,7 @@
Emacs now supports mouse highlight, help-echo (in the echo area), and
`mouse-autoselect-window'.
++++
** On MS Windows Vista and later Emacs now supports symbolic links.
+++
=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog 2012-10-26 20:44:38 +0000
+++ b/lisp/ChangeLog 2012-10-27 05:03:52 +0000
@@ -1,3 +1,7 @@
+2012-10-27 Chong Yidong <address@hidden>
+
+ * subr.el (insert-buffer-substring-as-yank): Doc fix.
+
2012-10-26 Jambunathan K <address@hidden>
* minibuffer.el (completion-category-overrides): New completion
=== modified file 'lisp/subr.el'
--- a/lisp/subr.el 2012-10-23 15:06:07 +0000
+++ b/lisp/subr.el 2012-10-27 05:03:52 +0000
@@ -2949,8 +2949,8 @@
BUFFER may be a buffer or a buffer name.
Arguments START and END are character positions specifying the substring.
They default to the values of (point-min) and (point-max) in BUFFER.
-Strip text properties from the inserted text according to
-`yank-excluded-properties'."
+Before insertion, process text properties according to
+`yank-handled-properties' and `yank-excluded-properties'."
;; Since the buffer text should not normally have yank-handler properties,
;; there is no need to handle them here.
(let ((opoint (point)))
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/trunk r110684: More Emacs 24.3 documentation updates.,
Chong Yidong <=