[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/compat 0a67a87216 3/8: Update manual
From: |
ELPA Syncer |
Subject: |
[elpa] externals/compat 0a67a87216 3/8: Update manual |
Date: |
Thu, 5 Jan 2023 03:57:27 -0500 (EST) |
branch: externals/compat
commit 0a67a87216939614564747f2a2eb61eb4122464b
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>
Update manual
---
compat.el | 10 ++++++----
compat.texi | 14 ++++++++------
2 files changed, 14 insertions(+), 10 deletions(-)
diff --git a/compat.el b/compat.el
index 93b404e7df..c163c65394 100644
--- a/compat.el
+++ b/compat.el
@@ -26,10 +26,12 @@
;; To allow for the usage of Emacs functions and macros that are
;; defined in newer versions of Emacs, compat.el provides definitions
-;; that are installed ONLY if necessary. These reimplementations of
-;; functions and macros are at least subsets of the actual
-;; implementations. Be sure to read the documentation string to make
-;; sure.
+;; that are installed ONLY if necessary. If Compat is installed on a
+;; recent version of Emacs, all of the definitions are disabled at
+;; compile time, such that no negative performance impact is incurred.
+;; These reimplementations of functions and macros are at least
+;; subsets of the actual implementations. Be sure to read the
+;; documentation string to make sure.
;;
;; Not every function provided in newer versions of Emacs is provided
;; here. Some depend on new features from the core, others cannot be
diff --git a/compat.texi b/compat.texi
index c5f38bf495..476b5a8047 100644
--- a/compat.texi
+++ b/compat.texi
@@ -135,12 +135,14 @@ the noerror flag should be specified.
(require 'compat nil 'noerror)
@end example
-This will load all implicit and explicit Compat definitions. Functions
-and macros where the calling convention or behavior has changed can be
-accessed explicitly via @code{compat-function} and
-@code{compat-call}. We call these definitions ``Explicit
-Definitions''. In contrast, ``Implicit Definitions'' can be called as
-usual.
+This will load all implicit and explicit Compat definitions. Note
+that if Compat is installed on a recent version of Emacs, all of the
+definitions are disabled at compile time, such that no negative
+performance impact is incurred. Functions and macros where the
+calling convention or behavior has changed can be accessed explicitly
+via @code{compat-function} and @code{compat-call}. We call these
+definitions ``Explicit Definitions''. In contrast, ``Implicit
+Definitions'' can be called as usual.
@example
(compat-call assoc KEY ALIST TESTFN) ;; Explicit
- [elpa] externals/compat updated (4bfab527f0 -> a0e79a8203), ELPA Syncer, 2023/01/05
- [elpa] externals/compat 0a67a87216 3/8: Update manual,
ELPA Syncer <=
- [elpa] externals/compat a0e79a8203 8/8: Do not compile obsolete packages, ELPA Syncer, 2023/01/05
- [elpa] externals/compat 0bbc83973d 6/8: Remove unnecessary declare-functions, ELPA Syncer, 2023/01/05
- [elpa] externals/compat fcee343947 7/8: .elpaignore: Add .gitignore, ELPA Syncer, 2023/01/05
- [elpa] externals/compat 3d5d2068d9 5/8: Remove unnecessary declare-functions, ELPA Syncer, 2023/01/05
- [elpa] externals/compat 17f018c0a1 4/8: Update author information, ELPA Syncer, 2023/01/05
- [elpa] externals/compat d696cf9218 2/8: Update manual, ELPA Syncer, 2023/01/05
- [elpa] externals/compat ca5a659f4d 1/8: Update ci config, ELPA Syncer, 2023/01/05