branch: externals/compat
commit f040277c38adec0b7c0c712c53e427d64b2a1537
Author: Daniel Mendler <m...@daniel-mendler.de>
Commit: Daniel Mendler <m...@daniel-mendler.de>
Improve commentary
---
compat-25.el | 5 ++---
compat-26.el | 5 ++---
compat-27.el | 5 ++---
compat-28.el | 5 ++---
compat-29.el | 5 ++---
compat.el | 7 ++++---
6 files changed, 14 insertions(+), 18 deletions(-)
diff --git a/compat-25.el b/compat-25.el
index 6186ace9dc..8414ada65d 100644
--- a/compat-25.el
+++ b/compat-25.el
@@ -1,4 +1,4 @@
-;;; compat-25.el --- Compatibility Layer for Emacs 25.1 -*- lexical-binding:
t; -*-
+;;; compat-25.el --- Functionality added in Emacs 25.1 -*- lexical-binding: t;
-*-
;; Copyright (C) 2021-2023 Free Software Foundation, Inc.
@@ -17,8 +17,7 @@
;;; Commentary:
-;; Find here the functionality added in Emacs 25.1, needed by older
-;; versions.
+;; Functionality added in Emacs 25.1, needed by older Emacs versions.
;;; Code:
diff --git a/compat-26.el b/compat-26.el
index 4340113dab..bdfb6e91dc 100644
--- a/compat-26.el
+++ b/compat-26.el
@@ -1,4 +1,4 @@
-;;; compat-26.el --- Compatibility Layer for Emacs 26.1 -*- lexical-binding:
t; -*-
+;;; compat-26.el --- Functionality added in Emacs 26.1 -*- lexical-binding: t;
-*-
;; Copyright (C) 2021-2023 Free Software Foundation, Inc.
@@ -17,8 +17,7 @@
;;; Commentary:
-;; Find here the functionality added in Emacs 26.1, needed by older
-;; versions.
+;; Functionality added in Emacs 26.1, needed by older Emacs versions.
;;; Code:
diff --git a/compat-27.el b/compat-27.el
index 6f940ce9ac..0fad7943a7 100644
--- a/compat-27.el
+++ b/compat-27.el
@@ -1,4 +1,4 @@
-;;; compat-27.el --- Compatibility Layer for Emacs 27.1 -*- lexical-binding:
t; -*-
+;;; compat-27.el --- Functionality added in Emacs 27.1 -*- lexical-binding: t;
-*-
;; Copyright (C) 2021-2023 Free Software Foundation, Inc.
@@ -17,8 +17,7 @@
;;; Commentary:
-;; Find here the functionality added in Emacs 27.1, needed by older
-;; versions.
+;; Functionality added in Emacs 27.1, needed by older Emacs versions.
;;; Code:
diff --git a/compat-28.el b/compat-28.el
index 7dcb4ed374..2c56c786b6 100644
--- a/compat-28.el
+++ b/compat-28.el
@@ -1,4 +1,4 @@
-;;; compat-28.el --- Compatibility Layer for Emacs 28.1 -*- lexical-binding:
t; -*-
+;;; compat-28.el --- Functionality added in Emacs 28.1 -*- lexical-binding: t;
-*-
;; Copyright (C) 2021-2023 Free Software Foundation, Inc.
@@ -17,8 +17,7 @@
;;; Commentary:
-;; Find here the functionality added in Emacs 28.1, needed by older
-;; versions.
+;; Functionality added in Emacs 28.1, needed by older Emacs versions.
;;; Code:
diff --git a/compat-29.el b/compat-29.el
index 2ad2dca448..1988df636f 100644
--- a/compat-29.el
+++ b/compat-29.el
@@ -1,4 +1,4 @@
-;;; compat-29.el --- Compatibility Layer for Emacs 29.1 -*- lexical-binding:
t; -*-
+;;; compat-29.el --- Functionality added in Emacs 29.1 -*- lexical-binding: t;
-*-
;; Copyright (C) 2021-2023 Free Software Foundation, Inc.
@@ -17,8 +17,7 @@
;;; Commentary:
-;; Find here the functionality added in Emacs 29.1, needed by older
-;; versions.
+;; Functionality added in Emacs 29.1, needed by older Emacs versions.
;;; Code:
diff --git a/compat.el b/compat.el
index 730604c870..bc573b5ebf 100644
--- a/compat.el
+++ b/compat.el
@@ -36,9 +36,10 @@
;; Not every function provided in newer versions of Emacs is provided
;; here. Some depend on new features from the core, others cannot be
;; implemented to a meaningful degree. Please consult the Compat
-;; manual for details. The main audience for this library are not
-;; regular users, but package maintainers. Therefore commands and
-;; user options are usually not implemented here.
+;; manual for details regarding the usage of the Compat library and
+;; the provided functionality. The main audience for this library are
+;; not regular users, but package maintainers. Therefore no commands,
+;; user-facing modes or user options are implemented here.
;;; Code:
