From 4fa47eabf21f3a13bb614cf8a63708f05decb710 Mon Sep 17 00:00:00 2001 From: Samuel Williams Date: Fri, 2 Dec 2022 17:49:42 +1300 Subject: Clarify the storage argument. (#6849) * Slightly more consistent indentation with other parts of the document. --- include/ruby/internal/intern/cont.h | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) (limited to 'include/ruby') diff --git a/include/ruby/internal/intern/cont.h b/include/ruby/internal/intern/cont.h index 3ee8b08dee..1ec78793b7 100644 --- a/include/ruby/internal/intern/cont.h +++ b/include/ruby/internal/intern/cont.h @@ -39,14 +39,18 @@ RBIMPL_SYMBOL_EXPORT_BEGIN() VALUE rb_fiber_new(rb_block_call_func_t func, VALUE callback_obj); /** - * Creates a Fiber instance from a C-backended block with the specified storage. + * Creates a Fiber instance from a C-backended block with the specified + * storage. * - * If the given storage is Qundef, this function is equivalent to + * If the given storage is Qundef or Qtrue, this function is equivalent to * rb_fiber_new() which inherits storage from the current fiber. * * If the given storage is Qfalse, this function uses the current fiber's * storage by reference. * + * Specifying either Qtrue or Qfalse is experimental and may be changed in the + * future. + * * If the given storage is Qnil, this function will lazy initialize the * internal storage which starts of empty (without any inheritance). * @@ -54,6 +58,7 @@ VALUE rb_fiber_new(rb_block_call_func_t func, VALUE callback_obj); * * @param[in] func A function, to become the fiber's body. * @param[in] callback_obj Passed as-is to `func`. + * @param[in] storage The way to set up the storage for the fiber. * @return An allocated new instance of rb_cFiber, which is ready to be * "resume"d. */ -- cgit v1.2.3