Merge changes made in No Gnus

gnus.texi (Mail Source Specifiers): Add a pop3 via an SSH tunnel example (modified from an example by Michael Albinus).
shr.el (shr-remove-trailing-whitespace): Don't strip whitespace from lines that are narrower than the window width.  Otherwise background "blocks" will look less readable.

Fix bug #4673 with Dired when `stat' fails for ".." or other files.

 lisp/ls-lisp.el (ls-lisp-sanitize): New function.
 (ls-lisp-insert-directory): Use it to fix or remove any elements
 in file-alist with missing attributes.

Fix spurious recognition of c-in-knr-argdecl.

cc-engine.el (c-forward-objc-directive): Prevent looping in "#pragma mark
@implementation".

* notifications.el (notifications-on-closed-signal): Make `reason'
  optional.  (Bug#10744)

Doc updates for define-minor-mode argument behavior

* doc/lispref/modes.texi (Defining Minor Modes):
Expand on args of defined minor modes.
* lisp/emacs-lisp/easy-mmode.el (define-minor-mode):
Doc fixes for the macro and the mode it defines.

NEWS markup for ImageMagick.

Minor adjustment to previous imagemagick change.

Further doc fix for imagemagick-types-inhibit

Fix and doc-fix for `buffer-local-variables'.

* src/buffer.c (Fbuffer_local_variables)
(buffer_lisp_local_variables): Handle unbound vars correctly;
don't let Qunbound leak into Lisp.

* doc/lispref/variables.texi (Creating Buffer-Local): Minor clarification
to buffer-local-variables doc.

Fixes: debbugs:10715

gnus-sum.el (gnus-summary-show-thread): Revert last two changes.

* doc/emacs/files.texi (File Conveniences): Mention ImageMagick images.

* doc/lispref/display.texi (ImageMagick Images): General update.

Small imagemagick doc fixes

* lisp/image.el (imagemagick-types-inhibit): Doc fix.

* src/image.c (Fimagemagick_types): Doc fix.

imagemagick-render-type fixes

* src/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.

* doc/lispref/display.texi (ImageMagick Images):
Move most details of imagemagick-render-type to the variable's doc.

* lisp/cus-start.el (imagemagick-render-type): Add it.

nnimap.el: Fix XEmacs 21.4 build failure from the last change

nnimap.el: Allow nnimap to parse headers with spaces in odd places

Merge changes made in No Gnus

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).
gnus-sum.el (gnus-summary-exit-no-update): Really deaden the summary buffer if `gnus-kill-summary-on-exit' is nil.

gnus-sum.el (gnus-summary-show-thread): next-single-char-property-change may return nil in XEmacs.

Allow calling C fontification while rendering MIME parts

* 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.

Minor Gnus group exit fix

* gnus-sum.el (gnus-handle-ephemeral-exit): Allow exiting from Gnus
when just reading a single group from "without" Gnus.

Add extra checks before expiring the URL cache

(url-cache-prune-cache): Check that the directory exists before
trying to delete it.

Expire URL items from the on-disk cache once in a while

* url.el (url-retrieve-number-of-calls): New variable.
(url-retrieve-internal): Use it to expire the cache once in a
while.

* url-cache.el (url-cache-prune-cache): New function.

Small NEWS imagemagick edits

* doc.c (store_function_docstring): Fix last change.

* simple.el (list-processes--refresh): Delete exited processes.

Fixes: debbugs:8094

Another minor fix for next-single-char-property-change.

* gnus/gnus-sum.el (gnus-summary-show-thread):
next-single-char-property-change never returns nil (Bug#8657).

Minor fix for next-single-char-property-change usage.

* lisp/comint.el (comint-next-prompt): next-single-char-property-change
and prev-single-char-property-change never return nil.

Fixes: debbugs:8657

* doc.c (store_function_docstring): Avoid applying docstring of alias to base function.

Fixes: debbugs:2603

* lisp/custom.el (defcustom): Another doc fix.

* lisp/custom.el (defcustom): Doc fix.

Fixes: debbugs:9711

Unhyphenate "menu-bar" in text

Finish off NEWS entry for removed obsolete funcs and vars

Comment fix.

Expand NEWS entry on old-style backquotes.

* nt/README.W32: Removed specific version information for libXpm
included in the binary distribution for maintenance purposes.

Document make-composed-keymap

* doc/lispref/keymaps.texi (Inheritance and Keymaps):
Mention make-composed-keymap and multiple inheritance.
* etc/NEWS: Related edits.

Make a NEWS entry fractionally less cryptic.

NEWS typo.

* doc/lispref/keymaps.texi (Tool Bar): Mention separators.
* etc/NEWS: Related markup.

Try to mitigate DNS failures when downloading stuff asynchronously

* 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.

* doc/lispref/modes.texi (Running Hooks): Mention run-hook-wrapped.
* etc/NEWS: Related edit.

Document yet more things that were never added to NEWS

* doc/lispref/control.texi (Handling Errors):
Mention condition-case-no-debug and with-demoted-errors.
* etc/NEWS: Related edits.

etc/tutorials/TUTORIAL.es: Updated; synchronize with TUTORIAL.

Added missing bug numbers to Changelog entries.

* make-dist (README.W32): Include file in source tarball.

* nt/README.W32: Clarification for inclusion in source tarball.

* lib/makefile.w32-in (PRAGMA_SYSTEM_HEADER): Move to platform
specific makefiles to support getopt_.h generation with MSVC.

* nt/gmake.defs (PRAGMA_SYSTEM_HEADER): Add for GCC.

* nt/nmake.defs (PRAGMA_SYSTEM_HEADER): Add, but ignore with MSVC.

* nt/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.

* cus-edit.el (custom-buffer-create-internal): Improve tooltip message.

* cus-edit.el (custom-display): Add a customization type tag.

Fix custom-variable-reset-backup's use of customized-value property.

* cus-edit.el (custom-variable-reset-backup): Quote the value
before storing it in the customized-value property.

Fixes: debbugs:6712

Fix how the `character' custom type handles space chars.

