[elpa] externals/compat 45028d9fa7 64/84: Merge branch 'master' into emacs-29.1

[ELPA Syncer]

branch: externals/compat
commit 45028d9fa72c87f8af7797cf2120ba4d95fff8e0
Merge: e7413bcf2b c6e6af4251
Author: Philip Kaludercic <philipk@posteo.net>
Commit: Philip Kaludercic <philipk@posteo.net>

    Merge branch 'master' into emacs-29.1
---
 NEWS.org    | 14 ++++++++++++++
 README.md   | 38 +++++++++++++++++++++++++-------------
 compat.el   |  2 +-
 compat.texi | 13 ++++++++-----
 4 files changed, 48 insertions(+), 19 deletions(-)

diff --git a/NEWS.org b/NEWS.org
index 9c6a819b6a..dee10ae9f1 100644
--- a/NEWS.org
+++ b/NEWS.org
@@ -1,6 +1,20 @@
 #+options: toc:nil num:nil
 #+link:    compat https://todo.sr.ht/~pkal/compat/
 
+* Release of "Compat" Version 28.1.2.1
+
+This is a minor release adding the following changes:
+
+- Add =derived-mode-p= defined in Emacs 27
+- Add =provided-mode-derived-p= defined in Emacs 27
+- Add =read-multiple-choice= defined in Emacs 26
+- Add =file-name-absolute-p= defined in Emacs 28
+
+The only other notable change is that the manual has been rewritten to
+include much more documentation that had been the case previously.
+
+(Release <2022-08-24 Wed>)
+
 * Release of "Compat" Version 28.1.2.0
 
 The main change of this release has been the major simplification of
diff --git a/README.md b/README.md
index ec9ca086cb..0ad7f15fb5 100644
--- a/README.md
+++ b/README.md
@@ -8,8 +8,10 @@ For information on how to use Compat, please consult the 
[manual].
 The latest state of development can be found in the [snapshot
 version].
 
-[manual]: https://elpa.gnu.org/packages/doc/compat.html
-[snapshot version]: https://elpa.gnu.org/devel/doc/compat.html
+[manual]:
+       https://elpa.gnu.org/packages/doc/compat.html
+[snapshot version]:
+       https://elpa.gnu.org/devel/doc/compat.html
 
 Contribute
 ----------
@@ -18,9 +20,12 @@ As compat.el is distribed as part of [GNU ELPA], and 
therefore
 requires a [copyright assignment] to the [FSF], for all non-trivial code
 contributions.
 
-[GNU ELPA]: http://elpa.gnu.org/packages/compat.html
-[copyright assignment]: 
https://www.gnu.org/software/emacs/manual/html_node/emacs/Copyright-Assignment.html
-[FSF]: https://www.fsf.org/
+[GNU ELPA]:
+       http://elpa.gnu.org/packages/compat.html
+[copyright assignment]:
+       
https://www.gnu.org/software/emacs/manual/html_node/emacs/Copyright-Assignment.html
+[FSF]:
+       https://www.fsf.org/
 
 Source code
 -----------
@@ -28,8 +33,10 @@ Source code
 Compat is developed on [SourceHut]. A restricted [GitHub] mirror is
 also provided.
 
-[SourceHut]: https://sr.ht/~pkal/compat
-[GitHub]: https://github.com/phikal/compat.el
+[SourceHut]:
+       https://sr.ht/~pkal/compat
+[GitHub]:
+       https://github.com/phikal/compat.el
 
 Bug and patches
 ---------------
@@ -44,11 +51,14 @@ When contributing, make sure to provide test and use the 
existing
 tests defined in compat-test.el.  These can be easily executed using
 the bundled Makefile:
 
-    make test
+       make test
 
-[development mailing list]: https://lists.sr.ht/~pkal/compat-devel
-[issue tracker]: https://todo.sr.ht/~pkal/compat
-[email]: mailto:~pkal/compat@todo.sr.ht
+[development mailing list]:
+       https://lists.sr.ht/~pkal/compat-devel
+[issue tracker]:
+       https://todo.sr.ht/~pkal/compat
+[email]:
+       mailto:~pkal/compat@todo.sr.ht
 
 Distribution
 ------------
@@ -58,5 +68,7 @@ under the [GNU Public License], Version 3 (like Emacs 
itself).  The manual
 (`compat.texi`) is distributed under the [GNU Free Documentation
 License], Version 1.3.
 
-[GNU Public License]: https://www.gnu.org/licenses/gpl-3.0.en.html
-[GNU Free Documentation License]: https://www.gnu.org/licenses/fdl-1.3.html
+[GNU Public License]:
+       https://www.gnu.org/licenses/gpl-3.0.en.html
+[GNU Free Documentation License]:
+       https://www.gnu.org/licenses/fdl-1.3.html
diff --git a/compat.el b/compat.el
index 0b28ff05e2..334c4237a5 100644
--- a/compat.el
+++ b/compat.el
@@ -4,7 +4,7 @@
 
 ;; Author: Philip Kaludercic <philipk@posteo.net>
 ;; Maintainer: Compat Development <~pkal/compat-devel@lists.sr.ht>
-;; Version: 28.1.2.0
+;; Version: 28.1.2.1
 ;; URL: https://sr.ht/~pkal/compat
 ;; Package-Requires: ((emacs "24.3") (nadvice "0.3"))
 ;; Keywords: lisp
diff --git a/compat.texi b/compat.texi
index 5f49bb2380..efc622bd54 100644
--- a/compat.texi
+++ b/compat.texi
@@ -31,7 +31,7 @@ modify this GNU manual.”
 @finalout
 @titlepage
 @title "Compat" Manual
-@subtitle For version 28.1.2.0
+@subtitle For version 28.1.2.1
 @author Philip Kaludercic
 @page
 @vskip 0pt plus 1filll
@@ -46,7 +46,7 @@ modify this GNU manual.”
 
 This manual documents the usage of the "Compat" Emacs lisp library,
 the forward-compatibility library for Emacs Lisp, corresponding to
-version 28.1.2.0.
+version 28.1.2.1.
 
 @insertcopying
 @end ifnottex
@@ -124,16 +124,20 @@ The intended use-case for this library is for package 
developers to add
 as a dependency in the header:
 
 @example
-;; Package-Requires: ((emacs "24.3") (compat "28.1.2.0"))
+;; Package-Requires: ((emacs "24.3") (compat "28.1.2.1"))
 @end example
 
+There is no need to depend on @code{emacs} 24.3 specifically.  One can
+choose to any newer version, if features not provided by Compat
+necessitate it.
 
-and later on a
+In any file where compatibility forms are used, a
 
 @example
 (require 'compat)
 @end example
 
+should be added early on.
 
 This will load all non-prefixed definitions (functions and macros with a
 leading `compat-`).  To load these, an additional
@@ -142,7 +146,6 @@ leading `compat-`).  To load these, an additional
 (require 'compat-XY) ; e.g. 26
 @end example
 
-
 will be necessary, to load compatibility code for Emacs version XY@.
 
 It is recommended to subscribe to the