Doc fixes for comp.el

* lisp/emacs-lisp/comp.el (comp-deferred-compilation-deny-list)
(comp-bootstrap-deny-list, comp-pred-to-cstr, make-comp-mvar)
(comp-mvar-used-p, comp-async-compilation): Doc fixes.

Fix some custom types in comp.el

* lisp/emacs-lisp/comp.el (comp-deferred-compilation-deny-list)
(comp-bootstrap-deny-list, comp-never-optimize-functions)
(comp-async-env-modifier-form, comp-native-driver-options):
Fix :type (`list' on its own isn't even a valid type).

* lisp/erc/erc.el: Add past maintainer Michael Olson to Contributors.

Fix compilation warnings in non-toolkit builds

* src/xterm.c (x_create_toolkit_scroll_bar)
(x_create_horizontal_toolkit_scroll_bar): String constants for
XtSetArg are defined as const strings (in
/usr/include/X11/Xaw3d/ThreeD.h, for instance), but the argument
in XtSetArg is defined as either a const char* or a regular char*
in /usr/include/X11/Intrinsic.h.  Cast the argument to String
(which should be correct on all platforms, hopefully) to avoid a
compilation warning (bug#47452).

Rename abnormal hook to comp-async-cu-done-functions

* lisp/emacs-lisp/comp.el (comp-async-cu-done-functions): Rename
from 'comp-async-cu-done-hook' to reflect that it is an abnormal
hook.  Doc fix and update single caller.

Fix failing subr test

* test/lisp/subr-tests.el (subr-tests-bug22027): Fix mocked
signature of `read-string' (bug#48022).

Fix failing auth-source test

* test/lisp/auth-source-tests.el
(auth-source-test-secrets-create-secret): Fix test failing because
the mocked `read-string' had the wrong interface.

Ensure that we get an X-Draft-From headers

* lisp/gnus/gnus-msg.el (gnus-setup-message): Ensure that we get an
X-Draft-From headers (bug#48049).

* lisp/emacs-lisp/package.el: Fix use of `find-library-name`

That function caused a warning for a good reason.
Don't just declare it and hope it will be available.

(package--list-of-conflicts): Require `find-func` explicitly before
declaring the function.  Also don't ignore all errors but only
the `file-error`s which will be emitted by `find-library-name`
in normal circumstances.

* lisp/emacs-lisp/find-func.el (find-library-name): Signal a `file-error`
Instead of a generic `error`.

* lisp/emacs-lisp/comp-cstr.el (comp-ctxt): Initialize it.

Rework where `comp-ctxt' is defined.

* test/lisp/emacs-lisp/comp-cstr-tests.el (comp-ctxt): Remove
`comp-ctxt' definition.
* lisp/emacs-lisp/comp.el (comp-ctxt): Likewise.
* lisp/emacs-lisp/comp-cstr.el (comp-ctxt): Define it here.

* lisp/emacs-lisp/comp.el: Make it loadable in vanilla builds (bug#48021).

* lisp/emacs-lisp/comp.el (comp-known-type-specifiers): Fix string-search.

Small tweaks to gnus-registry reindexing messaging

* lisp/gnus/gnus-registry.el (gnus-registry-fixup-registry): Use
`seq-set-equal-p' so we don't care about list element ordering.  Don't
show messages within `registry-reindex' if we aren't at gnus-verbose
level 9.

Fix previous emake adjustment

Make use of `ert-resource-file' `ert-resource-directory' in comp-tests

* test/src/comp-resources/comp-test-pure.el: Rename.
* test/src/comp-resources/comp-test-funcs.el: Likewise.
* test/src/comp-resources/comp-test-funcs-dyn.el: Likewise.
* test/src/comp-resources/comp-test-45603.el: Likewise.
* test/src/comp-tests.el (comp-test-src, comp-test-dyn-src): Use
`ert-resource-file'.
(comp-tests-bootstrap): Use ert-resource-directory.
(comp-tests-45603-1, comp-tests-pure): Use `ert-resource-file'.

* Use `expand-file-name' in place of `concat' in comp-tests.el

* test/src/comp-tests.el (comp-test-src,
comp-test-dyn-src) (comp-tests-bootstrap, comp-tests-pure,
comp-test-src): Use `expand-file-name' in place of `concat'.

Move native compiler test data into proper directory (bug#48031)

* test/src/comp-tests-resources/comp-test-45603.el: Rename.
* test/src/comp-tests-resources/comp-test-funcs-dyn.el: Likewise.
* test/src/comp-tests-resources/comp-test-funcs.el: Likewise.
* test/src/comp-tests-resources/comp-test-pure.el: Likewise.
* test/src/comp-tests.el (comp-test-directory): Update.

* test/src/comp-tests.el: Fix it for non native compiled build (bug#48031).

* Fix comp-cstr tests for vanilla build (bug#48021)

* test/lisp/emacs-lisp/comp-cstr-tests.el (comp-ctxt): Fix tests
for vanilla build (bug#48021)

* lisp/emacs-lisp/comp.el (comp-accept-and-process-async-output): Fix regexp.

Some rearrangement in gitlab-ci.yml

* test/infra/gitlab-ci.yml (test-filenotify-gio, test-gnustep):
Add 'needs:' clause.
(build-native-bootstrap-speed0, build-native-bootstrap-speed1)
(build-native-bootstrap-speed2): Rename from 'test-*'.  Do not use
'--without-makeinfo'.

Fix typo in tramp-get-remote-gid

* lisp/net/tramp.el (tramp-get-remote-gid): Pass the correct
operation to find-file-name-handler.  (Bug#48026)

* src/editfns.c (Fpropertize): Doc fix; reference Info manual.

; NEWS copyedits

; Add 2021 to copyright years

* lisp/url/url-proxy.el (url-find-proxy-for-url): Minor simplification

* lisp/startup.el (comp-eln-load-path): Silence a warning.

Hack around problems in Turkish environments in url-proxy

* lisp/url/url-proxy.el (url-find-proxy-for-url): Work around a
problem in Turkish language environments (where a downcased I is
?ı (bug#44604).

* lisp/emacs-lisp/comp.el (no-native-compile): Minor doc fixes.

* lisp/help-macro.el: Remove stale Change Log.

Adjust regexp to extra native-comp lines

Merge branch 'feature/native-comp' into into trunk

Revert window/winner changes (Revert 0454bfd3313)

See bug#23621 for an explanation.

CC Mode: Get proper search limits in c-font-lock-cut-off-declarators

* lisp/progmodes/cc-fonts.el (c-font-lock-cut-off-declarators): Instead of
using a crude 2,000 characters back limit for backward searching, which is
erroneous when that point is in a literal, use the already calculated
c-determine-limit result.

Merge from origin/emacs-27

7d5b973959 (origin/emacs-27) * doc/misc/cl.texi (For Clauses): Minor ...
4570781f8d ; * doc/lispref/files.texi (Directory Names): Add missing ...
1b52fd538d Minor update for make-tarball.txt
8efb8491b2 * doc/misc/cl.texi (Iteration Clauses): fix `never' clause...
0873134682 ; Fix Texinfo in last change to minibuf.texi.
cad8913c89 Improve filling-related documentation
2b7eed23eb ; * doc/lispref/keymaps.texi (Easy Menu): Fix typo.
47fc92cefc Fix reference to "yanking" in the main Emacs manual
1789dcdb35 Improve documentation of 'map-y-or-n-p'

Add more scroll key bindings to make-help-screen

* lisp/help-macro.el (make-help-screen): Add bindings to scroll on
<PageUp>, <PageDown>, <up>, <down>.

Fix the handling of the Delete key in help screens.

* lisp/help-macro.el (make-help-screen): Handle the Delete key
in help screens as in Emacs 23 and earlier.

Copyright-paperwork-exempt: yes

; * lisp/help.el (help-for-help): Fix thinko.

* lisp/ses.el: Doc fixes.

Don't hard-code face of "Install" button

* lisp/emacs-lisp/package.el (package-make-button): Use the
'custom-button' face for the "Install" button.  (Bug#47944)

Remove redundant #' before lambda in printing.el

* lisp/printing.el (pr-menu-create, pr-eval-setting-alist)
(pr-complete-alist, pr-file-list, pr-ps-file-list)
(pr-insert-section-1, pr-insert-section-2)
(pr-insert-section-4, pr-insert-section-5, pr-choice-alist)
Remove redundant #' before lambda.

* src/keyboard.c (Flossage_size): Improve prompt.

Show correct lossage size in help-for-help

* lisp/help.el (help-for-help): Show correct lossage size.  Add
trailing newline.
Suggested by Gregory Heytings <gregory@heytings.org>.

* doc/lispref/macros.texi (Eval During Expansion): Copy edit.

(completion-all-sorted-completions): Fix history use with boundaries

Preprocess the history (and the default) through the new function
`minibuffer--sort-preprocess-history` to filter out the completion
base for completion tables with boundaries (in particular the file
completion table).

* lisp/minibuffer.el (minibuffer--sort-preprocess-history_: New function.
(completion-all-sorted-completions): Use it.
* test/lisp/minibuffer-tests.el (completion-all-sorted-completions):
Add tests for various combinations of with/without history/base/default.

* lisp/progmodes/project.el: Use project-prefixed-buffer-name in more places.

(project-shell, project-eshell): Use project-prefixed-buffer-name (bug#47975).
(project-compilation-buffer-name-function): Add :version tag.

* doc/misc/cl.texi (For Clauses): Minor copyedits.

; * doc/lispref/files.texi (Directory Names): Add missing parenthesis

* lisp/mpc.el: Avoid (implicit) `eval`; prefer #' to quote function names

(mpc-format): Compose functions instead of constructing
source-code expressions at run time.
Rename `mpc-pred` property to `mpc--uptodate-p`.
(mpc-status-buffer-refresh): Adjust to the new property name.

* lisp/svg.el: Fix typo in sample code; add minor optimization

(svg--elliptical-arc-command, svg--moveto-command)
(svg--lineto-command): Use `mapcan`.

* doc/lispref/macros.texi (Eval During Expansion): Fix fixme

Simlify top-level Makefile since admin is always included

* Makefile.in (clean_dirs, distclean_dirs, maintainer_clean_dirs):
Add admin directories.
(clean, distclean, bootstrap-clean, maintainer-clean): Simplify.
(maybeclean_dirs): Remove - this dates to when admin/ was not
included in tar files.

; Fix some typos in doc strings and manuals

* lisp/help.el (help--for-help-make-sections): Fix typo.

Redesign and improve the help-for-help (C-h C-h) command

* lisp/help.el (help-for-help): Redesign help screen; add sections,
rearrange and reword.
(help-for-help-header): New face.
(help--for-help-make-commands, help--for-help-make-sections): New
functions.
(help-for-help-buffer-name): New variable.

* lisp/help-macro.el (make-help-screen): New optional argument
BUFFER-NAME.  Fontify keys.

This change was discussed in:
https://lists.gnu.org/r/emacs-devel/2021-02/msg01695.html
https://lists.gnu.org/r/emacs-devel/2021-03/msg00670.html
https://lists.gnu.org/r/emacs-devel/2021-04/msg00292.html

Improve detection of pdumper file and *.eln files

* src/emacs.c (load_pdump_find_executable): Resolve symlinks even
if argv[0] includes leading directories.  (Bug#46790)

Minor update for make-tarball.txt

* admin/make-tarball.txt (UPDATING THE EMACS WEB PAGES AFTER A
RELEASE): Update and enhance the section to make it easier to find
the banner and verify the updated pages are in place.

; * etc/NEWS: Fix last change.

* doc/misc/cl.texi (Iteration Clauses): fix `never' clause typo

This fixes bug#47962.

Copyright-paperwork-exempt: yes

Obsolete the TAB binding in *xref* buffers

* doc/emacs/maintaining.texi (Xref Commands): Remove the
description of the TAB binding.  Enhance the description of the
RET binding.  (Bug#44611)

* etc/NEWS: Announce the obsolescence of TAB binding in XREF.

* lisp/progmodes/xref.el (xref-goto-xref): Improve doc string.

* lisp/rot13.el: Improve documentation.  (Bug#47970)

Improve diagnostics of loading *.eln files

* src/pdumper.c (dump_do_dump_relocation): Improve diagnostics
when loading preloaded *.eln files fails.  (Bug#46790)

* lisp/subr.el (remove-hook): Improve last change

Don't put a `hook--depth-alist` property if there isn't one already.

Fix thinko introduced in the last ERC patch (bug#47788)

* lisp/erc/erc-backend.el (erc-open-network-stream): Need to use apply
to call open-network-stream with the supplied arguments because of the
plist p of arguments.  Thanks to neverwas for pointing it out.

* lisp/files.el (minibuffer-with-setup-hook): Fix bug#46326

* lisp/subr.el (add-hook): Try and fix bug#46326

Use `eq` indexing on `hook--depth-alist`.

(remove-hook): Remove old entries from `hook--depth-alist`.

* lisp/net/tramp-cmds.el (tramp-recompile-elpa-command-completion-p):

Check, whether Tramp has a package description.

* lisp/wdired.el (wdired--before-change-fn): Wrap body in save-match-data.

Suggested by Michael Heerdegen <michael_heerdegen@web.de> (bug#14013)

; * etc/NEWS: Fix quoting.

Fix a recent change in minibuf.texi

* doc/lispref/minibuf.texi (Basic Completion)
(Programmed Completion): Improve wording, punctuation, and markup
of a recently-added text.

; * etc/NEWS: Fix typo.

; * etc/NEWS: Fix a recently added entry.

* etc/NEWS: 'world-clock-mode' is no longer interactive.

Expand documentation on nontrivial completion boundaries.

The interplay between nontrivial completion boundaries and the other
completion functions is somewhat subtle, so it deserves a bit more
explanation.

* doc/lispref/minibuf.texi (Basic Completion)
(Programmed Completion): Add a few more remarks about nontrivial
completion boundaries.

Fix small bug in 'completion-table-subvert'.

Even for a trivial underlying completion table (where the 'boundaries'
action returns nil), we need to provide nontrivial boundaries so that
they match the behavior of 'all-completions'.

* lisp/minibuffer.el (completion-table-subvert): Return boundaries
even for trivial underlying completion table.
* test/lisp/minibuffer-tests.el (completion-table-subvert-test):
Amend unit test to also test boundaries.  While there, also test
the other completion functions.

Revert "Remove the binding for xref-quit-and-goto-xref"

This reverts commit 522c34f0e80f60969861b0dc34bc7105249f9994.

Making changes to which there was an explicit disagreement
and a long discussion is unacceptable.  (Bug#44611)

Misc changes

* lisp/progmodes/project.el (project-shell, project-eshell):
Simplify.
(project-switch-commands, project-switch-use-entire-map):
Add :group keywords (to fix misattribution to project-vc).

Add support for using a TLS client certificate with 'erc-tls' (bug#47788)

* lisp/erc/erc-backend.el (erc-session-client-certificate): New
buffer-local variable storing the TLS client certificate used for the
current connection.
(erc-open-network-stream): Use open-network-stream instead of
make-network-process, and pass any additional arguments to it.
(erc-server-connect): Add an optional client-certificate argument
that if present is passed with the :client-certificate keyword as part
of the arguments to erc-server-connect-function.
* lisp/erc/erc.el (erc-open): Add new optional client-certificate
argument, set it as erc-session-client-certificate, and pass it along
to erc-server-connect.
(erc): Clarify documentation string with respect to the full-name
argument.
(erc-tls): Add new client-certificate keyword argument and pass it in
the direct call to erc-open (instead of going through erc).
(erc-open-tls-stream): Pass any additional arguments (such as
:client-certificate) to open-network-stream.  Also allow overriding
:nowait if desired.

* doc/misc/erc.texi: Add documentation for erc-tls, including the new
:client-certificate argument.

* etc/NEWS: Announce the change.

Introduce project-compilation-buffer-name-function

* lisp/progmodes/project.el (project-compilation-buffer-name-function):
New option.
(project-compile): Use it.
(project-prefixed-buffer-name): New function.

Copyright-paperwork-exempt: yes

* lisp/progmodes/xref.el: Remove the "still experimental" note.

Remove the binding for xref-quit-and-goto-xref

* lisp/progmodes/xref.el (xref--xref-buffer-mode-map):
Remove the binding for xref-quit-and-goto-xref (bug#44611).

* doc/emacs/maintaining.texi (Xref Commands): Update.

; * configure.ac (LD_SWITCH_SYSTEM_TEMACS) [mingw32]: Fix last change.

* lisp/time.el (world-clock-mode): Make non-interactive.

Minor improvements to world-clock

* lisp/time.el (world-clock-mode-map): New variable.  Bind 'n' and
'p' to 'next-line' and 'previous-line'.
(world-clock-update): Preserve point.

Fix MS-Windows link switches for unexec

* configure.ac (LD_SWITCH_SYSTEM_TEMACS) [mingw32]: Disable ASLR
when linking for unexec.  Reported by Nikolay Kudryavtsev
<nikolay.kudryavtsev@gmail.com>.

* lisp/progmodes/which-func.el: Doc fixes.

Move part of the fix from project to xref

* lisp/progmodes/project.el (project--find-regexp-in-files):
Don't unquote file names here.

* lisp/progmodes/xref.el (xref-matches-in-files): Do it here.
And only if the first element in the list is quoted (bug#47799).

Ensure that argument to 'verify' is a constant expression.

Casting NULL is not a constant expression (Bug#47951).

* lib-src/seccomp-filter.c (main): Turn check for null pointer
representation into a runtime assertion.

* lisp/window.el (display-buffer): Doc fix.  (Bug#47950)

Copyright-paperwork-exempt: yes

Fix unload+reload of files using `custom-initialize-delay` (bug#47072)

* lisp/custom.el (custom-initialize-delay): Don't delay if
`custom-delayed-init-variables` has already been processed.
* lisp/startup.el (command-line): Mark `custom-delayed-init-variables`
as processed.

Fix unclean "can't happen" error handling in read_minibuf_unwind

Also fix a bug where, with minibuffer-follows-selected-frame neither nil nor
t, a minibuffer could appear in two frames at the same time.

* src/window.c (Fset_window_configuration): Add a new &optional parameter
DONT-SET-MINIWINDOW, which inhibits the minibuffer from being restored from
the supplied window configuration.
(restore_window_configuration): Enhance to match the above.

* src/minibuf.c (read_minibuf): Enhance the argument list to the
restore_window_configuration calls to match the above.  In the main case,
restoring the minibuffer is inhibited.
(read_minibuf_unwind): Should the frame with the expired minibuffer not be
found ("can't happen"), unwind the stacked data nevertheless, rather than just
exiting.

* src/keyboard.c (read_char_help_form_unwind): Amend a call of
Fset_window_configuration.

* doc/lispref/windows.texi (Window Configurations): Document the new form of
set-window-configuration.

* etc/NEWS (Lisp Changes in Emacs 28.1): Amend the entry for
set-window-configuration.

Fix Isearch hscrolling in a corner case

* lisp/isearch.el (isearch-update): When we start hscrolled,
consider also the case that point ends up being to the left of the
hscrolled window's edge.  (Bug#46316)

Fix 'window-text-pixel-size' when there's after-string at EOB

* src/xdisp.c (move_it_to): Fix logic of reaching TO_CHARPOS when
there's a display or overlay string(s) at EOB.  (Bug#47860)

Improve a native compiler test

* test/src/comp-tests.el (comp-test-47868-1): Improve
testcase.
* test/src/comp-test-funcs.el (comp-test-47868-3-f)
(comp-test-47868-4-f): New functions.

Avoid lowering gc-cons-threshold

* lisp/cedet/semantic/wisent/comp.el (wisent--compile-grammar):
* lisp/international/mule-cmds.el (ucs-names):
* lisp/progmodes/ebrowse.el (ebrowse-read):
* test/src/coding-tests.el (benchmark-decoder): Avoid lowering
gc-cons-treshold.

* lisp/strokes.el: Doc fix; update URL.

Use khaki1 as 'match' background

* lisp/replace.el (match): Use khaki1 as the background color for
light backgrounds (bug#47574).

* lisp/emacs-lisp/package.el (package-archives): Bump :version.

* lisp/emacs-lisp/package.el: Doc fix.