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

Mention the `find-library-name' changes

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

Allow finding libraries loaded manually outside the load-path

* lisp/emacs-lisp/find-func.el (find-library--from-load-path):
New function to find a library from a load path (bug#5661).
(find-library-name): Use it.

There are so many combinations of inputs and possibly entries in
`load-history' that the code looks like an entry in a code obfuscation
contest.  If anybody has a better implementation, please substitute.

But remember that the input given may be foo, foo.el, foo.elc, and the
entries in load-history may be foo.el, foo.elc and foo.el.gz, and we
want to return only foo.el and foo.el.gz.  *phew*

Allow minibuffer prompts to use faces

* doc/lispref/minibuf.texi (Text from Minibuffer): Document
`minibuffer-prompt-properties' and explain how faces work in
the minibuffer prompt.

* src/minibuf.c (read_minibuf): If `face' is in
`minibuffer-prompt-properties', apply it to the end of the
face list to allow users to have their own faces on the
prompts (bug#16136).

Add R7RS syntax forms to scheme.el

* lisp/progmodes/scheme.el (scheme-font-lock-keywords-2): Add
a number of special forms introduced in R7RS-small.
* lisp/progmodes/scheme.el (scheme-indent-function): Same.

Copyright-paperwork-exempt: yes

; Replace mixed tabs/spaces in scheme.el with just spaces

* lisp/progmodes/scheme.el: Remove tabs in preparation for
upcoming patch.

Implement horizontal scroll bars on NS

* lisp/scroll-bar.el (horizontal-scroll-bars-available-p): Remove NS
check.
* lisp/term/ns-win.el: Remove custom NS scroll-bar handlers and bind
scroll-bar mouse clicks to standard handlers.
* src/nsterm.h (EmacsScroller): Add 'horizontal' property and rename
pixel_height to pixel_length.
* src/nsterm.m (x_set_window_size): Remove left-hand scroll-bar code. It
caused scroll-bars to be over-drawn and the best working solution
appears to be complete removal.
(ns_set_horizontal_scroll_bar): Rewrite to handle horizontal scrollers
correctly.
(ns_set_vertical_scroll_bar): Set width to actual scroller width.
(setFrame): Handle horizontal case.
(dealloc): Handle horizontal case.
(judge): Handle horizontal case.
(setPosition): Rename pixel_height to pixel_length.
(sendScrollEventAtLoc): Handle horizontal case.
(mouseDown): Handle horizontal case and general tidy up of code.
(mouseDragged): Handle horizontal case. Call sendScrollEventAtLoc with
absolute pixel size instead of ratio.
* src/window.h: Remove NS check.

; Auto-commit of loaddefs files.

tramp.texi: Revert last change due to backward compatibility

Fix the buffer-count patch (Bug#23394)

* src/buffer.c (Fgenerate_new_buffer_name): Increment count just
once each time through the loop.  Reported by Lars Ingebrigtsen in:
http://lists.gnu.org/archive/html/emacs-devel/2016-04/msg00918.html

cua-prefix-override-inhibit-delay doc fix

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

Fix generate-new-buffer-name increment typo

Problem reported by Chaitanya Koparkar (Bug#23394).
* src/buffer.c (Fgenerate_new_buffer_name): Increment count when
generating a new buffer.  This fixes a typo I introduced in
2014-04-05T00:04:58Z!eggert@cs.ucla.edu.

global-eldoc-mode doc fix

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

Make the legend in describe-categories a link

* lisp/help-fns.el (describe-categories): Make the "see
bottom" text a link (bug#22227).

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

isearch-search-fun-function doc tweak

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

Fill some imenu--index-alist doc lines

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

Make describe-variable look up the variable in the current buffer

* lisp/help-fns.el (describe-variable): Get the variable
definition in the buffer we were called from (in case it only
exists there) (bug#21252).

Fmarker_position doc string clarification

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

Further define-obsolete-* doc fixups

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

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.

Mention with-silent-modifications in the lispref manual

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

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

clear-visited-file-modtime doc string fix

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

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

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

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

custom-buffer-style doc fix

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

Document how to check for ImageMagick support

* doc/lispref/display.texi (ImageMagick Images): Say how to
check for ImageMagick support, which isn't quite obvious
(bug#20702).

Minor doc fix for ImageMagick/SVG builds

* doc/lispref/display.texi (SVG Images): Don't imply that you
have to build Emacs yourself (bug#20702).
(ImageMagick Images): Ditto.

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

apropos-print doc fix

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

completion-table-with-predicate doc string fix

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

Fill the completion-table-with-predicate doc string

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

replace-match-maybe-edit doc clarification

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

add-timeout doc fix

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

Extremely minor doc fix in Choosing Window

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

* .dir-locals:  Amend for correct fontification of *.[ch] containing "IF_LINT"

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

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

Add a link from Tool Bar to Images

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

CC Mode: Recognize a noise macro with parens after a declarator's identifier

* lisp/progmodes/cc-engine (c-forward-decl-or-cast-1): In the while loop
following comment "Skip over type decl suffix operators." insert code also
to check for noise macros with parentheses.

(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).

Fcompare_buffer_substrings doc string clarification

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

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

Fix custom types for cursor-in-non-selected-windows

* lisp/cus-start.el (standard): Use the same custom types for
cursor-in-non-selected-windows as for cursor-type (bug#19214).

Doc clarification to mwheel-scroll

* lisp/mwheel.el (mwheel-scroll): Mention that the restriction
does not apply to Windows (bug#19209).

Clarify the doc of eval-expression-print-format

* lisp/simple.el (eval-expression-print-format): Doc
clarification (bug#19114).

(extended-command-suggest-shorter): Add a version string

* lisp/simple.el (extended-command-suggest-shorter): Add a
version string.

Document extended-command-suggest-shorter

* doc/emacs/m-x.texi (M-x): Mention
extended-command-suggest-shorter (bug#19152).

Add a variable to control "shorter command" suggestions

* lisp/simple.el (extended-command-suggest-shorter): New variable (bug#19152).
(execute-extended-command): Use it.

Explictly explain that package-initialize loads the packages

* lisp/emacs-lisp/package.el (package-initialize): Be explicit
in saying that `package-initialize' obviates adjusting the
path or requiring the packages, as this is a question that
apparently comes up now and then (bug#18829).

Have the doc strings of `load-path' and `require' mention each other

* src/fns.c (Frequire): Mention `load-path' and fill the doc
string (bug#18829).

* src/lread.c (syms_of_lread): Mention that `require' uses
`load-path'.

Doc fix for insert-pair-alist

* lisp/emacs-lisp/lisp.el (insert-pair-alist): Say what
COMMAND-CHAR is (bug#18809).

Move doc of backup-directory-alist to the Backup node

* doc/emacs/files.texi (Backup): Move the documentation of
`backup-directory-alist' here from the "Single or Numbered
Backups" node, because it doesn't seem to have much to do with
numbering (bug#18692).

Tiny doc clarification for create-fontset-from-fontset-spec

* lisp/international/fontset.el (create-fontset-from-fontset-spec):
Clarify what the optional part is (bug#18686).

Fill the doc string of font-lock-keywords

* lisp/font-lock.el (font-lock-keywords): Fill the lines and
reorganise some explanations (bug#21427).

Doc fix for font-lock-remove-keywords

* lisp/font-lock.el (font-lock-remove-keywords): Add a link to
`font-lock-add-keywords' to describe KEYWORDS (bug#18634).

Clarify whitespace-style doc string

* lisp/whitespace.el (whitespace-style): Doc clarification
(bug#18296).

No need to test for jka-compr

* lisp/vc/ediff-util.el (ediff-file-compressed-p): jka-compr
is always available; no need to test (bug#18204).

Doc fixed for next-error-buffer-p

* lisp/simple.el (next-error-buffer-p): Clarify doc string
(bug#18202).

Tiny doc fix

* src/fileio.c (Ffile_accessible_directory_p): Tiny doc fix
(and fill) (bug#18201).

Doc fix

* src/keymap.c (Fdefine_prefix_command): Clarify doc string
slightly (bug#18092).

delsel doc touch ups

* lisp/delsel.el (delete-selection-helper): Use non-nil
instead of t and clarify function return values (bug#18089).

Doc fixes for menu-bar.el

* lisp/menu-bar.el (clipboard-kill-ring-save): Describe the
REGION parameter (bug#18028).
(clipboard-kill-region): Ditto.

Doc fix

* lisp/rect.el (delete-whitespace-rectangle): Doc fix (bug#18026).

Minor doc clarification

* lisp/subr.el (y-or-n-p): Document the return value from "n"
(bug#18024).

Fill font-lock-mode doc string

* lisp/font-core.el (font-lock-mode): Fill the text to make it
narrower (bug#18008).

Wrap the auto-generated doc string

* lisp/emacs-lisp/easy-mmode.el (define-minor-mode): Wrap a
string to make it less likely that we get overlong lines
(bug#17999).

Clarify hi-lock-find-patterns

* lisp/hi-lock.el (hi-lock-find-patterns): Doc clarification
(bug#17989).

Warning fix in jit-lock-mode

* lisp/jit-lock.el (jit-lock-mode): Don't issue a warning when
turning the mode on in an indirect buffer, if this somehow has
happened (bug#17738).

Add a doc string to `winner-mode'

* lisp/winner.el (winner-mode): Add a doc string based on the
comments in the file (bug#17716).

Doc fix for align-newline-and-indent

* lisp/align.el (align-newline-and-indent): Mention that
alignment is done by `align' (bug#17707).

Cancel the eldoc timer when switching off eldoc mode

* lisp/emacs-lisp/eldoc.el (eldoc-mode): Cancel the eldoc
timer when switching off eldoc mode.  It will be restarted
again if needed (bug#17582).

Doc fix for `kbd'

* lisp/subr.el (kbd): Describe more fully the format of the
parameter (bug#17039).

; Comment tweak.

Add a sanity check to apropos-documentation-internal

* lisp/apropos.el (apropos-documentation-internal): Add a
sanity check to be less fragile in the presence of invalid
data (bug#16725).

Doc tweak

* lisp/simple.el (use-empty-active-region): Doc tweak.
There's only one region (bug#16513).

Clarify `read-face-name' doc and tweak the code

* lisp/faces.el (read-face-name): Clarify the documentation
and allow a mix of faces and faces names in all cases
(bug#16483).

Remove ": ?" from the read-face-name prompt

* lisp/faces.el (read-face-name): Remove ": ?" from the prompt
to be more backwards compatible (bug#15909).

Link from (emacs)Exiting to (lisp)Killing Emacs

* doc/emacs/entering.texi (Exiting): Link to the lispref
manual for further customisations (bug#15445).

find-lisp doc touchups

* lisp/find-lisp.el (find-lisp-format): Copy over the doc
string (bug#15047).
(find-lisp-find-files): Clarify doc.

Don't have the manual claim that it lists all CL incompatibilities

* doc/misc/cl.texi (Common Lisp Compatibility): The list of
incompatibilities isn't exhaustive, so don't say that it is
(bug#15171).

Fix call of `kmacro-display'

* lisp/kmacro.el (kmacro-view-ring-2nd): Fix call of
`kmacro-display' (bug#15020).

Change all occurrences of "Mouse-[0-9]" to "mouse-[0-9]"

* doc/emacs/*.texi: Change all occurrences of "Mouse-[0-9]" to
"mouse-[0-9]".  These are case sensitive, and the keys are lower case
(bug#14554).

Rename "Directory Search" menu to "Servers"

* lisp/menu-bar.el (menu-bar-tools-menu): Rename "Directory
Search" to "Directory Servers".  Suggested by Eli
Zaretskii. (bug#14919).

* lisp/net/eudc.el: Rename ditto throughout.

Remove uses of the unused to-end parameter from simple.el

* lisp/simple.el (line-move-partial): Remove usages of the
unused to-end parameter, and make it optional (bug#14844).
(line-move): Remove use of the unused to-end parameter.

Doc fix: _ chars are automatically removed.

* lisp/cus-edit.el (custom-buffer-create): _ chars are
automatically removed when displaying help, so fix the last
doc change.
(custom-buffer-create-other-window): Ditto.

Doc string change to enable-recursive-minibuffers

* src/minibuf.c (syms_of_minibuf): Mention
minibuffer-depth-indicator-mode in the doc string to
enable-recursive-minibuffers (bug#14147).

Fix definition of nobreak-space

* lisp/faces.el (nobreak-space): The definition to
nobreak-space was inadvertantly changed by the previous checkin.

Clarify the `interactive' doc string slightly

* src/callint.c (Finteractive): Clarify the doc string slightly
  (bug#14577).

Make icomplete respect `completion-ignored-extensions'

* lisp/icomplete.el (icomplete-completions): Heed
`completion-ignored-extensions' (bug#12939).

Make ibuffer not break on newline-embedded buffer names

* lisp/ibuffer.el (name): When buffer names contain newlines,
quote those newlines before displaying (bug#12378).

Add a new face for non-breaking hyphen characters

* doc/emacs/display.texi (Standard Faces): Mention nobreak-hyphen.
(Text Display): Ditto.

* lisp/faces.el (nobreak-hyphen): New face (bug#12048).

* src/xdisp.c (get_next_display_element): Use it instead of
the escape-glyph face.

* src/xdisp.c (syms_of_xdisp): New symbil Qnobreak_hyphen.