Document 'tags-apropos-additional-actions' with Xref

* doc/emacs/maintaining.texi (Looking Up Identifiers): Rearrange
and reword documentation of 'xref-find-apropos' and
'xref-auto-jump-to-first-definition'.  Add the description of
'tags-apropos-additional-actions'.  Delete the comment with
not-yet implemented features that were available with
'tags-apropos'.

* etc/NEWS: Augment the wording of 'xref-find-apropos' entry.

Further fix for the search-whitespace-regexp change

* lisp/isearch.el (search-whitespace-regexp): Fix yet another typo
in this one-line change (bug#21278).

New user options to move between isearch matches

* lisp/isearch.el (isearch-allow-motion,
isearch-motion-changes-direction): New user options.
(isearch-pre-command-hook): Handle the new options.

* etc/NEWS: Mention the new user options.

* doc/emacs/search.texi: Document the new user options.

Fix typo in previous search-whitespace-regexp change

* lisp/isearch.el (search-whitespace-regexp): Fix typo in last
checkin for this variable.

Fix behavior of isearch-{beginning,end}-of-buffer

* lisp/isearch.el (isearch-beginning-of-buffer)
(isearch-end-of-buffer): Fix their behavior when
isearch-repeat-on-direction-change is non-nil (bug#50466).

Change the default value of search-whitespace-regexp

* lisp/isearch.el (search-whitespace-regexp): Change the default
to always exclude newlines from the set (bug#21278).  It used to
be mode-dependent whether newlines were included or not, and this
was confusing as a user interface.

* lisp/progmodes/ruby-mode.el (ruby-current-indentation): Tweak obsoletion.

Support tags-apropos-additional-actions in etags Xref backend

* lisp/progmodes/etags.el (xref-etags-apropos-location):
New class.
(xref-location-marker): New method definition.
(xref-make-etags-apropos-location): New function.
(etags--xref-apropos-additional): New function.
(xref-backend-apropos): Use it here.

; * lisp/progmodes/python.el (python-shell-send-string): Fix last change.

Improve documentation of tab-bar functions and variables

* etc/NEWS: Improve wording of tab-bar related entries.

* lisp/tab-bar.el (tab-bar-show, tab-bar-select-tab-modifiers):
Improve and clarify the doc strings.

Fix a recent change wrt 'comint-max-line-length'

* lisp/progmodes/python.el (python-shell-send-string): Only heed
'comint-max-line-length' for subprocesses with which we
communicate via PTYs.  (Bug#49822)

* lisp/comint.el (comint-max-line-length): Doc fix.  Add a value
for MS-Windows.

Change ruby-align-chained-calls indendation

* lisp/progmodes/ruby-mode.el (ruby-smie-rules): Align with the
first sibling on the previous line instead of the last (bug#32496).

That is, before it used to be

one.two.three
       .four

and now it is

one.two.three
   .four

Better treatment of line length limits for the Python inferior

* lisp/comint.el (comint-max-line-length): New constant reflecting a
safe maximum line size that can be sent to an inferior process.
* lisp/progmodes/python.el
(python-shell-comint-watch-for-first-prompt-output-filter): Send setup
code to the inferior process only once and at this stage.
(python-shell-eval-setup-code, python-shell-eval-file-setup-code):
Move, unchanged, to an earlier point to avoid byte-compiler warnings.
(python-shell-send-string-no-output): Revert changes of e32c7d2a8d
(python-shell-send-string): Use 'comint-max-line-length' to decide
when to resort to temp files.
(python-shell-send-string, python-shell-send-file): Don't send setup
code each time (bug#49822).

Clarify Gnus vs. font locking in the Gnus manual

* doc/misc/gnus.texi (Formatting Variables): Explicitly mention
that font locking doesn't work in Gnus buffers (bug#50474).

Remove the "Real meaning of copyleft" node in efaq

* doc/misc/efaq.texi (Real meaning of copyleft): Remove the
section (bug#50446).
(Common acronyms): Add a link to the GNU site's page about licenses.

; Add NEWS about tab bar mouse commands

Merge branch 'feature/tab-bar-events'

; Remove NEWS about tab bar mouse commands to avoid merge conflicts

Document restriction of completion styles with remote file names

* doc/misc/tramp.texi (File name completion): Mention restriction
of completion styles.

Don't ding at the user in pop-mark

* lisp/simple.el (pop-mark): Don't ding at the user if there's no
mark to pop (bug#44375).  This function is used (in some
circumstances) when the user mouse-1-clicks links (in *Help*
buffer, for instance), which will then ding at the user before
following the link.

Further tweak describe-variable look

* lisp/help-fns.el (describe-variable): Tweak how long variable
values are shown.

Merge branch 'master' of git.savannah.gnu.org:/srv/git/emacs

; * admin/README: Add descriptions of more subdirectories.

; * admin/README: Mention 'coccinelle'.

* etc/NEWS: macOS alternative context menu mouse binding.

Fix previous help-fns change

* lisp/help-fns.el (help-fns--run-describe-functions): Fix the
test for whether the function inserted anything.

Adjust test to describe-function changes

The doc now always ends with an empty line

Allow kmacros to end with C-g in minibuffer

* src/keyboard.c (cmd_error): If a command causes a minibuffer-quit
condition, record its key in a keyboard macro (bug#48603).

Add support for keypad `=' key in xterm.el

* lisp/term/xterm.el (xterm-function-map): Add support for keypad
= key (bug#16645).

Don't disable ipython as a native interpreter

* lisp/progmodes/python.el
(python-shell-completion-native-disabled-interpreters): Remove
ipython from list, because it apparently works fine these days
(bug#50458).

Fix mail-user-agent defcustom type

* lisp/simple.el (mail-user-agent): Any symbol can be used as the
value (bug#50460).

Move the indented *Help* block to after the doc string

* lisp/help-fns.el (describe-function-1): Move indented admin
block to the end (bug#50463).
(describe-variable): Ditto (bug#50463).

Don't output "probably introduced" if we know the answer for sure

* lisp/help-fns.el (help-fns--customize-variable-version):
Factored out from `help-fns--customize-variable' to be able to see
whether it outputs anything.
(help-fns--run-describe-functions): New function.
(help-fns--activated-functions): New internal variable.
(describe-variable): Use new function.
(describe-face, describe-function-1): Ditto (bug#50463).

Center Emacs logo above text on the splash screen

* lisp/startup.el (fancy-splash-head): Center Emacs logo above
text on the splash and about screen.

Have Git backend actions accept nil filenames again

* lisp/vc/vc-git.el (vc-git--literal-pathspec):
Move the nil check to the beginning (bug#50422).

cperl-mode.el: Use rx sequences for Perl grammar

Following advice by Mattias Engdegård, most uses of rx-to-string
were eliminated, and rx sequences used instead to define Perl
grammar components.
* lisp/progmodes/cperl-mode.el: (cperl-block-declaration-p): New
function, replaces regexp literals.
(cperl-imenu--function-name-regexp-perl): Deleted, use rx
sequences to find imenu entries instead.
(cperl-indent-line): Use rx components instead of regexp literals.
(cperl-sniff-for-indent): use `cperl-block-declaration-p' to
increase accuracy, use rx sequence for labels to replace
inaccurate regexp literals.
(cperl-block-p): Replace inline comment by docstring.  Use
`cperl-block-declaration-p'.
(cperl-after-block-p): Use `cperl-block-declaration-p'.
(cperl-after-block-and-statement-beg): Replace inline comment by
docstring.
(cperl-imenu-package-keywords), (cperl-imenu-sub-keywords),
(cperl-imenu-pod-keywords) : New variables to sort imenu
entries into categories.
(cperl-imenu--create-perl-index): Use rx sequences to collect
imenu entries.
(cperl-init-faces): Use rx components instead of regexp literals
for labels.

* test/lisp/progmodes/cperl-mode-tests.el: Test rx sequences
instead of regexp strings

Don't let nndiary.el alter variables when loading file

* lisp/gnus/nndiary.el (nndiary-open-server): Move the manipulation of
`gnus-extra-headers' and `nnmail-extra-headers' into this function: it
should only happen if we're actually firing up an nndiary server.
Previously, simply attempting to complete a gnus-* prefixed symbol
could end up loading this file, and changing the variable values.

; Improve resolution of previous merge conflict

Increase jit-lock-chunk-size from 500 to 1500 for performance reasons

* lisp/jit-lock.el (jit-lock-chunk-size): Increase to 1500.

See also https://lists.gnu.org/archive/html/emacs-devel/2021-09/msg00540.html.

; * doc/emacs/maintaining.texi (Project File Commands): Fix wording.

Encode urls more before using in browse-url

* lisp/net/browse-url.el (browse-url-default-windows-browser)
(browse-url-default-macosx-browser): Encode the URL before using
(in case it contains spaces) (bug#50435).

Fix encoding in browse-url-encode-url

* lisp/net/browse-url.el (browse-url-url-encode-chars): Document
what the argument really is, and simplify the implementation
(bug#50435).
(browse-url-encode-url): Encode spaces.

Add a new Gnus command to toggle whether to use fonts in shr

* doc/misc/gnus.texi (Article Washing): Document it.

* lisp/gnus/gnus-art.el (gnus-article-toggle-fonts): New command
and key binding (bug#50383).

Improve the Info mode line further

* lisp/info.el (Info-set-mode-line): Improve the Info mode line
further (bug#13776).

Merge branch 'master' of git.savannah.gnu.org:/srv/git/emacs

Fix a recent documentation change

* lisp/progmodes/xref.el (xref-auto-jump-to-first-definition)
(xref-auto-jump-to-first-xref):
* etc/NEWS: Fix wording and typos.

Merge from origin/emacs-27

97aa8240d2 (origin/emacs-27) * doc/misc/efaq.texi: Misc copyedits.
e1050492d1 * doc/misc/efaq.texi (Reporting bugs): Refer to the Emacs ...

# Conflicts:
# doc/misc/efaq.texi

Adapt tramp-test26-file-name-completion

* test/lisp/net/tramp-tests.el (tramp-test26-file-name-completion):
Do not check for default method.

Improve documentation of new Xref options

* lisp/progmodes/xref.el (xref-auto-jump-to-first-definition)
(xref-auto-jump-to-first-xref): More accurate description in the
doc strings.

* doc/emacs/maintaining.texi (Looking Up Identifiers)
(Identifier Search, List Identifiers, Project File Commands): Fix
the documentation of 'xref-auto-jump-to-first-definition' and
'xref-auto-jump-to-first-xref' to be more accurate.

* etc/NEWS: More accurate wording of the entry about
'xref-auto-jump-to-first-definition' and
'xref-auto-jump-to-first-xref'.

Do not expand default method, user, host in remote file name completion

* lisp/net/tramp.el (tramp-completion-handle-file-name-all-completions):
Do not expand default method, user, host.  (Bug#50387)
(tramp-get-completion-methods): `partial-method' can be nil.

Fix display of tab-bar buttons

* src/xterm.c (x_draw_image_relief):
* src/w32term.c (w32_draw_image_relief): Fix calculation of relief
thickness for tab-bar buttons.

* lisp/tab-bar.el (tab-bar--load-buttons)
(tab-bar-history-mode): Fix the :margin specification for tab-bar
buttons.  (Bug#50424)

* test/lisp/vc/vc-tests.el (vc-test--version-diff): Git env tweak.

Support specifying just one command in project-switch-commands

* lisp/progmodes/project.el (project-switch-commands):
Describe the new possible type of value.
(project--switch-project-command):
New function, extract from project-switch-project.
(project-switch-project): If project-switch-commands's value is a
symbol, invoke that command without showing a menu.

Co-authored-by: Jiacai Liu <hello@liujiacai.net>

Small FAQ fixes

* doc/misc/efaq.texi (Colors on a TTY): Remove reference to
ancient Emacs version 22.
(Finding Emacs on the Internet): Use more current terminology.

Remove Emacs FAQ maintainer

* doc/misc/efaq.texi: Remove maintainer Romain Francoise after private
communication.

* etc/NEWS: Some further re-organization.

* etc/NEWS: Clarify entry about the "*Completions*" buffer.

Add possibility to override the default highlighting

* lisp/progmodes/bug-reference.el (bug-reference-fontify): Highlight
99th group if it exists.
(bug-reference-bug-regexp): Document that regexp group 99 can be used
to override the default behavior of highlighting the complete match.
(bug-reference--run-auto-setup): Use run-hook-with-args-until-success
instead of throw/catch.

; * etc/NEWS: revert a change that changed the meaning slightly

Normalise nested `progn` forms in byte-code optimiser

* lisp/emacs-lisp/byte-opt.el (byte-optimize-body): Flatten body.
This simplifies the source tree and reduces the number of different
cases that other optimisations need to take into account.

More robust optimisation of `ignore`

Treat `ignore` as any other function during source-level optimisation,
to avoid having its warning-suppression effects cancelled by repeated
passes.  Instead, define a custom code generation function.

* lisp/emacs-lisp/byte-opt.el (byte-optimize-form-code-walker):
Don't treat `ignore' specially here.
(side-effect-free-fns): Don't mark `ignore` as side-effect-free
or error-free (although it is), since that would allow the optimiser
to elide calls.
* lisp/emacs-lisp/bytecomp.el (ignore, byte-compile-ignore):
Define and register a code-gen function.

Optimise `member` and `assoc` (etc) with constant empty list

* lisp/emacs-lisp/byte-opt.el
(byte-optimize-assq): New.
(byte-optimize-member, byte-optimize-assoc, byte-optimize-memq):
When the list argument is constant nil, the result is always nil.
* test/lisp/emacs-lisp/bytecomp-tests.el (bytecomp-tests--test-cases):
Add test cases.

Fixup dired-do-find-regexp-and-replace

* lisp/dired-aux.el (dired-do-find-regexp-and-replace):
Disregard the customized value of xref-auto-jump-to-first-xref
(it breaks the xref-query-replace-in-results invocation).

* lisp/progmodes/xref.el (xref-auto-jump-to-first-xref):
Mention the caveat for users or xref distributed through ELPA.

Revert an accidential change in etc/NEWS

; Fix typos in etc/NEWS

Make calc-grab-region work with rectangular selects

* lisp/calc/calc.el (calc-grab-region): Heed `rectangle-mark-mode'
(bug#50403).

Restore the debugging window size more reliably

* lisp/emacs-lisp/debug.el (debug): Restore the debugging window
size more reliably (bug#12921).

Add a tooltip to the comint-mode mode line format

* lisp/comint.el (comint-mode): Add a tooltip to say what the :run
bit means (bug#13776).

Improve the info-mode mode line

* lisp/info.el (Info-set-mode-line): Add a help echo to help
explain what the thing in parentheses is (bug#13776).

; * lisp/tab-bar.el (toggle-frame-tab-bar, tab-bar-new-tab-to): Doc fix.

Merge branch 'master' of git.savannah.gnu.org:/srv/git/emacs

Merge branch 'master' of git.savannah.gnu.org:/srv/git/emacs

Simplify `image-dired-dired-file-marked-p'

* lisp/image-dired.el (image-dired-dired-file-marked-p): Use
`dired-re-mark' instead of open-coding the opposite regexp (bug#14925).

; * etc/NEWS: Rearrange and fix wording of some entries.

Improve the gnus-group-default-list-level doc string

* lisp/gnus/gnus-group.el (gnus-group-default-list-level): Improve
doc string.

Reset gnus-group-use-permanent-levels when Gnus restarts

* lisp/gnus/gnus-start.el (gnus-clear-system): Reset
`gnus-group-use-permanent-levels' upon Gnus restart (bug#50416).

Make `gnus-group-use-permanent-levels' work better

* lisp/gnus/gnus-group.el (gnus-group-default-level): Removed implicit
setting of gnus-group-use-permanent-levels.
(gnus-group-list-groups): Set gnus-group-use-permanent-levels
explicitly.
(gnus-group-get-new-news): Set gnus-group-use-permanent-levels
explicitly (bug#50417).
(gnus-group-get-new-news): When the user has given a numeric
prefix, use that as the list level.

; * etc/NEWS: Restore entry that had been inadvertently deleted.

* etc/NEWS: Reorder "Isearch and Replace" items

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

* etc/NEWS: Improve file organization.

Improve documentation of save-place-abbreviate-file-names

* lisp/saveplace.el (save-place-abbreviate-file-names): Document why
you might want to enable this option.

* etc/NEWS: Don't mention a fixed bug.

; * test/lisp/newcomment-tests.el: Fix copyright year.

project--files-in-directory: Fix handling of ignores

* lisp/progmodes/project.el (project--files-in-directory):
Pass "." as the DIR argument to 'find' because otherwise the ignore
expression can match the project root directory name, which we don't
want to happen (bug#50240).  Fixup the resulting file names at the end
with concatenation.
Originally I thought it could lead to worse performance, but the
results show equal or slightly better timings.

* lisp/progmodes/xref.el (xref-matches-in-directory):
Apply a similar fix.
(xref--find-ignores-arguments): Use file-name-as-directory, so
that when passed "." replace-match still had the expected effect.

* test/lisp/progmodes/project-tests.el (project-ignores-bug-50240):
New test.

* test/lisp/progmodes/xref-tests.el
(xref-matches-in-directory-filters-with-ignores): New test.

Try to fix vc-test-git06-version-diff on Hydra

* test/lisp/vc/vc-tests.el (vc-test--version-diff):
Fix Git backend when running in clean environment.
(vc-test-git06-version-diff): Unskip on Hydra.

* doc/misc/efaq.texi: Misc copyedits.

Prefer mailing lists to newgroups.
(History of Emacs): Rename from "Status of Emacs".
Move XEmacs node here.
(Emacs for other operating systems): Merge all the "non-Unix"
systems into a single node.

* test/lisp/vc/vc-tests.el (vc-test-git06-version-diff): Skip on hydra.

* lisp/progmodes/xref.el: Bump the version again.

; * lisp/indent.el (tab-first-completion): Fix :version tag.

Improve tab-bar event handling (bug#41343)

* lisp/tab-bar.el (tab-bar--key-to-number): Rename from tab--key-to-number.
(tab-bar--event-to-item): New function from tab-bar-handle-mouse.
(tab-bar-mouse-select-tab, tab-bar-mouse-close-tab)
(tab-bar-mouse-context-menu, tab-bar-mouse-move-tab):
Use tab-bar--event-to-item.

* src/menu.c (x_popup_menu_1): Handle Qtab_bar in the second list element.

* src/xdisp.c (tty_get_tab_bar_item): Change arg 'end' to bool 'close_p'.
(tty_get_tab_bar_item): Detect if the close button was clicked.
(tty_handle_tab_bar_click): Return a list with caption that has
text properties.

Autoload cl-struct-slot-info

* lisp/emacs-lisp/cl-macs.el (cl-struct-slot-info): Autoload
(bug#50301).

* test/lisp/emacs-lisp/memory-report-tests.el: Don't require cl-macs.

; * etc/NEWS: Fix a recent change.

Improve the documentation around the read-key/minibuffer prompting

* lisp/subr.el (read-char-choice-use-read-key): Explain the
difference.
(read-char-choice): Mention the variables.
(y-or-n-p-use-read-key): Explain the difference.
(y-or-n-p): Mention the variable (bug#50390).

Clarify completion-list-mode NEWS entry

* etc/NEWS: Clarify completion-list-mode entry (bug#50394).

; * doc/emacs/maintaining.texi (Looking Up Identifiers): Fix last change.

* lisp/progmodes/xref.el: Fix defcustoms (bug#50067)

* lisp/progmodes/xref.el (xref-auto-jump-to-first-definition)
(xref-auto-jump-to-first-xref, xref-search-program): Fix defcustoms.

Improve documentation of new Xref options

* doc/emacs/maintaining.texi (Looking Up Identifiers):
* etc/NEWS: Document the new Xref user options.  Move a lost
Xref-related entry to the rest of them.

Fixes for 'python-shell-send-string' and 'python-shell-send-file'

* lisp/progmodes/python.el (python-shell-send-string): use a temporary
file for sufficiently long strings.
(python-shell-send-file, python-shell-eval-file-setup-code): Avoid
showing "plumbing code" in the traceback (bug#32042).

Fix error handling in 'ispell-init-process'

* lisp/textmodes/ispell.el (ispell-init-process): When Ispell
initialization reports an error, call 'ispell-accept-output' only
if the Ispell process is still alive.  (Bug#50370)

Copyright-paperwork-exempt: yes