https://git.ruby-lang.org/ruby.git/commit/?id=5c3cd09715

From 5c3cd09715c8ac623c0c0b41451d1568cba85a74 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=9C=E9=83=A8=E6=98=8C=E5=B9=B3?=
 <shyouhei@r...>
Date: Thu, 21 Jan 2021 12:02:26 +0900
Subject: include/ruby/internal/arithmetic/size_t.h: add doxygen

Must not be a bad idea to improve documents. [ci skip]
---
 include/ruby/internal/arithmetic/size_t.h | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/include/ruby/internal/arithmetic/size_t.h b/include/ruby/internal/arithmetic/size_t.h
index 4b46dfb..1082160 100644
--- a/include/ruby/internal/arithmetic/size_t.h
+++ b/include/ruby/internal/arithmetic/size_t.h
@@ -26,7 +26,12 @@ https://github.com/ruby/ruby/blob/trunk/include/ruby/internal/arithmetic/size_t.h#L26
 #include "ruby/internal/arithmetic/long_long.h"
 #include "ruby/backward/2/long_long.h"
 
-#if SIZEOF_SIZE_T == SIZEOF_LONG_LONG
+#if defined(__DOXYGEN__)
+# /** Converts a C's `size_t` into an instance of ::rb_cInteger. */
+# define RB_SIZE2NUM RB_ULONG2NUM
+# /** Converts a C's `ssize_t` into an instance of ::rb_cInteger. */
+# define RB_SSIZE2NUM RB_LONG2NUM
+#elif SIZEOF_SIZE_T == SIZEOF_LONG_LONG
 # define RB_SIZE2NUM RB_ULL2NUM
 # define RB_SSIZE2NUM RB_LL2NUM
 #elif SIZEOF_SIZE_T == SIZEOF_LONG
@@ -37,7 +42,12 @@ https://github.com/ruby/ruby/blob/trunk/include/ruby/internal/arithmetic/size_t.h#L42
 # define RB_SSIZE2NUM RB_INT2NUM
 #endif
 
-#if SIZEOF_SIZE_T == SIZEOF_LONG_LONG
+#if defined(__DOXYGEN__)
+# /** Converts an instance of ::rb_cInteger into C's `size_t`. */
+# define RB_NUM2SIZE RB_NUM2ULONG
+# /** Converts an instance of ::rb_cInteger into C's `ssize_t`. */
+# define RB_NUM2SSIZE RB_NUM2LONG
+#elif SIZEOF_SIZE_T == SIZEOF_LONG_LONG
 # define RB_NUM2SIZE RB_NUM2ULL
 # define RB_NUM2SSIZE RB_NUM2LL
 #elif SIZEOF_SIZE_T == SIZEOF_LONG
@@ -48,9 +58,9 @@ https://github.com/ruby/ruby/blob/trunk/include/ruby/internal/arithmetic/size_t.h#L58
 # define RB_NUM2SSIZE RB_NUM2INT
 #endif
 
-#define NUM2SIZET RB_NUM2SIZE
-#define SIZET2NUM RB_SIZE2NUM
-#define NUM2SSIZET RB_NUM2SSIZE
-#define SSIZET2NUM RB_SSIZE2NUM
+#define NUM2SIZET RB_NUM2SIZE   /**< @old{RB_NUM2SIZE} */
+#define SIZET2NUM RB_SIZE2NUM   /**< @old{RB_SIZE2NUM} */
+#define NUM2SSIZET RB_NUM2SSIZE /**< @old{RB_NUM2SSIZE} */
+#define SSIZET2NUM RB_SSIZE2NUM /**< @old{RB_SSIZE2NUM} */
 
 #endif /* RBIMPL_ARITHMETIC_SIZE_T_H */
-- 
cgit v1.1


--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/