https://git.ruby-lang.org/ruby.git/commit/?id=9febab7afc

From 9febab7afcff3a2b7d6a90f022ad19377f62733d 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 10:36:19 +0900
Subject: include/ruby/internal/dllexport.h: add doxygen

Must not be a bad idea to improve documents. [ci skip]
---
 include/ruby/internal/dllexport.h | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/include/ruby/internal/dllexport.h b/include/ruby/internal/dllexport.h
index 4c8c2f6..08a2622 100644
--- a/include/ruby/internal/dllexport.h
+++ b/include/ruby/internal/dllexport.h
@@ -18,13 +18,24 @@ https://github.com/ruby/ruby/blob/trunk/include/ruby/internal/dllexport.h#L18
  *             Do not  expect for  instance `__VA_ARGS__` is  always available.
  *             We assume C99  for ruby itself but we don't  assume languages of
  *             extension libraries.  They could be written in C++98.
- * @brief      Tewaking visibility of C variables/functions.
+ * @brief      Tweaking visibility of C variables/functions.
  */
 #include "ruby/internal/config.h"
 #include "ruby/internal/compiler_is.h"
 
-/* For MinGW, we need __declspec(dllimport) for RUBY_EXTERN on MJIT.
-   mswin's RUBY_EXTERN already has that. See also: win32/Makefile.sub */
+/**
+ * Declaration of externally visible global variables.  Here "externally" means
+ * they should  be visible  from extension  libraries.  Depending  on operating
+ * systems (dynamic linkers,  to be precise), global variables inside  of a DLL
+ * may  or may  not be  visible  form outside  of  that DLL  by default.   This
+ * declaration manually tweaks  that default and ensures  the declared variable
+ * be truly globally visible.
+ *
+ * ```CXX
+ * extern VALUE foo;      // hidden on some OS
+ * RUBY_EXTERN VALUE foo; // ensure visible
+ * ```
+ */
 #undef RUBY_EXTERN
 #if defined(MJIT_HEADER) && defined(_WIN32)
 # define RUBY_EXTERN extern __declspec(dllimport)
@@ -48,6 +59,13 @@ https://github.com/ruby/ruby/blob/trunk/include/ruby/internal/dllexport.h#L59
 # define RUBY_FUNC_EXPORTED /* void */
 #endif
 
+/**
+ * @cond INTERNAL_MACRO
+ *
+ * These MJIT related macros are placed here because translate_mjit_header can
+ * need them.  Extension libraries should not touch.
+ */
+
 /* These macros are used for functions which are exported only for MJIT
    and NOT ensured to be exported in future versions. */
 
@@ -71,6 +89,8 @@ https://github.com/ruby/ruby/blob/trunk/include/ruby/internal/dllexport.h#L89
 # define MJIT_STATIC
 #endif
 
+/** @endcond */
+
 /** Shortcut macro equivalent to `RUBY_SYMBOL_EXPORT_BEGIN extern "C" {`.
  * \@shyouhei finds it handy. */
 #if defined(__DOXYGEN__)
-- 
cgit v1.1


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