[elpa] externals/compat f040277c38 4/4: Improve commentary

[ELPA Syncer]

branch: externals/compat
commit f040277c38adec0b7c0c712c53e427d64b2a1537
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@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: