From 29b3d683fb85d8c63b7b616ce8544d538814feaf Mon Sep 17 00:00:00 2001
From: Daisuke Aritomo <osyoyu@osyoyu.com>
Date: Sat, 10 May 2025 16:35:02 +0900
Subject: [PATCH] [DOC] Make clear that current behavior is not ideal

---
 gc.c | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/gc.c b/gc.c
index 418298a710..0443b313d1 100644
--- a/gc.c
+++ b/gc.c
@@ -1545,9 +1545,11 @@ os_obj_of(VALUE of)
  *     2.2250738585072e-308
  *     Total count: 7
  *
- *  When the process is in multi-Ractor mode (when <code>Ractor.new</code>
- *  has been called within the process at least once), this method yields
- *  Ractor-shareable objects only.
+ *  Due to implementation limitations, this method will not yield
+ *  Ractor-unshareable the process is in multi-Ractor mode (when
+ *  <code>Ractor.new</code> has been called within the process at least once).
+ *  This behavior is not considered ideal.
+ *  See https://bugs.ruby-lang.org/issues/19387 for more information.
  *
  *     a = 12345678987654321 # shareable
  *     b = [].freeze # shareable