[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[GNU ELPA] Compat version

From: ELPA update
Subject: [GNU ELPA] Compat version
Date: Mon, 16 Jan 2023 17:02:59 -0500

Version of package Compat has just been released in GNU ELPA.
You can now find it in M-x list-packages RET.

Compat describes itself as:

  Emacs Lisp Compatibility Library

More at

## Summary:

  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.  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.

## Recent NEWS:

                         COMPAT.EL - CHANGELOG

1 Release of "Compat" Version

  • All compatibility functions are covered by tests!
  • Add links from compatibility definitions to tests.
  • BREAKING: Drop JSON parsing support (libjansson API, unused
  • BREAKING: Drop `null-device' (unused downstream).
  • BREAKING: Drop `unlock-buffer' (unused downstream).
  • compat-26: Add `buffer-hash'.
  • compat-27: Add `fixnump' and `bignump'.
  • compat-27: Add `with-minibuffer-selected-window'.
  • compat-27: Add generalized variables for `decoded-time-*'.
  • compat-28: Add `macroexp-warn-and-return'.
  • compat-28: Add `subr-native-elisp-p'.
  • compat-28: Add `bounds-of-thing-at-mouse'.
  • compat-29: Add `with-buffer-unmodified-if-unchanged'.
  • compat-29: Fix and test `define-key' with REMOVE argument.

  (Release <2023-01-16 Mon>)

2 Release of "Compat" Version

  • Add tests, 167 out of 203 definitions tested (82%).
  • compat-25: Improve algorithmic complexity of `sort'.
  • compat-28: Add `make-separator-line'.
  • compat-29: Minor fixes to `keymap-*' functions.
  • compat-29: Add `with-memoization'.
  • compat-29: Add `buttonize' and `buttonize-region'.

  (Release <2023-01-14 Sat>)

3 Release of "Compat" Version

  • The macros in `compat-macs.el' have been rewritten and
    simplified. The refactoring allows to further refine the criteria
    under which compatibility aliases, functions, macros and variables
    are installed.
  • Remove deprecated, prefixed compatibility functions.
  • Remove deprecated features `compat-help', `compat-font-lock' and
  • Compat uses runtime checks (`boundp', `fboundp') to ensure that
    existing definitions are never overridden, when Compat is loaded on
    a newer Emacs than it was compiled on.
  • Compat compiles without byte compilation warnings on all supported
    Emacs versions. Warnings are treated as errors in the test suite.
  • Compat takes great care to remove unneeded definitions at compile
    time. On recent Emacs 29 the byte compiled files are empty and not
    loaded, such that Compat does not any cost to the Emacs process.
  • compat-26: Fix and test `image-property' setter.
  • compat-26: Fix and test `read-multiple-choice'.
  • compat-28: Fix and test `with-existing-directory'.
  • compat-28: Drop obsolete function `make-directory-autoloads'.
  • compat-29: Drop broken functions `string-pixel-width' and
    `buffer-text-pixel-size'. These functions had poor performance which
    lead to a downstream issue in the doom-modeline package. If a more
    efficient solution is possible, the function will be added back.
  • compat-29: Drop broken function `string-limit'.
  • compat-29: Drop broken macro `with-buffer-unmodified-if-unchanged',
    which relied on `buffer-hash' which does not exist on all supported
    Emacs versions.
  • compat-29: Add `pos-bol' and `pos-eol'.

  (Release <2023-01-07 Sat>)

4 Release of "Compat" Version

  • Add multiple new tests for existing APIs.
  • Fix bugs in compatibility functions: `setq-local', `proper-list-p,
    prop-match-p', `file-name-concat', `replace-regexp-in-region',
  • Add new Emacs 29 APIs. Some of them are still untested and may
    change. If you intend to use an Emacs 29 API please be careful and
    if possible contribute test cases. All untested functions are marked
    in the Compat code. Over time tests for all functions will be added
  • Add the macros `compat-call' and `compat-function' to call
    compatibility functions. Since Compat avoids overwriting already
    existing functions, we must define separate compatibility function
    definitions for functions which changed their calling convention or
    behavior. These compatibility definitions can be looked up using
    `compat-function' and called with `compat-call'. For example `assoc'
    can be called with a `TESTFN' since Emacs 26. In Emacs 25 and older
    the calling convention was `(assoc KEY ALIST)'. In order to use the
    new calling convention you can use `(compat-call assoc KEY ALIST
  • Deprecate all `compat-*' prefixed functions. Instead use the
  …  …

reply via email to

[Prev in Thread] Current Thread [Next in Thread]