Improve style and comments in font-related sources

* src/w32font.c (fill_in_logfont): Stylistic changes.
* src/font.h (font_property_index, font_select_entity):
Add/improve comments.

; Fix typos

Improve documentation of 'decode-coding-region'

* src/coding.c (Fdecode_coding_region): Doc fix.

* doc/lispref/nonascii.texi (Coding System Basics)
(Explicit Encoding): Explain the significance of using 'undecided'
in 'decode-coding-*' functions.

Fix problem with temp buffer killing in package-install-file

* lisp/emacs-lisp/package.el (package-install-file): Allow killing
the temporary buffer without querying (bug#51769).

Fix Lisp Intro markup error

* doc/lispintro/emacs-lisp-intro.texi (Insert let): Fix @code
markup error (bug#51777).

Fix ACL errors with WebDAV volumes on MS-Windows

* src/w32.c (acl_get_file): Handle ERROR_INVALID_FUNCTION from
WebDAV.  Patch from Ioannis Kappas <ioannis.kappas@gmail.com>.
(Bug#51773)

Fix tramp-compat-file-name-concat (Bug#51754)

* lisp/net/tramp-compat.el: Make `tramp-compat-file-name-concat'
work like file-name-concat.  (Bug#51754)

* lisp/vc/vc-git.el (vc-git-mergebase): More meaningful error message.

Display a readable error message instead of signaling an error on nil value.

; Fix heading in etc/NEWS

; * etc/NEWS: Move a bookmark related item further down.

time-stamp: %F is "file name" not "pathname" + other doc

* lisp/time-stamp.el (time-stamp-format): doc 'file' instead of 'path'.
* test/lisp/time-stamp-tests.el (formatz, format-time-offset):
Clarify the difference and similarity between these two test helpers.

; Fix typos in CONTRIBUTE, ELisp manual, ediff

* CONTRIBUTE: Remove stray '. after git command.
* doc/lispref/functions.texi (Function Cells): Fix typo.
* lisp/vc/ediff.el (ediff-regions-wordwise): Fix typo in prompts
("Region's A buffer" => "Region A's buffer") (bug#51718).

Copyright-paperwork-exempt: yes

* doc/misc/eww.texi (Advanced): Fix missed variable name eww-retrieve-command.

* doc/emacs/windows.texi (Window Convenience): Use @code for windmove.

This refers to both a command and a user option.

* etc/NEWS: Add some ---.

* doc/emacs/maintaining.texi (Basic VC Editing): Mention Dired buffer.

* doc/emacs/text.texi (Outline Mode): Replace S-TAB with with S-<TAB>.

* etc/NEWS: Add some missing +++/--- and move some related items closer.

; * doc/emacs/building.texi (Lisp Libraries): Fix a typo.  (Bug#51717)

* lisp/progmodes/prog-mode.el (prog-context-menu): Use "Go Back" (bug#38797)

; Do not merge to master.

Revert "Fix localized display of date and time in the NS port"

This reverts commit 5e05be566b0e13ce0b4e75da663fb051039f0751.

This was discussed in
https://debbugs.gnu.org/cgi/bugreport.cgi?bug=51321#93

* lisp/mouse.el (mouse-buffer-menu-mode-groups): Tighten "Version Control".

Use word boundaries in the "Version Control" regexp to match mode names
"Log-Edit", "Log-View", "Git-Log-View", "Change Log", "VC dir",
but not "Verilog", "Prolog", "Rlogin" (bug#51337).

* doc/emacs/search.texi (Isearch Yank): Add isearch-forward-thing-at-point.

; * etc/NEWS: Add +++ for isearch-forward-thing-at-point, reorder (bug#51444).

; * etc/PROBLEMS: Move librsvg-related item to better location.

Reported by Mike Kupfer <mkupfer@alum.berkeley.edu>.

Amend Follow Mode to handle header lines and tab lines correctly

This fixes bug #51590.

list/follow.el (follow-scroll-down): Incorporate the height of the tab line
into the calculation of the window height.
(follow-calc-win-end): Incorporate the pixel heights of the header line and
the tab line the calculation of the buffer position of the bottom screen line.

* lisp/files.el (user-emacs-directory-warning): Clarify docstring.

* doc/emacs/frames.texi (Tab Bars): Add text about mouse and tab-bar-format

Briefly describe mouse commands on the tab bar and tab-bar-format (bug#51444)

* doc/emacs/frames.texi (Tab Bars): Describe tab-last.

'C-9' and 'M-9' already had kindex, so describe them in the text as well
(bug#51444).

; * etc/PROBLEMS: Minor clarification of a recent entry.

This was accidentally committed to master instead of emacs-28.

(cherry picked from commit a95520d3dfa1b97f88e51f1ee5ef07e278cb854a)

Add some unit tests for 'abbreviate-file-name'

* test/lisp/files-tests.el (files-tests-abbreviate-file-name-homedir)
(files-tests-abbreviate-file-name-directory-abbrev-alist): New tests.

Fix compilation MinGW warnings

* src/w32.h (prepare_standard_handles, reset_standard_handles):
Fix prototypes.  Reported by Andy Moreton
<andrewjmoreton@gmail.com> in
https://lists.gnu.org/archive/html/emacs-devel/2021-11/msg00597.html.

; * etc/PROBLEMS: More specific recipe for WebKit-related crashes.

Escape '%' in filenames to fix flymake warnings

* lisp/progmodes/flymake.el (flymake--log-1): Escape '%' in filenames
for 'warning-type-format' so they are not interpreted as a %-sequence
by 'format' later.  (Bug#51549)

Fix search string generation in nnimap-make-thread-query

* lisp/gnus/nnimap.el (nnimap-make-thread-query): Remove text
properties before constructing the search string (bug#49926).

Update to Org 9.5-68-g77e2ec

Fix dbus-test04-register-method on CentOS (Bug#51369)

* test/lisp/net/dbus-tests.el (dbus-test04-register-method):
Fix problem on CentOS.  (Bug#51369)

* lisp/transient.el: Update to package version v0.3.7-11-g7f5520b3.

; * etc/NEWS: Native compilation is more picky about missing dependencies.

; * etc/PROBLEMS: Move entry about LLVM plugin to the right section.

; * etc/PROBLEMS: Describe a crash in xwidgets due to Bubblewrap.

; * etc/PROBLEMS: Rearrange and update the section about crashes.

Clarify "text area of a window" in the documentation

* src/keyboard.c (Fposn_at_x_y): Clarify that the Y coordinate
includes the header-line and the tab-line.  (Bug#51590)

* doc/lispref/windows.texi (Window Sizes, Splitting Windows)
(Textual Scrolling, Coordinates and Windows): Fix/remove improper
or confusing uses of "text area" of a window.

Improve docstring of kmacro-set-format

* lisp/kmacro.el (kmacro-set-format): Improve docstring.
(kmacro-insert-counter, kmacro-display-counter)
(kmacro-set-counter, kmacro-add-counter): Add cross-references
to the info manual.

Revert "* lisp/wid-edit.el (widget-field): Add subtle border to face."

This reverts commit 8b024a6ff10f7907445ea60c4db8355638616ed1.

This lead to some alignment issues.  (Bug#51550)
Don't merge to master, where we will continue investigating.

* etc/PROBLEMS: Mention X forwarding slowdowns.  (Bug#7092)

* lisp/custom.el (defgroup): Document the :prefix keyword.

Document ibuffer-auto-mode in ibuffer-mode doc string

* lisp/ibuffer.el (ibuffer-mode): Mention ibuffer-auto-mode in the
ibuffer-mode doc string (bug#51584).

* doc/emacs/frames.texi (Tab Bars): Reorder toggle-frame-tab-bar.

; * etc/NEWS: slightly more careful wording

Use current face foreground for SVG icons in customize

It turns out these few icons were missed when the color and size
information was removed from the SVG icons that replaced XPM icons for
Customize buffer.
* etc/images/down.svg:
* etc/images/left.svg:
* etc/images/right.svg:
* etc/images/up.svg: Don't define foreground; this means they will use
the foreground of the currently defined face instead.  (Bug#51556)

(cherry picked from commit 11702a6dd7cb8286f28b7cb986057d2d2c66a914)

; * etc/NEWS: Improve wording of a recently changed entry.

; * etc/NEWS: Improve NEWS entry for Image-Dired.

; * etc/NEWS: Various fixes.

Mark with +++ entries documented in the manual.
Move 'lossage-size' closer to 'view-lossage'.

* doc/emacs/building.texi (Compilation Mode): Add next-error-message-highlight

The variable 'next-error-message-highlight' already has vindex,
so describe it in the text as well (bug#51444).

; * etc/PROBLEMS: Minor copyedits of the last change.  (Bug#51571)

Document a macOS error message when opening Emacs

* etc/PROBLEMS: Document a potential error message when opening Emacs
on macOS for the first time.

Fix header-line and tab-line when mode-line-compact is set

* src/xdisp.c (display_mode_line): Make 'mode-line-compact' apply
only to mode lines.  (Bug#51558)

Add manual section about how to avoid regexp problems

Help users affected by our NFA engine's stack overflows and occasional
poor performance, replacing old text that was more limited in scope.

* doc/lispref/elisp.texi (Top):
* doc/lispref/searching.texi (Regular Expressions): Add menu entries.
(Regexp Problems): New node.
(Regexp Special):
* etc/PROBLEMS: Remove superseded text.

Clarify build environment

* admin/nt/dist-build/README-scripts:

Clarify build directory structure

* admin/nt/dist-build/README-scripts: Clarify build directory structure

* src/pdumper.c (dump_do_dump_relocation): Add sanity check.

* lisp/progmodes/prog-mode.el (prog-context-menu): Use text-mode-context-menu.

; Auto-commit of loaddefs files.

Fix bug#51369

* test/lisp/net/dbus-tests.el (dbus-test04-register-method): Skip on hydra.

Adapt arguments of `tramp-make-tramp-file-name'

* lisp/net/tramp-gvfs.el (tramp-gvfs-handler-mounted-unmounted):
* lisp/url/url-tramp.el (url-tramp-convert-url-to-tramp):
Use `make-tramp-file-name'.

* lisp/obsolete/rcompile.el (remote-compile): Pacify byte-compiler.

Fix typo in describe-map-tree doc string

* lisp/help.el (describe-map-tree): Fix typo in doc string.

Drop support for native compilation on 32-bit Cygwin

* configure.ac (cygwin32-native-compilation): New option.
[i686-pc-cygwin]: Don't allow native compilation unless that
option is specified.  (Bug#50666)

; * doc/emacs/help.texi (Help Mode): Improve indexing.

; * doc/misc/org.org: fix capture context example

* doc/misc/org.org (Templates in contexts): Add missing parenthesis to
code example for org-capture template contexts as documented in
docstring.

Copyright-paperwork-exempt: yes (bug#51524).

Merge branch 'emacs-28' of git.savannah.gnu.org:/srv/git/emacs into emacs-28

Fix rendering of title-less <abbr> tags in shr

* lisp/net/shr.el (shr-tag-abbr): Render <abbr> tags that have no
title (bug#51525).

; * lisp/files.el (make-nearby-temp-file): Doc fix.

Avoid signaling errors in lookup-key

* src/keymap.c (Flookup_key): Handle KEY vectors where not all
components are symbols.  (Bug#51527)  Do not merge to master.

Fix localized display of date and time in the NS port

* src/nsterm.m (ns_init_locale): If not already set, set LC_ALL to the
current locale ID so that dates, currencies, etc. use the settings
configured in the operating system.  (Bug#51321)

Fix display glitches with side-by-side windows on TTY frames

* src/dispnew.c (adjust_glyph_matrix, prepare_desired_row): Leave
room for the border glyph only if the window does actually have
the right margin.  (Bug#51521)

Avoid replacing common prefix with ellipsis

* lisp/progmodes/python.el
(python-shell-completion-native-setup): Configure readline not to
suppress common prefixes.  (Bug#51218)

Improve documentation of string truncation APIs

* doc/lispref/display.texi (Size of Displayed Text):
* lisp/international/mule-util.el (truncate-string-to-width):
Document caveats of using 'truncate-string-to-width' when
character composition is involved.

* lisp/emacs-lisp/subr-x.el (string-limit):
* doc/lispref/strings.texi (Creating Strings): Improve the
documentation of 'string-limit'.

* lisp/textmodes/css-mode.el: Fix typo.  (Bug#51488)

Copyright-paperwork-exempt: yes

Make message/rfc822 on buttons work again in Gnus

* lisp/gnus/gnus-art.el (gnus-article-mode): Set
mm-inline-message-prepare-function buffer-locally so that it works
both when inlining rfc822 and hitting the MIME button (bug#51388).
(gnus-mime--inline-message): Factor out into own function.
(gnus-mime-display-single): From here.

* lisp/loadup.el: Unbreak build.

Move lisp/shorthands.el to lisp/emacs-lisp/shorthands.el

Some Tramp changes, mainly in tramp-tests.el

* doc/misc/tramp.texi (External packages): Don't use Tramp internals.

* lisp/net/tramp-gvfs.el (tramp-gvfs-handler-mounted-unmounted):
Protect `tramp-make-tramp-file-name' call.

* lisp/net/tramp.el (tramp-make-tramp-file-name): Set advertised
calling conventions.

* test/lisp/net/tramp-tests.el (tramp-test18-file-attributes):
Adapt test.
(tramp--test-supports-processes-p): New defun.
(tramp-test28-process-file, tramp-test29-start-file-process)
(tramp-test30-make-process, tramp-test32-shell-command)
(tramp-test32-shell-command-dont-erase-buffer)
(tramp-test34-explicit-shell-file-name, tramp-test35-exec-path)
(tramp-test44-asynchronous-requests): Use it.

; * doc/emacs/custom.texi (Connection Variables): Fix typo.  Don't merge

; Improve commentary in the last change

* lisp/language/misc-lang.el: Minor copyedits of the commentary
regarding Egyptian hieroglyph support.

Make hieroglyphs display correctly with existing fonts

* etc/HELLO: Remove hieroglyph format control characters.

* lisp/language/misc-lang.el: Add a rule to compose Egyptian
hieroglyphs even without Unicode format control characters.

Clarify "default face attributes" in the ELisp manual

* doc/lispref/display.texi (Defining Faces): Add index entries for
face symbol properties.
(Attribute Functions): Clarify "default face attribute values" wrt
'face-all-attributes' and 'face-attribute'.  (Bug#51465)

Make `C-u RET' work again

* lisp/simple.el (newline): Fix regression introduced by
d1aacceae9 (bug#51459).

Fix typos in the manual and in a comment

* lisp/minibuffer.el (completion-pcm--hilit-commonality):
* doc/lispintro/emacs-lisp-intro.texi (Mode Line): Fix typos
(bug#51434).

Copyright-paperwork-exempt: yes

Avoid assertion violations in 'lookup-key'

* src/keymap.c (Flookup_key): Don't call ASIZE unless KEY is a
vector.  This avoids assertion violations when KEY is a string.

image-dired: Unreverse accidentally reversed menus

* lisp/image-dired.el (image-dired-thumbnail-mode-map)
(image-dired-display-image-mode-map, image-dired-minor-mode-map):
In Emacs 26.1 (commits b905454680c7 and bed0373855ea), the menus were
converted to use 'easy-menu-define', but they were reversed in the
process.  Unreverse the menus.  (Bug#51446)

Be more allowing when looking for menu-bar items

Don't merge to master.  This is a safe-for-release fix for Bug#50752.

* src/keymap.c (lookup_key_1): Factor out function from
Flookup_key.
(Flookup_key): Be case insensitive when looking for Qmenu_bar
items.  (Bug#50752)

* test/src/keymap-tests.el
(keymap-lookup-key/mixed-case)
(keymap-lookup-key/mixed-case-multibyte): New tests.

* lisp/textmodes/text-mode.el (text-mode-context-menu): Rename recently added.

; * etc/NEWS: Use active voice for 'repeat-mode', etc.

Allow automatic use of color fonts for emoji on macOS

* src/macfont.m (macfont_list): Don't exclude color fonts when the
fontspec has an 'emoji' script specification.

; * etc/NEWS: Fix last change.

Fix help commands for menu-bar menus

* lisp/help.el (help--analyze-key): Fix "C-h c" and "C-h k" on
menu-bar menu items.  (Bug#51421)

; * etc/NEWS: Fix typos.

; Explain why "kinds of atom" isn't a typo

* doc/lispintro/emacs-lisp-intro.texi (Lisp Atoms): Add a comment
explaining why "kinds of atom" isn't a typo.

; * etc/NEWS: Improve wording of the Emoji entry.

; Checkdoc fixes in image-dired.el

Improve function documentation with text from XDG BDS spec

* lisp/xdg.el (xdg-config-home, xdg-cache-home, xdg-data-home)
(xdg-runtime-dir, xdg-config-dirs, xdg-data-dirs): Copy in the
text from the XDG Base Directory Specification to better explain
what these functions return.

* lisp/transient.el: Update to package version 0.3.7.

; Revert parts of "Use string-replace instead of replace-regexp-in-string"

"transient.el" is also distributed as a separate package, which
supports Emacs versions as old as 25.1 (see "Package-Requires").