From b10c9d201222b144df7d63660d1c731af53c4ae2 Mon Sep 17 00:00:00 2001
From: Nobuyoshi Nakada <nobu@ruby-lang.org>
Date: Sun, 24 May 2020 10:53:12 +0900
Subject: [PATCH] [DOC] Added document for rb_check_symbol() [ci skip]

---
 symbol.c | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/symbol.c b/symbol.c
index a0aa4cc75f..185c6a8c82 100644
--- a/symbol.c
+++ b/symbol.c
@@ -957,6 +957,18 @@ rb_check_id(volatile VALUE *namep)
     return lookup_str_id(name);
 }
 
+/**
+ * Returns Symbol for the given name if it is interned already, or
+ * nil.
+ *
+ * \param namep   the pointer to the name object
+ * \return        the Symbol for *namep
+ * \pre           the object referred by \p namep must be a Symbol or
+ *                a String, or possible to convert with to_str method.
+ * \post          the object referred by \p namep is a Symbol or a
+ *                String if non-nil value is returned, or is a String
+ *                if nil is returned.
+ */
 VALUE
 rb_check_symbol(volatile VALUE *namep)
 {