upstream

48 files changed, 1001 insertions, 505 deletions

diff --git a/ChangeLog b/ChangeLog
index 9712a2f0d0f..d7d9b14c929 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2012-02-05  Christoph Scholtes  <cschol2112@googlemail.com>
+
+        * make-dist (README.W32): Include file in source tarball. (Bug#9750)
+
+        * lib/makefile.w32-in (PRAGMA_SYSTEM_HEADER): Move to platform
+        specific makefiles to support getopt_.h generation with MSVC.
+
 2012-02-04  Glenn Morris  <rgm@gnu.org>
 
         * Makefile.in (uninstall):
diff --git a/admin/FOR-RELEASE b/admin/FOR-RELEASE
index 74a758826a1..379363252b2 100644
--- a/admin/FOR-RELEASE
+++ b/admin/FOR-RELEASE
@@ -188,7 +188,7 @@ buffers.texi
 commands.texi     
 compile.texi      
 control.texi      cyd
-customize.texi    
+customize.texi    cyd
 debugging.texi    
 display.texi      
 edebug.texi
diff --git a/admin/notes/bugtracker b/admin/notes/bugtracker
index dd1ea46ceb2..3c24212ea10 100644
--- a/admin/notes/bugtracker
+++ b/admin/notes/bugtracker
@@ -640,3 +640,14 @@ I think you also have to add them to 'tags' and 'tags_single_letter'
 in /usr/share/perl5/Debbugs/Config.pm.
 And update /var/www/Developer.html with a description of what the tag means.
 And the "valid tags" list in /var/www/index.html.
+
+** Backups
+
+The FSF sysadmins handle multi-generational backups of the filesystem
+on debbugs.gnu.org.  But if you really want to have your own backup of
+the bug database, you can use rsync (this requires login access to
+debbugs.gnu.org):
+
+ rsync -azvv -e ssh USER@debbugs.gnu.org:/var/lib/debbugs/ DEST
+
+Note that this occupies well over 1G of disk space.
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index ab4161c75b8..a5a54dad049 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2012-02-07  Glenn Morris  <rgm@gnu.org>
+
+        * files.texi (File Conveniences): Mention ImageMagick images.
+
 2012-02-05  Glenn Morris  <rgm@gnu.org>
 
         * trouble.texi (Checklist): Mention debug-on-event.
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index b2eb68d2812..b34b96126ad 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -1915,15 +1915,18 @@ point.  Partial Completion mode offers other features extending
 mode allows you to toggle between displaying the file as an image in
 the Emacs buffer, and displaying its underlying text representation,
 using the command @kbd{C-c C-c} (@code{image-toggle-display}).  This
-works only when Emacs can display the specific image type.  If the
-displayed image is wider or taller than the frame, the usual point
-motion keys (@kbd{C-f}, @kbd{C-p}, and so forth) cause different parts
-of the image to be displayed.  If the image can be animated, then
-the command @kbd{RET} (@code{image-toggle-animation}), will start (or
-stop) animating it.  Animation plays once, unless the option
-@code{image-animate-loop} is non-@code{nil}.  Currently, Emacs only
-supports animated GIF files (@pxref{Animated Images,,, elisp, The Emacs
-Lisp Reference Manual}).
+works only when Emacs can display the specific image type@footnote{If
+your Emacs was compiled with ImageMagick support, then after using
+@code{imagemagick-register-types}, you can view in Image mode any
+image type that ImageMagick supports; @pxref{ImageMagick Images,,,
+elisp, The Emacs Lisp Reference Manual}}.  If the displayed image is wider
+or taller than the frame, the usual point motion keys (@kbd{C-f},
+@kbd{C-p}, and so forth) cause different parts of the image to be
+displayed.  If the image can be animated, then the command @kbd{RET}
+(@code{image-toggle-animation}), will start (or stop) animating it.
+Animation plays once, unless the option @code{image-animate-loop} is
+non-@code{nil}.  Currently, Emacs only supports animated GIF files
+(@pxref{Animated Images,,, elisp, The Emacs Lisp Reference Manual}).
 
 @findex thumbs-mode
 @findex mode, thumbs
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index bd7b27bbe60..a172f82d2e5 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,9 +1,38 @@
+2012-02-07  Glenn Morris  <rgm@gnu.org>
+
+        * modes.texi (Defining Minor Modes):
+        Expand on args of defined minor modes.
+
+2012-02-07  Chong Yidong  <cyd@gnu.org>
+
+        * variables.texi (Creating Buffer-Local): Minor clarification
+        to buffer-local-variables doc (Bug#10715).
+
+2012-02-07  Glenn Morris  <rgm@gnu.org>
+
+        * display.texi (ImageMagick Images): General update.
+        Move most details of imagemagick-render-type to the variable's doc.
+
+2012-02-06  Glenn Morris  <rgm@gnu.org>
+
+        * keymaps.texi (Tool Bar): Mention separators.
+        (Inheritance and Keymaps):
+        Mention make-composed-keymap and multiple inheritance.
+
+        * modes.texi (Running Hooks): Mention run-hook-wrapped.
+
+        * control.texi (Handling Errors):
+        Mention condition-case-no-debug and with-demoted-errors.
+
 2012-02-05  Chong Yidong  <cyd@gnu.org>
 
         * customize.texi (Common Keywords): Minor clarifications.
         Document custom-unlispify-remove-prefixes.
         (Variable Definitions): Backquotes in defcustom seem to work fine
         now.  Various other copyedits.
+        (Simple Types): Copyedits.  Document color selector.
+        (Composite Types): Copyedits.
+        (Splicing into Lists): Clarifications.
 
         * eval.texi (Backquote): Move from macros.texi.
 
diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi
index 0511f21007d..3673f753a0a 100644
--- a/doc/lispref/control.texi
+++ b/doc/lispref/control.texi
@@ -891,9 +891,8 @@ establishing an error handler, with the special form
 
 @noindent
 This deletes the file named @var{filename}, catching any error and
-returning @code{nil} if an error occurs@footnote{
-Actually, you should use @code{ignore-errors} in such a simple case;
-see below.}.
+returning @code{nil} if an error occurs.  (You can use the macro
+@code{ignore-errors} for a simple case like this; see below.)
 
   The @code{condition-case} construct is often used to trap errors that
 are predictable, such as failure to open a file in a call to
@@ -949,6 +948,13 @@ The effect of @code{debug} here is only to prevent
 given error will invoke the debugger only if @code{debug-on-error} and
 the other usual filtering mechanisms say it should.  @xref{Error Debugging}.
 
+@defmac condition-case-no-debug var protected-form handlers@dots{}
+The macro @code{condition-case-no-debug} provides another way to
+handle debugging of such forms.  It behaves exactly like
+@code{condition-case}, unless the variable @code{debug-on-error} is
+non-@code{nil}, in which case it does not handle any errors at all.
+@end defmac
+
   Once Emacs decides that a certain handler handles the error, it
 returns control to that handler.  To do so, Emacs unbinds all variable
 bindings made by binding constructs that are being exited, and
@@ -1122,6 +1128,13 @@ Here's the example at the beginning of this subsection rewritten using
 @end smallexample
 @end defmac
 
+@defmac with-demoted-errors body@dots{}
+This macro is like a milder version of @code{ignore-errors}.  Rather
+than suppressing errors altogether, it converts them into messages.
+Use this form around code that is not expected to signal errors,
+but should be robust if one does occur.  Note that this macro
+uses @code{condition-case-no-debug} rather than @code{condition-case}.
+@end defmac
 
 @node Error Symbols
 @subsubsection Error Symbols and Condition Names
diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi
index b8c30fff8ae..4c3adee0db5 100644
--- a/doc/lispref/customize.texi
+++ b/doc/lispref/customize.texi
@@ -519,30 +519,28 @@ Introduction, widget, The Emacs Widget Library}, for details.
 @node Simple Types
 @subsection Simple Types
 
-  This section describes all the simple customization types.
+  This section describes all the simple customization types.  For
+several of these customization types, the customization widget
+provides inline completion with @kbd{C-M-i} or @kbd{M-@key{TAB}}.
 
 @table @code
 @item sexp
-The value may be any Lisp object that can be printed and read back.  You
-can use @code{sexp} as a fall-back for any option, if you don't want to
-take the time to work out a more specific type to use.
+The value may be any Lisp object that can be printed and read back.
+You can use @code{sexp} as a fall-back for any option, if you don't
+want to take the time to work out a more specific type to use.
 
 @item integer
-The value must be an integer, and is represented textually
-in the customization buffer.
+The value must be an integer.
 
 @item number
-The value must be a number (floating point or integer), and is
-represented textually in the customization buffer.
+The value must be a number (floating point or integer).
 
 @item float
-The value must be a floating point number, and is represented
-textually in the customization buffer.
+The value must be a floating point number.
 
 @item string
-The value must be a string, and the customization buffer shows just the
-contents, with no delimiting @samp{"} characters and no quoting with
-@samp{\}.
+The value must be a string.  The customization buffer shows the string
+without delimiting @samp{"} characters or @samp{\} quotes.
 
 @item regexp
 Like @code{string} except that the string must be a valid regular
@@ -554,39 +552,35 @@ integer, but this type shows the value by inserting the character in the
 buffer, rather than by showing the number.
 
 @item file
-The value must be a file name, and you can do completion with
-@kbd{M-@key{TAB}}.
+The value must be a file name.  The widget provides completion.
 
 @item (file :must-match t)
-The value must be a file name for an existing file, and you can do
-completion with @kbd{M-@key{TAB}}.
+The value must be a file name for an existing file.  The widget
+provides completion.
 
 @item directory
-The value must be a directory name, and you can do completion with
-@kbd{M-@key{TAB}}.
+The value must be a directory name.  The widget provides completion.
 
 @item hook
-The value must be a list of functions (or a single function, but that is
-obsolete usage).  This customization type is used for hook variables.
-You can use the @code{:options} keyword in a hook variable's
-@code{defcustom} to specify a list of functions recommended for use in
-the hook; see @ref{Variable Definitions}.
+The value must be a list of functions.  This customization type is
+used for hook variables.  You can use the @code{:options} keyword in a
+hook variable's @code{defcustom} to specify a list of functions
+recommended for use in the hook; @xref{Variable Definitions}.
 
 @item symbol
 The value must be a symbol.  It appears in the customization buffer as
-the name of the symbol.
+the symbol name.  The widget provides completion.
 
 @item function
-The value must be either a lambda expression or a function name.  When
-it is a function name, you can do completion with @kbd{M-@key{TAB}}.
+The value must be either a lambda expression or a function name.  The
+widget provides completion for function names.
 
 @item variable
-The value must be a variable name, and you can do completion with
-@kbd{M-@key{TAB}}.
+The value must be a variable name.  The widget provides completion.
 
 @item face
-The value must be a symbol which is a face name, and you can do
-completion with @kbd{M-@key{TAB}}.
+The value must be a symbol which is a face name.  The widget provides
+completion.
 
 @item boolean
 The value is boolean---either @code{nil} or @code{t}.  Note that by
@@ -600,8 +594,10 @@ The value must be a coding-system name, and you can do completion with
 @kbd{M-@key{TAB}}.
 
 @item color
-The value must be a valid color name, and you can do completion with
-@kbd{M-@key{TAB}}.  A sample is provided.
+The value must be a valid color name.  The widget provides completion
+for color names, as well as a sample and a button for selecting a
+color name from a list of color names shown in a @samp{*Colors*}
+buffer.
 @end table
 
 @node Composite Types
@@ -635,9 +631,8 @@ its @sc{cdr} must fit @var{cdr-type}.  For example, @code{(cons string
 symbol)} is a customization type which matches values such as
 @code{("foo" . foo)}.
 
-In the customization buffer, the @sc{car} and the @sc{cdr} are
-displayed and edited separately, each according to the type
-that you specify for it.
+In the customization buffer, the @sc{car} and @sc{cdr} are displayed
+and edited separately, each according to their specified type.
 
 @item (list @var{element-types}@dots{})
 The value must be a list with exactly as many elements as the
@@ -680,7 +675,7 @@ specified by the @code{:options} keyword argument.
 
 The argument to the @code{:options} keywords should be a list of
 specifications for reasonable keys in the alist.  Ordinarily, they are
-simply atoms, which stand for themselves as.  For example:
+simply atoms, which stand for themselves.  For example:
 
 @smallexample
 :options '("foo" "bar" "baz")
@@ -753,14 +748,6 @@ key, using variations of this trick:
   "Alist of basic info about people.
 Each element has the form (NAME AGE MALE-FLAG)."
   :type '(alist :value-type (group integer boolean)))
-
-(defcustom pets '(("brian")
-                  ("dorith" "dog" "guppy")
-                  ("ken" "cat"))
-  "Alist of people's pets.
-In an element (KEY . VALUE), KEY is the person's name,
-and the VALUE is a list of that person's pets."
-  :type '(alist :value-type (repeat string)))
 @end smallexample
 
 @item (plist :key-type @var{key-type} :value-type @var{value-type})
@@ -770,9 +757,8 @@ that (i) the information is stored as a property list,
 defaults to @code{symbol} rather than @code{sexp}.
 
 @item (choice @var{alternative-types}@dots{})
-The value must fit at least one of @var{alternative-types}.
-For example, @code{(choice integer string)} allows either an
-integer or a string.
+The value must fit one of @var{alternative-types}.  For example,
+@code{(choice integer string)} allows either an integer or a string.
 
 In the customization buffer, the user selects an alternative
 using a menu, and can then edit the value in the usual way for that
@@ -964,20 +950,18 @@ whatever follows the last keyword-value pair.
 @subsection Splicing into Lists
 
   The @code{:inline} feature lets you splice a variable number of
-elements into the middle of a list or vector.  You use it in a
-@code{set}, @code{choice} or @code{repeat} type which appears among the
-element-types of a @code{list} or @code{vector}.
-
-  Normally, each of the element-types in a @code{list} or @code{vector}
-describes one and only one element of the list or vector.  Thus, if an
-element-type is a @code{repeat}, that specifies a list of unspecified
-length which appears as one element.
-
-  But when the element-type uses @code{:inline}, the value it matches is
-merged directly into the containing sequence.  For example, if it
-matches a list with three elements, those become three elements of the
-overall sequence.  This is analogous to using @samp{,@@} in the backquote
-construct.
+elements into the middle of a @code{list} or @code{vector}
+customization type.  You use it by adding @code{:inline t} to a type
+specification which is contained in a @code{list} or @code{vector}
+specification.
+
+  Normally, each entry in a @code{list} or @code{vector} type
+specification describes a single element type.  But when an entry
+contains @code{:inline t}, the value it matches is merged directly
+into the containing sequence.  For example, if the entry matches a
+list with three elements, those become three elements of the overall
+sequence.  This is analogous to @samp{,@@} in a backquote construct
+(@pxref{Backquote}).
 
   For example, to specify a list whose first element must be @code{baz}
 and whose remaining arguments should be zero or more of @code{foo} and
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index e97e6c264a3..d5870fd3abb 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -4527,30 +4527,51 @@ specifying the bounding box of the PostScript image, analogous to the
 support, you can use the ImageMagick library to load many image formats.
 
 @findex imagemagick-types
+@findex imagemagick-register-types
 The function @code{imagemagick-types} returns a list of image file
 extensions that your installation of ImageMagick supports.  To enable
 support, you must call the function @code{imagemagick-register-types}.
+This enables Emacs to visit these file types in @code{image-mode}
+(@pxref{File Conveniences,,, emacs, The GNU Emacs Manual}).
+If your Emacs was not compiled with ImageMagick support, then
+@code{imagemagick-types} will be undefined and
+@code{imagemagick-register-types} will do nothing.
 
 @vindex imagemagick-types-inhibit
 The variable @code{imagemagick-types-inhibit} specifies a list of
-image types that you do @emph{not} want ImageMagick to handle.  There
-may be overlap between image loaders in your Emacs installation, and
-you may prefer to use a different one for a given image type (which
-@c FIXME how is this priority determined?
-loader will be used in practice depends on the priority of the loaders).
-@c FIXME why are these uppercase when image-types is lower-case?
-@c FIXME what are the possible options?  Are these actually file extensions?
-For example, if you never want to use the ImageMagick loader to use
+image types that you do @emph{not} want ImageMagick to handle.  It is
+a list of symbols, each of which has the same name as one of the
+format tags used internally by ImageMagick (i.e., as
+@code{imagemagick-types} returns).  ImageMagick has a very broad
+definition of what an image is, for example it includes such file
+types as C files and HTML files.  It is not appropriate to treat these
+as images in Emacs.  You can add any other ImageMagick type that you
+wish to this list.
+@ignore
+@c I don't know what this means.  I suspect it means eg loading jpg
+@c images via libjpeg or ImageMagick.  But it doesn't work.
+@c If you don't have libjpeg support compiled in, you cannot
+@c view jpeg images, even if you have imagemagick support:
+@c http://debbugs.gnu.org/9045
+@c And if you have both compiled in, then you always get
+@c the libjpeg version:
+@c http://debbugs.gnu.org/10746
+There may be overlap between image loaders in your Emacs installation,
+and you may prefer to use a different one for a given image type
+(which loader will be used in practice depends on the priority of the
+loaders).  
+For example, if you never want to use the ImageMagick loader to view
 JPEG files, add @code{JPG} to this list.
+@end ignore
+Note that ImageMagick often distinguishes between several different
+types of a particular format (e.g., @code{JPG}, @code{JPEG},
+@code{PJPEG}, etc.), and you may need to add all versions to this
+list.
 
+@c Not sure this should even be in the manual at all.
 @vindex imagemagick-render-type
-You can set the variable @code{imagemagick-render-type} to choose
-between screen render methods for the ImageMagick loader.  The options
-are: @code{0}, a conservative method which works with older
-@c FIXME details of this "newer method"?
-@c Presumably it is faster but may be less "robust"?
-ImageMagick versions (it is a bit slow, but robust); and @code{1},
-a newer ImageMagick method.
+If you wish to experiment with the performance of the ImageMagick
+loader, see the variable @code{imagemagick-render-type}.
 
 Images loaded with ImageMagick support a few new display specifications:
 
@@ -4565,10 +4586,11 @@ aspect ratio may not be preserved.
 Specifies a rotation angle in degrees.
 
 @item :index
-Specifies which image to view inside an image bundle file format, such
-as TIFF or DJVM.  You can use the @code{image-metadata} function to
-retrieve the total number of images in an image bundle (this is
-similar to how GIF files work).
+@c Doesn't work: http://debbugs.gnu.org/7978
+This has the same meaning as it does for GIF images (@pxref{GIF Images}),
+i.e. it specifies which image to view inside an image bundle file format
+such as DJVM.  You can use the @code{image-metadata} function to
+retrieve the total number of images in an image bundle.
 @end table
 
 
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 8e03ade285f..a8528a548fc 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -432,6 +432,34 @@ for every numeric character code without modifier bits, even if it is
 @code{nil}, so these character's bindings are never inherited from
 the parent keymap.
 
+@cindex keymap inheritance from multiple maps
+  Sometimes you want to make a keymap that inherits from more than one
+map.  You can use the function @code{make-composed-keymap} for this.
+
+@defun make-composed-keymap maps &optional parent
+This function returns a new keymap composed of the existing keymap(s)
+@var{maps}, and optionally inheriting from a parent keymap
+@var{parent}.  @var{maps} can be a single keymap or a list of more
+than one.  When looking up a key in the resulting new map, Emacs
+searches in each of the @var{maps}, and then in @var{parent}, stopping
+at the first match.  A @code{nil} binding in any one of @var{maps}
+overrides any binding in @var{parent}, but not a non-@code{nil} binding
+in any other of the @var{maps}.
+@end defun
+
+@noindent For example, here is how Emacs sets the parent of
+@code{help-mode-map}, such that it inherits from both
+@code{button-buffer-map} and @code{special-mode-map}:
+
+@example
+(defvar help-mode-map
+  (let ((map (make-sparse-keymap)))
+    (set-keymap-parent map (make-composed-keymap button-buffer-map
+                                                 special-mode-map))
+    ... map) ... )
+@end example
+
+
 @node Prefix Keys
 @section Prefix Keys
 @cindex prefix key
@@ -2318,7 +2346,7 @@ The various toolkits with which you can build Emacs do not all support
 the same set of features for menus.  Some code works as expected with
 one toolkit, but not under another.
 
-One example is menu actions or buttons in a top-level menu-bar.  The
+One example is menu actions or buttons in a top-level menu bar.  The
 following works with the Lucid toolkit or on MS Windows, but not with
 GTK or Nextstep, where clicking on the item has no effect.
 
@@ -2658,6 +2686,15 @@ The @code{:rtl} property specifies an alternative image to use for
 right-to-left languages.  Only the Gtk+ version of Emacs supports this
 at present.
 
+Like the menu bar, the tool bar can display separators (@pxref{Menu
+Separators}).  Tool bar separators are vertical rather than
+horizontal, though, and only a single style is supported.  Separators
+are represented in the tool bar keymap in the same way as for the
+menu bar, i.e. using a @code{(menu-item "--"}) entry.  The Gtk+ and
+Nextstep tool bars render separators natively, otherwise Emacs selects
+a separator image that is appropriate for the display.  Note that tool
+bar separators do not support any properties, such as @code{:visible}.
+
 The default tool bar is defined so that items specific to editing do not
 appear for major modes whose command symbol has a @code{mode-class}
 property of @code{special} (@pxref{Major Mode Conventions}).  Major
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 638ab89e37f..052fd037167 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -163,6 +163,14 @@ A wrapper-hook also allows for a hook function to completely replace the
 default definition (by not calling @var{fun}).
 @end defmac
 
+@defun run-hook-wrapped hook wrap-function &rest args
+This function is similar to @code{run-hook-with-args-until-success}.
+Like that function, it runs the functions on the abnormal hook
+@code{hook}, stopping at the first one that returns non-@code{nil}.
+Instead of calling the hook functions directly, though, it actually
+calls @code{wrap-function} with arguments @code{fun} and @code{args}.
+@end defun
+
 @node Setting Hooks
 @subsection Setting Hooks
 
@@ -1372,11 +1380,21 @@ implementing a mode in one self-contained definition.
 @defmac define-minor-mode mode doc [init-value [lighter [keymap]]] keyword-args@dots{} body@dots{}
 This macro defines a new minor mode whose name is @var{mode} (a
 symbol).  It defines a command named @var{mode} to toggle the minor
-mode, with @var{doc} as its documentation string.  By default, it also
-defines a variable named @var{mode}, which is set to @code{t} or
-@code{nil} by enabling or disabling the mode.  The variable is
-initialized to @var{init-value}.  Except in unusual circumstances (see
-below), this value must be @code{nil}.
+mode, with @var{doc} as its documentation string.
+
+The toggle command takes one optional (prefix) argument.
+If called interactively with no argument it toggles the mode on or off.
+A positive prefix argument enables the mode, any other prefix argument
+disables it.  From Lisp, an argument of @code{toggle} toggles the mode,
+whereas an omitted or @code{nil} argument enables the mode.
+This makes it easy to enable the minor mode in a major mode hook, for example.
+If @var{doc} is nil, the macro supplies a default documentation string
+explaining the above.
+
+By default, it also defines a variable named @var{mode}, which is set to
+@code{t} or @code{nil} by enabling or disabling the mode.  The variable
+is initialized to @var{init-value}.  Except in unusual circumstances
+(see below), this value must be @code{nil}.
 
 The string @var{lighter} says what to display in the mode line
 when the mode is enabled; if it is @code{nil}, the mode is not displayed
@@ -1470,9 +1488,10 @@ for this macro.
 @smallexample
 (define-minor-mode hungry-mode
   "Toggle Hungry mode.
-With no argument, this command toggles the mode.
-Non-null prefix argument turns on the mode.
-Null prefix argument turns off the mode.
+Interactively with no argument, this command toggles the mode.
+A positive prefix argument enables the mode, any other prefix
+argument disables it.  From Lisp, argument omitted or nil enables
+the mode, `toggle' toggles the state.
 
 When Hungry mode is enabled, the control delete key
 gobbles all preceding whitespace except the last.
@@ -1501,13 +1520,7 @@ minor modes don't need any.
 @smallexample
 (define-minor-mode hungry-mode
   "Toggle Hungry mode.
-With no argument, this command toggles the mode.
-Non-null prefix argument turns on the mode.
-Null prefix argument turns off the mode.
-
-When Hungry mode is enabled, the control delete key
-gobbles all preceding whitespace except the last.
-See the command \\[hungry-electric-delete]."
+...rest of documentation as before..."
  ;; The initial value.
  :init-value nil
  ;; The indicator for the mode line.
diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index bdb16cd10a8..ab3a4edc0ac 100644
--- a/doc/lispref/variables.texi
+++ b/doc/lispref/variables.texi
@@ -1317,11 +1317,12 @@ value (@pxref{Default Value}) of @var{variable} instead.
 
 @defun buffer-local-variables &optional buffer
 This function returns a list describing the buffer-local variables in
-buffer @var{buffer}.  (If @var{buffer} is omitted, the current buffer is
-used.)  It returns an association list (@pxref{Association Lists}) in
-which each element contains one buffer-local variable and its value.
-However, when a variable's buffer-local binding in @var{buffer} is void,
-then the variable appears directly in the resulting list.
+buffer @var{buffer}.  (If @var{buffer} is omitted, the current buffer
+is used.)  Normally, each list element has the form
+@w{@code{(@var{sym} . @var{val})}}, where @var{sym} is a buffer-local
+variable (a symbol) and @var{val} is its buffer-local value.  But when
+a variable's buffer-local binding in @var{buffer} is void, its list
+element is just @var{sym}.
 
 @example
 @group
diff --git a/etc/ChangeLog b/etc/ChangeLog
index 9951e131e15..0ce71a21d06 100644
--- a/etc/ChangeLog
+++ b/etc/ChangeLog
@@ -1,3 +1,7 @@
+2012-02-06  Juanma Barranquero  <lekktu@gmail.com>
+
+        * tutorials/TUTORIAL.es: Updated; synchronize with TUTORIAL.
+
 2012-02-03  Pieter Schoenmakers  <tiggr@tiggr.net>
 
         * tutorials/TUTORIAL.nl: Updated; synchronize with TUTORIAL.
diff --git a/etc/NEWS b/etc/NEWS
index 2cdfcf1dad4..5866a065252 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -47,6 +47,7 @@ found at build time.  To prevent this, use the configure option
 This happens by default if a suitably recent version of the library is
 found at build time.  To prevent this, use the configure option
 `--without-imagemagick'.  See below for ImageMagick features.
+This feature is not available for the Nextstep or MS ports.
 
 ---
 ** Emacs can be compiled with libxml2 support.
@@ -995,15 +996,27 @@ coordinate in the POSITION list now counts from the top of the text
 area, excluding any header line.  Previously, it counted from the top
 of the header line.
 
-** A backquote not followed by a space is now always treated as new-style.
+---
+** Support for "old-style" backquotes, which have been obsolete for
+more than 10 years, has been further reduced.  Now a backquote not
+followed by a space is always treated as a "new-style" backquote.
+Please consider completely removing all "old-style" backquotes from
+your code as a matter of some urgency.  If your code uses backquotes
+as documented in the Elisp manual, and compiles without warning, then
+you have nothing to do in this regard.  Code not following the
+appropriate conventions may fail to compile.  The most common cause of
+trouble seems to be an old-style backquote followed by a newline.
 
 ---
 ** view-buffer now treats special mode-class in the same way that
 view-file has since Emacs 22 (ie, it won't enable View mode if the
 major-mode is special).
 
-** Passing a nil argument to a minor mode function now turns the mode
-ON unconditionally.
+** Passing a nil argument to a minor mode defined by define-minor-mode
+now turns the mode ON unconditionally.  This is so that you can write, e.g.
+  (add-hook 'text-mode-hook 'foo-minor-mode)
+to enable foo-minor-mode in Text mode buffers, thus removing the need
+for `turn-on-foo-minor-mode' style functions.
 
 +++
 ** During startup, Emacs no longer adds entries for `menu-bar-lines'
@@ -1030,20 +1043,32 @@ Eg simply pass the result through substring-no-properties if you need this.
 ** The menu bar bindings's caches are not used any more.
 Use (where-is-internal <def> nil t) instead.
 
-** The following obsolete functions and aliases were removed:
-comint-kill-output, decompose-composite-char, outline-visible,
-internal-find-face, internal-get-face, frame-update-faces,
-frame-update-face-colors, x-frob-font-weight, x-frob-font-slant,
-x-make-font-bold, x-make-font-demibold, x-make-font-unbold
-x-make-font-italic, x-make-font-oblique, x-make-font-unitalic
-x-make-font-bold-italic, mldrag-drag-mode-line, mldrag-drag-vertical-line,
-iswitchb-default-keybindings, char-bytes, isearch-return-char,
-make-local-hook
-
 +++
-** The following obsolete variables and varaliases were removed:
-checkdoc-minor-keymap, vc-header-alist, directory-sep-char,
-font-lock-defaults-alist, and e (use float-e).
+** The following obsolete (mostly since at least 21.1) functions and aliases
+have been removed (the appropriate new function is given in parentheses):
+comint-kill-output (comint-delete-output),
+decompose-composite-char (char-to-string),
+outline-visible (outline-invisible-p),
+internal-find-face (facep), internal-get-face (facep and check-face),
+frame-update-faces (not needed),
+frame-update-face-colors (frame-set-background-mode),
+x-frob-font-weight and x-frob-font-slant (appropriate make-face-* function),
+x-make-font-bold and x-make-font-demibold (make-face-bold),
+x-make-font-italic and x-make-font-oblique (make-face-italic),
+x-make-font-bold-italic (make-face-bold-italic),
+x-make-font-unbold (make-face-unbold),
+x-make-font-unitalic (make-face-unitalic),
+mldrag-drag-mode-line (mouse-drag-mode-line),
+mldrag-drag-vertical-line (mouse-drag-vertical-line),
+iswitchb-default-keybindings (iswitchb-mode), char-bytes (== 1),
+isearch-return-char (isearch-printing-char), make-local-hook (not needed)
+
++++
+** The following obsolete (mostly since at least 21.1) variables and varaliases
+have been removed (the appropriate new variable is given in parentheses):
+checkdoc-minor-keymap (checkdoc-minor-mode-map),
+vc-header-alist (vc-BACKEND-header), directory-sep-char (== ?/)
+font-lock-defaults-alist (font-lock-defaults), and e (float-e).
 
 ---
 ** The following obsolete files were removed:
@@ -1236,15 +1261,21 @@ Instead, the offending function is removed.
 
 ** New hook types
 
++++
 *** New function `run-hook-wrapped' for running an abnormal hook by
 passing the hook functions as arguments to a "wrapping" function.
+Like `run-hook-with-args-until-success', it stops at the first
+non-nil return value.
+
 +++
 *** New macro `with-wrapper-hook' for running an abnormal hook as a
 set of "wrapping" filters, similar to around advice.
 (A version of this macro was actually added in Emacs 23.2 but was not
 advertised at the time.)
 
-** Macro `with-demoted-errors' was added in Emacs 23.1 but not advertised.
++++
+** The macros `condition-case-no-debug' and `with-demoted-errors' were
+added in Emacs 23.1, but not advertised.
 
 +++
 ** The new function `server-eval-at' allows evaluation of Lisp forms on
@@ -1329,6 +1360,7 @@ argument is supplied (see Trash changes, above).
 or RGB triplet, instead of signaling an error if the user provides
 invalid input.
 
++++
 ** Tool-bars can display separators.
 Tool-bar separators are handled like menu separators in menu-bar maps,
 i.e. via menu entries of the form `(menu-item "--")'.
@@ -1352,13 +1384,14 @@ is being animated.
 *** `image-extension-data' has been renamed to `image-metadata'.
 The old name is an obsolete alias to the new one.
 
++++
 *** Emacs can be compiled with ImageMagick support.
+This feature is not available for the Nextstep or MS ports.
 Then the function `imagemagick-types' returns a list of image file
 extensions that your installation of ImageMagick supports.  The
 function `imagemagick-register-types' enables ImageMagick support for
 these image types, minus those listed in `imagemagick-types-inhibit'.
-
-See the Emacs Lisp Reference Manual for more information.
+Visiting one of these file types will then use Image mode.
 
 ** XML and HTML parsing
 If Emacs is compiled with libxml2 support, there are two new functions:
@@ -1405,7 +1438,11 @@ as well as those in the -*- line.
 ---
 ** rx.el has a new `group-n' construct for explicitly numbered groups.
 
-** keymaps can inherit from multiple parents.
++++
+** New function `make-composed-keymap' that constructs a new keymap
+from multiple input maps.  You can use this to make a keymap that
+inherits from multiple maps, eg:
+ (set-keymap-parent newmap (make-composed-keymap othermap parent))
 
 +++
 ** Set `debug-on-event' to make Emacs enter the debugger e.g. on receipt
diff --git a/etc/tutorials/TUTORIAL.es b/etc/tutorials/TUTORIAL.es
index 2597f00e95f..fe8c223551a 100644
--- a/etc/tutorials/TUTORIAL.es
+++ b/etc/tutorials/TUTORIAL.es
@@ -14,8 +14,10 @@ ocasión, usaremos las siguientes abreviaturas.
          <car>.  Escribimos <ESC> para referirnos a la tecla ESC.
 
 Nota importante: para terminar la sesión de Emacs teclee C-x C-c (dos
-caracteres).  Los caracteres ">>" en el margen izquierdo indican
-instrucciones para que usted trate de usar un comando.  Por ejemplo:
+caracteres).  Para cancelar un comando parcialmente introducido,
+teclee C-g.
+Los caracteres ">>" en el margen izquierdo indican instrucciones para
+que usted trate de usar un comando.  Por ejemplo:
 <<Blank lines inserted around following line by help-with-tutorial>>
 [Mitad de página en blanco para propósitos didácticos.  El texto continúa abajo]
 >> Ahora teclee C-v (ver la próxima pantalla) para desplazarse a la
@@ -47,9 +49,12 @@ Los siguientes comandos son útiles para ver pantallas completas:
                  pantalla (Esto es CONTROL-L, no CONTROL-1.)
 
 >> Encuentre el cursor, y fíjese qué texto hay cerca de éste.
-   Luego teclee C-l.
-   Encuentre el cursor otra vez y note que el mismo texto está cerca
-   del cursor ahora.
+   Luego teclee C-l.  Encuentre el cursor otra vez y note que el mismo
+   texto está todavía cerca del cursor, pero ahora está en el centro
+   de la pantalla.
+   Si vuelve teclear C-l, ese texto se moverá al principio de la
+   pantalla.  Al teclear C-l otra vez, se moverá al final de la
+   pantalla.
 
 Si su terminal las soporta, también puede usar las teclas AvPág o
 RegPág para moverse por pantallas completas, pero puede editar más
@@ -89,9 +94,9 @@ comandos de posicionamiento básico del cursor todo el tiempo.
    lo que hace C-p cuando el cursor está en medio de la línea.
 
 Cada línea de texto termina con un carácter de nueva línea (Newline),
-que sirve para separarla de la línea siguiente.  La última línea de su
-archivo debe de tener un carácter de nueva línea al final (pero Emacs
-no requiere que ésta lo tenga).
+que sirve para separarla de la línea siguiente.  (Normalmente, la
+última línea de un archivo termina con un carácter de nueva línea,
+pero Emacs no requiere que sea así.)
 
 >> Intente usar C-b al comienzo de una línea.  Debería moverse al
    final de la línea previa.  Esto sucede porque retrocede a través
@@ -227,24 +232,17 @@ Esto debió haber desplazado la pantalla hacia arriba 8 líneas.  Si
 quisiera desplazarla hacia abajo de nuevo, puede dar un argumento a
 M-v.
 
-Si está usando un sistema de ventanas, como X11 o MS-Windows, debe
+Si está usando un entorno gráfico, como X o MS-Windows, debe
 haber una larga área rectangular llamada una barra de desplazamiento
 en el lado izquierdo de la ventana de Emacs.  Puede desplazar el texto
 al oprimir el botón del ratón en la barra de desplazamiento.
 
->> Pruebe presionando el botón del medio en la parte superior del área
-   resaltada en la barra de desplazamiento.  Éste debe desplazar el
-   texto a una posición determinada según cuan alto o bajo oprima el
-   botón.
-
->> Intente mover el ratón arriba y abajo, mientras mantiene el botón
-   del medio presionado.  Verá que el texto se desplaza arriba y abajo
-   a medida que mueve el ratón.
-
+Si su ratón tiene un botón de rueda, también puede utilizarlo para
+desplazar el texto.
 
 
-* CUANDO EMACS ESTÁ BLOQUEADO
------------------------------
+* SI EMACS DEJA DE RESPONDER
+----------------------------
 
 Si Emacs dejara de responder a sus comandos, puede detenerlo con
 seguridad al teclear C-g.  Puede usar C-g para detener un comando que
@@ -253,7 +251,7 @@ esté tomando mucho tiempo para ejecutarse.
 También puede usar C-g para descartar un argumento numérico o el
 comienzo de un comando que no quiere finalizar.
 
->> Escriba C-u 100 para hacer un argumento numérico de 100, entonces
+>> Escriba C-u 100 para hacer un argumento numérico de 100, y luego
    pruebe C-g.
    Ahora pruebe C-f.  Esto deberá mover sólo un carácter, ya que
    canceló el argumento con C-g.
@@ -282,7 +280,7 @@ desactivado, conteste la pregunta con "n".
 * VENTANAS
 ----------
 
-Emacs puede tener varias ventanas, cada una mostrando su propio texto.
+Emacs puede tener varias "ventanas", cada una mostrando su propio texto.
 Explicaremos después como usar múltiples ventanas.  Ahora mismo
 queremos explicar cómo deshacerse de ventanas adicionales y volver a
 la edición básica en una ventana.  Es sencillo:
@@ -294,9 +292,9 @@ contiene el cursor, para ocupar toda la pantalla.  Esto borra todas las
 demás ventanas.
 
 >> Mueva el cursor a esta línea y escriba C-u 0 C-l.
->> Escriba Control-h k Control-f.
+>> Escriba C-h k C-f.
    Vea como esta ventana se encoge, mientras una nueva aparece y
-   muestra documentación sobre el comando Control-f.
+   muestra documentación sobre el comando C-f.
 
 >> Escriba C-x 1 y vea que la ventana de listado de documentación
    desaparece.
@@ -312,41 +310,36 @@ cuatro caracteres.
 * INSERTAR Y BORRAR
 -------------------
 
-Si quiere insertar un texto, basta con que lo teclee.  Emacs
-interpreta los caracteres que usted puede ver, tales como A, 7, *,
-etc. como texto y los inserta inmediatamente.  Teclee <Return> (la
-tecla Enter) para insertar un carácter de nueva línea.
-
-Puede borrar el último carácter que escribió oprimiendo <Delback>.
-<Delback> es una tecla en el teclado--la misma que normalmente usa
-fuera de emacs para borrar el último carácter que escribió.
-Normalmente es una tecla una o dos filas arriba de la tecla <Return>,
-y que está usualmente rotulada como "Backspace", "Del" o simplemente
-con una flecha en dirección izquierda que no es parte de las teclas de
-flecha.
+Si quiere insertar un texto, basta con que lo teclee.  Los caracteres
+normales, como A, 7, *, etc. se insertan nada más teclearlos.  Teclee
+<Return> (la tecla "Enter" o "Intro") para insertar un carácter de
+nueva línea.
 
-Si la tecla larga está rotulada "Backspace", entonces ésa es la que
-debe de usar para <Delback>.  Puede haber otra tecla llamada "Del" en
-otra parte, pero ésa no es <Delback>.
+Para borrar el carácter que precede al cursor, oprima <DEL>. Es una
+tecla alargada, normalmente etiquetada como "Backspace" o "Del", o con
+una flecha apuntando a la izquierda; la misma que suele utilizar fuera
+de Emacs para borrar el último carácter introducido.
 
-Generalmente, <Delback> borra el carácter inmediatamente anterior a la
-posición actual del cursor.
+Puede haber otra tecla llamada "Del" o "Supr" en otra parte, pero ésa
+no es <DEL>.
 
 >> Haga esto ahora: teclee unos pocos caracteres, después bórrelos
-   tecleando <Delback> varias veces.  No se preocupe si este archivo
+   tecleando <DEL> varias veces.  No se preocupe si este archivo
    cambia, no alterará el tutorial principal.  Ésta es su copia
    personal de él.
 
-Cuando una línea de texto se hace muy grande para una sola línea en la
+Cuando una línea de texto se hace muy grande para una sola línea de la
 pantalla, la línea de texto "continúa" en una segunda línea en la
-pantalla.  Un backslash ("\") (o, si está usando un sistema de
-ventanas, una pequeña flecha curva) en el margen derecho indica que la
-línea "continúa".
+pantalla. Si está usando un entorno gráfico, se mostrarán pequeñas
+flechas curvas en las estrechas franjas vacías (los "márgenes" derecho
+e izquierdo) a cada lado del área de texto, para indicar que la línea
+continúa. Si está utilizando una terminal, la continuación se señala
+mediante una barra invertida ("\") en la última columna de la derecha.
 
 >> Inserte texto hasta que llegue al margen derecho, y siga
    insertando.  Verá aparecer una línea de continuación.
 
->> Use <Delback> para borrar el texto hasta que la línea de nuevo
+>> Use <DEL> para borrar el texto hasta que la línea de nuevo
    quepa en la pantalla.  La línea de continuación se pierde.
 
 Puede borrar un carácter de nueva línea como cualquier otro carácter.
@@ -355,7 +348,7 @@ sola línea.  Si el resultado de la combinación de líneas es demasiado
 largo para caber en el ancho de la pantalla, se mostrará con una línea
 de continuación.
 
->> Mueva el cursor al comienzo de una línea y teclee <Delback>.  Esto
+>> Mueva el cursor al comienzo de una línea y teclee <DEL>.  Esto
    juntará esa línea con la línea anterior.
 
 >> Teclee <Return> para reinsertar la nueva línea que borró.
@@ -370,27 +363,29 @@ Ya ha aprendido la manera más básica de teclear algo en Emacs y
 corregir errores.  Puede borrar por palabras o por líneas.  He aquí un
 resumen de las operaciones de borrado:
 
-        <Delback>       borra el carácter justo antes que el cursor
+        <DEL>           borra el carácter justo antes que el cursor
         C-d             borra el siguiente carácter después del cursor
 
-        M-<Delback>     Elimina la palabra inmediatamente antes del
+        M-<DEL>         Elimina la palabra inmediatamente antes del
                          cursor
         M-d             Elimina la siguiente palabra después del cursor
 
         C-k             Elimina desde el cursor hasta el fin de la línea
         M-k             Elimina hasta el final de la oración actual
 
-Note que <Delback> y C-d, comparados con M-<Delback> y M-d, extienden
-el paralelismo iniciado por C-f y M-f (bien, <Delback> no es realmente
-una tecla de control, pero no nos preocuparemos de eso ahora).  C-k y
-M-k, en ciertas forma, son como C-e y M-e, en que las líneas son
-oraciones opuestas.
+Note que <DEL> y C-d, comparados con M-<DEL> y M-d, extienden el
+paralelismo iniciado por C-f y M-f (bien, <DEL> no es realmente una
+tecla de control, pero no nos preocuparemos de eso ahora).  C-k y M-k,
+en ciertas forma, son como C-e y M-e, en que las líneas de unos
+corresponden a sentencias en los otros.
 
-También puede eliminar cualquier parte del buffer con un método
-uniforme.  Muévase a un extremo de esa parte, y teclee C-@ o C-SPC
-(cualquiera de los dos).  (SPC es la barra espaciadora.)  Muévase al
-otro extremo de esa parte, y teclee C-w.  Eso elimina todo el texto
-entre las dos posiciones.
+También puede eliminar un segmento contiguo de texto con un método
+uniforme.  Muévase a un extremo de ese segmento de texto, y teclee C-@
+o C-SPC (cualquiera de los dos).  (SPC es la barra espaciadora.)
+Luego, mueva el cursor al otro extremo del texto que desea eliminar.
+Al hacerlo, Emacs resaltará el texto situado entre el cursor y la
+posición en la que tecleó C-SPC.  Finalmente, teclee C-w.  Eso elimina
+todo el texto entre las dos posiciones.
 
 >> Mueva el cursor a la letra T del inicio del párrafo anterior.
 >> Teclee C-SPC.  Emacs debe mostrar el mensaje "Mark set" en la parte
@@ -401,12 +396,15 @@ entre las dos posiciones.
    termina justo antes de la x.
 
 La diferencia entre "eliminar" y "borrar" es que el texto "eliminado"
-puede ser reinsertado, mientras que las cosas "borradas" no pueden ser
-reinsertadas.  La reinserción de texto eliminado se llama "yanking" o
-"pegar".  Generalmente, los comandos que pueden quitar mucho texto lo
-eliminan, mientras que los comandos que quitan solo un carácter, o
-solo líneas en blanco y espacios, borran (para que no pueda pegar ese
-texto).
+puede ser reinsertado (en cualquier posición), mientras que las cosas
+"borradas" no pueden ser reinsertadas (sin embargo, es posible
+deshacer el borrado; ver más abajo).  La reinserción de texto
+eliminado se llama "yanking" o "pegar".  Generalmente, los comandos
+que pueden quitar mucho texto lo eliminan (para que pueda pegarlo de
+nuevo) mientras que los comandos que quitan solo un carácter, o solo
+líneas en blanco y espacios, borran (y por tanto no se puede pegar lo
+borrado).  Si se normalmente, sin pasar un argumento, <DEL> y C-d
+borran.  Con un argumento, eliminan.
 
 >> Mueva el cursor al comienzo de una línea que no esté vacía.
    Luego teclee C-k para eliminar el texto de esa línea.
@@ -420,12 +418,13 @@ especialmente: Elimina ese número de líneas y TAMBIÉN sus
 contenidos.  Esto no es una simple repetición.  C-u 2 C-k elimina dos
 líneas y sus nuevas líneas, tecleando C-k dos veces no hace esto.
 
-Traer texto eliminado de regreso es llamado "yanking" o "pegar".
-(Piense en ello como pegar de nuevo, o traer de vuelta, algún texto
-que le fue quitado.)  Puede pegar el texto eliminado en, ya sea el
-lugar en que fue eliminado, o en otra parte del buffer, o hasta en un
-archivo diferente.  Puede pegar el texto varias veces, lo que hace
-varias copias de él.
+Reinsertar texto eliminado se denomina "yanking" o "pegar".  (Piense
+en ello como pegar de nuevo, o traer de vuelta, algún texto que le fue
+quitado.)  Puede pegar el texto eliminado, ya sea el lugar en que fue
+eliminado, o en otra parte del buffer, o hasta en un archivo
+diferente.  Puede pegar el texto varias veces, lo que hace varias
+copias de él.  Algunos editores se refieren a eliminar y reinsertar
+como "cortar" y "pegar" (consulte el Glosario en el manual de Emacs).
 
 El comando para pegar es C-y.  Reinserta el último texto eliminado, en
 la posición actual del cursor.
@@ -468,32 +467,31 @@ eliminación más reciente).
 ----------
 
 Si hace un cambio al texto, y luego decide que fue un error,
-puede deshacer el cambio con el comando deshacer, C-x u.
+puede deshacer el cambio con el comando deshacer, C-/.
 
-Normalmente, C-x u deshace los cambios hechos por un comando; si repite
-varias veces seguidas C-x u, cada repetición deshará un comando
+Normalmente, C-/ deshace los cambios hechos por un comando; si repite
+varias veces seguidas C-/, cada repetición deshará un comando
 adicional.
 
 Pero hay dos excepciones: los comandos que no cambian el texto no
-cuentan (esto incluye los comandos de movimiento del cursor y el
-comando de desplazamiento), y los caracteres de autoinserción se
-manejan usualmente en grupos de hasta 20.  (Esto es para reducir el
-numero de C-x u que tenga que teclear para deshacer una inserción en
+cuentan (esto incluye los comandos de movimiento del cursor y de
+desplazamiento), y los caracteres de autoinserción se manejan
+usualmente en grupos de hasta 20 caracteres.  (Esto es para reducir el
+numero de C-/ que tenga que teclear para deshacer una inserción en
 el texto.)
 
->> Elimine esta línea con C-k, después teclee C-x u y debería
+>> Elimine esta línea con C-k, después teclee C-/ y debería
    reaparecer.
 
-C-_ es un comando alternativo para deshacer; funciona igual que C-x u,
-pero es más fácil de teclear varias veces seguidas.  La desventaja de
-C-_ es que en algunos teclados no es obvio cómo se teclea.  Por esto
-existe también C-x u.  En algunas terminales, puede teclear C-_ al
-teclear / mientras oprime CONTROL.
+C-_ es un comando alternativo para deshacer; funciona igual que C-/.
+En algunas terminales, al teclear C-/ en realidad envía C-_ a Emacs.
+También existe la alternativa de usar C-x u, que funciona exactamente
+igual que C-/, pero es menos cómodo de teclear.
 
-Un argumento numérico para C-_ o C-x u actúa como un factor de
+Un argumento numérico para C-/, C-_ o C-x u actúa como un factor de
 repetición.
 
-Uuede deshacer un texto borrado justo como puede deshacer el texto
+Puede deshacer un texto borrado justo como puede deshacer el texto
 eliminado.  La distinción entre eliminar algo y borrar algo afecta en
 si puede pegarlo con C-y; no hay diferencia alguna para deshacer.
 
@@ -516,17 +514,17 @@ cuando guarde, Emacs dejará el archivo original bajo un nombre
 cambiado en caso de que luego decida que sus cambios fueron un error.
 
 Si mira cerca del final de la pantalla podrá ver una línea que
-comienza y termina con guiones, y comienza con "--:-- TUTORIAL.es" o
-algo así.  Esta parte de la pantalla normalmente muestra el nombre del
-archivo que está visitando.  En este momento está visitando un archivo
-llamado "TUTORIAL.es" que es su borrador personal del tutorial de
-Emacs.  Cuando encuentre un archivo con Emacs, el nombre de ese
-archivo aparecerá en ese mismo punto.
+comienza con guiones, y empieza con " -:--- TUTORIAL.es" o algo así.
+Esta parte de la pantalla normalmente muestra el nombre del archivo
+que está visitando.  En este momento está visitando su propia copia
+del tutorial de Emacs, que se llama "TUTORIAL.es".  Cuando encuentre
+un archivo con Emacs, el nombre de ese archivo aparecerá en ese mismo
+punto.
 
 Una cosa especial acerca del comando para encontrar un archivo, es que
 tendrá que decir que nombre de archivo desea.  Decimos que el comando
-"lee un argumento desde la terminal" (en este caso, el argumento es el
-nombre del archivo).  Después de teclear el comando:
+"lee un argumento" (en este caso, el argumento es el nombre del
+archivo).  Después de teclear el comando:
 
         C-x C-f   Encontrar un archivo
 
@@ -544,13 +542,12 @@ entrada al minibuffer) puede cancelar el comando con C-g.
    Así que no encontrará archivo alguno.
 
 Cuando haya finalizado de ingresar el nombre del archivo, teclee
-<Return> para terminarlo.  Entonces el comando C-x C-f trabaja, y
-encuentra el archivo que escogió.  El minibuffer desaparece cuando el
-comando C-x C-f termina.
+<Return> para terminarlo.  El minibuffer desaparece, y el comando C-x
+C-f trabaja para encontrar el archivo que escogió.
 
-Poco tiempo después aparecerá el contenido del archivo en la pantalla,
-y puede editarlo.  Cuando quiera que sus cambios sean permanentes,
-teclee el comando
+En seguida aparecerá el contenido del archivo en la pantalla, y puede
+editarlo.  Cuando quiera que sus cambios sean permanentes, teclee el
+comando
 
         C-x C-s   Guardar el archivo
 
@@ -561,11 +558,12 @@ final del nombre del archivo original.
 
 Cuando guardar haya terminado, Emacs mostrará el nombre del archivo
 escrito.  Deberá guardar frecuentemente, para que no pierda mucho
-trabajo si el sistema falla.
+trabajo si el sistema falla (vea la sección "AUTO GUARDADO", más
+adelante).
 
->> Teclee C-x C-s, guardando la copia del tutorial.
-   Esto debería mostrar "Wrote ...TUTORIAL.es" al final de la
-   pantalla.
+>> Teclee C-x C-s TUTORIAL.es <Return>
+   Esto guardará el tutorial en un archivo llamado TUTORIAL.es, y
+   mostrará "Wrote ...TUTORIAL.es" al final de la pantalla.
 
 Puede encontrar un archivo existente, para verlo o editarlo.  También
 puede hacerlo con un archivo que no exista.  Ésta es la forma de crear
@@ -584,16 +582,10 @@ dentro de Emacs.  Puede volver a el encontrándolo de nuevo con C-x
 C-f.  De esta forma puede mantener un gran número de archivos dentro
 de Emacs.
 
->> Cree un archivo llamado "foo" tecleando C-x C-f foo <Return>.
-   Luego inserte algún texto, edítelo, y guarde "foo" tecleando C-x
-   C-s.
-   Finalmente teclee C-x C-f TUTORIAL.es <Return>
-   para regresar al tutorial.
-
 Emacs almacena cada texto del archivo dentro de un objeto llamado
 "buffer".  Al encontrar un archivo se crea un nuevo buffer dentro de
-Emacs.  Para mirar la lista de los buffers que existen actualmente en
-su sesión de Emacs, teclee:
+Emacs.  Para mirar la lista de los buffers que existen actualmente,
+teclee:
 
         C-x C-b   Lista de buffers
 
@@ -612,22 +604,24 @@ que corresponde a un archivo, puede hacerlo visitando el archivo de
 nuevo con C-x C-f.  Pero existe una manera más rápida: use el comando
 C-x b.  En ese comando, necesita teclear el nombre de buffer.
 
->> Teclee C-x b foo <Return> para volver al buffer "foo" que contiene
-   el texto del archivo "foo".  Después teclee C-x b TUTORIAL.es
-   <Return> para regresar a este tutorial.
+>> Cree un archivo llamado "foo" tecleando C-x C-f foo <Return>.
+   Después teclee C-x b TUTORIAL.es <Return> para regresar a este
+   tutorial.
 
 La mayoría del tiempo el nombre del buffer es el mismo que el nombre
 del archivo (sin la parte del directorio del archivo).  Sin embargo,
 esto no es así siempre.  La lista de buffers que hace con C-x C-b
-siempre muestra el nombre de todos los buffers.
+muestra el nombre de cada buffer y de su archivo correspondiente.
 
-CUALQUIER texto que vea en una ventana de Emacs siempre es parte de un
-buffer.  Algunos buffers no corresponden a un archivo.  Por ejemplo,
-el buffer llamado "*Buffer List*" no tiene ningún archivo.  Es el
-buffer que contiene la lista de buffers que ha creado con C-x C-b.  El
-buffer llamado "*Messages*" tampoco tiene un archivo correspondiente;
-contiene los mensajes que han aparecido en la línea de abajo durante
-su sesión de Emacs.
+Algunos buffers no corresponden a un archivo.  El buffer llamado
+"*Buffer List*", que contiene la lista de buffers que ha creado con
+C-x C-b, no tiene archivo.  Este buffer TUTORIAL.es al principio no
+tenía archivo, pero ahora ya sí, porque en la sección anterior tecleó
+C-x C-s y lo guardó en un archivo.
+
+El buffer llamado "*Messages*" tampoco tiene un archivo
+correspondiente.  Este buffer contiene los mensajes que han aparecido
+en la línea de abajo durante su sesión de Emacs.
 
 >> Teclee C-x b *Messages* <Return> para ver el buffer de mensajes.
    Luego teclee C-x b TUTORIAL <Return> para regresar a este tutorial.
@@ -669,45 +663,45 @@ comando C-x C-c.  (No se preocupe por perder los cambios que haya
 hecho; C-x C-c ofrece guardar cada archivo alterado antes de finalizar
 Emacs.)
 
-C-z es el comando para salir de Emacs *temporalmente*: para que pueda
-regresar a la misma sesión de Emacs después.
+Si está utilizando una pantalla gráfica, no necesita ningún comando
+especial para cambiar de Emacs a otra aplicación.  Puede hacerlo con
+el ratón, o mediante el gestor de ventanas.  Sin embargo, si está
+usando una terminal que solo puede mostrar una aplicación a la vez,
+tendrá que "suspender" Emacs para poder acceder a otros programas.
 
-En sistemas que lo permiten C-z "suspende" Emacs; esto es, se regresa
-al intérprete de comandos pero no se destruye Emacs.  En los
+C-z es el comando para salir de Emacs *temporalmente*: para que pueda
+regresar a la misma sesión de Emacs después.  Cuando Emacs está
+ejecutándose en una terminal, C-z "suspende" Emacs; esto es, se
+regresa al intérprete de comandos pero no se destruye Emacs.  En los
 intérpretes de comandos más comunes, puede reanudar Emacs con el
 comando `fg' o con `%emacs'.
 
-En sistemas que no implementen el suspendido, C-z crea un
-subintérprete que corre bajo Emacs para darle la opción de correr
-otros programas y regresar a Emacs después; esto en realidad no "sale"
-de Emacs.  En este caso, el comando `exit' del intérprete es la vía
-usual para regresar a Emacs desde éste.
-
 El momento para usar C-x C-c es cuando está listo para salir del
 sistema.  Es además el paso correcto para salir de un Emacs llamado
-bajo programas de manejo de correo y diversas otras utilidades, puesto
-que ellos no saben cómo lidiar con la suspensión de Emacs.  En
-circunstancias normales, si no va a salir, es mejor suspender
-Emacs con C-z en lugar de salir de él.
+bajo programas de gestión de correo y otras utilidades diversas.
 
-Existen varios comandos C-x.  Aquí hay una lista de los que ha
+Existen muchos comandos C-x.  He aquí la lista de los que ya ha
 aprendido:
 
-        C-x C-f         Encontrar archivo.
-        C-x C-s         Guardar archivo.
-        C-x C-b         Lista de buffers.
-        C-x C-c         Salir de Emacs.
-        C-x 1           Borrar todo menos una ventana.
-        C-x u           Deshacer.
+        C-x C-f         Encontrar archivo
+        C-x C-s         Guardar archivo
+        C-x s           Guardar varios buffers
+        C-x C-b         Lista de buffers
+        C-x b           Cambiar a otro buffer
+        C-x C-c         Salir de Emacs
+        C-x 1           Borrar todo menos una ventana
+        C-x u           Deshacer
 
 Los comandos eXtendidos por nombre son comandos que se utilizan aún
 con menos frecuencia, o únicamente en ciertos modos.  Un ejemplo es el
-comando replace-string, el cual globalmente substituye una cadena de
-caracteres por otra.  Cuando teclea M-x, Emacs le pregunta al
-final de la pantalla con M-x y debe escribir el nombre del
-comando; en este caso "replace-string".  Solo teclee "repl s<TAB>" y
-Emacs completará el nombre.  Finalice el nombre del comando con
-<Return>.
+comando replace-string, el cual substituye globalmente una cadena de
+caracteres por otra.  Cuando teclea M-x, Emacs le pregunta al final de
+la pantalla con M-x y debe escribir el nombre del comando; en este
+caso "replace-string".  Solo teclee "repl s<TAB>" y Emacs completará
+el nombre.  (<TAB> es la tecla del tabulador, que habitualmenté está
+situada sobre la tecla de bloquear mayúsculas o la de shift, en el
+lado izquierdo del teclado.)  Para aceptar el comando y ejecutarlo,
+pulse <Return>.
 
 El comando replace-string requiere dos argumentos: la cadena de
 caracteres a reemplazar, y la cadena de caracteres para reemplazarla.
@@ -733,11 +727,11 @@ un # al principio y al final; por ejemplo, si su archivo se llama
 "hola.c", su archivo auto guardado es "#hola.c#".  Cuando guarda por
 la vía normal, Emacs borra su archivo de auto guardado.
 
-Si la computadora falla, puede recuperar su edición de auto
-guardado encontrando el archivo normal (el archivo que estuvo
-editando, no el archivo de auto guardar) y entonces tecleando M-x
-recover file<Return>.  Cuando le pregunte por la confirmación, teclee
-yes<Return> para ir y recuperar la información del auto guardado.
+Si la computadora falla, puede recuperar su edición de auto guardado
+encontrando el archivo normal (el archivo que estuvo editando, no el
+archivo de auto guardar) y entonces tecleando M-x recover-file
+<Return>.  Cuando le pregunte por la confirmación, teclee yes<Return>
+para seguir adelante y recuperar la información de auto guardado.
 
 
 * ÁREA DE ECO
@@ -754,20 +748,20 @@ lentamente, se los muestra al final de la pantalla en un área llamada
 La línea inmediatamente encima del área de eco recibe el nombre de
 "línea de modo" o "mode line".  La línea de modo dice algo así:
 
---:** TUTORIAL.es         (Fundamental)--l765--65%---------
+ -:**-  TUTORIAL.es       63% L749    (Fundamental)
 
 Esta línea da información útil acerca del estado de Emacs y del texto
 que está editando.
 
 Ya sabe qué significa el nombre del archivo: es el archivo que usted
-ha encontrado.  -NN%-- indica su posición actual en el texto; esto
+ha encontrado.  NN% indica su posición actual en el texto; esto
 significa que NN por ciento del texto está encima de la parte superior
 de la pantalla.  Si el principio del archivo está en la pantalla, éste
-dirá --Top-- en vez de --00%--.  Si el final del texto está en la
-pantalla, dirá --Bot--.  Si está mirando un texto tan pequeño que cabe
-en la pantalla, el modo de línea dirá --All--.
+dirá "Top" en vez de " 0%".  Si el final del texto está en la
+pantalla, dirá "Bot".  Si está mirando un texto tan pequeño que cabe
+entero en la pantalla, el modo de línea dirá "All".
 
-La L y los dígitos indican la posición de otra forma: ellos dan el
+La L y los dígitos señalan la posición de otra forma: indican el
 número de línea actual del punto.
 
 Los asteriscos cerca del frente significan que usted ha hecho cambios
@@ -795,7 +789,8 @@ fundamental-mode es un comando para cambiar al modo fundamental.
 
 Si va a editar un texto de algún lenguaje humano, como este archivo,
 debería usar el modo de texto.
->> Teclee M-x text mode<Return>.
+
+>> Teclee M-x text-mode <Return>.
 
 No se preocupe, ninguno de los comandos de Emacs que ha aprendido
 cambia de manera significativa.  Pero puede observar que M-f y M-b
@@ -805,20 +800,20 @@ de palabras.
 
 Los modos mayores normalmente hacen cambios sutiles como el anterior:
 la mayoría de comandos hacen "el mismo trabajo" en cada modo mayor,
-pero funcionan un poco diferente.
+pero funcionan de forma un poco diferente.
 
-Para ver documentación en el modo mayor actual, teclee C-h m.
+Para ver la documentación del modo mayor actual, teclee C-h m.
 
->> Use C-u C-v una o más veces para traer esta línea cerca de la
-   parte superior de la pantalla.
+>> Use C-l C-l para traer esta línea en la parte superior de la
+   pantalla.
 
 >> Teclee C-h m, para ver como el modo de Texto difiere del modo
    Fundamental.
 
 >> Teclee C-x 1 para eliminar la documentación de la pantalla.
 
-Los modos mayores son llamados así porque también hay modos menores.
-Los modos menores no son alternativas para los modos mayores, solo
+Los modos mayores se llaman así porque también hay modos menores.  Los
+modos menores no son alternativas para los modos mayores, solo
 modificaciones menores de éstos.  Cada modo menor puede ser activado o
 desactivado por sí mismo, independiente de todos los otros modos
 menores, e independiente de su modo mayor.  Por tanto, puede no usar
@@ -830,13 +825,13 @@ español, es el modo Auto Fill.  Cuando este modo está activado, Emacs
 rompe la línea entre palabras automáticamente siempre que inserte
 texto y la línea sea demasiado ancha.
 
-Puede activar el modo Auto Fill al hacer M-x auto fill mode<Return>.
+Puede activar el modo Auto Fill al hacer M-x auto-fill-mode <Return>.
 Cuando el modo esté activado, puede desactivarlo nuevamente usando M-x
-auto fill mode<Return>.  Si el modo está desactivado, este comando lo
+auto-fill-mode <Return>.  Si el modo está desactivado, este comando lo
 activa, y si el modo está activado, este comando lo desactiva.
 Decimos que el comando "cambia el modo".
 
->> teclee M-x auto fill mode<Return> ahora.  Luego inserte una línea
+>> teclee M-x auto-fill-mode <Return> ahora.  Luego inserte una línea
    de "asdf " repetidas veces hasta que la vea dividida en dos líneas.
    Debe intercalar espacios porque Auto Fill sólo rompe líneas en los
    espacios.
@@ -861,15 +856,13 @@ ese párrafo.
 * BUSCAR
 --------
 
-Emacs puede hacer búsquedas de cadenas (grupos de caracteres o
-palabras contiguos) hacia adelante a través del texto o hacia atrás en
-el mismo.  La búsqueda de una cadena es un comando de movimiento de
+Emacs puede hacer búsquedas de cadenas (una "cadena" es un grupo de
+caracteres contiguos) hacia adelante a través del texto o hacia atrás
+en el mismo.  La búsqueda de una cadena es un comando de movimiento de
 cursor; mueve el cursor al próximo lugar donde esa cadena aparece.
 
-El comando de búsqueda de Emacs es diferente a los comandos de
-búsqueda de los demás editores, en que es "incremental".  Esto
-significa que la búsqueda ocurre mientras teclea la cadena para
-buscarla.
+El comando de búsqueda de Emacs es "incremental".  Esto significa que
+la búsqueda ocurre mientras teclea la cadena para buscarla.
 
 El comando para iniciar una búsqueda es C-s para búsqueda hacia
 adelante, y C-r para la búsqueda hacia atrás.  ¡PERO ESPERE!  No los
@@ -886,7 +879,7 @@ quiere buscar.  <Return> termina una búsqueda.
    Ahora ha buscado "cursor", una vez.
 >> Teclee C-s de nuevo, para buscar la siguiente ocurrencia de
    "cursor".
->> Ahora teclee <Delback> cuatro veces y vea como se mueve el cursor.
+>> Ahora teclee <DEL> cuatro veces y vea como se mueve el cursor.
 >> Teclee <Return> para terminar la búsqueda.
 
 ¿Vió lo que ocurrió?  Emacs, en una búsqueda incremental, trata de ir
@@ -895,27 +888,22 @@ ir a la próxima ocurrencia de 'cursor' solo teclee C-s de nuevo.  Si
 tal ocurrencia no existe, Emacs pita y le dice que la búsqueda actual
 está fallando ("failing").  C-g también termina la búsqueda.
 
-NOTA: En algunos sistemas, teclear C-s dejará inmóvil la pantalla y no
-podrá ver más respuesta de Emacs.  Esto indica que una
-"característica" del sistema operativo llamada "control de flujo" está
-interceptando el C-s y no permitiéndole llegar hasta Emacs.  Para
-descongelar la pantalla, teclee C-q.  Luego consulte la sección
-"Entrada Espontánea para Búsqueda Incremental" en el manual de Emacs
-para consejos de cómo tratar con esta "característica".
-
-Si se encuentra en medio de una búsqueda incremental y teclea
-<Delback>, notará que el último carácter de la cadena buscada se borra
-y la búsqueda vuelve al sitio anterior de la búsqueda.  Por ejemplo,
-suponga que ha tecleado "c", para buscar la primera ocurrencia de "c".
-Ahora, si teclea "u", el cursor se moverá a la primera ocurrencia de
-"cu".  Ahora teclee <Delback>.  Esto borra la "u" de la cadena
-buscada, y el cursor vuelve a la primera ocurrencia de "c".
+Si se encuentra en medio de una búsqueda incremental y teclea <DEL>,
+la búsqueda "vuelve" a un punto anterior.  Si teclea <DEL> justo
+después de teclear C-s para avanzar hasta la siguiente ocurrencia de
+la cadena buscada, el cursor retrocede a una ocurrencia previa.  Si no
+hay ocurrencias previas, <DEL> borra el último carácter de la cadena
+buscada.  Por ejemplo, suponga que ha tecleado "c", para buscar la
+primera ocurrencia de "c".  Ahora, si teclea "u", el cursor se moverá
+a la primera ocurrencia de "cu".  Ahora teclee <DEL>.  Esto borra la
+"u" de la cadena buscada, y el cursor vuelve a la primera ocurrencia
+de "c".
 
 Si está en medio de una búsqueda y teclea un carácter control o meta
 (con algunas pocas excepciones: los caracteres que son especiales en
 una búsqueda, tales como C-s y C-r), la búsqueda termina.
 
-El C-s inicia una exploración que busca alguna ocurrencia de la cadena
+C-s inicia una exploración que busca alguna ocurrencia de la cadena
 buscada DESPUÉS de la posición actual del cursor.  Si quiere buscar
 algo anterior en el texto, teclee en cambio C-r.  Todo lo que hemos
 dicho sobre C-s también se aplica a C-r, excepto que la dirección de
@@ -926,14 +914,16 @@ la búsqueda se invierte.
 --------------------
 
 Una de las características agradables de Emacs es que se puede mostrar
-más de una ventana en la pantalla al mismo tiempo.
+más de una ventana en la pantalla al mismo tiempo.  (Note que Emacs
+usa el término "marcos", descrito en la siguiente sección, para
+referirse a lo que otras aplicaciones llaman "ventanas".  El manual de
+Emacs contiene un Glosario de términos.)
 
->> Mueva el cursor a esta línea y teclee C-u 0 C-l (eso es CONTROL-L,
-   no CONTROL-1).
+>> Mueva el cursor a esta línea y teclee C-l C-l.
 
->> Ahora teclee C-x 2 que divide la pantalla en dos ventanas.  Ambas
-   ventanas muestran este tutorial.  El cursor permanece en la ventana
-   superior.
+>> Ahora teclee C-x 2 que divide la pantalla en dos ventanas.
+   Ambas ventanas muestran este tutorial.  El cursor de edición
+   permanece en la ventana superior.
 
 >> Teclee C-M-v para desplazar la ventana inferior.
    (Si no tiene una tecla META real, teclee ESC C-v.)
@@ -947,24 +937,25 @@ más de una ventana en la pantalla al mismo tiempo.
    superior.
    El cursor en la ventana superior está justo donde estaba antes.
 
-Puede continuar usando C-x o para cambiar entre las ventanas.  Cada
-ventana tiene su propia posición del cursor, pero únicamente una
-ventana actual muestra el cursor.  Todos los comandos de edición
-comunes se aplican a la ventana en que está el cursor.  Llamaremos
-esto la "ventana seleccionada".
+Puede continuar usando C-x o para cambiar entre las ventanas.  La
+"ventana seleccionada", donde tiene lugar casi toda la edición, es la
+que tiene un cursor muy visible que parpadea cuando usted no está
+tecleando.  Las otras ventanas tienen sus propia posición del cursor;
+si está ejecutando Emacs en una pantalla gráfica, esos cursores se
+muestran como rectángulos vacíos que no parpadean.
 
 El comando C-M-v es muy útil cuando está editando un texto en una
-ventana y usando la otra ventana como referencia.  Puede mantener el
-cursor siempre en la ventana donde está editando, y avanzar a la otra
-ventana secuencialmente con C-M-v.
+ventana y usando la otra ventana como referencia.  Sin moverse de la
+ventana seleccionada, puede desplazar el texto de la otra ventana con
+C-M-v.
 
 C-M-v es un ejemplo de un carácter CONTROL-META.  Si tiene una tecla
-META real, puede teclear C-M-v pulsando a la vez CONTROL y META
+META (o Alt), puede teclear C-M-v pulsando a la vez CONTROL y META
 mientras teclea v.  No importa qué tecla "vaya primero", CONTROL o
 META, porque las dos teclas actúan modificando los caracteres que
 teclea.
 
-Si no tiene una tecla META real, y en vez de eso usa ESC, el orden sí
+Si no tiene una tecla META, y en vez de eso usa ESC, el orden sí
 importa: debe teclear ESC seguido de Control-v, porque Control-ESC v
 no funcionará.  Esto es porque ESC es un carácter que tiene valor por
 sí mismo, no es una tecla modificadora.
@@ -992,6 +983,32 @@ diferentes:
    borrar la ventana inferior.
 
 
+* MÚLTIPLES MARCOS
+------------------
+
+Emacs puede crear también múltiples "marcos".  Marco es como
+denominamos a un grupo de ventanas, junto con sus menus, barras de
+desplazamiento, áreas de eco, etc.  En entornos gráficos, lo que Emacs
+denomina "marco" es lo que otras aplicaciones llaman "ventana".  En
+entornos gráficos, es posible mostrar varios marcos al mismo tiempo.
+En una terminal, solo se puede mostrar un marco a la vez.
+
+>> Teclee M-x make-frame <Return>.
+   En la pantalla aparecerá un nuevo marco.
+
+En el nuevo marco puede hacer todo lo que hacía en el marco original.
+El primer marco no tiene nada de especial.
+
+>> Teclee M-x delete-frame <Return>.
+   Esto destruye el marco seleccionado.
+
+También puede destruir un marco mediante el método normal que ofrezca
+el entorno gráfico (a menudo, pinchando con el ratón en un botón
+etiquetado como "X" en alguna de las esquinas superiores del marco).
+Si al hacer eso destruye el último marco de Emacs, la aplicación
+termina.
+
+
 * NIVELES RECURSIVOS DE EDICIÓN
 --------------------------------
 
@@ -1024,32 +1041,27 @@ Emacs.  Todos estos comandos de "ayuda" comienzan con el carácter
 Control-h, que es llamado "el carácter de Ayuda (Help)".
 
 Para usar las funciones de ayuda, teclee el carácter C-h, y luego un
-carácter decidiendo qué tipo de ayuda quiere.  Si está REALMENTE
+carácter que especifica qué tipo de ayuda quiere.  Si está REALMENTE
 perdido teclee C-h ? y Emacs le dirá qué tipo de ayuda puede
 ofrecerle.  Si ha tecleado C-h y decide que no quiere ninguna ayuda,
 teclee C-g para cancelarlo.
 
-(En algunas instalaciones cambian el significado del carácter C-h.
-Realmente no deberían hacer esto como una política para todos los
-usuarios, así que tiene argumentos para quejarse al administrador del
-sistema.  Mientras tanto, si C-h no muestra un mensaje de ayuda en el
-final de la pantalla, intente teclear la tecla F1 o, en su lugar, M-x
-help <Return>).
+(Si C-h no muestra un mensaje de ayuda en el final de la pantalla,
+intente teclear la tecla F1 o, en su lugar, M-x help <Return>.)
 
 La función de AYUDA más básica es C-h c.  Teclee C-h, el carácter c y
 un carácter de comando o secuencia de comando; Emacs le mostrará
 una descripción muy breve del comando.
 
 >> Teclee C-h c C-p.
-  El mensaje debe ser algo como
+   El mensaje debe ser algo como
 
           C-p runs the command previous-line
 
-Esto le dice el "nombre de la función".  Los nombres de función se
-usan principalmente para adecuar y extender Emacs.  Pero ya que los
-nombres de las funciones se eligen para indicar lo que el comando
-hace, también pueden servir como una breve documentación: suficiente
-para recordarle los comandos que ha aprendido.
+Esto le dice el "nombre de la función".  Ya que los nombres de las
+funciones se eligen para indicar lo que hace el comando, pueden servir
+como una breve documentación: suficiente para recordarle los comandos
+que ha aprendido.
 
 Los comandos de múltiples caracteres tales como C-x C-s y (sí no tiene
 las teclas META o EDIT o ALT) <ESC>v también están permitidos después
@@ -1062,22 +1074,23 @@ C-h c.
 
 Esto muestra la documentación de la función, al igual que el nombre,
 en una ventana de Emacs.  Cuando haya terminado de leer el resultado,
-teclee C-x 1 para deshacerse del texto de ayuda.  No tiene que hacer
-esto ahora.  Puede hacer algunas ediciones mientras se refiere
-al texto de ayuda, y entonces teclear C-x 1.
+teclee C-x 1 para deshacerse de la ventana.  No tiene que hacer esto
+ahora.  Puede hacer algunas ediciones mientras se refiere al texto de
+ayuda, y entonces teclear C-x 1.
 
 Aquí hay algunas otras opciones útiles de C-h:
 
    C-h f        Describe una función.  Usted teclea el nombre de la
                 función.
 
->> Intente teclear C-h f previous-line<Return>.
+>> Intente teclear C-h f previous-line <Return>.
    Esto muestra toda la información que Emacs tiene sobre la función
    que implementa el comando C-p
 
-Un comando similar, C-h v, muestra la documentación de variables cuyos
-valores pueda poner para adecuar el comportamiento de Emacs.  Necesita
-teclear el nombre de la variable cuando Emacs pregunte por ella.
+Un comando similar, C-h v, muestra documentación de las variables,
+incluyendo los valores que pueda poner para adaptar el comportamiento
+de Emacs.  Deberá teclear el nombre de la variable cuando Emacs
+pregunte por ella.
 
    C-h a        Comando Apropos.  Teclee una palabra y Emacs hará una
                 lista de todos los comandos que contengan esa palabra.
@@ -1086,7 +1099,7 @@ teclear el nombre de la variable cuando Emacs pregunte por ella.
                 listará una secuencia de uno o dos caracteres la cual
                 ejecutará el mismo comando.
 
->> Teclee C-h a file<Return>.
+>> Teclee C-h a file <Return>.
 
 Esto muestra en otra ventana una lista de todos los comandos M-x con
 la palabra "file" en sus nombres.  Verá comandos de caracteres como
@@ -1098,36 +1111,37 @@ correspondientes tales como find-file.
 
 >> Teclee C-x 1 para borrar la ventana de ayuda.
 
-   C-h i        Leer los Manuales En-Línea (alias Info).  Este comando
+   C-h i        Leer los manuales incluidos (alias Info).  Este comando
                 lo pone en un buffer especial llamado `*info*' donde
-                puede leer manuales en línea de los paquetes
-                instalados en su sistema.  Teclee m Emacs <Return>
-                para leer el manual de Emacs.  Sí nunca ha usado Info
-                antes, teclee ? y Emacs lo llevará en una visita
-                guiada de los servicios del modo de Info.  Una vez que
-                haya terminado este tutorial, debería considerar el
-                manual Info de Emacs como su documentación primaria.
+                puede leer manuales de los paquetes instalados en su
+                sistema. Teclee m emacs <Return> para leer el manual
+                de Emacs.  Si nunca ha usado Info, teclee ? y Emacs y
+                lo llevará por una visita guiada de los servicios del
+                modo de Info.  Una vez que haya terminado este
+                tutorial, debería considerar el manual Info de Emacs
+                como su documentación primaria.
 
 
 * MÁS CARACTERÍSTICAS
 ---------------------
 
-Puede aprender más de Emacs leyendo su manual, ya sea como libro o en
-línea en el Info (use el menú Ayuda--"Help"--o teclee F10 h r).  Dos
-características que pueden gustarle son la completación, que ahorra
-teclear, y dired, que simplifica el manejo de archivos.
+Puede aprender más acerca de Emacs leyendo su manual, ya sea como
+libro o en el propio Emacs (use el menú Ayuda, "Help", o teclee C-h
+r).  Dos características que pueden gustarle son la completación, que
+ahorra teclear, y dired, que simplifica el manejo de archivos.
 
 La completación es una manera de ahorrar teclear innecesariamente.
 Por ejemplo, si quiere cambiarse al buffer "*Messages*", puede teclear
 C-x b *M<Tab> y emacs encontrará el resto del nombre del buffer tan
 lejos como pueda determinar de lo que ya haya tecleado.  La
-completación es descrita en el Info del manual de Emacs en el nodo
-llamado "Completation".
+completación también funciona con nombres de comandos y de archivos.
+La completación se describe en el Info del manual de Emacs en el nodo
+llamado "Completion".
 
 Dired le permite listar los archivos en un directorio (y opcionalmente
 sus subdirectorios), moverse alrededor de esa lista, visitar,
 renombrar, borrar y aparte de eso operar en los archivos.  Dired está
-descrito en el Info en el manual de Emacs en el nodo llamado "Dired".
+descrito en el manual de Emacs en el nodo llamado "Dired".
 
 El manual también describe otras características de Emacs.
 
@@ -1135,13 +1149,11 @@ El manual también describe otras características de Emacs.
 * CONCLUSIÓN
 ------------
 
-Recuerde, para salir permanentemente de Emacs use C-x C-c.  Para salir
-temporalmente a un intérprete de comandos, de forma que puede volver a
-Emacs después, use C-z.
+Para salir permanentemente de Emacs use C-x C-c.
 
 Este tutorial intenta ser comprensible para todos los usuarios nuevos,
-así que si encuentra algo que no esté claro, no se siente y se culpe a
-sí mismo: ¡Quéjese!
+así que si encuentra algo que no esté claro, no se quede parado
+culpándose a sí mismo: ¡Quéjese!
 
 
 * COPIA
@@ -1174,6 +1186,7 @@ La versión en español ha sido revisada y corregida por:
 La versión en español ha sido actualizada por:
 
         Rafael Sepúlveda <drs@gnulinux.org.mx>
+        Juanma Barranquero <lekktu@gmail.com>
 
 Por favor, en caso de duda, sólo es válido el original en inglés de la
 siguiente nota de derechos de reproducción (que puede encontrar en el
diff --git a/lib/makefile.w32-in b/lib/makefile.w32-in
index ccc0cf6a595..3600406ac13 100644
--- a/lib/makefile.w32-in
+++ b/lib/makefile.w32-in
@@ -213,7 +213,6 @@ getopt_.h-SH: doit
 
 HAVE_GETOPT_H = HAVE_GETOPT_H
 INCLUDE_NEXT = include_next
-PRAGMA_SYSTEM_HEADER = \#pragma GCC system_header
 PRAGMA_COLUMNS =
 NEXT_GETOPT_H = <getopt.h>
 ARG_NONNULL_H = ../build-aux/snippet/arg-nonnull.h
diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index fdf25af86ee..0a65a759b7f 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,51 @@
+2012-02-07  Alan Mackenzie  <acm@muc.de>
+
+        * progmodes/cc-engine.el (c-forward-objc-directive): Prevent
+        looping in "#pragma mark @implementation".
+
+2012-02-07  Michael Albinus  <michael.albinus@gmx.de>
+
+        * notifications.el (notifications-on-closed-signal): Make `reason'
+        optional.  (Bug#10744)
+
+2012-02-07  Glenn Morris  <rgm@gnu.org>
+
+        * emacs-lisp/easy-mmode.el (define-minor-mode):
+        Doc fixes for the macro and the mode it defines.
+
+        * image.el (imagemagick-types-inhibit): Doc fix.
+
+        * cus-start.el (imagemagick-render-type): Add it.
+
+2012-02-06  Lars Ingebrigtsen  <larsi@gnus.org>
+
+        * progmodes/cc-mode.el
+        (c-standard-font-lock-fontify-region-function): Set the default at
+        load time, too, so that `font-lock-fontify-buffer' can be called
+        without setting up the entire mode first.  This fixes a bug in
+        `mm-inline-text' with C MIME parts.
+
+2012-02-06  Chong Yidong  <cyd@gnu.org>
+
+        * simple.el (list-processes--refresh): Delete exited processes
+        (Bug#8094).
+
+        * comint.el (comint-next-prompt): next-single-char-property-change
+        and prev-single-char-property-change never return nil (Bug#8657).
+
+        * custom.el (defcustom): Doc fix (Bug#9711).
+
+2012-02-05  Chong Yidong  <cyd@gnu.org>
+
+        * cus-edit.el (custom-variable-reset-backup): Quote the value
+        before storing it in the customized-value property (Bug#6712).
+        (custom-display): Add a customization type tag.
+        (custom-buffer-create-internal): Improve tooltip message.
+
+        * wid-edit.el (widget-field-value-get): New optional arg to
+        suppress trailing whitespace truncation.
+        (character): Use it (Bug#2689).
+
 2012-02-05  Andreas Schwab  <schwab@linux-m68k.org>
 
         * progmodes/gud.el (gud-pv): Use pv instead of pv1.
@@ -5,6 +53,9 @@
 
 2012-02-05  Chong Yidong  <cyd@gnu.org>
 
+        * cus-edit.el (custom-variable-value-create): For mismatched
+        types, show the current value (Bug#7600).
+
         * custom.el (defcustom): Doc fix.
 
 2012-02-05  Glenn Morris  <rgm@gnu.org>
diff --git a/lisp/comint.el b/lisp/comint.el
index 2d0ae6920f9..975291471df 100644
--- a/lisp/comint.el
+++ b/lisp/comint.el
@@ -2513,7 +2513,7 @@ text matching `comint-prompt-regexp'."
               (if (> n 0)
                   (next-single-char-property-change pos 'field)
                 (previous-single-char-property-change pos 'field)))
-        (cond ((or (null pos) (= pos prev-pos))
+        (cond ((= pos prev-pos)
                ;; Ran off the end of the buffer.
                (when (> n 0)
                  ;; There's always an input field at the end of the
diff --git a/lisp/cus-edit.el b/lisp/cus-edit.el
index 0d7b0733b64..4ed72be06fb 100644
--- a/lisp/cus-edit.el
+++ b/lisp/cus-edit.el
@@ -1624,7 +1624,9 @@ Otherwise use brackets."
     ;; Insert the search field.
     (when custom-search-field
       (widget-insert "\n")
-      (let* ((echo "Search for custom items")
+      (let* ((echo "Search for custom items.
+You can enter one or more words separated by spaces,
+or a regular expression.")
              (search-widget
               (widget-create
                'editable-field
@@ -2599,7 +2601,6 @@ try matching its doc string against `custom-guess-doc-alist'."
                   :parent widget)
                  buttons))
           ((memq form '(lisp mismatch))
-           ;; In lisp mode edit the saved value when possible.
            (push (widget-create-child-and-convert
                   widget 'custom-visibility
                   :help-echo "Hide the value of this option."
@@ -2611,11 +2612,10 @@ try matching its doc string against `custom-guess-doc-alist'."
                   t)
                  buttons)
            (insert " ")
-           (let* ((value (cond ((get symbol 'saved-value)
-                                (car (get symbol 'saved-value)))
-                               ((get symbol 'standard-value)
-                                (car (get symbol 'standard-value)))
-                               ((default-boundp symbol)
+           ;; This used to try presenting the saved value or the
+           ;; standard value, but it seems more intuitive to present
+           ;; the current value (Bug#7600).
+           (let* ((value (cond ((default-boundp symbol)
                                 (custom-quote (funcall get symbol)))
                                (t
                                 (custom-quote (widget-get conv :value))))))
@@ -3073,7 +3073,7 @@ to switch between two values."
               (funcall set symbol (car value))
              (error nil)))
       (error "No backup value for %s" symbol))
-    (put symbol 'customized-value (list (car value)))
+    (put symbol 'customized-value (list (custom-quote (car value))))
     (put symbol 'variable-comment comment)
     (put symbol 'customized-variable-comment comment)
     (custom-variable-state-set widget)
@@ -3251,6 +3251,7 @@ Also change :reverse-video to :inverse-video."
   :args '((const :tag "all" t)
           (const :tag "defaults" default)
           (checklist
+           :tag "specific display"
            :offset 0
            :extra-offset 9
            :args ((group :sibling-args (:help-echo "\
diff --git a/lisp/cus-start.el b/lisp/cus-start.el
index 2cee72d717e..a5032cf99e7 100644
--- a/lisp/cus-start.el
+++ b/lisp/cus-start.el
@@ -237,6 +237,8 @@ Leaving \"Default\" unchecked is equivalent with specifying a default of
                             :set custom-set-minor-mode)
              ;; fringe.c
              (overflow-newline-into-fringe fringe boolean)
+             ;; image.c
+             (imagemagick-render-type image integer "24.1")
              ;; indent.c
              (indent-tabs-mode indent boolean)
              ;; keyboard.c
@@ -504,6 +506,8 @@ since it could result in memory overflow and make Emacs crash."
                        (fboundp 'x-selection-exists-p))
                       ((string-match "fringe" (symbol-name symbol))
                        (fboundp 'define-fringe-bitmap))
+                      ((string-match "\\`imagemagick" (symbol-name symbol))
+                       (fboundp 'imagemagick-types))
                       ((equal "font-use-system-font" (symbol-name symbol))
                        (featurep 'system-font-setting))
                       ;; Conditioned on x-create-frame, because that's
diff --git a/lisp/custom.el b/lisp/custom.el
index 962336978b1..2d880d23955 100644
--- a/lisp/custom.el
+++ b/lisp/custom.el
@@ -198,12 +198,16 @@ set to nil, as the value is no longer rogue."
   (run-hooks 'custom-define-hook)
   symbol)
 
-(defmacro defcustom (symbol value doc &rest args)
-  "Declare SYMBOL as a customizable variable that defaults to VALUE.
+(defmacro defcustom (symbol standard doc &rest args)
+  "Declare SYMBOL as a customizable variable.
+SYMBOL is the variable name; it should not be quoted.
+STANDARD is an expression specifying the variable's standard
+value.  It should not be quoted.  It is evaluated once by
+`defcustom', and the value is assigned to SYMBOL if the variable
+is unbound.  The expression itself is also stored, so that
+Customize can re-evaluate it later to get the standard value.
 DOC is the variable documentation.
 
-Neither SYMBOL nor VALUE need to be quoted.
-If SYMBOL is not already bound, initialize it to VALUE.
 The remaining arguments should have the form
 
    [KEYWORD VALUE]...
@@ -320,14 +324,15 @@ for more information."
   `(custom-declare-variable
     ',symbol
     ,(if lexical-binding    ;FIXME: This is not reliable, but is all we have.
-         ;; The `default' arg should be an expression that evaluates to
-         ;; the value to use.  The use of `eval' for it is spread over
-         ;; many different places and hence difficult to eliminate, yet
-         ;; we want to make sure that the `value' expression is checked by the
-         ;; byte-compiler, and that lexical-binding is obeyed, so quote the
-         ;; expression with `lambda' rather than with `quote'.
-         `(list (lambda () ,value))
-       `',value)
+         ;; The STANDARD arg should be an expression that evaluates to
+         ;; the standard value.  The use of `eval' for it is spread
+         ;; over many different places and hence difficult to
+         ;; eliminate, yet we want to make sure that the `standard'
+         ;; expression is checked by the byte-compiler, and that
+         ;; lexical-binding is obeyed, so quote the expression with
+         ;; `lambda' rather than with `quote'.
+         `(list (lambda () ,standard))
+       `',standard)
     ,doc
     ,@args))
 
diff --git a/lisp/emacs-lisp/easy-mmode.el b/lisp/emacs-lisp/easy-mmode.el
index d871f6f1212..dbacba6cd29 100644
--- a/lisp/emacs-lisp/easy-mmode.el
+++ b/lisp/emacs-lisp/easy-mmode.el
@@ -90,6 +90,14 @@ This defines the toggle command MODE and (by default) a control variable
 MODE (you can override this with the :variable keyword, see below).
 DOC is the documentation for the mode toggle command.
 
+The defined mode command takes one optional (prefix) argument.
+Interactively with no prefix argument it toggles the mode.
+With a prefix argument, it enables the mode if the argument is
+positive and otherwise disables it.  When called from Lisp, it
+enables the mode if the argument is omitted or nil, and toggles
+the mode if the argument is `toggle'.  If DOC is nil this
+function adds a basic doc-string stating these facts.
+
 Optional INIT-VALUE is the initial value of the mode's variable.
 Optional LIGHTER is displayed in the modeline when the mode is on.
 Optional KEYMAP is the default keymap bound to the mode keymap.
@@ -242,7 +250,7 @@ or call the function `%s'."))))
               (format (concat "Toggle %s on or off.
 With a prefix argument ARG, enable %s if ARG is
 positive, and disable it otherwise.  If called from Lisp, enable
-the mode if ARG is omitted or nil.
+the mode if ARG is omitted or nil, and toggle it if ARG is `toggle'.
 \\{%s}") pretty-name pretty-name keymap-sym))
          ;; Use `toggle' rather than (if ,mode 0 1) so that using
          ;; repeat-command still does the toggling correctly.
diff --git a/lisp/gnus/ChangeLog b/lisp/gnus/ChangeLog
index 740a2340243..7c83b9d99de 100644
--- a/lisp/gnus/ChangeLog
+++ b/lisp/gnus/ChangeLog
@@ -1,3 +1,43 @@
+2012-02-07  Katsumi Yamaoka  <yamaoka@jpl.org>
+
+        * gnus-sum.el (gnus-summary-show-thread): Revert last two changes.
+
+2012-02-07  Lars Ingebrigtsen  <larsi@gnus.org>
+
+        * nnimap.el (nnimap-transform-headers): Remove unused variable.
+        (nnimap-transform-headers): Fix parsing BODYSTRUCTURE elements that
+        have newlines within the strings, and where the UID comes after the
+        BODYSTRUCTURE element (bug#10537).
+
+        * shr-color.el (shr-color-set-minimum-interval): Renamed to add prefix
+        (bug#10732).
+
+        * shr.el (shr-insert-document): Add doc string.
+        (shr-visit-file): Ditto.
+        (shr-remove-trailing-whitespace): New function.
+        (shr-insert-document): Use it to clean up trailing whitespace as the
+        final step (bug#10714).
+
+2012-02-06  Lars Ingebrigtsen  <larsi@gnus.org>
+
+        * gnus-sum.el (gnus-summary-exit-no-update): Really deaden the summary
+        buffer if `gnus-kill-summary-on-exit' is nil.
+
+2012-02-06  Katsumi Yamaoka  <yamaoka@jpl.org>
+
+        * gnus-sum.el (gnus-summary-show-thread):
+        next-single-char-property-change may return nil in XEmacs.
+
+2012-02-06  Lars Ingebrigtsen  <larsi@gnus.org>
+
+        * gnus-sum.el (gnus-handle-ephemeral-exit): Allow exiting from Gnus
+        when just reading a single group from "without" Gnus.
+
+2012-02-06  Chong Yidong  <cyd@gnu.org>
+
+        * gnus-sum.el (gnus-summary-show-thread):
+        next-single-char-property-change never returns nil (Bug#8657).
+
 2012-02-05  Lars Ingebrigtsen  <larsi@gnus.org>
 
         * nnimap.el (nnimap-open-server): Allow switching the nnoo server
diff --git a/lisp/gnus/gnus-sum.el b/lisp/gnus/gnus-sum.el
index d0a582e2712..296f25a09f9 100644
--- a/lisp/gnus/gnus-sum.el
+++ b/lisp/gnus/gnus-sum.el
@@ -7328,9 +7328,11 @@ If FORCE (the prefix), also save the .newsrc file(s)."
         (gnus-kill-buffer gnus-original-article-buffer)
         (setq gnus-article-current nil))
       ;; Return to the group buffer.
-      (gnus-configure-windows 'group 'force)
       (if (not gnus-kill-summary-on-exit)
-          (gnus-deaden-summary)
+          (progn
+            (gnus-deaden-summary)
+            (gnus-configure-windows 'group 'force))
+        (gnus-configure-windows 'group 'force)
         (gnus-close-group group)
         (gnus-kill-buffer gnus-summary-buffer))
       (unless gnus-single-article-buffer
@@ -7352,7 +7354,7 @@ If FORCE (the prefix), also save the .newsrc file(s)."
 (defun gnus-handle-ephemeral-exit (quit-config)
   "Handle movement when leaving an ephemeral group.
 The state which existed when entering the ephemeral is reset."
-  (if (not (buffer-name (car quit-config)))
+  (if (not (buffer-live-p (car quit-config)))
       (gnus-configure-windows 'group 'force)
     (set-buffer (car quit-config))
     (unless (eq (cdr quit-config) 'group)
@@ -11579,6 +11581,7 @@ Returns nil if no thread was there to be shown."
          (beg (progn (beginning-of-line) (if (bobp) (point) (1- (point)))))
          (eoi (when end
                 (if (fboundp 'next-single-char-property-change)
+                    ;; Note: XEmacs version of n-s-c-p-c may return nil
                     (or (next-single-char-property-change end 'invisible)
                         (point-max))
                   (while (progn
diff --git a/lisp/gnus/nnimap.el b/lisp/gnus/nnimap.el
index 09cf554312b..4c75f721ff6 100644
--- a/lisp/gnus/nnimap.el
+++ b/lisp/gnus/nnimap.el
@@ -189,25 +189,32 @@ textual parts.")
 
 (defun nnimap-transform-headers ()
   (goto-char (point-min))
-  (let (article bytes lines size string)
+  (let (article lines size string)
     (block nil
       (while (not (eobp))
-        (while (not (looking-at "\\* [0-9]+ FETCH.+?UID \\([0-9]+\\)"))
+        (while (not (looking-at "\\* [0-9]+ FETCH"))
           (delete-region (point) (progn (forward-line 1) (point)))
           (when (eobp)
             (return)))
-        (setq article (match-string 1))
+        (goto-char (match-end 0))
         ;; Unfold quoted {number} strings.
-        (while (re-search-forward "[^]][ (]{\\([0-9]+\\)}\r?\n"
-                                  (1+ (line-end-position)) t)
+        (while (re-search-forward
+                "[^]][ (]{\\([0-9]+\\)}\r?\n"
+                (save-excursion
+                  (or (re-search-forward "\\* [0-9]+ FETCH" nil t)
+                      (point-max)))
+                t)
           (setq size (string-to-number (match-string 1)))
           (delete-region (+ (match-beginning 0) 2) (point))
           (setq string (buffer-substring (point) (+ (point) size)))
           (delete-region (point) (+ (point) size))
-          (insert (format "%S" string)))
-        (setq bytes (nnimap-get-length)
-              lines nil)
+          (insert (format "%S" (mm-subst-char-in-string ?\n ?\s string))))
         (beginning-of-line)
+        (setq article
+              (and (re-search-forward "UID \\([0-9]+\\)" (line-end-position)
+                                      t)
+                   (match-string 1)))
+        (setq lines nil)
         (setq size
               (and (re-search-forward "RFC822.SIZE \\([0-9]+\\)"
                                       (line-end-position)
diff --git a/lisp/gnus/shr-color.el b/lisp/gnus/shr-color.el
index e23ab57965e..7011034d242 100644
--- a/lisp/gnus/shr-color.el
+++ b/lisp/gnus/shr-color.el
@@ -267,7 +267,8 @@ Like rgb() or hsl()."
      (t
       nil))))
 
-(defun set-minimum-interval (val1 val2 min max interval &optional fixed)
+(defun shr-color-set-minimum-interval (val1 val2 min max interval
+                                            &optional fixed)
   "Set minimum interval between VAL1 and VAL2 to INTERVAL.
 The values are bound by MIN and MAX.
 If FIXED is t, then VAL1 will not be touched."
@@ -341,9 +342,9 @@ color will be adapted to be visible on BG."
                  (>= luminance-distance shr-color-visible-luminance-min))
             (list bg fg)
           ;; Not visible, try to change luminance to make them visible
-          (let ((Ls (set-minimum-interval (car bg-lab) (car fg-lab) 0 100
-                                          shr-color-visible-luminance-min
-                                          fixed-background)))
+          (let ((Ls (shr-color-set-minimum-interval
+                     (car bg-lab) (car fg-lab) 0 100
+                     shr-color-visible-luminance-min fixed-background)))
             (unless fixed-background
               (setcar bg-lab (car Ls)))
             (setcar fg-lab (cadr Ls))
diff --git a/lisp/gnus/shr.el b/lisp/gnus/shr.el
index acce7660263..deaef1d3f25 100644
--- a/lisp/gnus/shr.el
+++ b/lisp/gnus/shr.el
@@ -128,6 +128,7 @@ cid: URL as the argument.")
 ;; Public functions and commands.
 
 (defun shr-visit-file (file)
+  "Parse FILE as an HTML document, and render it in a new buffer."
   (interactive "fHTML file name: ")
   (pop-to-buffer "*html*")
   (erase-buffer)
@@ -139,12 +140,29 @@ cid: URL as the argument.")
 
 ;;;###autoload
 (defun shr-insert-document (dom)
+  "Render the parsed document DOM into the current buffer.
+DOM should be a parse tree as generated by
+`libxml-parse-html-region' or similar."
   (setq shr-content-cache nil)
-  (let ((shr-state nil)
+  (let ((start (point))
+        (shr-state nil)
         (shr-start nil)
         (shr-base nil)
         (shr-width (or shr-width (window-width))))
-    (shr-descend (shr-transform-dom dom))))
+    (shr-descend (shr-transform-dom dom))
+    (shr-remove-trailing-whitespace start (point))))
+
+(defun shr-remove-trailing-whitespace (start end)
+  (save-restriction
+    (narrow-to-region start end)
+    (delete-trailing-whitespace)
+    (goto-char start)
+    (while (not (eobp))
+      (end-of-line)
+      (dolist (overlay (overlays-at (point)))
+        (when (overlay-get overlay 'before-string)
+          (overlay-put overlay 'before-string nil)))
+      (forward-line 1))))
 
 (defun shr-copy-url ()
   "Copy the URL under point to the kill ring.
diff --git a/lisp/image.el b/lisp/image.el
index c4b51716dad..8c52db149a0 100644
--- a/lisp/image.el
+++ b/lisp/image.el
@@ -686,13 +686,16 @@ The minimum delay between successive frames is 0.01s."
   '(C HTML HTM TXT PDF)
   "ImageMagick types that Emacs should not use ImageMagick to handle.
 This should be a list of symbols, each of which has the same
-names as one of the format tags used internally by ImageMagick;
+name as one of the format tags used internally by ImageMagick;
 see `imagemagick-types'.  Entries in this list are excluded from
-being registered by `imagemagick-register-types'.
+being registered by `imagemagick-register-types', so if you change
+this variable you must do so before you call that function.
 
 If Emacs is compiled without ImageMagick, this variable has no effect."
   :type '(choice (const :tag "Let ImageMagick handle all types it can" nil)
                  (repeat symbol))
+  ;; Ideally, would have a :set function that checks if we already did
+  ;; imagemagick-register-types, and if so undoes it, then redoes it.
   :version "24.1"
   :group 'image)
 
diff --git a/lisp/notifications.el b/lisp/notifications.el
index c3b6c759506..9f7576b3f5d 100644
--- a/lisp/notifications.el
+++ b/lisp/notifications.el
@@ -107,9 +107,12 @@
    notifications-action-signal
    'notifications-on-action-signal))
 
-(defun notifications-on-closed-signal (id reason)
+(defun notifications-on-closed-signal (id &optional reason)
   "Dispatch signals to callback functions from `notifications-on-closed-map'."
-  (let ((entry (assoc id notifications-on-close-map)))
+  ;; notification-daemon prior 0.4.0 does not send a reason.  So we
+  ;; make it optional, and assume `undefined' as default.
+  (let ((entry (assoc id notifications-on-close-map))
+        (reason (or reason 4)))
     (when entry
       (funcall (cadr entry)
                id (cadr (assoc reason notifications-closed-reason)))
diff --git a/lisp/progmodes/cc-engine.el b/lisp/progmodes/cc-engine.el
index 52f18a89849..47ceec309f4 100644
--- a/lisp/progmodes/cc-engine.el
+++ b/lisp/progmodes/cc-engine.el
@@ -7396,6 +7396,7 @@ comment at the start of cc-engine.el for more info."
     (let ((start (point))
           start-char
           (c-promote-possible-types t)
+          lim
           ;; Turn off recognition of angle bracket arglists while parsing
           ;; types here since the protocol reference list might then be
           ;; considered part of the preceding name or superclass-name.
@@ -7423,6 +7424,7 @@ comment at the start of cc-engine.el for more info."
 ;             (c-forward-token-2) ; 2006/1/13 This doesn't move if the token's
 ;             at EOB.
               (goto-char (match-end 0))
+              (setq lim (point))
               (c-skip-ws-forward)
               (c-forward-type))
 
@@ -7447,7 +7449,7 @@ comment at the start of cc-engine.el for more info."
                 t))))
 
           (progn
-            (c-backward-syntactic-ws)
+            (c-backward-syntactic-ws lim)
             (c-clear-c-type-property start (1- (point)) 'c-decl-end)
             (c-put-c-type-property (1- (point)) 'c-decl-end)
             t)
diff --git a/lisp/progmodes/cc-mode.el b/lisp/progmodes/cc-mode.el
index 0c86b68f1d9..374c9b434d1 100644
--- a/lisp/progmodes/cc-mode.el
+++ b/lisp/progmodes/cc-mode.el
@@ -1155,7 +1155,8 @@ Note that the style variables are always made local to the buffer."
   ;; `c-set-fl-decl-start' for the detailed functionality.
   (cons (c-set-fl-decl-start beg) end))
 
-(defvar c-standard-font-lock-fontify-region-function nil
+(defvar c-standard-font-lock-fontify-region-function
+  (default-value 'font-lock-fontify-region-function)
   "Standard value of `font-lock-fontify-region-function'")
 
 (defun c-font-lock-fontify-region (beg end &optional verbose)
diff --git a/lisp/simple.el b/lisp/simple.el
index 8bd32a8db8d..610d4a3be42 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -2713,47 +2713,50 @@ support pty association, if PROGRAM is nil."
   (tabulated-list-init-header))
 
 (defun list-processes--refresh ()
-  "Recompute the list of processes for the Process List buffer."
+  "Recompute the list of processes for the Process List buffer.
+Also, delete any process that is exited or signaled."
   (setq tabulated-list-entries nil)
   (dolist (p (process-list))
-    (when (or (not process-menu-query-only)
-              (process-query-on-exit-flag p))
-      (let* ((buf (process-buffer p))
-             (type (process-type p))
-             (name (process-name p))
-             (status (symbol-name (process-status p)))
-             (buf-label (if (buffer-live-p buf)
-                            `(,(buffer-name buf)
-                              face link
-                              help-echo ,(concat "Visit buffer `"
-                                                 (buffer-name buf) "'")
-                              follow-link t
-                              process-buffer ,buf
-                              action process-menu-visit-buffer)
-                          "--"))
-             (tty (or (process-tty-name p) "--"))
-             (cmd
-              (if (memq type '(network serial))
-                  (let ((contact (process-contact p t)))
-                    (if (eq type 'network)
-                        (format "(%s %s)"
-                                (if (plist-get contact :type)
-                                    "datagram"
-                                  "network")
-                                (if (plist-get contact :server)
-                                    (format "server on %s"
-                                            (plist-get contact :server))
-                                  (format "connection to %s"
-                                          (plist-get contact :host))))
-                      (format "(serial port %s%s)"
-                              (or (plist-get contact :port) "?")
-                              (let ((speed (plist-get contact :speed)))
-                                (if speed
-                                    (format " at %s b/s" speed)
-                                  "")))))
-                (mapconcat 'identity (process-command p) " "))))
-        (push (list p (vector name status buf-label tty cmd))
-              tabulated-list-entries)))))
+    (cond ((memq (process-status p) '(exit signal closed))
+           (delete-process p))
+          ((or (not process-menu-query-only)
+               (process-query-on-exit-flag p))
+           (let* ((buf (process-buffer p))
+                  (type (process-type p))
+                  (name (process-name p))
+                  (status (symbol-name (process-status p)))
+                  (buf-label (if (buffer-live-p buf)
+                                 `(,(buffer-name buf)
+                                   face link
+                                   help-echo ,(concat "Visit buffer `"
+                                                      (buffer-name buf) "'")
+                                   follow-link t
+                                   process-buffer ,buf
+                                   action process-menu-visit-buffer)
+                               "--"))
+                  (tty (or (process-tty-name p) "--"))
+                  (cmd
+                   (if (memq type '(network serial))
+                       (let ((contact (process-contact p t)))
+                         (if (eq type 'network)
+                             (format "(%s %s)"
+                                     (if (plist-get contact :type)
+                                         "datagram"
+                                       "network")
+                                     (if (plist-get contact :server)
+                                         (format "server on %s"
+                                                 (plist-get contact :server))
+                                       (format "connection to %s"
+                                               (plist-get contact :host))))
+                           (format "(serial port %s%s)"
+                                   (or (plist-get contact :port) "?")
+                                   (let ((speed (plist-get contact :speed)))
+                                     (if speed
+                                         (format " at %s b/s" speed)
+                                       "")))))
+                     (mapconcat 'identity (process-command p) " "))))
+             (push (list p (vector name status buf-label tty cmd))
+                   tabulated-list-entries))))))
 
 (defun process-menu-visit-buffer (button)
   (display-buffer (button-get button 'process-buffer)))
diff --git a/lisp/url/ChangeLog b/lisp/url/ChangeLog
index 7c92fc33490..f4cca618b49 100644
--- a/lisp/url/ChangeLog
+++ b/lisp/url/ChangeLog
@@ -1,3 +1,19 @@
+2012-02-06  Lars Ingebrigtsen  <larsi@gnus.org>
+
+        * url-cache.el (url-cache-prune-cache): New function.
+        (url-cache-prune-cache): Check that the directory exists before
+        trying to delete it.
+
+        * url.el (url-retrieve-number-of-calls): New variable.
+        (url-retrieve-internal): Use it to expire the cache once in a
+        while.
+
+        * url-queue.el (url-queue-setup-runners): New function that uses
+        `run-with-idle-timer' for extra asynchronicity.
+        (url-queue-remove-jobs-from-host): New function.
+        (url-queue-callback-function): Remove jobs from the same host if
+        connection failed.
+
 2012-01-12  Glenn Morris  <rgm@gnu.org>
 
         * url-auth.el (url-basic-auth, url-digest-auth):
diff --git a/lisp/url/url-cache.el b/lisp/url/url-cache.el
index 20602a2f8ef..6559de4deb7 100644
--- a/lisp/url/url-cache.el
+++ b/lisp/url/url-cache.el
@@ -209,6 +209,34 @@ If `url-standalone-mode' is non-nil, cached items never expire."
             (seconds-to-time (or expire-time url-cache-expire-time)))
            (current-time))))))
 
+(defun url-cache-prune-cache (&optional directory)
+  "Remove all expired files from the cache.
+`url-cache-expire-time' says how old a file has to be to be
+considered \"expired\"."
+  (let ((current-time (current-time))
+        (total-files 0)
+        (deleted-files 0))
+    (setq directory (or directory url-cache-directory))
+    (when (file-exists-p directory)
+      (dolist (file (directory-files directory t))
+        (unless (member (file-name-nondirectory file) '("." ".."))
+          (setq total-files (1+ total-files))
+          (cond
+           ((file-directory-p file)
+            (when (url-cache-prune-cache file)
+              (setq deleted-files (1+ deleted-files))))
+           ((time-less-p
+             (time-add
+              (nth 5 (file-attributes file))
+              (seconds-to-time url-cache-expire-time))
+             current-time)
+            (delete-file file)
+            (setq deleted-files (1+ deleted-files))))))
+      (if (< deleted-files total-files)
+          nil
+        (delete-directory directory)
+        t))))
+
 (provide 'url-cache)
 
 ;;; url-cache.el ends here
diff --git a/lisp/url/url-queue.el b/lisp/url/url-queue.el
index 534c94b4d52..976a26635cd 100644
--- a/lisp/url/url-queue.el
+++ b/lisp/url/url-queue.el
@@ -30,6 +30,7 @@
 
 (eval-when-compile (require 'cl))
 (require 'browse-url)
+(require 'url-parse)
 
 (defcustom url-queue-parallel-processes 6
   "The number of concurrent processes."
@@ -49,7 +50,7 @@
 
 (defstruct url-queue
   url callback cbargs silentp
-  buffer start-time)
+  buffer start-time pre-triggered)
 
 ;;;###autoload
 (defun url-queue-retrieve (url callback &optional cbargs silent)
@@ -63,7 +64,30 @@ controls the level of parallelism via the
                                       :callback callback
                                       :cbargs cbargs
                                       :silentp silent))))
-  (url-queue-run-queue))
+  (url-queue-setup-runners))
+
+;; To ensure asynch behaviour, we start the required number of queue
+;; runners from `run-with-idle-timer'.  So we're basically going
+;; through the queue in two ways: 1) synchronously when a program
+;; calls `url-queue-retrieve' (which will then start the required
+;; number of queue runners), and 2) at the exit of each job, which
+;; will then not start any further threads, but just reuse the
+;; previous "slot".
+
+(defun url-queue-setup-runners ()
+  (let ((running 0)
+        waiting)
+    (dolist (entry url-queue)
+      (cond
+       ((or (url-queue-start-time entry)
+            (url-queue-pre-triggered entry))
+        (incf running))
+       ((not waiting)
+        (setq waiting entry))))
+    (when (and waiting
+               (< running url-queue-parallel-processes))
+      (setf (url-queue-pre-triggered waiting) t)
+      (run-with-idle-timer 0.01 nil 'url-queue-run-queue))))
 
 (defun url-queue-run-queue ()
   (url-queue-prune-old-entries)
@@ -81,10 +105,27 @@ controls the level of parallelism via the
       (url-queue-start-retrieve waiting))))
 
 (defun url-queue-callback-function (status job)
+  (when (and (eq (car status) :error)
+             (eq (cadr (cadr status)) 'connection-failed))
+    ;; If we get a connection error, then flush all other jobs from
+    ;; the host from the queue.  This particularly makes sense if the
+    ;; error really is a DNS resolver issue, which happens
+    ;; synchronously and totally halts Emacs.
+    (url-queue-remove-jobs-from-host
+     (plist-get (nthcdr 3 (cadr status)) :host)))
   (setq url-queue (delq job url-queue))
   (url-queue-run-queue)
   (apply (url-queue-callback job) (cons status (url-queue-cbargs job))))
 
+(defun url-queue-remove-jobs-from-host (host)
+  (let ((jobs nil))
+    (dolist (job url-queue)
+      (when (equal (url-host (url-generic-parse-url (url-queue-url job)))
+                   host)
+        (push job jobs)))
+    (dolist (job jobs)
+      (setq url-queue (delq job url-queue)))))
+  
 (defun url-queue-start-retrieve (job)
   (setf (url-queue-buffer job)
         (ignore-errors
diff --git a/lisp/url/url.el b/lisp/url/url.el
index 883e1a0c765..03b66b15232 100644
--- a/lisp/url/url.el
+++ b/lisp/url/url.el
@@ -119,6 +119,9 @@ Sometimes while retrieving a URL, the URL library needs to use another buffer
 than the one returned initially by `url-retrieve'.  In this case, it sets this
 variable in the original buffer as a forwarding pointer.")
 
+(defvar url-retrieve-number-of-calls 0)
+(autoload 'url-cache-prune-cache "url-cache")
+
 ;;;###autoload
 (defun url-retrieve (url callback &optional cbargs silent)
   "Retrieve URL asynchronously and call CALLBACK with CBARGS when finished.
@@ -174,6 +177,10 @@ If SILENT, don't message progress reports and the like."
   (unless (url-type url)
     (error "Bad url: %s" (url-recreate-url url)))
   (setf (url-silent url) silent)
+  ;; Once in a while, remove old entries from the URL cache.
+  (when (zerop (% url-retrieve-number-of-calls 1000))
+    (url-cache-prune-cache))
+  (setq url-retrieve-number-of-calls (1+ url-retrieve-number-of-calls))
   (let ((loader (url-scheme-get-property (url-type url) 'loader))
         (url-using-proxy (if (url-host url)
                              (url-find-proxy-for-url url (url-host url))))
diff --git a/lisp/wid-edit.el b/lisp/wid-edit.el
index 27922327f44..61bb4db558c 100644
--- a/lisp/wid-edit.el
+++ b/lisp/wid-edit.el
@@ -1987,10 +1987,14 @@ the earlier input."
     (when (overlayp overlay)
       (delete-overlay overlay))))
 
-(defun widget-field-value-get (widget)
-  "Return current text in editing field."
+(defun widget-field-value-get (widget &optional no-truncate)
+  "Return current text in editing field.
+Normally, trailing spaces within the editing field are truncated.
+But if NO-TRUNCATE is non-nil, include them."
   (let ((from (widget-field-start widget))
-        (to (widget-field-text-end widget))
+        (to   (if no-truncate
+                  (widget-field-end widget)
+                (widget-field-text-end widget)))
         (buffer (widget-field-buffer widget))
         (secret (widget-get widget :secret))
         (old (current-buffer)))
@@ -3407,6 +3411,7 @@ To use this type, you must define :match or :match-alternatives."
   :format "%{%t%}: %v\n"
   :valid-regexp "\\`.\\'"
   :error "This field should contain a single character"
+  :value-get (lambda (w) (widget-field-value-get w t))
   :value-to-internal (lambda (_widget value)
                        (if (stringp value)
                            value
diff --git a/make-dist b/make-dist
index d1d80097824..55dac98d713 100755
--- a/make-dist
+++ b/make-dist
@@ -398,13 +398,12 @@ echo "Making links to \`m4'"
 (cd m4
  ln *.m4 ../${tempdir}/m4)
 
-## Exclude README.W32 because it is specific to pre-built binaries(?).
 echo "Making links to \`nt'"
 (cd nt
  ln emacs.manifest emacs.rc emacsclient.rc config.nt ../${tempdir}/nt
  ln emacs-src.tags nmake.defs gmake.defs subdirs.el ../${tempdir}/nt
  ln [a-z]*.bat [a-z]*.[ch] ../${tempdir}/nt
- ln ChangeLog INSTALL README makefile.w32-in ../${tempdir}/nt)
+ ln ChangeLog INSTALL README README.W32 makefile.w32-in ../${tempdir}/nt)
 
 echo "Making links to \`nt/inc' and its subdirectories"
 for f in `find nt/inc -type f -name '[a-z]*.h'`; do
diff --git a/nt/ChangeLog b/nt/ChangeLog
index 81bf6a1e105..544b964be3d 100644
--- a/nt/ChangeLog
+++ b/nt/ChangeLog
@@ -1,3 +1,21 @@
+2012-02-06  Christoph Scholtes  <cschol2112@googlemail.com>
+
+        * README.W32: Removed specific version information for libXpm
+        included in the binary distribution for maintenance purposes.
+
+2012-02-05  Christoph Scholtes  <cschol2112@googlemail.com>
+
+        * README.W32: Clarification for inclusion in source tarball. (Bug#9750)
+
+        * gmake.defs (PRAGMA_SYSTEM_HEADER): Add for GCC.
+
+        * nmake.defs (PRAGMA_SYSTEM_HEADER): Add, but ignore with MSVC.
+
+        * makefile.w32-in (maybe-copy-distfiles)
+        (maybe-copy-distfiles-CMD, maybe-copy-distfiles-SH)
+        (create-tmp-dist-dir): Added to make --distfiles optional.
+        (dist): Use create-tmp-dist-dir and maybe-copy-distfiles. (Bug#10261)
+
 2012-02-04  Eli Zaretskii  <eliz@gnu.org>
 
         * inc/sys/stat.h (_STAT_DEFINED): Define, to prevent redefinitions
diff --git a/nt/README.W32 b/nt/README.W32
index 8f33dee2d9b..05456fd1d6d 100644
--- a/nt/README.W32
+++ b/nt/README.W32
@@ -3,16 +3,21 @@ See the end of the file for license conditions.
 
                            Emacs for Windows
 
-  This README file describes how to set up and run a precompiled
-  version of GNU Emacs for Windows.  This distribution can be found on
-  the ftp.gnu.org server and its mirrors:
+  This README.W32 file describes how to set up and run a precompiled
+  distribution of GNU Emacs for Windows.  You can find the precompiled
+  distribution on the ftp.gnu.org server and its mirrors:
 
-        ftp://ftp.gnu.org/gnu/emacs/windows/
+        ftp://ftp.gnu.org/gnu/emacs/windows/
 
   This server contains other distributions, including the full Emacs
   source distribution and a barebin distribution which can be installed
   over it, as well as older releases of Emacs for Windows.
 
+  Information on how to compile Emacs from sources on Windows is in
+  the files README and INSTALL in this directory.  If you received
+  this file as part of the Emacs source distribution, please read
+  those 2 files and not this one.
+
   Answers to frequently asked questions, and further information about
   this port of GNU Emacs and related software packages can be found via
   http:
@@ -123,9 +128,7 @@ See the end of the file for license conditions.
   Emacs has built in support for XBM and PPM/PGM/PBM images, and the
   libXpm library is bundled, providing XPM support (required for color
   toolbar icons and splash screen).  Source for libXpm should be available
-  on the same place as you got this binary distribution from.  The version
-  of libXpm bundled with this version of Emacs is 3.5.7, based on x.org's
-  libXpm library from X11R7.3.
+  on the same place as you got this binary distribution from.
 
   Emacs can also support some other image formats with appropriate
   libraries.  These libraries are all available as part of GTK
diff --git a/nt/gmake.defs b/nt/gmake.defs
index e58ee4f3213..6839b28b975 100644
--- a/nt/gmake.defs
+++ b/nt/gmake.defs
@@ -289,6 +289,8 @@ ifdef USER_LIBS
 USER_LIBS := $(patsubst %,-l%,$(USER_LIBS))
 endif
 
+PRAGMA_SYSTEM_HEADER = \#pragma GCC system_header
+
 ifeq "$(ARCH)" "i386"
 ifdef NOOPT
 ARCH_CFLAGS     = -c $(DEBUG_FLAG) $(NOCYGWIN)
diff --git a/nt/makefile.w32-in b/nt/makefile.w32-in
index b442ca57b78..30a5f83ea00 100644
--- a/nt/makefile.w32-in
+++ b/nt/makefile.w32-in
@@ -257,8 +257,22 @@ install-other-dirs-gmake:
 install-shortcuts:

         "$(INSTALL_DIR)/bin/addpm" -q

 

-dist: install-bin

-        mkdir $(TMP_DIST_DIR)

+maybe-copy-distfiles: maybe-copy-distfiles-$(SHELLTYPE)

+

+maybe-copy-distfiles-CMD: doit

+        @if not $(ARGQUOTE)$(DIST_FILES)$(ARGQUOTE)=="" $(CP_DIR) $(DIST_FILES) $(TMP_DIST_DIR)/bin

+

+maybe-copy-distfiles-SH: doit

+        @if [ ! $(ARGQUOTE)$(DIST_FILES)$(ARGQUOTE)=="" ] ; then \

+          $(CP_DIR) $(DIST_FILES) $(TMP_DIST_DIR)/bin

+        fi

+

+create-tmp-dist-dir:

+        mkdir "$(TMP_DIST_DIR)"

+# Also create bin directory for dist files.

+        mkdir "$(TMP_DIST_DIR)/bin"

+

+dist: install-bin create-tmp-dist-dir maybe-copy-distfiles

         $(CP) "$(INSTALL_DIR)/BUGS" $(TMP_DIST_DIR)

         $(CP) "$(INSTALL_DIR)/COPYING" $(TMP_DIST_DIR)

         $(CP) "$(INSTALL_DIR)/README" $(TMP_DIST_DIR)

@@ -269,7 +283,6 @@ dist: install-bin
         $(CP_DIR) "$(INSTALL_DIR)/lisp" $(TMP_DIST_DIR)

         $(CP_DIR) "$(INSTALL_DIR)/leim" $(TMP_DIST_DIR)

         $(CP_DIR) "$(INSTALL_DIR)/site-lisp" $(TMP_DIST_DIR)

-        $(CP_DIR) $(DIST_FILES) $(TMP_DIST_DIR)/bin

         $(COMSPEC)$(ComSpec) /c $(ARGQUOTE)zipdist.bat $(VERSION)$(ARGQUOTE)

         $(DEL_TREE) $(TMP_DIST_DIR)

 

diff --git a/nt/nmake.defs b/nt/nmake.defs
index a143fe65fac..2cb3113ca9a 100644
--- a/nt/nmake.defs
+++ b/nt/nmake.defs
@@ -203,6 +203,9 @@ DEBUG_LINK = -debug
 D = d

 !endif

 

+# gcc-specific pragma (ignore for MSVC)

+PRAGMA_SYSTEM_HEADER =

+

 !if "$(ARCH)" == "i386"

 !ifdef NOOPT

 #ARCH_CFLAGS     = -nologo -c -Zel -W2 -H63 -Od -G3d -Zp8 $(DEBUG_FLAG)

diff --git a/src/ChangeLog b/src/ChangeLog
index 2353cc1eca2..71af862cdac 100644
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,22 @@
+2012-02-07  Chong Yidong  <cyd@gnu.org>
+
+        * buffer.c (Fbuffer_local_variables)
+        (buffer_lisp_local_variables): Handle unbound vars correctly;
+        don't let Qunbound leak into Lisp.
+
+2012-02-07  Glenn Morris  <rgm@gnu.org>
+
+        * image.c (Fimagemagick_types): Doc fix.
+
+        * image.c (imagemagick-render-type): Change it from a lisp object
+        to an integer.  Move the doc here from the lisp manual.
+        Treat all values not equal to 0 the same.
+
+2012-02-06  Chong Yidong  <cyd@gnu.org>
+
+        * doc.c (store_function_docstring): Avoid applying docstring of
+        alias to base function (Bug#2603).
+
 2012-02-04  Andreas Schwab  <schwab@linux-m68k.org>
 
         * .gdbinit (pp1, pv1): Remove redundant defines.
diff --git a/src/buffer.c b/src/buffer.c
index 01418956c8d..a6f61a1936a 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -1022,7 +1022,10 @@ buffer_lisp_local_variables (struct buffer *buf)
       if (buf != current_buffer)
         val = XCDR (elt);
 
-      result = Fcons (Fcons (XCAR (elt), val), result);
+      result = Fcons (EQ (val, Qunbound)
+                      ? XCAR (elt)
+                      : Fcons (XCAR (elt), val),
+                      result);
     }
 
   return result;
@@ -1064,9 +1067,12 @@ No argument or nil as argument means use current buffer as BUFFER.  */)
         idx = PER_BUFFER_IDX (offset);
         if ((idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
             && SYMBOLP (PER_BUFFER_SYMBOL (offset)))
-          result = Fcons (Fcons (PER_BUFFER_SYMBOL (offset),
-                                 PER_BUFFER_VALUE (buf, offset)),
-                          result);
+          {
+            Lisp_Object sym = PER_BUFFER_SYMBOL (offset);
+            Lisp_Object val = PER_BUFFER_VALUE (buf, offset);
+            result = Fcons (EQ (val, Qunbound) ? sym : Fcons (sym, val),
+                            result);
+          }
       }
   }
 
diff --git a/src/doc.c b/src/doc.c
index 7bdb8c658b0..02db4dde072 100644
--- a/src/doc.c
+++ b/src/doc.c
@@ -502,10 +502,12 @@ aren't strings.  */)
 /* Scanning the DOC files and placing docstring offsets into functions.  */
 
 static void
-store_function_docstring (Lisp_Object fun, EMACS_INT offset)
+store_function_docstring (Lisp_Object obj, EMACS_INT offset)
 /* Use EMACS_INT because we get offset from pointer subtraction.  */
 {
-  fun = indirect_function (fun);
+  /* Don't use indirect_function here, or defaliases will apply their
+     docstrings to the base functions (Bug#2603).  */
+  Lisp_Object fun = SYMBOLP (obj) ? XSYMBOL (obj)->function : obj;
 
   /* The type determines where the docstring is stored.  */
 
diff --git a/src/image.c b/src/image.c
index f4def3e681e..b2951dd70fb 100644
--- a/src/image.c
+++ b/src/image.c
@@ -7617,7 +7617,6 @@ imagemagick_load_image (struct frame *f, struct image *img,
   EMACS_INT ino;
   int desired_width, desired_height;
   double rotation;
-  EMACS_INT imagemagick_rendermethod;
   int pixelwidth;
   ImageInfo  *image_info;
   ExceptionInfo *exception;
@@ -7798,9 +7797,8 @@ imagemagick_load_image (struct frame *f, struct image *img,
      went ok.  */
 
   init_color_table ();
-  imagemagick_rendermethod = (INTEGERP (Vimagemagick_render_type)
-                              ? XINT (Vimagemagick_render_type) : 0);
-  if (imagemagick_rendermethod == 0)
+
+  if (imagemagick_render_type == 0)
     {
       size_t image_height;
 
@@ -7850,8 +7848,7 @@ imagemagick_load_image (struct frame *f, struct image *img,
         }
       DestroyPixelIterator (iterator);
     }
-
-  if (imagemagick_rendermethod == 1)
+  else                          /* imagemagick_render_type != 0 */
     {
       /* Magicexportimage is normally faster than pixelpushing.  This
          method is also well tested. Some aspects of this method are
@@ -7986,6 +7983,7 @@ DEFUN ("imagemagick-types", Fimagemagick_types, Simagemagick_types, 0, 0, 0,
 Each entry in this list is a symbol named after an ImageMagick format
 tag.  See the ImageMagick manual for a list of ImageMagick formats and
 their descriptions (http://www.imagemagick.org/script/formats.php).
+You can also try the shell command: `identify -list format'.
 
 Note that ImageMagick recognizes many file-types that Emacs does not
 recognize as images, such as C.  See `imagemagick-types-inhibit'.  */)
@@ -8958,8 +8956,17 @@ The value can also be nil, meaning the cache is never cleared.
 The function `clear-image-cache' disregards this variable.  */);
   Vimage_cache_eviction_delay = make_number (300);
 #ifdef HAVE_IMAGEMAGICK
-  DEFVAR_LISP ("imagemagick-render-type", Vimagemagick_render_type,
-               doc: /* Choose between ImageMagick render methods.  */);
+  DEFVAR_INT ("imagemagick-render-type", imagemagick_render_type,
+    doc: /* Integer indicating which ImageMagick rendering method to use.
+The options are:
+  0 -- the default method (pixel pushing)
+  1 -- a newer method ("MagickExportImagePixels") that may perform
+       better (speed etc) in some cases, but has not been as thoroughly
+       tested with Emacs as the default method.  This method requires
+       ImageMagick version 6.4.6 (approximately) or later.
+*/);
+  /* MagickExportImagePixels is in 6.4.6-9, but not 6.4.4-10.  */
+  imagemagick_render_type = 0;
 #endif
 
 }
diff --git a/src/xfaces.c b/src/xfaces.c
index 617097d056b..bcb04188aeb 100644
--- a/src/xfaces.c
+++ b/src/xfaces.c
@@ -3360,7 +3360,7 @@ update_face_from_frame_parameter (struct frame *f, Lisp_Object param,
 
       /* Changing the background color might change the background
          mode, so that we have to load new defface specs.
-         Call frame-update-face-colors to do that.  */
+         Call frame-set-background-mode to do that.  */
       XSETFRAME (frame, f);
       call1 (Qframe_set_background_mode, frame);