* lisp/wid-edit.el (widget-field-value-get): New optional arg to
suppress trailing whitespace truncation.
(character): Use it.

Fixes: debbugs:2689

Update Customization chapter of Lisp manual.

* doc/lispref/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.

Fix presentation of type-mismatched customization widgets.

* lisp/cus-edit.el (custom-variable-value-create): For mismatched
types, show the current value.

Fixes: debbugs:7600

* progmodes/gud.el (gud-pv): Use pv instead of pv1.
* progmodes/gdb-mi.el (gud-pp): Use pp instead of pp1.

Updates to Macros and Customization chapters of Lisp manual.

* doc/lispref/customize.texi (Common Keywords): Minor clarifications.
Document custom-unlispify-remove-prefixes.
(Variable Definitions): Backquotes in defcustom seem to work fine
now.  Various other copyedits.

* doc/lispref/macros.texi (Expansion): Minor clarification.
(Backquote): Move node to eval.texi.
(Defining Macros): Move an example from Backquote node.
(Argument Evaluation): No need to mention Pascal.
(Indenting Macros): Add xref to Defining Macros.

* doc/lispref/eval.texi (Backquote): Move from macros.texi.

* lisp/custom.el (defcustom): Doc fix.

nnimap.el: Fix inloop if the server dies before the async -finish is called

More doc for debug-on-event.

* emacs/trouble.texi (Checklist): Mention debug-on-event.

* lispref/debugging.texi (Error Debugging): Mention debug-on-event default.

NEWS tweak.

Rephrase previous change.

Mention ERT in the Emacs manual.

* doc/emacs/maintaining.texi (Maintaining): Add cross-ref to ERT.
* etc/NEWS: Related markup.

* lisp/font-lock.el (lisp-font-lock-keywords-2): Add with-wrapper-hook.

with-demoted errors is another thing never mentioned in NEWS.

lisp/emacs-lisp/pp.el: Do not reimplement common macros; use `looking-at-p'.

(pp-to-string): Use `with-temp-buffer'.
(pp-buffer): Use `ignore-errors', `looking-at-p'.
(pp-last-sexp): Use `looking-at-p'.

* Makefile.in (uninstall): Handle compressed info files and man pages.

Fixes: debbugs:10718

Mention updating the homepage after a release.

Document revert-buffer-in-progress-p

* doc/lispref/backups.texi (Reverting): Mention revert-buffer-in-progress-p.
* lisp/files.el (revert-buffer): Doc fix (mention revert-buffer-in-progress-p).
* etc/NEWS: Related markup.

Document debug-on-event

* doc/lispref/debugging.texi (Error Debugging): Mention debug-on-event.
* doc/lispref/commands.texi (Misc Events): Mention sigusr1,2 and debugging.
* etc/NEWS: Related edit.

Document ns-auto-hide-menu-bar

* doc/emacs/macos.texi (Customization options specific to Mac OS / GNUstep):
New subsection.

* etc/NEWS: Related markup.

* nt/INSTALL: Mention --lib, --enable-checking.

* etc/NEWS: Markup for things in nt/INSTALL (no need for these things
to be in the manuals proper).

ert-x trivia

* lisp/emacs-lisp/ert-x.el (ert-simulate-command):
Check deferred-action-list (which is obsolete) is bound.

* etc/NEWS: Related markup.

with-wrapper-hook doc clarifications

* doc/lispref/modes.texi (Running Hooks): Try to clarify with-wrapper-hook.
* lisp/subr.el (with-wrapper-hook): Doc fixes.

* .gdbinit (pp1, pv1): Remove redundant defines.
(pr): Use pp.

Try to document filter-buffer-substring changes

* doc/lispref/text.texi (Buffer Contents):
Update filter-buffer-substring description.

* lisp/simple.el (filter-buffer-substring-functions)
(buffer-substring-filters, filter-buffer-substring): Doc fixes.

* etc/NEWS: Related edits.

* src/nsterm.m: Declare a global (Bug#10694).

Update Functions chapter of Lisp manual; document closures.

* doc/emacs/functions.texi (What Is a Function): Add closures.  Mention
"return value" terminology.  Add xref for command-execute.  Remove
unused "keystroke command" terminology.
(Lambda Expressions): Give a different example than in the
following subsection.  Add xref to Anonymous Functions.
(Function Documentation): Remove gratuitous markup.
(Function Names): Move introductory text to `What Is a Function'.
(Defining Functions): Fix defun argument spec.
(Anonymous Functions): Document lambda macro explicitly.  Mention
effects on lexical binding.
(Function Cells): Downplay direct usage of fset.
(Closures): New node.
(Inline Functions): Remove "open-code" terminology.
(Declaring Functions): Minor tweak; .m is not C code.

