Make `R' in eww work more reliably

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

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.

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

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

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

abbrev-tests.el fix

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

(shr-rescale-image): Clarify logic slightly

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

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

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

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)

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

(cherry picked from commit b66bc0cced786e0320e1c3b0758bd3c434d4e8b5)

Doc clarification to mwheel-scroll

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

(cherry picked from commit 696052b5fdfbc5c25dff3c6b081aebe70f6d06c7)

Clarify the doc of eval-expression-print-format

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

(cherry picked from commit cd193a871f5a8e1c81ba86fc398ac382fa814383)

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

(cherry picked from commit 619e0aedb2f3dbfe6821ac34e2d25b4e5c181117)

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

(cherry picked from commit 3eca9a03816f95da0030665223c0b5262f223ba7)

Doc fix for insert-pair-alist

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

(cherry picked from commit 2824c587e9749a8f350f1d3dddd65176b4561dcb)

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

(cherry picked from commit e77b8d84b4161f2cf8720dec2bf44a3e50134398)

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

(cherry picked from commit c05d186455ce9907eeb6b21ea4227e453996c681)

Fill the doc string of font-lock-keywords

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

(cherry picked from commit c05716d3a26ea7518b89eacfccaf70c9d0731df7)

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

(cherry picked from commit bc00dcf12983cd399127d0eea39647f29778eb02)

Clarify whitespace-style doc string

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

(cherry picked from commit d96c720d0cca7c9ffbb4c712ad315bb707d6625c)

Doc fixed for next-error-buffer-p

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

(cherry picked from commit a10eb168cc96db9f0dab2d75550cbd8f08be2363)

Tiny doc fix

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

(cherry picked from commit 2ef0040e2363a669d9b93df935d31c98fa130132)

Doc fix

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

(cherry picked from commit 6b769c81d024f7eeb90b167e7df6f87d859614d4)

delsel doc touch ups

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

(cherry picked from commit d7a5b5be9a5869bcd233434ec3103dd1976d7df7)

Doc fixes for menu-bar.el

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

(cherry picked from commit 33d2c67bff0992ecbc0fe38556683242b9d1a4ae)

Doc fix

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

(cherry picked from commit 6baca4911ec901579749dbf7596011d90fea3781)

Minor doc clarification

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

(cherry picked from commit 5d1f3192d484edee92caa46cd7d699da3e920259)

Fill font-lock-mode doc string

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

(cherry picked from commit 27abf372836532c57be2e9e3ed23413729cc07fc)

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

(cherry picked from commit 323b69664914d687fd4b48593479cea223dfbcb4)

Clarify hi-lock-find-patterns

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

(cherry picked from commit 552e90ce7dff3a7107243fdf71c4de3af443e13a)

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

(cherry picked from commit 2c3ab9b6e39a3d600e7d82deacc24effaec051bb)

Doc fix for align-newline-and-indent

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

(cherry picked from commit 340a224ec3e01706112a07164da9a9f3f369a5aa)

Doc fix for `kbd'

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

(cherry picked from commit 3a33afe25d8518f194fa4706eaccdb2a786a0348)