; Add commentary to disabled OTF support code in font.c

* src/font.c (check_gstring, check_otf_features, otf_tag_symbol)
(otf_open, font_otf_capability, generate_otf_features)
(font_otf_DeviceTable, font_otf_ValueRecord, font_otf_Anchor):
Move closer to the primitives that use them.  Add commentary for
the purpose of this code.

* lisp/progmodes/hideshow.el (hs-toggle-hiding): Fix `interactive` form

This fixes the first part of bug#52092, which is a regression
introduced by commit d0e9113de97.

; * src/keyboard.c (Fposn_at_point): Doc fix.  (Bug#52092)

Fix shaping with bitmap-only fonts on HarfBuzz 5.2.0 (Bug#57976)

* src/ftcrfont.c (ftcrhbfont_begin_hb_font): Undo last change for
HarfBuzz 5.2.0.

; Minor copyedits of elisp.texi

* doc/lispref/variables.texi (Setting Generalized Variables):
Improve wording.

; * doc/lispref/windows.texi (Window Hooks): Fix a typo (bug#51930).

* lisp/text-modes/tex-mode.el (tex-mode): Fix AUCTeX regression

As discussed in
https://lists.gnu.org/r/auctex/2022-08/msg00004.html
AUCTeX installs its own advice to redefine `tex-mode`, and that
advice used to take precedence before commit 6075a7c5ae3fa456cd.

Add vc-annotate-switches to manual

* doc/emacs/maintaining.texi (Old Revisions): Add description of
`vc-annotate-switches' and `vc-BACKEND-annotate-switches'.

; Fix typos in Lisp symbols

Remove mention of non-existent `annotate-switches'

* lisp/vc/vc.el (vc-annotate-switches): Remove mention of
`annotate-switches'.  As far as I can tell this has never existed in
Emacs.

Mention that src/macuvs.h sometimes needs committing

* admin/notes/unicode: src/macuvs.h is generated, but needs to be
committed sometimes.

; More comment fixes in font.h (bug#57935)

; * src/font.h (struct font_driver): Comment fix.

MacOS ld warning from native compilation (bug#57849)

* lisp/emacs-lisp/comp.el (native-comp-driver-options): Add "-Wl,-w"
on Darwin systems.
* etc/NEWS: Describe change.

; Minor copyedits of *-frame-alist doc strings

* src/frame.c (syms_of_frame) <default-frame-alist>:
* lisp/frame.el (initial-frame-alist): Minor doc fixes.

; * src/intervals.c (get_local_map): Fix commentary.

Fix Tramp error with eshell integration

* lisp/net/tramp-integration.el (tramp-eshell-directory-change):
Respect local `default-directory'.  (Bug#57556)

; * admin/admin.el (make-news-html-file): Fix typo.

Sync with Tramp 2.5.3.2.  Don't merge with master

* doc/misc/tramp.texi (Android shell setup): Rework.
(Frequently Asked Questions): Improve recommendations for speeding up.

* doc/misc/trampver.texi:
* lisp/net/trampver.el: Change version to "2.5.4-pre".

* lisp/net/tramp-adb.el (tramp-methods): Use "%d".
(tramp-adb-handle-directory-files-and-attributes): Fix "." and
".." in listing.
(tramp-adb-handle-file-attributes)
(tramp-adb-handle-directory-files-and-attributes)
(tramp-adb-handle-file-name-all-completions): Pipe "ls" output
through "cat", in order to avoid quoting special characters.
(tramp-adb-maybe-open-connection): Compute args from `tramp-login-args'.

* lisp/net/tramp-compat.el (tramp-compat-replace-regexp-in-region):
New defalias.

* lisp/net/tramp-gvfs.el (tramp-gvfs-do-copy-or-rename-file):
Adapt check for proper remote command.

* lisp/net/tramp.el (tramp-methods): Adapt docstring.
(tramp-handle-make-process): Check for adb device if indicated.
(tramp-get-remote-tmpdir): Cache result in temporary connection
property.

* test/lisp/net/tramp-tests.el  (tramp-test17-insert-directory)
(tramp-test22-file-times, tramp--test-utf8): Adapt tests.
(tramp--test-shell-file-name): Do not depend on `tramp--test-adb-p'.
(tramp-test46-unload): Ignore autoload functions in
`tramp-file-name' structure tests, since `tramp-file-name-handler'
is also autoloaded in Emacs 29.

; * etc/NEWS: Fix typo.

Simplify regexp in make-news-html-file

* admin/admin.el (make-news-html-file): Simplify regexp.
Suggested by Mattias Engdegård <mattiase@acm.org>.

* admin/admin.el (make-news-html-file): Set id on correct tag.

Add version headlines to HTML NEWS export

This allows linking to, e.g. "NEWS.28.html#28.1" to go directly to
those release notes.
* admin/admin.el (admin--org-export-headers-format)
(make-news-html-file): Add XX.Y version headlines with an HTML anchor.

; * etc/NEWS: Fix formatting.

; * etc/NEWS: Backport fixes from master.

Don't merge to master.

Improve HTML export of NEWS file

* admin/admin.el (admin--org-export-headers-format)
(admin--org-html-postamble): New variables.
(admin--require-external-package): New function.
(make-news-html-file): Improve HTML export.

Delete "etc/NEWS*.html" from .gitignore

We actually do want to see it when preparing a release, so that we
don't include it in a tarball by mistake.
* .gitignore: Don't ignore "etc/NEWS*.html".

; * etc/NEWS: Fix typos.

Recommend NonGNU ELPA over MELPA

* doc/misc/org.org (Using CDLaTeX to enter math, Footnotes): Recommend
NonGNU ELPA over MELPA.

Minor doc fixes in picture.el

* lisp/textmodes/picture.el: Improve Commentary.
(picture-forward-column, picture-backward-column)
(picture-move-down, picture-move-up, picture-movement-nw)
(picture-movement-ne, picture-movement-sw, picture-movement-se)
(picture-set-motion, picture-clear-line, picture-newline)
(picture-tab, picture-yank-rectangle)
(picture-yank-rectangle-from-register, picture-insert-rectangle)
(picture-draw-rectangle): Minor doc fixes.

* lisp/textmodes/page-ext.el: Improve Commentary.

Automate exporting etc/NEWS to HTML

* admin/admin.el (make-news-html-file): New function.
* .gitignore: Ignore generated "etc/NEWS*.html" file.

* Makefile.in (uninstall): Remove the *.eln files.  (Bug#57771)

; * admin/notes/www: Fix typos.

; * admin/make-tarball.txt: Minor clarifications.

; Bump Emacs version past 28.2

* README:
* configure.ac:
* nt/README.W32:
* msdos/sed2v2.inp:
* etc/NEWS: Bump Emacs version to 28.2.50.

Update HISTORY for Emacs 28.2

* etc/HISTORY: Update for the Emacs 28.2 release.

Bump Emacs version to 28.2

* README:
* configure.ac:
* msdos/sed2v2.inp:
* nt/README.W32: Bump Emacs version to 28.2.

Update ChangeLog and AUTHORS for Emacs 28.2

* ChangeLog.3:
* etc/AUTHORS:
* etc/NEWS: Update for Emacs 28.2.

* doc/misc/idlwave.texi (Troubleshooting): Don't say "Emacsen".

; * doc/emacs/misc.texi (emacsclient Options): Fix typo.

Don't mention very old Emacs versions in docs

* doc/misc/mh-e.texi (Conventions):
* doc/misc/reftex.texi (Problems and Work-Arounds):
* doc/misc/viper.texi (Loading Viper): Delete references to
very old versions of Emacs.

* lisp/server.el: Improve Commentary.

Explain how the font appearance can be fine-tuned in fbterm.

* doc/misc/efaq.texi (Emacs in a Linux console): Briefly document
Xft font specifications with which the font appearance can be
fine-tuned.

Update to Org 9.5.5

* lisp/emacs-lisp/comp.el (comp-run-async-workers): Fail more gracefully

Otherwise Emacs may fail to start if it can't find a writable
`~/.emacs.d/eln-cache` directory.
Fixes bug#57562.  See also Debian's bug #1017739.

; Normalize email

Don't merge to master.

Update acknowledgments

* doc/emacs/ack.texi (Acknowledgments): Update.
* doc/emacs/emacs.texi (Acknowledgments): Add several names from
Author: headers.

Make some versions in docs match package version

* doc/emacs/misc.texi (Interactive Shell): Bump Emacs version.
* doc/misc/ediff.texi:
* doc/misc/flymake.texi:
* doc/misc/viper.texi: Fix version to match package.
* lisp/emulation/viper.el: Make version match variable.

Minor doc fix; improve sorting of VC backends

* doc/emacs/maintaining.texi (Version Control Systems): Minor doc fix;
rearrange list to put git, cvs and subversion at the top.

Clarify the doc string of 'set-face-attribute'

* lisp/faces.el (set-face-attribute): Clarify the issue with
resetting attribute values to 'unspecified' for future frames.
(Bug#57499)

; Auto-commit of loaddefs files.

Enable 256 colors in fbterm.

* lisp/term/fbterm.el: New file.

* doc/misc/efaq.texi (Emacs in a Linux console): Document the TERM
environment variable with which the new file is used.

One more fix for find-file.el

* lisp/find-file.el (ff-get-file-name): Use 'expand-file-name'
instead of 'concat', which doesn't DTRT with absolute file names.
(ff-other-file-alist): Yet another doc fix.  (Bug#57325)

; Yet another doc fix for 'ff-other-file-alist' (bug#57325)

Recommend using fbterm in the Linux console.

* doc/misc/efaq.texi (Emacs in a Linux console): New node.
(Common requests): Entry for the new node.

* etc/PROBLEMS (Linux console problems...): Mention the new FAQ node.

; * src/window.c (syms_of_window) <window-point-insertion-type>: Doc fix.

* lisp/find-file.el (ff-other-file-alist): Doc fix.  (Bug#57325)

* lisp/info.el (Info-mode): Support the Linux console better.

; Fix doc strings in latin1-disp.el

* lisp/international/latin1-disp.el (latin1-display-ucs-per-lynx)
(latin1-display): Doc fix.

Improve the documentation of glyphless-character display

* lisp/international/characters.el (glyphless-char-display-control):
* src/xdisp.c (syms_of_xdisp) <glyphless-char-display>: Mention
the 'glyphless-char' face in the doc string.

* doc/lispref/display.texi (Glyphless Chars): Index
'glyphless-char' face.

; * lisp/jit-lock.el (jit-lock-chunk-size): Doc fix.

Fix documentation of 'glyphless-char-display'

* src/xdisp.c (syms_of_xdisp)<glyphless-char-display>: Doc fix.
(gui_produce_glyphs, lookup_glyphless_char_display): Fix
indentation.

; * etc/DEBUG: Fix wording of "X protocol errors" section.

Treat smtp-auth method from auth-info as a symbol

The lookup of the SMTP auth method is done based on symbols, but
sometimes the requested value comes from `auth-info', in which case it
is a string, so call `intern-soft' to convert it to a symbol (which
does nothing if it's already a symbol).

* lisp/mail/smtpmail.el (smtpmail-try-auth-methods): Call
`intern-soft' on the smtp-auth key's value.  (Bug#57373)

Do not merge to master

* lisp/wdired.el: Improve "Commentary" section.

* lisp/wdired.el: Doc fix; don't mention obsolete variable.

* lisp/progmodes/etags.el (next-file): Minor doc fix.

* configure.ac: Move AC_LANG_PUSH/POP out of AC_CACHE_CHECK.  (Bug#57380)

(cherry picked from commit ce82300221f270241fdda1f5dfb567bdb1208543)

; * doc/misc/htmlfontify.texi: Fix version.

Update to Org 9.5.4-19-g4dff42

; * lisp/find-file.el (ff-other-file-alist): Fix typo.

; * lisp/find-file.el (ff-other-file-alist): Another doc fix.  (Bug#57325)

* lisp/find-file.el (ff-other-file-alist): Doc fix.  (Bug#57325)

Resurrect obsoletion warning for two functions

These were supposed to have been deleted, but never were.  Resurrect
their obsoletion warning and let's delete them in Emacs 29 instead.

* lisp/subr.el (process-filter-multibyte-p)
(set-process-filter-multibyte): Resurrect obsoletion warning.
* etc/NEWS: Don't announce their deletion.

* src/window.c (select_window): Fix assert for buffer = non-active minibuffer

Find libgccjit on macOS with Homebrew differently

* configure.ac (MAC_LIBS): Find libgccjit's directory slightly
differently for brew installations.

Improve image-mode-as-hex docstring

* lisp/image-mode.el: Fix typos.
(image-mode-as-hex): Doc fix; say that it uses 'hexl-mode' and reflow.

* lisp/image-mode.el (image-mode-as-hex): Fix toggle instructions.

; lisp/image-mode.el: Fix typo.

* lisp/image-mode.el: Improve commentary.

cl-reduce doc string improvement

* lisp/emacs-lisp/cl-seq.el (cl-reduce): Explain what happens when
using :from-end (bug#57273).

Backport tempname changes from master (bug#57129)

* lib/tempname.c: Backport from master, which uses current Gnulib.

; * lisp/vc/ediff.el: Improve wording in last change.

Revert "; * doc/lispintro/emacs-lisp-intro.texi: Fix typo."

This reverts commit 9d0dba44da7ac83d018fff3c26d33dac12ebd806.

This was not a typo, but incorrectly matching parens in Info-mode.

* doc/misc/gnus.texi (Article Washing): Fix Links URL.

; * doc/lispintro/emacs-lisp-intro.texi: Fix typo.

; Improve documentation of minibuffer history wrt completion

* doc/emacs/mini.texi (Minibuffer History): Mention explicitly
that minibuffer history is related also to completion candidates.
Improve indexing.  (Bug#57163)

Delete references to deleted library hilit19.el

* doc/misc/gnus.texi (Compatibility):
* lisp/progmodes/f90.el:
* lisp/ps-print.el:
* lisp/vc/ediff.el: Delete references to hilit19.el.

Delete stale comments from Lisp Intro manual

* doc/lispintro/emacs-lisp-intro.texi (Args as Variable or List)
(print-elements-of-list, Miscellaneous): Delete some references to
Emacs 22.

; Delete redundant installation instructions from ebnf2ps.el

* lisp/progmodes/ebnf2ps.el: Delete redundant installation
instructions.

; * lisp/printing.el: Delete outdated download instructions.

Don't list Emacs as requirement for built-in package

* doc/misc/htmlfontify.texi (Requirements): Don't list Emacs as
requirement for built-in package.

Fix wrong metrics for bitmap-only fonts with HarfBuzz 5

* src/ftcrfont.c (ftcrhbfont_begin_hb_font): Always use the standard
position unit value on HarfBuzz 5 and later regardless of whether the
font is bitmap-only or not.  (Bug#57066)

; Fix @setfilename in calc.texi

* doc/misc/calc.texi: Move the @setfilename command to its proper
place.  (Bug#57107)

Improve wording when documenting other TRAMP syntaxes

* doc/misc/tramp.texi (Change file name syntax): Improve wording.
(Bug#57061)

; * doc/misc/viper.texi (Rudimentary Changes): Avoid alias.

* lisp/vc/diff-mode.el: Don't mention XEmacs.

Don't mention XEmacs toolbar in ediff manual

* doc/misc/ediff.texi (Other Session Commands): Don't mention XEmacs
specific toolbar support for now.  This can be changed back once the
toolbar is ported to Emacs.

* etc/PROBLEMS: Problems with Alacritty and Emoji.  (Bug#56952)