Merge from origin/emacs-25

3b47898 Fix doc string in `insert'
b479dea * doc/misc/emacs-mime.texi (time-date): Document now-builtins...
cd27f73 Say 'All results processed' at the end
4ffec91 Document automatic adjustment of process' logical window dime...
dc66271 ; Fix typos and stylistic glitches in NEWS

6 files changed, 184 insertions, 114 deletions

diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index e8a9ad05c22..e3346aa3a5b 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -1381,6 +1381,58 @@ Killing the process's buffer deletes the process, which kills the
 subprocess with a @code{SIGHUP} signal (@pxref{Signals to Processes}).
 @end defun
 
+If the process's buffer is displayed in a window, your Lisp program
+may wish telling the process the dimensions of that window, so that
+the process could adapt its output to those dimensions, much as it
+adapts to the screen dimensions.  The following functions allow to
+communicate this kind of information to processes; however, not all
+systems support the underlying functionality, so it is best to provide
+fallbacks, e.g., via command-line arguments or environment variables.
+
+@defun set-process-window-size process height width
+Tell @var{process} that its logical window size has dimensions
+@var{width} by @var{height}, in character units.  If this function
+succeeds in communicating this information to the process, it returns
+@code{t}; otherwise it returns @code{nil}.
+@end defun
+
+When windows that display buffers associated with process change their
+dimensions, the affected processes should be told about these changes.
+By default, when the window configuration changes, Emacs will
+automatically call @code{set-process-window-size} on behalf of every
+process whose buffer is displayed in a window, passing it the smallest
+dimensions of all the windows displaying the process's buffer.  This
+works via @code{window-configuration-change-hook} (@pxref{Window
+Hooks}), which is told to invoke the function that is the value of
+the variable @code{window-adjust-process-window-size-function} for
+each process whose buffer is displayed in at least one window.  You
+can customize this behavior by setting the value of that variable.
+
+@defopt window-adjust-process-window-size-function
+The value of this variable should be a function of two arguments: a
+process and the list of windows displaying the process's buffer.  When
+the function is called, the process's buffer is the current buffer.
+The function should return a cons cell @w{@code{(@var{width}
+. @var{height})}} that describes the dimensions of the logical process
+window to be passed via a call to @code{set-process-window-size}.  The
+function can also return @code{nil}, in which case Emacs will not call
+@code{set-process-window-size} for this process.
+
+Emacs supplies two predefined values for this variable:
+@code{window-adjust-process-window-size-smallest}, which returns the
+smallest of all the dimensions of the windows that display a process's
+buffer; and @code{window-adjust-process-window-size-largest}, which
+returns the largest dimensions.  For more complex strategies, write
+your own function.
+
+This variable can be buffer-local.
+@end defopt
+
+If the process has the @code{adjust-window-size-function} property
+(@pxref{Process Information}), its value overrides the global and
+buffer-local values of
+@code{window-adjust-process-window-size-function}.
+
 @node Filter Functions
 @subsection Process Filter Functions
 @cindex filter function
diff --git a/doc/misc/emacs-mime.texi b/doc/misc/emacs-mime.texi
index 2b3bba39ad9..2b935870dae 100644
--- a/doc/misc/emacs-mime.texi
+++ b/doc/misc/emacs-mime.texi
@@ -1554,7 +1554,7 @@ Here's a bunch of time/date/second/day examples:
 (time-less-p '(13818 19266) '(13818 19145))
 @result{} nil
 
-(subtract-time '(13818 19266) '(13818 19145))
+(time-subtract '(13818 19266) '(13818 19145))
 @result{} (0 121)
 
 (days-between "Sat Sep 12 12:21:54 1998 +0200"
@@ -1632,14 +1632,14 @@ return a ``zero'' time.
 
 @item time-less-p
 Take two times and say whether the first time is less (i.e., earlier)
-than the second time.
+than the second time.  (This is a built-in function.)
 
 @item time-since
 Take a time and return a time saying how long it was since that time.
 
-@item subtract-time
+@item time-subtract
 Take two times and subtract the second from the first.  I.e., return
-the time between the two times.
+the time between the two times.  (This is a built-in function.)
 
 @item days-between
 Take two days and return the number of days between those two days.
diff --git a/etc/NEWS b/etc/NEWS
index 22eb2eabc37..b4407a661ad 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -547,7 +547,7 @@ build with 'make V=1'.
 ---
 ** The configure option '--with-gameuser' now allows you to specify a
 group instead of a user if its argument is prefixed by ':' (a colon).
-This will cause the game score files in ${localstatedir}/games/emacs
+This will cause the game score files in "${localstatedir}/games/emacs"
 to be owned by that group, and the helper program for updating them to
 be installed setgid.  The option now defaults to the 'games' group.
 
@@ -574,7 +574,7 @@ tests which take more time to perform.
 'initial-buffer-choice' is non-nil, display both the file and
 'initial-buffer-choice'.  When Emacs is given more than one file and
 'initial-buffer-choice' is non-nil, show 'initial-buffer-choice'
-and *Buffer List*.  This makes Emacs convenient to use from the
+and '*Buffer List*'.  This makes Emacs convenient to use from the
 command line when 'initial-buffer-choice' is non-nil.
 
 +++
@@ -650,14 +650,14 @@ added via the new Network Security Manager (NSM) and controlled via
 the 'network-security-level' variable.
 
 +++
-** C-h l now also lists the commands that were run.
+** 'C-h l' now also lists the commands that were run.
 
 +++
-** x-select-enable-clipboard is renamed select-enable-clipboard
-and x-select-enable-primary is renamed select-enable-primary.
+** 'x-select-enable-clipboard' is renamed 'select-enable-clipboard'
+and 'x-select-enable-primary' is renamed 'select-enable-primary'.
 Additionally they both now apply to all systems (OSX, GNUstep, Windows, you
 name it), with the proviso that on some systems (e.g. Windows)
-select-enable-primary is ineffective since the system doesn't
+'select-enable-primary' is ineffective since the system doesn't
 have the equivalent of a primary selection.
 
 +++
@@ -670,7 +670,7 @@ selected window is strongly dedicated to its buffer.
 'even-window-sizes' and now handles window widths as well.
 
 +++
-** terpri gets an optional arg ENSURE to conditionally output a newline.
+** 'terpri' gets an optional arg ENSURE to conditionally output a newline.
 
 +++
 ** 'insert-register' now leaves point after the inserted text
@@ -693,9 +693,9 @@ variable 'read-hide-char'.
 
 +++
 ** The Emacs pseudo-random number generator can be securely seeded.
-On system where Emacs can access the system entropy or some other
+On systems where Emacs can access the system entropy or some other
 cryptographically secure random stream, it now uses that when 'random'
-is called with its argument 't'.  This allows cryptographically strong
+is called with its argument t.  This allows cryptographically strong
 random values; in particular, the Emacs server now uses this facility
 to produce its authentication key.
 
@@ -706,7 +706,7 @@ to produce its authentication key.
 * Editing Changes in Emacs 25.1
 
 +++
-** M-x suggests shorthands and ignores obsolete commands for completion.
+** 'M-x' suggests shorthands and ignores obsolete commands for completion.
 
 ** Changes in undo
 
@@ -728,19 +728,20 @@ affected by the command.
 ** New and improved facilities for inserting Unicode characters
 
 ---
-*** Unicode names entered via C-x 8 RET now use substring completion by default.
+*** Unicode names entered via 'C-x 8 RET' now use substring completion
+by default.
 
 +++
-*** C-x 8 now has shorthands for several chars, such as U+2010
+*** 'C-x 8' now has shorthands for several chars, such as U+2010
 (HYPHEN), U+2011 (NON-BREAKING HYPHEN), and U+2012 (FIGURE DASH).  As
-before, you can type C-x 8 C-h to list shorthands.
+before, you can type 'C-x 8 C-h' to list shorthands.
 
 +++
-*** New minor mode electric-quote-mode for using curved quotes as you
+*** New minor mode 'electric-quote-mode' for using curved quotes as you
 type.  See also the new variable 'text-quoting-style'.
 
 ---
-** New minor mode global-eldoc-mode is enabled by default.
+** New minor mode 'global-eldoc-mode' is enabled by default.
 
 ---
 ** Emacs now uses "bracketed paste mode" on text terminals that support it.
@@ -765,7 +766,7 @@ Bidirectional Parentheses Algorithm (BPA) specified by these Unicode
 standards.
 
 +++
-** You can access 'mouse-buffer-menu' (C-down-mouse-1) using C-f10.
+** You can access 'mouse-buffer-menu' ('C-down-mouse-1') using 'C-f10'.
 
 +++
 ** New buffer-local 'electric-pair-local-mode'.
@@ -773,7 +774,7 @@ standards.
 +++
 ** New variable 'fast-but-imprecise-scrolling' inhibits
 fontification during full screen scrolling operations, giving less
-hesitant operation during auto-repeat of C-v, M-v at the cost of
+hesitant operation during auto-repeat of 'C-v', 'M-v' at the cost of
 possible inaccuracies in the end position.
 
 +++
@@ -787,8 +788,8 @@ unsaved customizations and prompts user to customize (if found).  It
 is intended for adding to 'kill-emacs-query-functions'.
 
 +++
-** The old 'C-x w' bindings in hi-lock-mode are officially deprecated
-in favor of the global 'M-s h' bindings introduced in Emacs-23.1.
+** The old 'C-x w' bindings in 'hi-lock-mode' are officially deprecated
+in favor of the global 'M-s h' bindings introduced in Emacs 23.1.
 They'll disappear soon.
 
 
@@ -813,13 +814,13 @@ emacs -batch --eval "(checkdoc-file \"subr.el\")"
 *** The desktop format version has been upgraded from 206 to 208.
 Although Emacs 25.1 can read a version 206 desktop, earlier Emacsen
 cannot read a version 208 desktop.  To upgrade your desktop file, you
-must explicitly request the upgrade, by C-u M-x desktop-save.  You are
+must explicitly request the upgrade, by 'C-u M-x desktop-save'.  You are
 recommended to do this as soon as you have firmly upgraded to Emacs
 25.1 (or later).  Should you ever need to downgrade your desktop file
-to version 206, you can do this with C-u C-u M-x desktop-save.
+to version 206, you can do this with 'C-u C-u M-x desktop-save'.
 
 +++
-** New function 'bookmark-set-no-overwrite' bound to C-x r M.
+** New function 'bookmark-set-no-overwrite' bound to 'C-x r M'.
 It raises an error if a bookmark of that name already exists,
 unlike 'bookmark-set' which silently updates an existing bookmark.
 
@@ -926,10 +927,10 @@ being made case-sensitive in Emacs 24.2.
 **** New play/pause command 'mpc-toggle-play' bound to 's'
 
 **** 'g' bound to new command 'mpc-seek-current' will navigate current
-     track.
+track.
 
 **** New commands 'mpc-toggle-{consume,repeat,single,shuffle}' for
-     toggling playback modes.
+toggling playback modes.
 
 ---
 *** Now supports connecting to a UNIX domain socket.
@@ -1022,10 +1023,10 @@ installed strictly as dependencies but are no longer needed.
 +++
 ** Shell
 
-When you invoke 'shell' interactively, the *shell* buffer will now
+When you invoke 'shell' interactively, the '*shell*' buffer will now
 display in a new window.  However, you can customize this behavior via
 the 'display-buffer-alist' variable.  For example, to get
-the old behavior -- *shell* buffer displays in current window -- use
+the old behavior -- '*shell*' buffer displays in current window -- use
 (add-to-list 'display-buffer-alist
      '("^\\*shell\\*$" . (display-buffer-same-window))).
 
@@ -1046,13 +1047,14 @@ If you need your objects to be named, do it by inheriting from 'eieio-named'.
 Use the equivalent facilities from cl-generic.el instead.
 +++
 *** 'constructor' is now an obsolete alias for 'make-instance'.
---- 'pcase' accepts a new UPattern 'eieio'.
+---
+*** 'pcase' accepts a new UPattern 'eieio'.
 
 ** ido
 
 +++
-*** New command 'ido-bury-buffer-at-head' bound to C-S-b
-Bury the buffer at the head of 'ido-matches', analogous to how C-k
+*** New command 'ido-bury-buffer-at-head' bound to 'C-S-b'.
+Bury the buffer at the head of 'ido-matches', analogous to how 'C-k'
 kills the buffer at head.
 
 ---
@@ -1108,13 +1110,13 @@ by searching commands to produce a regexp matching anything that
 character-folds into STRING.
 
 +++
-*** The new M-s M-w key binding uses eww to search the web for the
+*** The new 'M-s M-w' key binding uses eww to search the web for the
 text in the region.  The search engine to use for this is specified by
 the customizable variable 'eww-search-prefix'.
 
 +++
-*** Query-replace history is enhanced.
-When query-replace reads the FROM string from the minibuffer, typing
+*** 'query-replace' history is enhanced.
+When 'query-replace' reads the FROM string from the minibuffer, typing
 'M-p' will now show previous replacements as "FROM SEP TO", where FROM
 and TO are the original text and its replacement, and SEP is an arrow
 string defined by the new variable 'query-replace-from-to-separator'.
@@ -1128,19 +1130,19 @@ typing RET.
 result of the calculation into the current buffer.
 
 +++
-** In Edebug, you can now set the initial mode with C-x C-a C-m.  With
-this you can tell Edebug not to stop at the start of the first
+** In Edebug, you can now set the initial mode with 'C-x C-a C-m'.
+With this you can tell Edebug not to stop at the start of the first
 instrumented function.
 
 ** ElDoc
 
 +++
-*** New minor mode 'global-eldoc-mode'
+*** New minor mode 'global-eldoc-mode'.
 It is turned on by default, and affects '*scratch*' and other buffers
 whose major mode supports Emacs Lisp.
 
 ---
-*** 'eldoc-documentation-function' now defaults to 'ignore'
+*** 'eldoc-documentation-function' now defaults to 'ignore'.
 
 ---
 *** 'describe-char-eldoc' displays information about character at point,
@@ -1232,7 +1234,7 @@ CLOS class and slot documentation.
 *** Rectangle Mark mode can have corners past EOL or in the middle of a TAB.
 
 +++
-*** C-x C-x in rectangle-mark-mode now cycles through the four corners.
+*** 'C-x C-x' in 'rectangle-mark-mode' now cycles through the four corners.
 *** 'string-rectangle' provides on-the-fly preview of the result.
 
 +++
@@ -1258,7 +1260,7 @@ prepending it.
 ** Calendar and diary
 
 +++
-*** The default 'diary-file' is now located in .emacs.d.
+*** The default 'diary-file' is now located in "~/.emacs.d".
 
 +++
 *** New commands to insert diary entries with Chinese dates:
@@ -1335,7 +1337,7 @@ to delete or undelete multiple messages.
 libxml2 or if you have the Lynx browser installed.  By default, Rmail
 will display the HTML version of a mail message that has both HTML and
 plain text parts, if display of HTML email is possible; customize the
-'rmail-mime-prefer-html' option to 'nil' if you don't want that.
+'rmail-mime-prefer-html' option to nil if you don't want that.
 
 +++
 *** In the commands that make summaries by subject, recipients, or senders,
@@ -1388,7 +1390,7 @@ variable, meaning you can bind it around an 'url-retrieve' call.
 
 ---
 *** If URL is used with a https connection, the first callback argument
-plist will contain a :peer element that has the output of
+PLIST will contain a :peer element that has the output of
 'gnutls-peer-status' (if Emacs is built with GnuTLS support).
 
 ** Tramp
@@ -1429,10 +1431,10 @@ comments.
 +++
 *** Basic push support, via 'vc-push', bound to 'C-x v P'.
 Implemented for Bzr, Git, Hg.  As part of this change, the pre-existing
-(undocumented) command vc-hg-push now behaves slightly differently.
+(undocumented) command 'vc-hg-push' now behaves slightly differently.
 
 +++
-*** The new command vc-region-history shows the log+diff of the active region.
+*** The new command 'vc-region-history' shows the log+diff of the active region.
 
 +++
 *** You can refresh the VC state of a file buffer with 'M-x vc-refresh-state'.
@@ -1517,7 +1519,7 @@ file name patterns.  Defaults to files whose extension is one of '.h',
 *** New custom variable 'hide-ifdef-expand-reinclusion-protection' to prevent
 reinclusion protected (a.k.a. "idempotent") header files from being hidden.
 (This could happen when an idempotent header file is visited again,
-when its guard symbol is already defined.)  Defaults to 't'.
+when its guard symbol is already defined.)  Defaults to t.
 
 ---
 *** New custom variable 'hide-ifdef-exclude-define-regexp' to define symbol
@@ -1550,7 +1552,7 @@ New options 'tildify-space-string', 'tildify-pattern', and
 helper functions) obsolete.
 
 +++
-** New package Xref replaces Etags's front-end and UI
+** New package Xref replaces Etags's front-end and UI.
 
 The new package Xref provides a generic framework and new commands to
 find and move to definitions of functions, macros, data structures
@@ -1662,7 +1664,8 @@ EUDC's PH backend (eudcb-ph.el) is obsolete.
 
 +++
 *** The new built-in command 'clear' can scroll window contents out of sight.
-If provided with an optional non-nil argument, the scrollback contents will be cleared.
+If provided with an optional non-nil argument, the scrollback contents
+will be cleared.
 
 +++
 *** New buffer syntax '#<buffer-name>', which is equivalent to
@@ -1692,7 +1695,7 @@ make the new option 'eshell-destroy-buffer-when-process-dies' non-nil.
 *** Support for several ancient browsers is now officially obsolete.
 
 +++
-** tar-mode: new 'tar-new-entry' command, allowing for new members to
+** 'tar-mode': new 'tar-new-entry' command, allowing for new members to
 be added to the archive.
 
 ** Autorevert
@@ -1721,11 +1724,11 @@ notification descriptor still corresponds to an activate watch.
 ** Dired
 
 +++
-*** The command 'dired-do-compress' bound to 'Z' now can compress
+*** The command 'dired-do-compress', bound to 'Z', now can compress
 directories and decompress zip files.
 
 +++
-*** New command 'dired-do-compress-to' bound to 'c' can be used to
+*** New command 'dired-do-compress-to', bound to 'c', can be used to
 compress many marked files into a single named archive.  The
 compression command is determined from the new
 'dired-compress-files-alist' variable.
@@ -1750,7 +1753,7 @@ call 'tabulated-list-init-header', in which case it will have no
 header.
 
 +++
-*** 'tabulated-list-print' takes a second optional argument, update,
+*** 'tabulated-list-print' takes a second optional argument, UPDATE,
 which specifies an alternative printing method which is faster when
 few or no entries have changed.
 
@@ -1780,11 +1783,11 @@ The main entry points are 'cl-defgeneric' and 'cl-defmethod'.  See the
 node "Generic Functions" in the Emacs Lisp manual for more details.
 
 ---
-** scss-mode (a minor variant of css-mode) is a major mode for editing
+** 'scss-mode' (a minor variant of 'css-mode') is a major mode for editing
 SCSS (Sassy CSS) files.
 
 ---
-** let-alist is a new macro (and a package) that allows one to easily
+** 'let-alist' is a new macro (and a package) that allows one to easily
 let-bind the values stored in an alist.
 
 ---
@@ -1810,7 +1813,7 @@ alists, hash-table and arrays.  All functions are prefixed with
 evaluation of forms.
 
 ---
-** js-jsx-mode (a minor variant of js-mode) provides indentation
+** 'js-jsx-mode' (a minor variant of 'js-mode') provides indentation
 support for JSX, an XML-like syntax extension to ECMAScript.
 
 
@@ -1824,8 +1827,8 @@ eliminated.
 
 +++
 ** 'syntax-begin-function' is declared obsolete.
-Removed font-lock-beginning-of-syntax-function and the SYNTAX-BEGIN
-slot in font-lock-defaults.
+Removed 'font-lock-beginning-of-syntax-function' and the SYNTAX-BEGIN
+slot in 'font-lock-defaults'.
 
 +++
 ** The new implementation of Subword mode affects word movement everywhere.
@@ -1857,24 +1860,24 @@ pointer shape during dragging, should bind the variable 'track-mouse'
 to the special value 'dragging' in the body of the form.
 
 ---
-** The optional 'predicate' argument of 'lisp-complete-symbol' no longer
+** The optional PREDICATE argument of 'lisp-complete-symbol' no longer
 has any effect.  (This change was made in Emacs 24.4 but was not
 advertised at the time.)
 
 +++
 ** 'indirect-function' does not signal 'void-function' any more.
 This is mostly a bug-fix, since this change was missed back in 24.4 when
-symbol-function was changed not to signal 'void-function' any more.
+'symbol-function' was changed not to signal 'void-function' any more.
 
 +++
 *** As a consequence, the second arg of 'indirect-function' is now obsolete.
 
 +++
-** M-x shell and M-x compile no longer set the EMACS environment variable.
+** 'M-x shell' and 'M-x compile' no longer set the EMACS environment variable.
 This avoids clashing when other programs use the variable for other purposes.
-Although M-x term still sets EMACS for compatibility with Bash 4.3 and earlier,
-this is deprecated and will be phased out when Bash 4.4 or later takes over.
-Use the INSIDE_EMACS environment variable instead.
+Although 'M-x term' still sets EMACS for compatibility with Bash 4.3
+and earlier, this is deprecated and will be phased out when Bash 4.4
+or later takes over.  Use the INSIDE_EMACS environment variable instead.
 
 +++
 ** 'save-excursion' does not save&restore the mark any more.
@@ -1882,31 +1885,31 @@ Use 'save-mark-and-excursion' if you want the old behavior.
 
 +++
 ** 'read-buffer' and 'read-buffer-function' can now be called with a 4th
-argument ('predicate').
+argument (PREDICATE).
 
 +++
 ** 'completion-table-dynamic' by default stays in the minibuffer.
 The minibuffer will be the current buffer when the function is called.
 If you want the old behavior of calling the function in the buffer
 from which the minibuffer was entered, use the new argument
-'switch-buffer' to 'completion-table-dynamic'.
+SWITCH-BUFFER to 'completion-table-dynamic'.
 
 ---
 ** window-configurations no longer record the buffers' marks.
 
 ---
-** inhibit-modification-hooks now also inhibits lock-file checks, as well as
-active region handling.
+** 'inhibit-modification-hooks' now also inhibits lock-file checks, as
+well as active region handling.
 
 +++
-** deactivate-mark is now buffer-local.
+** 'deactivate-mark' is now buffer-local.
 
 +++
 ** 'cl-the' now asserts that its argument is of the given type.
 
 +++
 ** 'process-running-child-p' may now return a numeric process
-group ID instead of 't'.
+group ID instead of t.
 
 +++
 ** Mouse click events on mode line or header line no longer include
@@ -1916,7 +1919,7 @@ position list returned for such events is now nil.
 ---
 ** Menu items in keymaps do not support the "key shortcut cache" any more.
 These slots used to hold key-shortcut data, but have been obsolete since
-Emacs-21.
+Emacs 21.
 
 ---
 ** Emacs no longer downcases the first letter of a system diagnostic
@@ -1942,7 +1945,7 @@ not affected by 'text-quoting-style', e.g., (message "%s" (format
 "...." foo bar)).
 
 +++
-** substitute-command-keys now replaces quotes.
+** 'substitute-command-keys' now replaces quotes.
 That is, it converts documentation strings' quoting style as per the
 value of 'text-quoting-style'.  Doc strings in source code can use
 either curved single quotes or grave accents and apostrophes.  As
@@ -1986,7 +1989,7 @@ that happen, 'unhandled-file-name-directory' now defaults to calling
 
 * Lisp Changes in Emacs 25.1
 
-** pcase
+** 'pcase'
 +++
 *** New UPatterns 'quote', 'app'.
 +++
@@ -1995,7 +1998,7 @@ that happen, 'unhandled-file-name-directory' now defaults to calling
 *** New vector QPattern.
 
 ---
-** syntax-propertize is now automatically called on-demand during forward
+** 'syntax-propertize' is now automatically called on-demand during forward
 parsing functions like 'forward-sexp'.
 
 +++
@@ -2010,7 +2013,7 @@ file byte offsets, given the file's encoding.
 
 +++
 ** The default value of 'load-read-function' is now 'read'.
-Previously, the default value of 'nil' implied using 'read'.
+Previously, the default value of nil implied using 'read'.
 
 +++
 ** New hook 'pre-redisplay-functions'.
@@ -2027,13 +2030,13 @@ implemented by the new 'cursor-intangible-mode' and
 'cursor-sensor-mode' minor modes.
 
 +++
-** 'inhibit-point-motion-hooks' now defaults to 't' and is obsolete.
+** 'inhibit-point-motion-hooks' now defaults to t and is obsolete.
 Use the new minor modes 'cursor-intangible-mode' and
 'cursor-sensor-mode' instead.
 
 +++
 ** New process type 'pipe', which can be used in combination with the
-':stderr' keyword of make-process to handle standard error output
+':stderr' keyword of 'make-process' to handle standard error output
 of subprocess.
 
 +++
@@ -2043,13 +2046,21 @@ process filter, sentinel, etc., through keyword arguments (similar to
 'make-network-process').
 
 +++
+** Subprocesses are automatically told about changes in window dimensions
+The new option 'window-adjust-process-window-size-function' controls
+how subprocesses are told to adapt their logical window sizes to
+changes in the Emacs window configuration.  Its default value calls
+'set-process-window-size' with the smallest dimensions of all the
+windows that display the subprocess's buffer.
+
++++
 ** A new function 'directory-files-recursively' returns all matching
 files (recursively) under a directory.
 
 +++
 ** New variable 'inhibit-message', when bound to non-nil, inhibits
 'message' and related functions from displaying messages in the echo
-area.  The output is still logged to the *Messages* buffer.
+area.  The output is still logged to the '*Messages*' buffer.
 
 +++
 ** A new text property 'inhibit-read-only' can be used in read-only
@@ -2057,8 +2068,8 @@ buffers to allow certain parts of the text to be writable.
 
 +++
 ** A new variable 'comment-end-can-be-escaped' is useful in languages
-   such as C and C++ where line comments with escaped newlines are
-   continued to the next line.
+such as C and C++ where line comments with escaped newlines are
+continued to the next line.
 
 +++
 ** New macro 'define-advice'.
@@ -2073,24 +2084,24 @@ See the "Finalizer Type" subsection in the ELisp manual for the
 details.
 
 ---
-** lexical closures can use (:documentation FORM) to build their docstring.
+** Lexical closures can use '(:documentation FORM)' to build their docstring.
 It should be placed right where the docstring would be, and FORM is then
 evaluated (and should return a string) when the closure is built.
 
 +++
-** define-inline provides a new way to define inlinable functions.
+** 'define-inline' provides a new way to define inlinable functions.
 
 +++
 ** New function 'macroexpand-1' to perform a single step of macro expansion.
 
 +++
 ** Some "x-*" functions were obsoleted and/or renamed:
-*** x-select-text is renamed gui-select-text.
-*** x-selection-value is renamed gui-selection-value.
-*** x-get-selection is renamed gui-get-selection.
-*** x-get-clipboard and x-clipboard-yank are marked obsolete.
-*** x-get-selection-value is renamed to gui-get-primary-selection.
-*** x-set-selection is renamed to gui-set-selection
+*** 'x-select-text' is renamed 'gui-select-text'.
+*** 'x-selection-value' is renamed 'gui-selection-value'.
+*** 'x-get-selection' is renamed 'gui-get-selection'.
+*** 'x-get-clipboard' and 'x-clipboard-yank' are marked obsolete.
+*** 'x-get-selection-value' is renamed to 'gui-get-primary-selection'.
+*** 'x-set-selection' is renamed to 'gui-set-selection'.
 
 +++
 ** New function 'string-greaterp', which return the opposite result of
@@ -2149,9 +2160,9 @@ text and directional control characters.
 
 +++
 ** New properties that can be specified with 'declare':
-*** (interactive-only INSTEAD), says to use INSTEAD for non-interactive use.
-*** (pure VAL), if VAL is non-nil, indicates the function is pure.
-*** (side-effect-free VAL), if VAL is non-nil, indicates the function does not
+*** '(interactive-only INSTEAD)', says to use INSTEAD for non-interactive use.
+*** '(pure VAL)', if VAL is non-nil, indicates the function is pure.
+*** '(side-effect-free VAL)', if VAL is non-nil, indicates the function does not
 have side effects.
 
 +++
@@ -2210,10 +2221,12 @@ font, and (iii) the specified window.
 
 ---
 ** New utilities in subr-x.el:
+
 *** New macros 'if-let' and 'when-let' allow defining bindings and to
-    execute code depending whether all values are true.
+execute code depending whether all values are true.
+
 *** New macros 'thread-first' and 'thread-last' allow threading a form
-    as the first or last argument of subsequent forms.
+as the first or last argument of subsequent forms.
 
 +++
 ** Documentation strings now support quoting with curved single quotes
@@ -2232,7 +2245,7 @@ curved single quotes, grave accents and apostrophes as per
 'text-quoting-style'.
 
 +++
-** show-help-function's arg is converted via substitute-command-keys
+** 'show-help-function's arg is converted via 'substitute-command-keys'
 before being passed to the function.  Help strings, help-echo
 properties, etc. can therefore contain command key escapes and
 quotation marks.
@@ -2282,12 +2295,12 @@ the name is a directory separator character (forward slash on GNU and
 Unix systems, forward- or backslash on MS-Windows and MS-DOS).
 
 ---
-** ASCII approximations to curved quotes are put in standard-display-table
+** ASCII approximations to curved quotes are put in 'standard-display-table'
 if the terminal cannot display curved quotes.
 
 +++
 ** Standard output and error streams now transliterate characters via
-standard-display-table, and encode output using locale-coding-system.
+'standard-display-table', and encode output using 'locale-coding-system'.
 To force a specific encoding, bind 'coding-system-for-write' to the
 coding-system of your choice when invoking functions like 'prin1' and
 'message'.
@@ -2314,30 +2327,30 @@ provide toolkit scroll bars, namely Gtk+, Lucid, Motif and Windows.
 Horizontal scroll bars are turned off by default.
 
 **** New function 'horizontal-scroll-bars-available-p' telling whether
-    horizontal scroll bars are available on the underlying system.
+horizontal scroll bars are available on the underlying system.
 
 **** New mode 'horizontal-scroll-bar-mode' to toggle horizontal scroll
-    bars on all existing and future frames.
+bars on all existing and future frames.
 
 **** New function 'toggle-horizontal-scroll-bar' to toggle horizontal
-    scroll bars on the selected frame.
+scroll bars on the selected frame.
 
 **** New frame parameters 'horizontal-scroll-bars' and
-    'scroll-bar-height' to set horizontal scroll bars and their height
-    for individual frames and in 'default-frame-alist'.
+'scroll-bar-height' to set horizontal scroll bars and their height
+for individual frames and in 'default-frame-alist'.
 
 **** New functions 'frame-scroll-bar-height' and
-    'window-scroll-bar-height' return the height of horizontal scroll
-    bars on a specific frame or window.
+'window-scroll-bar-height' return the height of horizontal scroll
+bars on a specific frame or window.
 
 **** 'set-window-scroll-bars' now accepts five parameters where the last
-    two specify height and type of the window's horizontal scroll bar.
+two specify height and type of the window's horizontal scroll bar.
 
 **** 'window-scroll-bars' now returns type and sizes of horizontal scroll
-    bars too.
+bars too.
 
 **** New buffer-local variables 'horizontal-scroll-bar' and
-    'scroll-bar-height'.
+'scroll-bar-height'.
 
 +++
 *** New functions 'frame-geometry' and 'frame-edges' give access to a
@@ -2376,10 +2389,11 @@ they display when setting default font, menu bar, fringe width, or
 scroll bars.  In particular, maximized and fullscreen frames are
 conceptually never resized if such settings change.  For fullheight and
 fullwidth frames, the behavior may depend on the toolkit used.
+
 **** New option 'frame-inhibit-implied-resize' if non-nil, means that
-   setting default font, menu bar, fringe width, or scroll bars of a
-   specific frame does not resize that frame in order to preserve the
-   number of columns or lines it displays.
+setting default font, menu bar, fringe width, or scroll bars of a
+specific frame does not resize that frame in order to preserve the
+number of columns or lines it displays.
 
 +++
 *** New function 'window-preserve-size' allows you to preserve the size of
@@ -2449,7 +2463,7 @@ whitespace at line beginning.
 * Changes in Emacs 25.1 on Non-Free Operating Systems
 
 ---
-** MS-Windows specific Emacs build scripts are no longer in the distribution
+** MS-Windows specific Emacs build scripts are no longer in the distribution.
 This includes the makefile.w32-in files in various subdirectories, and
 the support files.  The file nt/configure.bat now just tells the user
 to use the procedure described in nt/INSTALL, by running the Posix
diff --git a/lisp/progmodes/xref.el b/lisp/progmodes/xref.el
index f651dc9cd18..05cd97932a3 100644
--- a/lisp/progmodes/xref.el
+++ b/lisp/progmodes/xref.el
@@ -624,7 +624,9 @@ references displayed in the current *xref* buffer."
       (setq pairs (cdr buf-pairs))
       (setq continue
             (perform-replace from to t t nil nil multi-query-replace-map)))
-    (unless did-it-once (user-error "No suitable matches here"))))
+    (unless did-it-once (user-error "No suitable matches here"))
+    (when (and continue (not buf-pairs))
+      (message "All results processed"))))
 
 (defvar xref--xref-buffer-mode-map
   (let ((map (make-sparse-keymap)))
diff --git a/src/editfns.c b/src/editfns.c
index 0e1a6e3415f..afcf1cab72b 100644
--- a/src/editfns.c
+++ b/src/editfns.c
@@ -2535,7 +2535,7 @@ insert1 (Lisp_Object arg)
 
 DEFUN ("insert", Finsert, Sinsert, 0, MANY, 0,
        doc: /* Insert the arguments, either strings or characters, at point.
-Point and before-insertion markers move forward to end up
+Point and after-insertion markers move forward to end up
  after the inserted text.
 Any other markers at the point of insertion remain before the text.
 
@@ -2559,7 +2559,7 @@ usage: (insert &rest ARGS)  */)
 DEFUN ("insert-and-inherit", Finsert_and_inherit, Sinsert_and_inherit,
    0, MANY, 0,
        doc: /* Insert the arguments at point, inheriting properties from adjoining text.
-Point and before-insertion markers move forward to end up
+Point and after-insertion markers move forward to end up
  after the inserted text.
 Any other markers at the point of insertion remain before the text.
 
diff --git a/src/process.c b/src/process.c
index 2d0fb567943..3e66949b690 100644
--- a/src/process.c
+++ b/src/process.c
@@ -1134,7 +1134,9 @@ See `set-process-sentinel' for more info on sentinels.  */)
 
 DEFUN ("set-process-window-size", Fset_process_window_size,
        Sset_process_window_size, 3, 3, 0,
-       doc: /* Tell PROCESS that it has logical window size HEIGHT and WIDTH.  */)
+       doc: /* Tell PROCESS that it has logical window size WIDTH by HEIGHT.
+Value is t if PROCESS was successfully told about the window size,
+nil otherwise.  */)
   (Lisp_Object process, Lisp_Object height, Lisp_Object width)
 {
   CHECK_PROCESS (process);