[elpa] externals/compat a78b016a04: Drop MANUAL in favour of compat.texi

[ELPA Syncer]

branch: externals/compat
commit a78b016a0401fb3b7226ab0e968b373495d94e15
Author: Philip Kaludercic <philipk@posteo.net>
Commit: Philip Kaludercic <philipk@posteo.net>

    Drop MANUAL in favour of compat.texi
---
 .elpaignore |   1 -
 MANUAL      | 556 ------------------------------------------------------------
 Makefile    |   3 -
 3 files changed, 560 deletions(-)

diff --git a/.elpaignore b/.elpaignore
index f26dd85948..2fe0af53a7 100644
--- a/.elpaignore
+++ b/.elpaignore
@@ -5,5 +5,4 @@ Makefile
 .elpaignore
 COPYING
 README.md
-MANUAL
 compat.texi
diff --git a/MANUAL b/MANUAL
deleted file mode 100644
index 00b5cced86..0000000000
--- a/MANUAL
+++ /dev/null
@@ -1,556 +0,0 @@
-#                       -*- mode: org; -*-
-#+title:                "Compat" Manual
-#+subtitle:             For version {{{version}}}
-#+author:               Philip Kaludercic
-#+email:                ~pkal/compat-devel@lists.sr.ht
-#+export_file_name:     compat.texi
-#+texinfo_dir_category: Emacs
-#+texinfo_dir_title:    Compat: (compat)
-#+texinfo_dir_desc:     Compatibility Library for Emacs Lisp
-#+options:              compact-itemx:t
-
-#+macro: version 28.1.2.0
-#+link:         debbugs https://debbugs.gnu.org/cgi/bugreport.cgi?bug=
-
-This manual documents the usage of the "Compat" Emacs lisp library,
-the forward-compatibility library for Emacs Lisp, corresponding to
-version {{{version}}}.
-
-#+texinfo: @insertcopying
-
-* Introduction
-** Overview
-The objective of Compat is to provide "forwards compatibility"
-library for Emacs Lisp.  That is to say by using Compat, an Elisp
-package does not have to make the decision to either use new and
-useful functionality or support old versions of Emacs.
-
-Version 24.3 is chosen as the oldest version, because this is the
-newest version on CentOS 7. It is intended to preserve compatibility
-for at least as the Centos 7 reaches 
[[https://wiki.centos.org/About/Product][EOL]], 2024.
-
-If you are developing a package with Compat in mind, consider loading
-=compat-help= (on your system, not in a package) to get relevant notes
-inserted into the help buffers of functions that are implemented or
-advised in Compat.
-
-Note that Compat provides a few prefixed function, ie. functions with
-a ~compat-~ prefix.  These are used to provide extended functionality
-for commands that are already defined (~sort~, ~assoc~, ~seq~, ...).
-It might be possible to transform these into advised functions later
-on, so that the modified functionality is accessible without a prefix.
-Feedback on this point is appreciated.
-
-** Usage
-The intended use-case for this library is for package developers to
-add as a dependency in the header:
-
-: ;; Package-Requires: ((emacs "24.3") (compat "28.1.2.0"))
-
-and later on a
-
-: (require 'compat)
-
-This will load all non-prefixed definitions (functions and macros with
-a leading =compat-=).  To load these, an additional
-
-: (require 'compat-XY) ; e.g. 26
-
-will be necessary, to load compatibility code for Emacs version XY.
-
-It is recommended to subscribe to the 
[[https://lists.sr.ht/~pkal/compat-announce][compat-announce]] mailing list to
-be notified when new versions are released or relevant changes are
-made.
-
-*** Additional libraries
-These libraries are packages with Compat, but are disabled by default.
-To use them you can use ~M-x load-library~:
-
-- compat-help :: Add notes to ~*Help*~ buffer, if a compatibility
-  definition has something to warn you about.
-- compat-font-lock :: Highlight functions that are implemented as
-  compatibility definitions.
-
-** Intentions
-The library intends to provide support back until Emacs 24.3.  The
-intended audience are package developers that are interested in using
-newer developments, without having to break compatibility.
-
-Sadly, total backwards compatibility cannot be provided for technical
-reasons.  These might include:
-
-- An existing function or macro was extended by some new functionality.  To
-  support these cases, the function or macro would have to be advised.
-  As this is usually regarded as invasive and is shown to be a
-  significant overhead, even when the new feature is not used, this
-  approach is not used.
-
-  As a compromise, prefixed functions and macros (starting with a
-  ~compat-~ prefix) can be provided.
-
-- New functionality was implemented in the core, and depends on
-  external libraries that cannot be reasonably duplicated in the scope
-  of a compatibility library.
-
-- New functionality depends on an entire new, non-trivial library.
-  Sometimes these are provided via ELPA (xref, project, ...), but other
-  times it would be infeasible to duplicate an entire library within
-  Compat while also providing the necessary backwards compatibility.
-
-- It just wasn't added, and there is no good reason (though good
-  excuses might exist).  If you happen to find such a function,
-  [[*Development][reporting]] it would be much appreciated.
-
-  Always begin by assuming that this might be the case, unless proven
-  otherwise.
-
-* Support
-This section goes into the features that Compat manages and doesn't
-manage to provide for each Emacs version.
-
-** Emacs 24.4
-:PROPERTIES:
-:DESCRIPTION: Compatibility support for Emacs 24.4
-:END:
-The following functions and macros implemented in 24.4, and are
-provided by Compat by default:
-
-- Macro: with-eval-after-load :: See [[info:elisp#Hooks for Loading][Hooks for 
Loading]].
-- Function: special-form-p :: See [[info:elisp#Special Forms][Special Forms]].
-- Function: macrop :: See [[info:elisp#Simple Macro][Simple Macro]].
-- Function: string-suffix-p :: See [[info:elisp#Text Comparison][Text 
Comparison]].
-- Function: delete-consecutive-dups :: Defined in ~subr.el~.
-- Function: define-error :: See [[info:elisp#Error Symbols][Error Symbols]].
-- Function: bool-vector-exclusive-or :: See 
[[info:elisp#Bool-Vectors][Bool-Vectors]].
-- Function: bool-vector-union :: See [[info:elisp#Bool-Vectors][Bool-Vectors]].
-- Function: bool-vector-intersection :: See 
[[info:elisp#Bool-Vectors][Bool-Vectors]].
-- Function: bool-vector-not :: See [[info:elisp#Bool-Vectors][Bool-Vectors]].
-- Function: bool-vector-subsetp :: See 
[[info:elisp#Bool-Vectors][Bool-Vectors]].
-- Function: bool-vector-count-consecutive :: See 
[[info:elisp#Bool-Vectors][Bool-Vectors]].
-- Function: bool-vector-count-population :: See 
[[info:elisp#Bool-Vectors][Bool-Vectors]].
-- Function: completion-table-merge :: See [[info:elisp#Basic Completion][Basic 
Completion]].
-- Function: completion-table-with-cache :: See [[info:elisp#Programmed 
Completion][Programmed
-  Completion]].
-- Function: face-spec-set :: See [[info:elisp#Defining Faces][Defining Faces]].
-
-These functions are prefixed with ~compat~ prefix, and are only loaded
-when ~compat-24~ is required:
-
-- Function: compat-= ::
-- Function: compat-< ::
-- Function: compat-> ::
-- Function: compat-<= ::
-- Function: compat->= ::
-  See [[info:elisp#Comparison of Numbers][Comparison of Numbers]].
-
-  Allows for more than two arguments to be compared.
-- Function: compat-split-string :: See [[info:elisp#Creating Strings][Creating 
Strings]].
-
-  Takes optional argument TRIM.
-
-Compat does not provide support for the following Lisp features
-implemented in 24.4:
-
-- Allowing the second optional argument to ~eval~ to specify a lexical
-  environment.
-- The ~define-alternatives~ macro.
-- Support for the ~defalias-fset-function~ symbol property.
-- The ~group-gid~ and ~groupd-read-gid~ functions.
-- The ~pre-redisplay-function~ hook.
-- Allowing for ~with-demoted-errors~ to take a additional argument ~format~.
-- The ~face-spec-set~ function.
-- The ~add-face-text-property~ function.
-- No ~tty-setup-hook~ hook.
-- The ~get-pos-property~ function.
-- The ~define-advice~ macro.
-- Support for generators.
-- The ~string-trim~, ~string-trim-left~ and ~string-trim-right~
-  functions.  These are instead provided as prefixed function as part
-  of [[*Emacs 26.1][Emacs 26.1]] support.
-
-** Emacs 24.5
-:PROPERTIES:
-:DESCRIPTION: Compatibility support for Emacs 24.5
-:END:
-
-No special support for 24.5 was deemed necessary.
-** Emacs 25.1
-:PROPERTIES:
-:DESCRIPTION: Compatibility support for Emacs 25.1
-:END:
-The following functions and macros implemented in 25.1, and are
-provided by Compat by default:
-
-- Function: format-message :: See [[info:elisp#Formatting Strings][Formatting 
Strings]].
-- Function: directory-name-p :: See [[info:elisp#Directory Names][Directory 
Names]].
-- Function: string-greaterp :: See [[info:elisp#Text Comparison][Text 
Comparison]].
-- Macro: with-file-modes :: See [[info:elisp#Changing Files][Changing Files]].
-- Function: alist-get :: See [[info:elisp#Association Lists][Association 
Lists]].
-- Macro: if-let :: Defined in ~subr-x.el~.
-- Macro: when-let :: Defined in ~subr-x.el~.
-- Macro: thread-first :: Defined in ~subr-x.el~.
-- Macro: thread-last :: Defined in ~subr-x.el~.
-- Function: macroexpand-1 :: See [[info:elisp#Expansion][Expansion]].
-- Function: directory-files-recursively :: See [[info:elisp#Contents of 
Directories][Contents of
-  Directories]].
-- Function: bool-vector :: See [[info:elisp#Bool-Vectors][Bool-Vectors]].
-
-These functions are prefixed with ~compat~ prefix, and are only loaded
-when ~compat-25~ is required:
-
-- Function: compat-sort :: See [[info:elisp#Sequence Functions][Sequence 
Functions]].
-
-  Adds support for vectors to be sorted, next to just lists.
-
-Compat does not provide support for the following Lisp features
-implemented in 25.1:
-
-- New ~pcase~ patterns.
-- The hook ~prefix-command-echo-keystrokes-functions~ and
-  ~prefix-command-preserve-state-hook~.
-- The hook ~pre-redisplay-functions~.
-- The function ~make-process~.
-- Support for the variable ~inhibit-message~.
-- The ~define-inline~ functionality.
-- The functions ~string-collate-lessp~ and ~string-collate-equalp~.
-- Support for ~alist-get~ as a generalised variable.
-- The function ~funcall-interactivly~.
-- The function ~buffer-substring-with-bidi-context~.
-- The function ~font-info~.
-- The function ~default-font-width~.
-- The function ~window-font-height~ and ~window-font-width~.
-- The function ~window-max-chars-per-line~.
-- The function ~set-binary-mode~.
-- The functions ~bufferpos-to-filepos~ and ~filepos-to-bufferpos~.
-
-Note that the changes in Emacs 25.2 and 25.3 are also included here,
-for the sake of simplicity.
-
-** Emacs 26.1
-:PROPERTIES:
-:DESCRIPTION: Compatibility support for Emacs 26.1
-:END:
-The following functions and macros implemented in 26.1, and are
-provided by Compat by default:
-
-- Function: func-arity :: See [[info:elisp#What Is a Function][What Is a 
Function]].
-- Function: mapcan :: See [[info:elisp#Mapping Functions][Mapping Functions]].
-- Function: cXXXr ::
-- Function: cXXXXr ::
-  See [[info:elisp#List Elements][List Elements]].
-- Variable: gensym-counter :: See ~gensym~.
-- Function: gensym :: See [[info:elisp#Creating Symbols][Creating Symbols]].
-- Function: make-nearby-temp-file :: See [[info:elisp#Unique File 
Names][Unique File Names]].
-- Variable: mounted-file-systems ::  Defined in ~files.el~.
-- Function: temporary-file-directory :: See [[info:elisp#Unique File 
Names][Unique File Names]].
-- Macro: if-let* :: Defined in ~subr-x.el~.
-- Macro: when-let* :: Defined in ~subr-x.el~.
-- Macro: and-let* :: Defined in ~subr-x.el~.
-
-  **Please Note:** The implementation provided by Compat does not
-  include a bug that was observed with Emacs 26 (see [[debbugs:31840]]).
-- Function: file-local-name :: See [[info:elisp#Magic File Names][Magic File 
Names]].
-- Function: file-name-quoted-p :: See [[info:elisp#File Name Expansion][File 
Name Expansion]].
-- Function: file-name-quote :: See [[info:elisp#File Name Expansion][File Name 
Expansion]].
-- Function: image-property :: Defined in ~image.el~.
-
-  This function can also be used as a generalised variable.  To use
-  this you need to explicitly require ~compat-26~.
-- Function: file-attribute-type :: See [[info:elisp#File Attributes][File 
Attributes]].
-- Function: file-attribute-link-number :: See [[info:elisp#File 
Attributes][File Attributes]].
-- Function: file-attribute-user-id :: See [[info:elisp#File Attributes][File 
Attributes]].
-- Function: file-attribute-group-id :: See [[info:elisp#File Attributes][File 
Attributes]].
-- Function: file-attribute-access-time :: See [[info:elisp#File 
Attributes][File Attributes]].
-- Function: file-attribute-modification-time :: See [[info:elisp#File 
Attributes][File Attributes]].
-- Function: file-attribute-status-change-time :: See [[info:elisp#File 
Attributes][File Attributes]].
-- Function: file-attribute-size :: See [[info:elisp#File Attributes][File 
Attributes]].
-- Function: file-attribute-modes :: See [[info:elisp#File Attributes][File 
Attributes]].
-- Function: file-attribute-inode-number :: See [[info:elisp#File 
Attributes][File Attributes]].
-- Function: file-attribute-device-number :: See [[info:elisp#File 
Attributes][File Attributes]].
-- Function: file-attribute-collect :: Defined in ~files.el~.
-
-These functions are prefixed with ~compat~ prefix, and are only loaded
-when ~compat-26~ is required:
-
-- Function: compat-assoc :: See [[info:elisp#Association Lists][Association 
Lists]].
-
-  Handle the optional argument TESTFN.
-- Function: compat-line-number-at-pos :: See [[info:elisp#Text Lines][Text 
Lines]].
-
-  Handle the optional argument ABSOLUTE.
-- Function: compat-alist-get :: See [[info:elisp#Association 
Lists][Association Lists]].
-
-  Handle the optional argument TESTFN.  Can also be used as a
-  generalised variable.
-- Function: compat-string-trim-left :: See [[info:elisp#Creating 
Strings][Creating Strings]].
-
-  Handles the optional argument REGEXP.
-- Function: compat-string-trim-right :: See [[info:elisp#Creating 
Strings][Creating Strings]].
-
-  Handles the optional argument REGEXP.
-- Function: compat-string-trim :: See [[info:elisp#Creating Strings][Creating 
Strings]].
-
-  Handles the optional arguments TRIM-LEFT and TRIM-RIGHT.
-
-Compat does not provide support for the following Lisp features
-implemented in 26.1:
-
-- The function ~secure-hash-algorithms~.
-- The function ~gnutls-avalaible-p~.
-- Support for records and record functions.
-- The function ~mapbacktrace~.
-- The function ~file-name-case-insensitive-p~.
-- The file-attributes constructors.
-- The function ~read-multiple-choice~.
-- The additional elements of ~parse-partial-sexp~.
-- The function ~add-variable-watcher~.
-- The function ~undo-amalgamate-change-group~.
-- The function ~char-from-name~
-- Signalling errors when ~length~ or ~member~ deal with list cycles.
-- The function ~frame-list-z-order~.
-- The function ~frame-restack~.
-- Support for side windows and atomic windows.
-- All changes related to ~display-buffer~.
-- The function ~window-swap-states~.
-
-Note that the changes in Emacs 26.2 and 26.3 are also included here,
-for the sake of simplicity.
-
-** Emacs 27.1
-:PROPERTIES:
-:DESCRIPTION: Compatibility support for Emacs 27.1
-:END:
-The following functions and macros implemented in 27.1, and are
-provided by Compat by default:
-
-- Function: proper-list-p :: See [[info:elisp#List-related 
Predicates][List-related Predicates]].
-- Function: string-distance :: See [[info:elisp#Text Comparison][Text 
Comparison]].
-- Function: json-serialize :: See [[info:elisp#Parsing JSON][Parsing JSON]].
-- Function: json-insert :: See [[info:elisp#Parsing JSON][Parsing JSON]].
-- Function: json-parse-string :: See [[info:elisp#Parsing JSON][Parsing JSON]].
-- Function: json-parse-buffer :: See [[info:elisp#Parsing JSON][Parsing JSON]].
-- Macro: ignore-error :: See [[info:elisp#Handling Errors][Handling Errors]].
-- Macro: dolist-with-progress-reporter :: See 
[[info:elisp#Progress][Progress]].
-- Function: flatten-tree :: See [[info:elisp#Building Lists][Building Lists]].
-- Function: xor :: See [[info:elisp#Combining Conditions][Combining 
Conditions]].
-- Variable: regexp-unmatchable :: Defined in ~subr.el~.
-- Function: decoded-time-second :: Defined in ~simple.el~.
-- Function: decoded-time-minute :: Defined in ~simple.el~.
-- Function: decoded-time-hour :: Defined in ~simple.el~.
-- Function: decoded-time-day :: Defined in ~simple.el~.
-- Function: decoded-time-month :: Defined in ~simple.el~.
-- Function: decoded-time-year :: Defined in ~simple.el~.
-- Function: decoded-time-weekday :: Defined in ~simple.el~.
-- Function: decoded-time-dst :: Defined in ~simple.el~.
-- Function: decoded-time-zone :: Defined in ~simple.el~.
-- Function: package-get-version :: Defined in ~package.el~.
-- Function: time-equal-p :: See [[info:elisp#Time Calculations][Time 
Calculations]].
-- Function: date-days-in-month :: See [[info:elisp#Time Calculations][Time 
Calculations]].
-- Function: exec-path :: See [[info:elisp#Subprocess Creation][Subprocess 
Creation]].
-
-  This function requires the ~time-date~ feature to be loaded.
-
-These functions are prefixed with ~compat~ prefix, and are only loaded
-when ~compat-27~ is required:
-
-- Function: compat-recenter :: See [[info:elisp#Textual Scrolling][Textual 
Scrolling]].
-
-  Adds the optional argument REDISPLAY.
-- Function: compat-lookup-key :: See [[info:elisp#Low-Level Key 
Binding][Low-Level Key Binding]].
-
-  Allows KEYMAP to be a list of keymaps.
-- Macro: compat-setq-local :: See [[info:elisp#Creating Buffer-Local][Creating 
Buffer-Local]].
-
-  Allow for more than one variable to be set.
-- Function: compat-regexp-opt :: See [[info:elisp#Regexp Functions][Regexp 
Functions]].
-
-  Handle an empty list of strings.
-- Function: compat-file-size-human-readable :: Defined in ~files.el~.
-
-  Handle the optional third (SPACE) and forth (UNIT) arguments.
-- Function: compat-assoc-delete-all :: See [[info:elisp#Association 
Lists][Association Lists]].
-
-  Handle the optional third (TESTFN) argument.
-- Function: compat-executable-find :: [[info:elisp#Locating Files][Locating 
Files]].
-
-  Handle the optional second (REMOTE) argument.
-- Function: compat-dired-get-marked-files :: Defined in ~dired.el~
-
-  Handles the optional fifth (ERROR) argument.
-
-Compat does not provide support for the following Lisp features
-implemented in 27.1:
-
-- Bigint support.
-- The function ~time-convert~.
-- All ~iso8601-*~ functions.
-- The macro ~benchmark-progn~.
-- The function ~read-char-from-minibuffer~.
-- The minor mode ~reveal-mode~.
-- The macro ~with-suppressed-warnings~.
-- Support for ~condition-case~ to handle t.
-- The functions ~major-mode-suspend~ and ~major-mode-restore~.
-- The function ~provided-mode-derived-p~.
-- The function ~file-system-info~.
-- The more consistent treatment of NaN values.
-- The function ~ring-resize~.
-- The function ~group-name~.
-- Additional ~format-spec~ modifiers.
-- Support for additional body forms for
-  ~define-globalized-minor-mode~.
-- The macro ~with-connection-local-variables~ and related
-  functionality.
-
-Note that the changes in Emacs 27.2 are also included here, for the
-sake of simplicity.
-
-** Emacs 28.1
-:PROPERTIES:
-:DESCRIPTION: Compatibility support for Emacs 28.1
-:END:
-The following functions and macros implemented in 28.1, and are
-provided by Compat by default:
-
-- Function: string-search :: See [[info:elisp#Text Comparison][Text 
Comparison]].
-- Function: length= :: See [[info:elisp#Sequence Functions][Sequence 
Functions]].
-- Function: length< :: See [[info:elisp#Sequence Functions][Sequence 
Functions]].
-- Function: length> :: See [[info:elisp#Sequence Functions][Sequence 
Functions]].
-- Function: file-name-concat :: See [[info:elisp#Directory Names][Directory 
Names]].
-- Function: garbage-collect-maybe :: Defined in ~alloc.c~.
-- Function: string-replace :: See [[info:elisp#Search and Replace][Search and 
Replace]].
-- Function: always :: [[info:elisp#Calling Functions][Calling Functions]].
-- Function: insert-into-buffer :: See [[info:elisp#Insertion][Insertion]].
-- Function: replace-regexp-in-region :: See [[info:elisp#Search and 
Replace][Search and Replace]].
-- Function: replace-string-in-region :: See [[info:elisp#Search and 
Replace][Search and Replace]].
-- Function: buffer-local-boundp :: See [[info:elisp#Creating 
Buffer-Local][Creating Buffer-Local]].
-- Function: with-existing-directory :: See [[info:elisp#Testing 
Accessibility][Testing Accessibility]].
-- Macro: dlet :: See [[info:elisp#Local Variables][Local Variables]].
-- Function: ensure-list :: See [[info:elisp#Building Lists][Building Lists]].
-- Function: string-clean-whitespace :: See [[info:elisp#Creating 
Strings][Creating Strings]].
-- Function: string-fill :: See [[info:elisp#Creating Strings][Creating 
Strings]].
-- Function: string-lines :: See [[info:elisp#Creating Strings][Creating 
Strings]].
-- Function: string-pad :: See [[info:elisp#Creating Strings][Creating 
Strings]].
-- Function: string-chop-newline :: See [[info:elisp#Creating Strings][Creating 
Strings]].
-- Macro: named-let :: See [[info:elisp#Local Variables][Local Variables]].
-- Function: file-name-with-extension :: See [[info:elisp#File Name 
Components][File Name
-  Components]].
-- Function: directory-empty-p :: See [[info:elisp#Contents of 
Directories][Contents of Directories]].
-- Function: format-prompt :: See [[info:elisp#Text from Minibuffer][Text from 
Minibuffer]].
-- Function: thing-at-mouse :: Defined in ~thingatpt.el~.
-- Function: macroexp-file-name :: Defined in ~macroexp~.
-- Macro: with-environment-variables :: See [[info:elisp#System 
Environment][System
-  Environment]].
-- Function: button-buttonize :: Defined in ~button.el~.
-- Function: make-directory-autoloads :: See [[info:elisp#Autoload][Autoload]].
-- Function: color-values-from-color-spec :: Defined in ~xfaces.c~.
-- Function: file-modes-number-to-symbolic :: See [[info:elisp#Changing 
Files][Changing
-  Files]].
-- Function: file-backup-file-names :: See [[info:elisp#Backup Names][Backup 
Names]].
-- Function: make-lock-file-name :: Defined in ~files.el~.
-- Function: null-device :: Defined in ~files.el~.
-- Function: decoded-time-period :: Defined in ~time-data.el~.
-- Function: subr-primitive-p :: Defined in ~subr.el~.
-- Function: file-name-absolute-p :: See [[info:elisp#Relative File 
Names][Relative File Names]].
-
-These functions are prefixed with ~compat~ prefix, and are only loaded
-when ~compat-28~ is required:
-
-- Function: compat-unlock-buffer :: See [[info:elisp#File Locks][File Locks]].
-
-  Handle ~file-error~ conditions.
-
-- Function: compat-string-width :: See [[info:elisp#Size of Displayed 
Text][Size of Displayed Text]].
-
-  Handle optional arguments FROM and TO.
-
-- Function: compat-json-serialize :: See [[info:elisp#Parsing JSON][Parsing 
JSON]].
-
-  Handle primitive, top-level JSON values.
-- Function: compat-json-insert :: See [[info:elisp#Parsing JSON][Parsing 
JSON]].
-
-  Handle primitive, top-level JSON values.
-- Function: compat-json-parse-string :: See [[info:elisp#Parsing JSON][Parsing 
JSON]].
-
-  Handle primitive, top-level JSON values.
-- Function: compat-json-parse-buffer :: See [[info:elisp#Parsing JSON][Parsing 
JSON]].
-
-  Handle primitive, top-level JSON values.
-- Function: compat-count-windows :: Defined in ~window.el~.
-
-  Handle optional argument ALL-FRAMES.
-
-Compat does not provide support for the following Lisp features
-implemented in 28.1:
-
-- Support for ~interactive~ or ~declare~ to list applicable modes.
-- Support for ~:interactive~ argument to ~define-minor-mode~ and
-  ~define-derived-mode~.
-- Support for ~:predicate~ argument to ~define-globalized-minor-mode~.
-- "Success handler" for ~condition-case~.
-- The function ~benchmark-call~.
-- Support for the ~natnum~ defcustom type.
-- The function ~macroexp-compiling-p~.
-- The function ~macroexp-warn-and-return~.
-- Additional Edebug keywords.
-- Shorthand support.
-- The function ~custom-add-choice~.
-- The function ~decoded-time-period~.
-- The function ~dom-print~.
-- The function ~dom-remove-attribute~.
-- The function ~dns-query-asynchronous~.
-- The function ~get-locale-names~.
-- The function ~json-avaliable-p~.
-- The function ~mail-header-parse-addresses-lax~.
-- The function ~mail-header-parse-address-lax~.
-- The function ~make-separator-line~.
-- The function ~num-processors~.
-- The function ~object-intervals~.
-- The function ~process-lines-ignore-status~.
-- The function ~require-theme~.
-- The function ~syntax-class-to-char~.
-- The function ~null-device~ and ~path-separator~.
-
-* Development
-Compat is developed on [[https://sr.ht/~pkal/compat][SourceHut]]. A restricted 
[[https://github.com/phikal/compat.el][GitHub mirror]] is also
-maintained.
-
-Patches and comments can be sent to the 
[[https://lists.sr.ht/~pkal/compat-devel][development mailing list]]
-([[mailto:~pkal/compat-devel@lists.sr.ht][~pkal/compat-devel@lists.sr.ht]]).  
Bug reports are best sent to the
-[[https://todo.sr.ht/~pkal/compat][issue tracker]] 
([[mailto:~pkal/compat@todo.sr.ht][~pkal/compat@todo.sr.ht]]).  The GitHub 
mirror can also
-be used to submit patches.  These may include issues in the
-compatibility code, missing definitions or performance issues.
-
-Please note that as a GNU ELPA package, Compat requires contributors
-to have signed the 
[[https://www.gnu.org/software/emacs/manual/html_node/emacs/Copyright-Assignment.html][FSF
 copyright assignment]], before any non-trivial
-contribution (roughly 15 lines of code) can be applied.
-
-* Function Index
-:PROPERTIES:
-:APPENDIX:   t
-:INDEX:      fn
-:END:
-
-* Variable Index
-:PROPERTIES:
-:APPENDIX:   t
-:INDEX:      vr
-:END:
-
-* Distribution
-:PROPERTIES:
-:COPYING: t
-:END:
-
-Copyright \copy 2022  Free Software Foundation, Inc.
-
-#+begin_quote
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.3 or
-any later version published by the Free Software Foundation; with no
-Invariant Sections, with the Front-Cover Texts being “A GNU Manual,” and
-with the Back-Cover Texts as in (a) below.  A copy of the license is
-included in the section entitled “GNU Free Documentation License.”
-
-(a) The FSF’s Back-Cover Text is: “You have the freedom to copy and
-modify this GNU manual.”
-#+end_quote
diff --git a/Makefile b/Makefile
index af3cce2637..776c125027 100644
--- a/Makefile
+++ b/Makefile
@@ -35,8 +35,5 @@ compat-font-lock.el: compat-macs.el
 .el.elc:
        $(EMACS) -Q --batch -L . -f batch-byte-compile $<
 
-# compat.texi: MANUAL
-#      $(EMACS) -Q --batch $< -f org-texinfo-export-to-texinfo --kill
-
 compat.info: compat.texi
        $(MAKEINFO) $<