[elpa] externals/compat 0bb4709d83 16/16: Expand commentary

[ELPA Syncer]

branch: externals/compat
commit 0bb4709d832081b7c301258cb2be323a48e758fa
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>

    Expand commentary
---
 compat-tests.el | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/compat-tests.el b/compat-tests.el
index 37fc1f4d69..d8293090c6 100644
--- a/compat-tests.el
+++ b/compat-tests.el
@@ -21,12 +21,18 @@
 ;;
 ;; Note that not all functions have tests yet.  Additions are very welcome.
 ;; If you intend to use a function, which doesn't have tests yet, please
-;; add tests here.  NO GUARANTEES ARE MADE FOR FUNCTIONS WITHOUT TESTS.
-
-;; The tests are written in a simple, explicit style.  The functions tested
-;; here are guaranteed to work on the Emacs versions tested by continuous
-;; integration.  This includes 24.4, 24.5, 25.1, 25.2, 25.3, 26.1, 26.2,
-;; 26.3, 27.1, 27.2, 28.1 and the current Emacs master branch.
+;; contribute tests here.  NO GUARANTEES ARE MADE FOR FUNCTIONS WITHOUT
+;; TESTS.
+
+;; The tests are written in a simple, explicit style.  Please inspect the
+;; tests in order to find out the supported calling conventions.  In
+;; particular, note the use of `compat-call' to call functions, where the
+;; calling convention changed between Emacs versions.
+
+;; The functions tested here are guaranteed to work on the Emacs versions
+;; tested by continuous integration.  This includes 24.4, 24.5, 25.1, 25.2,
+;; 25.3, 26.1, 26.2, 26.3, 27.1, 27.2, 28.1 and the current Emacs master
+;; branch.
 
 ;;; Code: