Merge from origin/emacs-25

50650cb Doc fixes for fclist and grep
5e814e0 Minor doc fixes for quoting
3347a73 `nreverse' the marker pairs list
1a4127d Use save-excursion in xref-location-marker more
ab3ba91 shell-quote-argument DIR when appropriate
922c7a3 Rework xref-query-replace-in-results
3fe3510 * lisp/replace.el (query-replace-read-from): Use minibuffer-w...
0932b94 Fix todo-mode bug involving archived items (bug#23447)
e68ad1f ; * etc/NEWS: Tiny edit. (Bug#23432)
adc80b7 ; * test/automated/xref-tests.el: Add copyright and license.
4d8fd9c Handle "empty line" regexp in xref searches
f559b37 Add tests for xref-collect-matches
6428aa0 Use grep-find-ignored-directories instead of vc-directory-exc...
6f82d8e Clear buffer-undo-list when showing xrefs
c68a091 Note the quote translation in `message' in section "incompati...
52f86a7 * etc/NEWS: Mention (message "%s" (format ...)).
93703c5 (Common Keywords): Correct what missing :group means
79e5800 Improve documentation of Dired's 'A' and 'Q' commands
2ea2a2f Doc fixes for quoting
8544b98 posnp doc clarification
805204f Mention what a missing :group does
ec554d7 Fix documentation of dired-aux search/replace commands

Doc fixes for fclist and grep

A newline is needed between two fc-list calls.
egrep and fgrep have been withdrawn from POSIX,
so document grep -E and grep -F instead.

Support completion of HTML tags in CSS selectors

* lisp/textmodes/css-mode.el (css--html-tags): New variable holding a
list of HTML tags for completion.
(css--nested-selectors-allowed): New variable for determining whether
nested selectors are allowed in the current mode.
(css--complete-selector): New function for completing part of a CSS
selector.
(css-completion-at-point): Support completion of selectors.
(scss-mode): Allow nested selectors.

Make `R' in eww work more reliably

* lisp/net/eww.el (eww-score-readability): Protect against
null children.

Minor doc fixes for quoting

* doc/lispref/control.texi (Signaling Errors):
* doc/lispref/display.texi (Displaying Messages):
Don’t say that formats “generate”.  Try to word more clearly.
* etc/NEWS: Coalesce near-duplicate entries.

`nreverse' the marker pairs list

* lisp/progmodes/xref.el (xref--buf-pairs-iterator): `nreverse'
the marker pairs list for each buffer before returning.

Call hack-local-variables from major modes rather than from file visiting

This prevents file/directory local variables from being lost when the major
mode is set or changed.

This fixes bug #15577 and bug #23407.

* lisp/files.el (normal-mode): Call `hack-local-variables' when the major mode
function hasn't already done so.
(hack-local-variables): Rename parameter `mode-only' to `handle-mode', make
its previous non-nil setting be t, and introduce the following action for a
non-nil non-t value: apply all settings apart from `mode'.

* lisp/subr.el (run-mode-hooks): call `hack-local-variables' for buffers
which are visiting files.

* doc/emacs/custom.texi (File Variables): Note that setting a major mode also
sets file variables.
(Directory Variables): Note that `mode', `eval', and `unibyte' can be set as
dir local variables, but `coding' can't.

* doc/lispref/modes.texi (Major Mode Conventions): Say that `run-mode-hooks'
also calls `hack-local-variables'.
(Auto Major Mode): Say that `find-file' no longer runs `hack-local-variables',
as from 25.2.  Remove vagueness from `normal-mode' and `set-auto-mode' by
saying that the mode IS SET, not merely "selected" or "chosen".
(Mode Hooks): Document change to `run-mode-hooks'.

* doc/lispref/variables.texi (File Local Variables): Document change to
`hack-local-variables'.

tramp-sh.el: Work around a stat bug

* lisp/net/tramp-sh.el (tramp-get-remote-stat): Do not use
stat versions which produce shell quoted output.  See also
coreutils Bug#23422.

Fix autogen.sh for separate worktrees

* autogen.sh: Use the $hooks variable in the $sample_hooks loop, instead
of assuming .git/hooks is a directory.

Use save-excursion in xref-location-marker more

* lisp/progmodes/elisp-mode.el (xref-location-marker): Use
save-excursion, in order not to alter the value of point if the
buffer is currently open in the background (problem reported by
Robert Weiner).

* lisp/progmodes/etags.el (xref-location-marker): Same.

shell-quote-argument DIR when appropriate

* lisp/progmodes/project.el (project-file-completion-table):
`shell-quote-argument' DIR as well.

* lisp/progmodes/xref.el (xref--rgrep-command): Pass DIR through
`shell-quote-argument' (bug#23453).  Thanks for Kaushal Modi for
pointing out the problem.  Assert that DIR doesn't start with `~'.

Rework xref-query-replace-in-results

* lisp/progmodes/xref.el (xref-query-replace-in-results): Collect
all xrefs from the buffer first, then delegate most of the
processing to the value returned by xref--buf-pairs-iterator.
(xref--buf-pairs-iterator): New function.  Return an "iterator"
which partitions returned markers into buffers, and only processes
markers from one buffer at a time.  When an xref is out of date,
skip it with a message instead of signaling error (bug#23284).
(xref--outdated-p): Extract from xref--buf-pairs-iterator.  Trim
CR from both strings before comparing.
(xref--query-replace-1): Remove the variable current-buf, no need
to track it anymore.  Simplify the filter-predicate and search
functions accordingly.  Iterate over buffer-markers pairs returned
by the iterator, and call `perform-replace' for each of them.  Use
multi-query-replace-map (bug#23284).  Use `switch-to-buffer' every
time after the first, in order not to jump between windows.

* test/automated/xref-tests.el
(xref--buf-pairs-iterator-groups-markers-by-buffers-1)
(xref--buf-pairs-iterator-groups-markers-by-buffers-2)
(xref--buf-pairs-iterator-cleans-up-markers): New tests.

* lisp/replace.el (query-replace-read-from): Use minibuffer-with-setup-hook

to set minibuffer-local value of text-property-default-nonsticky.
(Bug#23418, bug#23127)

Allow `text-quoting-style' to be `leave', i.e. no translation of quotes.

* lisp/help-fns.el (describe-function-1): Don't set coding system to UTF-8
when text-quoting-style is `leave'.

* src/lisp.h (enum text_quoting_style): Add identifier LEAVE_QUOTING_STYLE.

* src/doc.c (syms_of_doc): New symbol "leave".  Amend doc string of
`text_quoting_style'.
(text_quoting_style): Handle `leave' by returning LEAVE_QUOTING_STYLE.
(Fsubstitute_command_keys): Don't translate quotes when quoting_style is
LEAVE_QUOTING_STYLE.

* src/editfns.c (styled_format): Set quoting_style to -1 when
text-quoting-style is `leave'.

Fix todo-mode bug involving archived items (bug#23447)

* lisp/calendar/todo-mode.el (todo-jump-to-category): When jumping
from Todo Categories mode to a category with only archived items
and todo-skip-archived-categories is non-nil, make sure the
archive file buffer is in Todo Archive mode to prevent
todo-category-select from raising an error, and don't set
todo-current-todo-file, since that makes todo-show display the
archived category.  Remove a no-op call to kill-buffer, which is
already called in todo-insert-category-line.

; * etc/NEWS: Tiny edit. (Bug#23432)

* lisp/emulation/viper(-cmd)?.el: Use lexical-binding.

* lisp/emulation/viper-cmd.el: Use lexical-binding.
(viper-change-state-to-vi, viper-change-state-to-emacs): Allow dummy
args, for use in advice-add.
(viper--init-message): Rename from init-message.
(viper-minibuffer-standard-hook): Adjust accordingly.
(viper-undo): Remove unused var `modified'.
(viper-read-string-with-history, viper-set-searchstyle-toggling-macros):
Don't use dynamic vars as args.
(viper-submit-report): Clarify use of dynamic vars.

* lisp/emulation/viper.el: Use lexical-binding and nadvice.
Remove redundant :group keywords.  Group the (if viper-mode) at top-level.
Use add-function rather than a `(lambda ...).
(viper--advice-list): New var.
(viper--advice-add, viper--deactivate-advice-list): New funs.
(viper-go-away, viper-set-hooks, viper-non-hook-settings): Use them.
(viper-non-hook-settings): Don't hook into find-file any more.

* lisp/vc/ediff-util.el: Use lexical-binding.

* lisp/progmodes/js.el (js-syntax-propertize): Recognize shebang line.

; * test/automated/xref-tests.el: Add copyright and license.

Add an animation sanity check

* lisp/image.el (image-multi-frame-p): Give up on animations
if it seems like they are too slow (bug#23431).

Handle "empty line" regexp in xref searches

* lisp/progmodes/xref.el (xref--collect-matches-1): Stop after one
match if re-search-forward doesn't move point (bug#23426).

* test/automated/xref-tests.el
(xref-collect-matches-finds-an-empty-line-regexp-match):
Uncomment test.

Add tests for xref-collect-matches

* test/automated/xref-tests.el: New file.  Add tests for
xref-collect-matches.

Use grep-find-ignored-directories instead of vc-directory-exclusion-list

* lisp/dired-aux.el (dired-do-find-regexp):
Use grep-find-ignored-directories instead of
vc-directory-exclusion-list.  The result should be functionally
similar (the former uses the latter as the default value), but it
should be more consistent and appropriate WRT user
customizations.
(dired-do-find-regexp-and-replace): Update the docstring.

* lisp/dired.el: Update the corresponding autoloads.

* doc/emacs/dired.texi (Operating on Files): Update the
documentation accordingly.

Clear buffer-undo-list when showing xrefs

* lisp/progmodes/xref.el (xref--show-xref-buffer): Clear
buffer-undo-list and temporarily bind it to t while rendering the
buffer contents.

Note the quote translation in `message' in section "incompatible changes".

* etc/NEWS: Note that `message' translates quotes, that the translation
cannot be disabled, and that `format' can be used to get the old
behavior back.

* etc/NEWS: Mention (message "%s" (format ...)).

abbrev-tests.el fix

* test/lisp/abbrev-tests.el (abbrev-table-p-test): Don't check
internal implementation detail.

(Common Keywords): Correct what missing :group means

* doc/lispref/customize.texi (Common Keywords): Correct what
missing :group means.

Improve documentation of Dired's 'A' and 'Q' commands

* lisp/dired-aux.el (dired-do-find-regexp)
(dired-do-find-regexp-and-replace): Mention
'grep-find-ignored-files' and 'vc-directory-exclusion-list', and
also the fact that REGEXP should be palatable by Grep.  (Bug#23426)
* lisp/dired.el: Update the corresponding autoload forms.

* doc/emacs/dired.texi (Operating on Files): Mention
'grep-find-ignored-files' and 'vc-directory-exclusion-list'.
(Bug#23429)

(shr-rescale-image): Clarify logic slightly

* lisp/net/shr.el (shr-rescale-image): Clarify logic slightly.

Doc fixes for quoting

* doc/emacs/text.texi, doc/lispintro/emacs-lisp-intro.texi:
* doc/lispref/control.texi, doc/lispref/display.texi:
* doc/lispref/help.texi, doc/lispref/strings.texi, lisp/subr.el:
* src/callint.c, src/doprnt.c, src/editfns.c:
Document quoting a bit more systematically.
Problem reported by Alan Mackenzie (Bug#23425).

Bind `widget-button-click' to mouse-1/-2 instead of down-mouse-1/-2

* lisp/wid-edit.el (widget-keymap): Bind `widget-button-click'
to mouse-1/-2 instead of down-mouse-1/-2.  Suggested by Stefan
Monnier.  (Bug#19185, Bug#20398)

Add more abbrev tests

* test/lisp/abbrev-tests.el
(clear-abbrev-table-test): Use `abbrev-expansion'
(abbrev-table-empty-p-test, list-abbrevs-test)
(prepare-abbrev-list-buffer-test, insert-abbrevs-test)
(edit-abbrevs-test, define-abbrevs-test)
(read-write-abbrev-file-test)
(abbrev-edit-save-to-file-test): New tests (bug#23139).

posnp doc clarification

* lisp/subr.el (posnp): Mention that a posn object is returned
from `event-start' (bug#18211).

Mention what a missing :group does

* doc/lispref/customize.texi (Common Keywords): Document that
a missing :group reuses the group from the preceding item (bug#21601).

Allow eval-ing named character literals

* lisp/progmodes/elisp-mode.el (elisp--preceding-sexp): Skip over
named character literals.
* test/lisp/progmodes/elisp-mode-tests.el
(elisp--preceding-sexp--char-name): Add test for skipping over
named character literals (bug#23354).

Copyright-paperwork-exempt: yes

Call va_end in boot_error

* src/gnutls.c (boot_error): A recent change added a function
to signal an error or return an error code. That function uses
a variadic argument list to populate an error message
string. However, it missed calling va_end after using the
variadic argument list.

  Copyright-paperwork-exempt: yes

Fix the call to set_network_coding_system

* src/process.c (Fmake_network_process): A recent commit
modified the set_network_socket_coding_system function to take
arguments host, service, and name. However, those arguments
appear to be swapped.

  Copyright-paperwork-exempt: yes

Fix documentation of dired-aux search/replace commands

* lisp/dired-aux.el (dired-do-find-regexp)
(dired-do-find-regexp-and-replace): Doc fixes.  (Bug#23429)
* lisp/dired.el: Update the corresponding autoload forms.

Revert "alas, a map can have only one parent"

This reverts commit d05806fda1cbba2db112bc783597fbe9d27175b2.

This had already been fixed by using `make-composed-map'.  And
we don't want image-map to inherit from special-mode-map, anyway.

Merge from origin/emacs-25

bf21c84 Fix quoting problem in cc-engine debug message
8f36614 Add electric-quote-string unit test
6280531 Don’t electrically quote ‘'’ in Python
fd7b430 `nreverse' Grep hits before passing them to xref--convert-hits

Fix quoting problem in cc-engine debug message

* lisp/progmodes/cc-engine.el (c-replay-parse-state-state):
Use "%s" format to pass through ‘'’ unscathed (Bug#23425), and
likewise for ‘`’, and ‘%’.

Add electric-quote-string unit test

* test/automated/electric-tests.el (electric-quote-string): New test.

Don’t electrically quote ‘'’ in Python

Problem reported by Philipp Stephani (Bug#23387).
* lisp/electric.el (electric-quote-post-self-insert-function):
Do not requote a string starter or ender.

alas, a map can have only one parent

* lisp/image-mode.el (image-model-map): Cannot have two parents.
* lisp/image.el (image-map): Inherit from `special-mode-map'.

; Fix last commit in tramp-tests.el

`nreverse' Grep hits before passing them to xref--convert-hits

* lisp/progmodes/xref.el (xref-collect-matches): `nreverse' hits
before passing them to xref--convert-hits.  Fixes a regression
from cc0b7132.

Fix Bug#10085

* lisp/net/tramp.el (tramp-find-foreign-file-name-handler):
Add optional arguments OPERATION and COMPETION.  Handle
`file-name-as-directory', `file-name-directory' and
`file-name-nondirectory' also in completion mode.
(tramp-file-name-handler): Use it.  (Bug#10085)

* test/lisp/net/tramp-tests.el (tramp-test06-directory-file-name):
Extend test.

* src/minibuf.c (read_minibuf): Use CONSP instead of Fconsp.

Tweak .gitignore

* .gitignore: Remove leim/changed.misc, leim/changed.tit,
as these files are no longer created.  Add gmon.out, for
-pg profiling.  Sort.

; Spelling and quoting fixes

Sync from gnulib

This incorporates:
2016-05-01 mktime: port to stricter signed overflow checking
2016-05-01 mktime: speed up DEBUG_MKTIME benchmarks
2016-05-01 mktime: resurrect DEBUG_MKTIME testing
2016-05-01 mktime: simplify DEBUG_MKTIME
2016-05-01 Port mktime_internal offset to unsigned time_t
2016-04-27 xstrtol: prohibit monstrosities like "1bB"
2016-04-13 mktime: improve integer overflow checking
2016-04-13 intprops: check two's complement assumption
2016-04-13 intprops, mktime, strtol: assume two's complement
* lib/intprops.h, lib/mktime-internal.h, lib/mktime.c:
* lib/strtol.c, lib/timegm.c, m4/mktime.m4, m4/std-gnu11.m4:
Copy from gnulib.

; Fix texinfo typo

Merge from origin/emacs-25

c695fb3 ; Spelling fixes
03750c0 * doc/misc/texinfo.tex: Sync from gnulib.
42fed3b * lisp/isearch.el (isearch-forward-symbol-at-point): Add isea...

; Merge from origin/emacs-25

The following commits were skipped:

8aa4147 tramp.texi: Revert last change due to backward compatibility
69f7940 cua-prefix-override-inhibit-delay doc fix
350792e global-eldoc-mode doc fix
c3b3b90 normal-top-level-add-subdirs-to-load-path doc fix
9f27bcf isearch-search-fun-function doc tweak
78ae805 Fill some imenu--index-alist doc lines
d1ab001 Fmarker_position doc string clarification
8c66ebf Further define-obsolete-* doc fixups
25b4cf3 Describe WHEN in all the define-obsolete- macros
6b39501 Mention with-silent-modifications in the lispref manual
9722ae1 with-silent-modifications doc clarification
3bc26a7 clear-visited-file-modtime doc string fix
7b7b4c2 Document mode mode line variables
7907b82 Add a cross ref to Optional Mode Line
ecdb340 Add a doc string to display-time-string
6d8c2d0 custom-buffer-style doc fix
ef32be6 Rearrange the doc of query-replace slightly
7350d3d apropos-print doc fix
afb2257 completion-table-with-predicate doc string fix
f3f4502 Fill the completion-table-with-predicate doc string
983ad8d replace-match-maybe-edit doc clarification
bbda22c add-timeout doc fix
818fb69 Extremely minor doc fix in Choosing Window
2abc85e Transform mentions of `eval-after-load' to `with-eval-after-l...
ec392ff cursor-type doc fix
ff834ff Add a link from Tool Bar to Images
93598ff (default-mode-line-format): More explicit obsolete info
b04fcc4 Fcompare_buffer_substrings doc string clarification
f92d0aa insert-file-contents-literally doc fix
ad5572b Fix custom types for cursor-in-non-selected-windows
2ef780f Doc clarification to mwheel-scroll
ed8474e Clarify the doc of eval-expression-print-format
8f1e784 Explictly explain that package-initialize loads the packages
1378680 Have the doc strings of `load-path' and `require' mention eac...
a73de71 Doc fix for insert-pair-alist
619f1ed Move doc of backup-directory-alist to the Backup node
0846f21 Tiny doc clarification for create-fontset-from-fontset-spec
925af7e Fill the doc string of font-lock-keywords
05194cb Doc fix for font-lock-remove-keywords
7a03d55 Clarify whitespace-style doc string
651182d Doc fixed for next-error-buffer-p
d815ba5 Tiny doc fix
7b85885 Doc fix
c355774 delsel doc touch ups
4a2f33d Doc fixes for menu-bar.el
71795d4 Doc fix
3852fd6 Minor doc clarification
db20f89 Fill font-lock-mode doc string
df6cee9 Wrap the auto-generated doc string
dc960d9 Clarify hi-lock-find-patterns
8748c21 Add a doc string to `winner-mode'
02c1aa8 Doc fix for align-newline-and-indent
bc6c294 Doc fix for `kbd'
28ef870 Doc tweak
92559c7 Link from (emacs)Exiting to (lisp)Killing Emacs
cc00738 find-lisp doc touchups
396747d Don't have the manual claim that it lists all CL incompatibil...
3cbc1e3 Change all occurrences of "Mouse-[0-9]" to "mouse-[0-9]"
de8349e Doc string change to enable-recursive-minibuffers
cf33ae0 Clarify the `interactive' doc string slightly
0a14d84 Clarify some doc strings
351c079 Add some concept index entries for custom types
3fc1ed8 Mention `lisp-indent-function' in the lispref manual
9bd2af8 Clarify doc string of internal compilation function

Merge from origin/emacs-25

d8affa3 Use ‘T *restrict’ proto, not ‘T[restrict]’
d38d2a8 Fix documentation of 'url-retrieve-synchronously'
586b213 * lisp/url/url.el (url-retrieve-synchronously): Doc fix.  (Bu...

# Conflicts:
# doc/misc/url.texi
# lisp/url/url.el

; Merge from origin/emacs-25

The following commit was skipped:

3cade20 ; Auto-commit of loaddefs files.

Merge from origin/emacs-25

16e5e8e Fix last change to isearch-update (bug#23406)
b755d98 Autoload cursor-sensor-inhibit (bug#23406)
b52ebd4 org-map-entries: Fix org-agenda-prepare-buffers call
86aa409 Followup for last commit in the user manual
7004459 Improve doc string of 'set-goal-column'
ccdaf04 Fix the MSDOS build
ffe701c Remove \= from format string (bug#18190)
1c58fa1 Fix variable-pitch font on MS-Windows
c6077bf Restore follow-scroll-up/down to scrolling by the combined si...
b671e21 Revert unneeded change which harms syntactic parsing.  This f...
48b24c9 Correct indentation of ids in a C++ enum after a protection k...
5c3534f * lisp/window.el (window--process-window-list): No-op if no p...
734fb3a Port dumping to NetBSD with PaX
0255a70 Don't mistake `for' inside a function for a part of array com...

# Conflicts:
# src/Makefile.in

; Merge from origin/emacs-25

The following commit was skipped:

ff7e201 Fix bug#22891: wrong terminal width when a fringe width is zero.

Merge from origin/emacs-25

71fb0e0 Improve last change to vc-git-mode-line-string
6858e77 Todo mode doc bug fix
e55d0db Fix revision calculation in vc-git-mode-line-string
ca87b34 ; Fix errant revert ccb75d7
40bfebe Add Python 3.5 keyword "await"
fa7886a Add new keywords of Python 3.5
ccb75d7 Partially revert previous change.
8ee168a ; * etc/NEWS: Update entry about color fonts on OS X with a w...
b09ca27 Say why text-quoting-style is not a user option

; Merge from origin/emacs-25

The following commits were skipped:

935715a * lisp/emacs-lisp/autoload.el (update-directory-autoloads): F...
6ac9892 ; Auto-commit of loaddefs files.

Merge from origin/emacs-25

5a952eb Don't mention ~/.emacs.bmk literally in doc strings
c338cf3 * etc/NEWS: Explain why multicolor font display is disabled o...
c30d1b4 Port to Ubuntu 16.04 --enable-gcc-warnings

; Spelling fixes

* doc/misc/texinfo.tex: Sync from gnulib.

Mention the `find-library-name' changes

* lisp/isearch.el (isearch-forward-symbol-at-point): Add isearch-push-state.

(Bug#23410)

Fix text in menu in minor-mode-menu-from-indicator

* lisp/mouse.el (minor-mode-menu-from-indicator): Don't
capitalize "Off" in "Turn Off" (bug#11028).

gitmerge: Add cherry pick to gitmerge-skip-regexp

* gitmerge.el (gitmerge-skip-regexp): Add "cherry picked from commit",
  which is the string appended by 'git cherry-pick -x'.

Allow `global-set-key' to bind keys under the `M-o' map

* lisp/subr.el (global-set-key): Allow binding keys under the
`M-o' map (bug#9730).

Add `size-indication-mode' to the menu on `mouse-1' "Top"

* lisp/bindings.el (mode-line-column-line-number-mode-map):
Add `size-indication-mode' to the menu (bug#5727).

tramp.texi: Revert last change due to backward compatibility

(cherry picked from commit 910f9a0a936aacbffe9b9b790d7f698dfd287aac)

cua-prefix-override-inhibit-delay doc fix

* lisp/emulation/cua-base.el
(cua-prefix-override-inhibit-delay): Typo fix in doc string
(bug#23401).

(cherry picked from commit 2b4c099822811ede787fc6e575bfbb17b3cc0681)

global-eldoc-mode doc fix

* lisp/emacs-lisp/eldoc.el (global-eldoc-mode): Be more
specific about what "applicable" means (bug#23071).

(cherry picked from commit 25e95b5dd8cd92e03788e589bf99a4b399f03114)

normal-top-level-add-subdirs-to-load-path doc fix

* lisp/startup.el (normal-top-level-add-subdirs-to-load-path):
Doc fix (bug#21962).

(cherry picked from commit 28aaa6d20586e3330a23b017a65e56dd6461c003)

isearch-search-fun-function doc tweak

* lisp/isearch.el (isearch-search-fun-function): Mention what
the STRING parameter is (bug#21552).

(cherry picked from commit cafc2a5940cdc523cfea6dcf1cf540f48367c62a)

Fill some imenu--index-alist doc lines

* lisp/imenu.el (imenu--index-alist): Fill some doc lines (bug#21269).

(cherry picked from commit 4b7bb8f596550628eaa83b82c0f7eabe59a84964)

Fmarker_position doc string clarification

* src/marker.c (Fmarker_position): Clarify the doc string
(bug#21231).

(cherry picked from commit eeac7c57273cec3f9408b18392dd2bafe3be4450)

Further define-obsolete-* doc fixups

* lisp/emacs-lisp/byte-run.el (define-obsolete-face-alias):
Fix up last change.
(define-obsolete-variable-alias): Ditto.

(cherry picked from commit 28e9f4390d8391c2c36be4ef515cf3a2c679a5a5)

Describe WHEN in all the define-obsolete- macros

* lisp/emacs-lisp/byte-run.el (define-obsolete-face-alias):
Say more verbosely what WHEN is (bug#21225).
(define-obsolete-function-alias): Describe the WHEN parameter.
(define-obsolete-variable-alias): Ditto.

(cherry picked from commit 247c388f160581d207e41ca5926990bbf69d4a0f)

Mention with-silent-modifications in the lispref manual

* doc/lispref/text.texi (Changing Properties): Document
with-silent-modifications (bug#21171).

(cherry picked from commit fcd0d854eef6e439d51e8f07cf734d5e34e502b3)

with-silent-modifications doc clarification

* lisp/subr.el (with-silent-modifications): Rearrange the doc
string a bit so that the most pertinent information is at the
top (bug#21171).

(cherry picked from commit e0e70f030e69d9696a963a86f5f7caaff4df06eb)

clear-visited-file-modtime doc string fix

* lisp/files.el (clear-visited-file-modtime): Fix possibly
confusing doc string wording (bug#21169).

(cherry picked from commit 1aaeaf1450756a71c9254a2a5b174c72084ca67a)

Document mode mode line variables

* doc/lispref/modes.texi (Mode Line Variables): Document
`mode-line-front-space, `mode-line-misc-info',
`mode-line-end-spaces' (bug#21014).

(cherry picked from commit bf7a630b0a5d3900f2afb0e7a881ce62e2b9f935)

Add a cross ref to Optional Mode Line

* doc/lispref/modes.texi (Mode Line Variables): Add a cross
reference to the Emacs mode line node that explains things
like `display-time-string' (bug#21002).

(cherry picked from commit a3151a28789f413af73b14fbba557b2a587fca53)

Add a doc string to display-time-string

* lisp/time.el: Add a doc string to `display-time-string',
because it's referred to in the manual, and is too mysterious
otherwise (bug#21002).

(cherry picked from commit 45559c584e5a4ddeed1539b028b50b95baa372f8)

custom-buffer-style doc fix

* lisp/cus-edit.el (custom-buffer-style): Document the `tree'
value (bug#20724).

(cherry picked from commit bcf0291d0cd02095b0809b1eb91f1e5c5c2ac5e3)

Rearrange the doc of query-replace slightly

* lisp/replace.el (query-replace): Move the mention of the
interactive prefix arg earlier so that users can find it
(bug#20654).

(cherry picked from commit bcc10761c3b968fa4534718116a0a601ed7da389)

apropos-print doc fix

* lisp/apropos.el (apropos-print): Document the undocumented
parameters (bug#20520).

(cherry picked from commit 0714d7387812a151f59993ac77c7321724ef79b1)

completion-table-with-predicate doc string fix

* lisp/minibuffer.el (completion-table-with-predicate): t ->
non-nil in the doc string (bug#20460).

(cherry picked from commit b6a4d162208f239bc7804696d611ae52c686f138)

Fill the completion-table-with-predicate doc string

* lisp/minibuffer.el (completion-table-with-predicate): Fill
the doc string (bug#20460).

(cherry picked from commit 207a31432c1ed8b548003a3e4af32c49aa3441e9)

replace-match-maybe-edit doc clarification

* lisp/replace.el (replace-match-maybe-edit): Say what
MATCH-DATA is (bug#20304).

(cherry picked from commit 139874ba53c2e2de9868f8e5234d6ea2bcb97af8)

add-timeout doc fix

* lisp/emacs-lisp/timer.el (add-timeout): Mention the return
value (bug#20181).

(cherry picked from commit 921b40476f597c84d7c34aa289cd43caeb389c4a)

Extremely minor doc fix in Choosing Window

* doc/lispref/windows.texi (Choosing Window): There's only one
action alist, I think (bug#20158).

(cherry picked from commit 6c7e7f421d02d9290d6d1d85320737371160aef7)

Transform mentions of `eval-after-load' to `with-eval-after-load'

* doc/lispref/loading.texi (Hooks for Loading): Update text to
not mention `eval-after-load' (bug#20038).

(cherry picked from commit 9392193be56eebdfac702a0bbb5e954088371c7a)

cursor-type doc fix

* src/buffer.c (syms_of_buffer): Mention that cursor-type's
WIDHT/HEIGHT can't exceed the frame char size (bug#19215).

(cherry picked from commit 77c5f4554ebb3b7c7d49bc881e45a550f6c93987)

Add a link from Tool Bar to Images

* doc/lispref/keymaps.texi (Tool Bar): Add a link to the
Images node (bug#19722).

(cherry picked from commit da5d0786163a91400eced4fddba4a92b652458d1)

(default-mode-line-format): More explicit obsolete info

* lisp/subr.el (default-mode-line-format): Be more explicit in
how default values are now handled (bug#19424).

(cherry picked from commit 9dc5f6d830e72420dc4d41c8f6ca1ca6b28609c0)

Fcompare_buffer_substrings doc string clarification

* src/editfns.c (Fcompare_buffer_substrings): Extremely minor
doc string clarification (bug#19255).

(cherry picked from commit aa692acbb598a1cc8219ed7a87dde25fd7626ba5)

insert-file-contents-literally doc fix

* lisp/files.el (insert-file-contents-literally): Say that the
parameters are explained in the other function (bug#18317).

(cherry picked from commit b6481b19bc9592492b1f70dfecb4de6256f537fe)