Improve commentary

6 files changed, 14 insertions, 18 deletions

diff --git a/compat-25.el b/compat-25.el
index 6186ace..8414ada 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 4340113..bdfb6e9 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 6f940ce..0fad794 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 7dcb4ed..2c56c78 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 2ad2dca..1988df6 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 730604c..bc573b5 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: