From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 15 Jul 2023 10:04:41 +0000 (+0300)
Subject: ; * src/lisp.h: Improve commentary for XIL, XLI, XLP (bug#64645).
X-Git-Tag: emacs-29.1-rc1~30
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=d78e670237bc735e0804a91b3cb4fc962317ad8a;p=emacs.git

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

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))