* doc/emacs/variables.texi (Variables): Don't refer to "global value".
(Local Variables, Void Variables): Copyedits.
(Lexical Binding): Minor clarification of example.
(File Local Variables): Mention :safe and :risky defcustom args.
(Lexical Binding): Add xref to Closures node.

Include --enable-checking in system-configuration-options on MS-Windows.

 srtc/w32.c (get_emacs_configuration_options): Include
 --enable-checking, if specified, in the return value.

Avoid MS-Windows compilation errors when struct stat is redefined.

 nt/inc/sys/stat.h (_STAT_DEFINED): Define, to prevent redefinitions
 by other headers.

When changing frame sizes round before applying new sizes.  (Bug#9723)

* dispnew.c (change_frame_size_1): Calculate new_frame_total_cols
after rounding frame sizes.  (Bug#9723)

Fix bug #10523 with bad value of eshell-windows-shell-file.

 lisp/eshell/esh-ext.el (eshell-windows-shell-file): Match "cmdproxy"
 anywhere in shell-file-name, not just at the beginning.  (Bug#10523)

Fix bug #10696 with crash when an empty display string is at BOB.

 src/keyboard.c (adjust_point_for_property): Don't position point
 before BEGV.

Fix dead link in smie.el

http://debbugs.gnu.org/10711

Fix MS-DOS build in lib-src.

 msdos/sed3v2.inp (insrcdir): Use $(<F) rather than $<, as
 command.com's "if not exist" doesn't grok forward slashes in file
 names.

NEWS annoyance.

NEWS.

* lisp/isearch.el (isearch-update): Doc fix.

* lisp/image.el (image-extension-data): Add obsolete alias.

* doc/lispref/minibuf.texi (High-Level Completion): Updates for read-color.
* etc/NEWS: Likewise.

PROBLEMS tiny fixes for references to src/{m,s} files.

NEWS misc small edits.

* lisp/facemenu.el (list-colors-display): Doc fix (minor rephrasing).

* lisp/ido.el (ido-find-file): Doc fix (ido-toggle-vc not on any key).

* doc/emacs/display.texi (Colors): Mention list-colors-sort.

* doc/emacs/files.texi (File Conveniences): Mention image animation.

Handle overflow when computing char display width (Bug#9496).

* character.c (char_width): Return EMACS_INT, not int.
(char_width, c_string_width): Check for overflow when
computing the width; this is possible now that individual
characters can have unbounded width.  Problem introduced
by merge from Emacs 23 on 2012-01-19.

* tutorials/TUTORIAL.nl: Updated; synchronize with TUTORIAL.

Document animated image API

* doc/lispref/display.texi (GIF Images): Mention animation.
Remove commented-out old example of animation.
(Animated Images): New subsection.
* doc/lispref/elisp.texi (Top):
* doc/lispref/vol1.texi (Top):
* doc/lispref/vol2.texi (Top): Add Animated Images menu entry.

* lisp/image-mode.el (image-animate-loop, image-toggle-animation): Doc fixes.

* lisp/image.el (image-animated-p): Doc fix.  Use image-animated-types.
(image-animate-timeout): Doc fix.

* etc/NEWS: Markup.

* doc/lispref/display.texi (GIF Images, TIFF Images): Minor rephrasing.

Small display.texi fix

* doc/lispref/display.texi (Image Formats):
Remove oddly specific information on versions of image libraries.

Some more NEWS markup.