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

Xref: automatic jumping to the first definition or reference

* lisp/progmodes/xref.el (xref-auto-jump-to-first-definition)
(xref-auto-jump-to-first-xref): New user options.
Discussed in bug#50067.
(xref--show-xrefs, xref--show-defs): Use them here.
(xref--auto-jump-first): New function, handles different values.
(xref-show-definitions-buffer)
(xref-show-definitions-buffer-at-bottom): Use it.

Fix test on machines with Bzr not set up

* test/lisp/vc/vc-tests.el (vc-test--version-diff):
Add EMAIL= to the environment to avoid potential failure.

Add tests for vc-version-diff

* test/lisp/vc/vc-tests.el (vc-test--version-diff):
New function.
(vc-test-%s06-version-diff): New family of tests.

Rename xref-select-and-{goto,show}-xref

* lisp/progmodes/xref.el (xref-select-and-show-xref):
Rename from xref-select-and-goto-xref (bug#35376).
Update all references.

Avoid segfault in command-modes

* src/data.c (Fcommand_modes): Check that bytecode object is
interactive before accessing its interactive spec to avoid
segfaulting (bug#50376).

; * etc/NEWS: Fix copyright year; file recreated in 2019 for 28.1.

; * etc/NEWS: Fix markup in recent example.

* lisp/emacs-lisp/timer.el (timer-create): Don't inline it

Improve documentation of line truncation and wrapping

* doc/emacs/display.texi (Line Truncation, Visual Line Mode):
* doc/lispref/display.texi (Truncation): Document that turning on
line truncation disables wrapping, and vice versa.

* src/buffer.c (syms_of_buffer) <truncate-lines>:
* src/xdisp.c (syms_of_xdisp) <truncate-partial-width-windows>:
Warn against turning on when 'visual-line-mode' is in effect.
* lisp/simple.el (visual-line-mode): Document that this mode
disables line truncation.  (Bug#29664)

Allow killing the diff buffer after `C-x v u'

* doc/emacs/maintaining.texi (VC Undo): Document this.
* lisp/vc/vc.el (vc-revert-show-diff): Allow a `kill' value.
(vc-revert): Use it (bug#16902).

Improve error message in ielm on printing errors

* lisp/ielm.el (ielm-eval-input): Don't claim that there's a bug
on pp -- it may just be something that nests too far (bug#18012).

Add a customization group link from whitespace-mode

* lisp/whitespace.el (whitespace-mode): Add a link to the
whitespace customization group to see the faces (bug#18296).

Add support for customization group hyperlinks in doc strings

* lisp/help-mode.el (help-customization-group): New button.
(help-xref-customization-group-regexp): New const.
(help-make-xrefs): Use them to allow making customization group
buttons.

Make multi-frame `M-x calendar' setup work when `pop-up-frames'

* lisp/calendar/calendar.el (calendar): Make the calendar frame
setup work when pop-up-frames is non-nil (bug#19256).

Tweak hi-lock-mode doc string

* lisp/hi-lock.el (hi-lock-mode): Tweak the doc string so that
running hi-lock-mode in a *Help* buffer showing this help text
won't issue an error (bug#20977).

Make `M-x term' offer completion

* lisp/term.el (term): Have completion in the prompt (bug#21296).

Add diary-offset to diary-lib.el

* doc/emacs/calendar.texi: Document the change.
* lisp/calendar/diary-lib.el (diary-offset):
* test/lisp/calendar/icalendar-tests.el: Add a test (bug#50195).

* etc/DISTRIB: Refer to gnu.org instead of the deleted file etc/GNU.

Merge from origin/emacs-27

0aa0410372 (origin/emacs-27, emacs-27) Fix "Finder" description for m...

Change Python eval to send directly instead of using temporary files

* lisp/progmodes/python.el (python-shell-eval-setup-code): New
const for setting up eval (bug#49822).
(python-shell--encode-string): New function.
(python-shell-send-string): Use it to send commands directly
instead of writing to a temporary file.
(python-shell-send-string-no-output): Adjust sending.
(python-shell-send-file): Ditto.

Update to CSS Flexible Box Layout Module Level 2

* css-mode.el (css-property-alist): Update link.

Update to CSS Containment Module Level 2

* css-mode.el (css-property-alist): Update contain, and add
content-visibility.

Update to CSS Grid Layout Module Level 2

* css-mode.el (css-property-alist): Update to the newer spec, and add
the subgrid keywords

Clean up css-property-alist for alignment

* css-mode.el (css-property-alist, css-value-class-alist): Provide new
position related entries for use in css-property-alist.  Make sure
that property-alist reflect the spec:
https://www.w3.org/TR/css-align-3/#property-index

Fix `describe-function' for autoloaded adviced functions

* lisp/emacs-lisp/nadvice.el (advice--make-single-doc): Factor
out.
(advice--make-docstring): From here (bug#23523).  Also include
advices for autoloads.

Allow gud-mi to edit two executables with the same name

* lisp/progmodes/gud.el (gud-common-init): Allow editing two
executables with the same name (bug#22772).

; Fix typos

Make recent timer changes more backwards-compatible

* lisp/emacs-lisp/timer.el (timerp, timer-event-handler): Make
backwards-compatible with old .elc files that have their own
versions of `timer-create'd structures.

Fix message in previous toggle-truncate-lines change

* lisp/simple.el (toggle-truncate-lines): Fix message in previous
change.

Allow not putting pasted text onto the kill ring under xterm

* lisp/term/xterm.el (xterm-paste): Don't put pasted text onto the
kill ring (bug#28868).
(xterm-store-paste-on-kill-ring): New user option.

* etc/NEWS: Announce recent change in 'toggle-truncate-lines'.

Sync latest SKK-JISYO.L

* leim/SKK-DIC/SKK-JISYO.L: Sync to current upstream version.

Update publicsuffix.txt from upstream

* etc/publicsuffix.txt: Update from
https://publicsuffix.org/list/public_suffix_list.dat
dated 2021-09-02 22:13:03 UTC.

Make toggle-truncate-lines disable visual-line-mode

* lisp/simple.el (toggle-truncate-lines): Disable
`visual-line-mode' (bug#29664).

Avoid cl-lib alias for cadadr and friends

* lisp/edmacro.el (edmacro-fix-menu-commands):
* lisp/frameset.el (frameset-move-onscreen):
* lisp/htmlfontify.el (hfy-face-at, hfy-merge-adjacent-spans)
(hfy-mark-tag-names):
* lisp/mail/footnote.el (footnote--make-hole)
(footnote-back-to-message):
* lisp/net/eudc.el (eudc-get-email, eudc-get-phone):
* lisp/net/rcirc.el (rcirc-make-trees, rcirc-handler-333)
(rcirc-authenticate):
* lisp/play/5x5.el (5x5-draw-grid, 5x5-solver):
* lisp/play/decipher.el (decipher-insert-frequency-counts):
* lisp/ses.el (ses-relocate-range):
* test/lisp/emacs-lisp/edebug-tests.el (edebug-tests-step-into-macro-error)
(edebug-tests-error-stepping-into-subr): Avoid using cl-lib aliases
for cadadr and friends that now reside in subr.el.

Move cl-lib tests for caaXr to subr-tests.el

* test/lisp/emacs-lisp/cl-lib-tests.el (cl-test-caaar)
(cl-test-caadr): Move tests using a cl-lib alias from here...
* test/lisp/subr-tests.el (subr-test-caaar, subr-test-caadr): ...to
here.  The functions under test are in subr.el.

Add CSS Box Alignment Module Level 3 to css-mode

* lisp/textmodes/css-mode.el (css-property-alist): Consolidate
`align-{contents, items, self}', as well as the corresponding
values for `justify-{contents, items, self}' and `place-{contents,
items, self}'.  Values extracted from the flex part and into its
own block (bug#50345).

Add selection to css-pseudo-element-ids

* lisp/textmodes/css-mode.el (css-pseudo-element-ids): Add
selection as an element id (bug#50345).

Fix `revert-buffer' message in `find-file-select'

* lisp/files.el (find-file-noselect): Refer to revert-buffer-quick
here since we're in a file-based buffer.

Fix memory-report test failure

* test/lisp/emacs-lisp/memory-report-tests.el: Fix test build failure.

Fix recently broken vc-delete-file with Git

* lisp/vc/vc-git.el (vc-git-delete-file):
Treat FILE as string, not list (bug#50334).

More fixes for recently added vc-rename test

* test/lisp/vc/vc-tests.el (vc-test-cvs05-rename-file): Skip.
(vc-test-sccs05-rename-file): Treat like RCS.

Support forges by type rather than by host

Formerly, bug-reference-setup-from-vc-alist basically had one entry
per host (like gitlab.com).  Restructure so that it's easy to add new
hosts being just an instance of some type of forge such as SourceHut,
Gitea, or GitLab.

While we're at it, add support for gitea.com, salsa.debian.org, and
framagit.org, the latter two being GitLab instances.

* lisp/progmodes/bug-reference.el (bug-reference-gitea-instances)
(bug-reference-gitlab-instances,bug-reference-sourcehut-instances):
New variables listing online instances of those forges.
(bug-reference--setup-from-vc-alist): New function (and variable for
caching) using the former three new variables to generate suitable VC
auto-setup alist.
(bug-reference-try-setup-from-vc): Use both
bug-reference-setup-from-vc-alist and
bug-reference--setup-from-vc-alist.

* lisp/abbrev.el: Improve docstrings of inverse commands (bug#50303)

* lisp/abbrev.el (add-mode-abbrev, add-global-abbrev)
(inverse-add-mode-abbrev, inverse-add-global-abbrev):
Add interlinking to opposite commands in docstrings.

; * doc/emacs/dired.texi (Operating on Files): Fix last change.

Fix expansion of non-ASCII $HOME

* src/fileio.c (Fexpand_file_name): Make the file name multibyte
if the value of $HOME is multibyte.  (Bug#50266)

Fix 'clone-frame' on TTY frames

* src/frame.c (Fmake_terminal_frame): Make a separate copy of the
faces for the new frame before calling modify-frame-parameters, as
on TTY frames that needs the faces already set up.  (Bug#34715)

Improve a recent change in 'mule-cmds.el'

* lisp/international/mule-cmds.el
(select-safe-coding-system--format-list): Display codepoints in
hex and as characters.  Display the ellipsis in a better place.
Enlarge the limit to 5 codepoints, as the display is now easier to
grasp.
(select-safe-coding-system-interactively): Don't use
'select-safe-coding-system--format-list' for "rejected"
coding-systems, as those don't come with characters and positions.

Make the coding system warning prettier

* lisp/international/mule-cmds.el
(select-safe-coding-system--format-list): New function to display
the coding system information in a more readable format (bug#31062).
(select-safe-coding-system-interactively): Use it.

Reformat up-list and backward-up-list doc strings

* lisp/emacs-lisp/lisp.el (backward-up-list): Reformat the doc
string into several paragraphs (bug#31349).
(up-list): Ditto and fix the "start" to be "end".

isearch*-lax-whitespace doc string improvements

* lisp/isearch.el (isearch-regexp-lax-whitespace):
* lisp/isearch.el (isearch-lax-whitespace): Mention the key binding
in the doc string (bug#31790).

Fix documentation of `dired-do-touch'

* doc/emacs/dired.texi (Operating on Files): Fix documentation of
`dired-do-touch' (bug#50323).

memory-report: support calculating size for structures

* lisp/emacs-lisp/memory-report.el (memory-report--object-size-1): Add
support for cl-defstruct types (bug#50301).

Fix up previous ebfn2ps tweak

* lisp/progmodes/ebnf2ps.el (ebnf-print-buffer): Remove NOOP decode
step.

Add a test for bug#50320 in sh-script

Revert "Tweak sh-script-mode indentation further"

This reverts commit 6392bc37ab3b7eb83465d9b2248d21173373ae73.

The changes led to errors throughout (bug#50320).

tramp-auto-save-directory: make private

* lisp/net/tramp.el (tramp-handle-make-auto-save-file-name):
chmod 0700 tramp-auto-save-directory when creating

Thanks to Michael Albinus for reviewing this patch.

Fix segfault with invalid key-translation-map binding

* src/keyboard.c (access_keymap_keyremap): Don't assume an invalid
function is specified as a symbol.  Reported by Perry E. Metzger
<perry@piermont.com>.

Filter out the `name' parameter in clone-frame

* lisp/frame.el (clone-frame): Filter out the `name' parameter,
because two frames shouldn't have the same name and this will
lead to a warning.

Don't have epg bug out on non-existent packages

* lisp/epg.el (epg--start): We may be called from contexts where
the directory doesn't exist, but we need to have an existing
directory here for the process (bug#32004).

Add new macro `with-existing-directory'

* doc/lispref/files.texi (Testing Accessibility): Document it.
* lisp/subr.el (with-existing-directory): New macro (bug#32004).

; Auto-commit of loaddefs files.

* Add a dll loader entry for gcc_jit_context_new_cast (bug#50315)

* src/comp.c: Add a dll loader entry for
'gcc_jit_context_new_cast' (bug#50315).

Add new command `clone-frame'

* doc/emacs/frames.texi (Creating Frames): Document it.

* lisp/frame.el (clone-frame): New command and keystroke (bug#34715).

Make set-foreground-color display completions using foreground colors

* lisp/faces.el (defined-colors-with-face-attributes): Also create
colors for foregrounds (bug#33799).
(read-color): Also allow varying the foreground color.

* lisp/frame.el (set-foreground-color): Vary the foreground color.

Fix (setf (map-elt map key) (my-func))

* lisp/emacs-lisp/map.el (map-elt): Ensure that the value isn't
referenced more than once (bug#50290).

Autoload calc-grab-sum-across and calc-grab-sum-down

* lisp/calc/calc.el (calc-grab-sum-down):
(calc-grab-sum-across): Autoload, since they can be used from
outside Calc (bug#50311).

In batch mode, avoid killing Emacs with C-g in the minibuffer

* src/keyboard.c (Fcommand_error_default_function): Don't kill emacs
when handling the minibuffer-quit condition (bug#48603).

Use "gzip -d" instead of "gunzip"

* lisp/dired-aux.el (dired-compress-file-suffixes): Use "gzip -d"
instead of "gunzip" since we already assume that "gzip" exists on
the system (bug#10990).

Copyright-paperwork-exempt: yes

Avoid failing if vc backend doesn't implement ignore-completion-table

* project.el (project-ignores): Handle vc-not-supported signals

; Add comment to tramp-read-passwd for debugging

Rename xref--mouse-2 and adjust documentation

* doc/emacs/maintaining.texi (Xref Commands): `mouse-1' is bound
to `xref-goto-xref', not `mouse-2' (bug#35376).
(Xref Commands): Mention what `mouse-2' does.

* lisp/progmodes/xref.el (xref--button-map): Adjust.
(xref-select-and-goto-xref): Rename from xref--mouse-2 (bug#35376).

Fix point placement after ispell-complete-word

* lisp/textmodes/ispell.el (ispell-complete-word): Leave point at
the end of the inserted word instead of a less than useful amount
of distance from the start of the word (bug#37552).

call-process doc string clarification

* src/callproc.c (Fcall_process): Explicitly say that "output"
means both stdout and stderr (bug#37906).

Make calc plotting through gnuplot work on non-X gnuplots

* lisp/calc/calc-graph.el (calc-graph-plot): Fall back on "dumb"
if we don't support the terminal (bug#50237).
(calc-gnuplot-command): Say whether the command errored out.

Fix abnf parsing of <prose> elements

* lisp/progmodes/ebnf-abn.el (ebnf-abn-lex): Make <prose> parsing
work (bug#39663).

Make run-at-time try harder to run at integral multiples

* lisp/emacs-lisp/timer.el (timer): Add new slot integral-multiple.
(timerp): Adjust.
(timer-event-handler): Recompute the delay if requested
(bug#39099).
(run-at-time): Mark the timer as recomputable if given a t
parameter.

* src/keyboard.c (decode_timer): Adjust.

Move the expansion of abbreviated names to vc-git.el

* lisp/vc/vc-git.el (vc-git--literal-pathspec):
Perform the expansion of abbreviated file names here instead
(bug#39452).

* lisp/vc/vc.el (vc-root-diff, vc-print-root-log):
Undo the recent change.

; cperl-mode.el: Fix border cases of inserting with elisp

* lisp/progmodes/cperl-mode.el (cperl-unwind-to-safe): Replace
(and extend) inline comment by a docstring.  Handle edge cases when
inserting text with elisp (related to Bug#28962).
(cperl-process-here-doc): Add syntax-type `here-doc-start'.
(cperl-find-pods-heres): Make sure that the results of this
function are immediately visible.

* test/lisp/progmodes/cperl-mode-tests.el (cperl-test-bug-14343):
Add test cases for "empty" here-documents and inserting at the
edges of a here-document.

Implement proper type conversion in native compiler

* src/comp.c (enum cast_kind_of_type): Remove.
(comp_t): Add cast_ptr_to_int, cast_int_to_ptr, remove
cast_type_sizes, cast_type_kind, cast_type_names, cast_union_fields,
cast_union_field_biggest_type.
(emit_coerce): Remove check for type size.
(struct cast_type): Remove bytes_size.
(define_type_punning): New function.
(define_cast_from_to): Implement proper type conversion.
(define_cast_functions): Adjust.  (bug#50230)

(cperl-test-bug-14343): Make it work for perl-mode

* test/lisp/progmodes/cperl-mode-tests.el (cperl--tests-heredoc-face):
New const.
(cperl-test-heredocs, cperl-test-bug-14343): Use it.
(cperl-test-identify-no-heredoc): Remove left-over message.

* test/lisp/progmodes/cperl-mode-tests.el: Adjust here-doc tests for perl-mode

(cperl-test-identify-heredoc, cperl-test-identify-no-heredoc):
Tweak tests so they can also be used for perl-mode.

* etc/NEWS: Fix typo

Improve documentation of 'ispell-hunspell-add-multi-dic'

* lisp/textmodes/ispell.el (ispell-hunspell-add-multi-dic):
Explain in the doc string how to call from Lisp.  (Bug#50241)

Minor improvement in 'get-locale-names' on MS-Windows

* lisp/international/mule-cmds.el (get-locale-names): Delete
duplicate locales from the list returned by the MS-Windows
implementation.

Fix typo in kill-buffer-delete-auto-save-files NEWS entry

Make some non-ASCII work in ebnf2ps

* lisp/progmodes/ebnf2ps.el (ebnf-print-buffer): Make non-ASCII
work slightly better (bug#39663).

Fix typo in previous custom.texi change

* doc/emacs/custom.texi (Init Syntax): Fix typo in previous change
-- it's customize-set-variable.

Make epg use rfc6068 for decoding %-encoded strings

* lisp/epg.el (epg--decode-percent-escape-as-utf-8): Make obsolete
and adjust callers.
(epg--decode-hexstring): Ditto.

* lisp/mail/rfc6068.el (rfc6068-unhexify-string): Allow returning
non-decoded octets (bug#39689).

Make rfc2368 obsolete and add rfc6068

* lisp/obsolete/rfc2368.el: Moved here and made obsolete.

* lisp/mail/rfc6068.el (rfc6068-unhexify-string): New file.

Only look for the port command on MacOS

* configure.ac: Only look for the port command on MacOS (bug#50259).

Move vc-branch-p and vc-branch-part from vc.el to vc-rcs.el and rename

* lisp/vc/vc-rcs.el (vc-rcs-branch-p): Renamed from `vc-branch-p'
(old name made into obsolete alias) and moved from vc.el.
(vc-rcs-branch-part): Renamed from `vc-branch-part'
(old name made into obsolete alias) and moved from vc.el.

Fix vc test for RCS

* test/lisp/vc/vc-tests.el (vc-test--rename-file): Fix test for RCS.

Mention `set-variable' in the Init Syntax Emacs manual node

* doc/emacs/custom.texi (Init Syntax): Mention set-variable
(bug#50248).
(Init Examples): Add an example.

Change --with-nativecomp to --with-native-compilation in messages

* configure.ac:
* test/infra/Dockerfile.emba:
* test/infra/gitlab-ci.yml: Fix mentions of --with-nativecomp
(bug#50255).

Add support for OSC 7 in comint (current directory tracking)

* lisp/comint.el (comint-osc-directory-tracker, comint-osc-handlers):
Define and register a handler for OSC 7.
(comint-osc-process-output): Do fewer checks on
'comint-last-output-start'.

Tweak sh-script-mode indentation further

* lisp/progmodes/sh-script.el (sh-smie--default-backward-token):
Allow more parentheses in a token (bug#44592).

Improve compatibility with musl-libc (Bug#48789)

* lib-src/seccomp-filter.c (export_filter): Remove use of
nonstandard macro TEMP_FAILURE_RETRY.

; * src/xfaces.c (gui_supports_face_attributes_p): Fix typo in comment.