From 19ddbdcf4b8d455c5c999bed11978b787a5b5907 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Thu, 5 Jun 2025 23:12:50 +0000
Subject: [PATCH] Add descriptive comments for MRB_API functions in src/state.c

This commit adds descriptive comments to the following MRB_API functions in src/state.c, clarifying their purpose and functionality:

- mrb_open_core
- mrb_open
- mrb_free_context
- mrb_close
- mrb_add_irep
- mrb_top_self
- mrb_state_atexit
---
 src/state.c | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/state.c b/src/state.c
index f94f108be..1aeb42552 100644
--- a/src/state.c
+++ b/src/state.c
@@ -35,6 +35,7 @@ init_gc_and_core(mrb_state *mrb, void *opaque)
   mrb_init_core(mrb);
 }
 
+/* Initializes the core of mruby, without loading gems. */
 MRB_API mrb_state*
 mrb_open_core(void)
 {
@@ -63,6 +64,7 @@ init_mrbgems(mrb_state *mrb, void *opaque)
 }
 #endif
 
+/* Initializes mruby, including loading gems. */
 MRB_API mrb_state*
 mrb_open(void)
 {
@@ -156,6 +158,7 @@ mrb_irep_free(mrb_state *mrb, mrb_irep *irep)
   mrb_free(mrb, irep);
 }
 
+/* Frees a mruby context. */
 MRB_API void
 mrb_free_context(mrb_state *mrb, struct mrb_context *c)
 {
@@ -167,6 +170,7 @@ mrb_free_context(mrb_state *mrb, struct mrb_context *c)
 
 void mrb_protect_atexit(mrb_state *mrb);
 
+/* Closes and finalizes a mruby state. */
 MRB_API void
 mrb_close(mrb_state *mrb)
 {
@@ -181,6 +185,7 @@ mrb_close(mrb_state *mrb)
   mrb_free(mrb, mrb);
 }
 
+/* Adds an instruction sequence (irep) to the mruby state. */
 MRB_API mrb_irep*
 mrb_add_irep(mrb_state *mrb)
 {
@@ -194,12 +199,14 @@ mrb_add_irep(mrb_state *mrb)
   return irep;
 }
 
+/* Returns the top-level self object. */
 MRB_API mrb_value
 mrb_top_self(mrb_state *mrb)
 {
   return mrb_obj_value(mrb->top_self);
 }
 
+/* Registers a function to be called when the mruby state is closed. */
 MRB_API void
 mrb_state_atexit(mrb_state *mrb, mrb_atexit_func f)
 {