; * src/lisp.h: Improve commentary for XIL, XLI, XLP (bug#64645).

1 files changed, 8 insertions, 1 deletions

diff --git a/src/lisp.h b/src/lisp.h
index e8b9a795e3c..740e031e865 100644
--- a/src/lisp.h
+++ b/src/lisp.h
@@ -331,7 +331,14 @@ typedef EMACS_INT Lisp_Word;
    see these functions for commentary.  */
 
 /* Convert among the various Lisp-related types: I for EMACS_INT, L
-   for Lisp_Object, P for void *.  */
+   for Lisp_Object, P for void *.
+
+   These use the following mnemonics:
+
+   XLI: Lisp_Object to Integer;
+   XIL: Integer to Lisp_Object;
+   XLP: Lisp_Object to Pointer.  */
+
 #if !CHECK_LISP_OBJECT_TYPE
 # if LISP_WORDS_ARE_POINTERS
 #  define lisp_h_XLI(o) ((EMACS_INT) (o))