From f032a6a9c51cc0e9568c7cb36e30d365c14b5b8b Mon Sep 17 00:00:00 2001 Message-ID: From: Ihor Radchenko Date: Sat, 15 Jul 2023 12:46:43 +0300 Subject: [PATCH] * src/lisp.h: Describe a simple mnemonics to understand XLI/XIL/XLP macros These macro names may be confusing for untrained mind. Mnemonics described in the added comment helps to remember what is what for new readers. --- src/lisp.h | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/lisp.h b/src/lisp.h index f10bce86b45..528db45dbcf 100644 --- a/src/lisp.h +++ b/src/lisp.h @@ -332,7 +332,11 @@ #define LISP_WORDS_ARE_POINTERS (EMACS_INT_MAX == INTPTR_MAX) 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 *. + Useful mnemonics: + 1. XLI :: X is Lisp Integer + 2. XIL :: X Is Lisp + 3. XLP :: X is Lisp Pointer */ #if !CHECK_LISP_OBJECT_TYPE # if LISP_WORDS_ARE_POINTERS # define lisp_h_XLI(o) ((EMACS_INT) (o)) -- 2.41.0