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.

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.

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)

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)

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

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

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

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

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

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.

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.

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

; Spelling fixes

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

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

(Bug#23410)

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)

Doc tweak

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

(cherry picked from commit 35fb7897f161d5e5a87e039dc1e427094640b0c8)

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

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

(cherry picked from commit bc5f27aa099cdde02ca66e71501b89300685ab28)

find-lisp doc touchups

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

(cherry picked from commit e4c7657b0d1a31d64ca24bc64b5480cd7687e332)

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

(cherry picked from commit fb685bc91a72508c97ce7e30f970d4157677f371)

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

(cherry picked from commit e4c26271f2c2fe08f8490e25c63a436ab2a804ca)

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

(cherry picked from commit 23ba488a5e8290c4de91e0ff4161641efa364c0d)

Clarify the `interactive' doc string slightly

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

(cherry picked from commit cd993be60da2d12db0d390001373d486c1091c47)

Clarify some doc strings

* lisp/emacs-lisp/syntax.el (syntax-propertize-via-font-lock):
Clarify doc string (bug#8693).
(syntax-propertize): Clarify doc string.

(cherry picked from commit ad3ef417f3c40f086de9c547d6272e5685595e42)

Add some concept index entries for custom types

* doc/lispref/customize.texi (Composite Types): Add concept
index entries for restricted-sexp, radio and choice (bug#7385).

(cherry picked from commit 388bb723fa078158d3148de05e942f9c01e95dd8)

Mention `lisp-indent-function' in the lispref manual

* doc/lispref/macros.texi (Indenting Macros): Mention
`lisp-indent-function' (bug#3393).

(cherry picked from commit a1627691a896b2afaa264f93534178bc763564c9)

Clarify doc string of internal compilation function

* lisp/progmodes/compile.el (compilation-get-file-structure):
Clarify doc string (bug#3137).

(cherry picked from commit 123191decb7428db3b32a6c01631fa755088393a)

Use ‘T *restrict’ proto, not ‘T[restrict]’

* src/fns.c (sort_vector_copy): Use a different way to attempt to
work around GCC 3.0-and-earlier incompatibility with C99, one that
does not have problems with modern non-GCC compilers.

Fix documentation of 'url-retrieve-synchronously'

* doc/misc/url.texi (Retrieving URLs): Update argument list of
'url-retrieve-synchronously'.  (Bug#23411)

* lisp/url/url.el (url-retrieve-synchronously): Doc fix.  (Bug#23411)

; Auto-commit of loaddefs files.

Fix last change to isearch-update (bug#23406)

* lisp/isearch.el (isearch-update): Remove (setq cursor-sensor-inhibit
  nil) ie remove the original (unless (boundp 'cursor-sensor-inhibit)
  ...) form.

Autoload cursor-sensor-inhibit (bug#23406)

* lisp/emacs-lisp/cursor-sensor.el (cursor-sensor-inhibit): Autoload.
* lisp/isearch.el (isearch-update): Remove boundp check.

org-map-entries: Fix org-agenda-prepare-buffers call

* lisp/org.el (org-map-entries): Check that buffer-file-name is non-nil
  before passing to org-agenda-prepare-buffers.

This is a backport of commit 44c8cd7136e3fcd1e6bfa08895cac437b7a691fa
from upstream org-mode. Addresses bug #23365.