From ea39e1e39b59d58e19aef015fbc847099cf0c673 Mon Sep 17 00:00:00 2001
From: Burdette Lamar <BurdetteLamar@Yahoo.com>
Date: Sat, 27 Jun 2026 11:18:59 -0500
Subject: [PATCH 1/3] [DOC] Update Set#clear documentation

---
 set.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/set.c b/set.c
index 84841ed4e30f47..d68dc97bd79b98 100644
--- a/set.c
+++ b/set.c
@@ -1024,11 +1024,11 @@ set_clear_i(st_data_t key, st_data_t dummy)
  *  call-seq:
  *    clear -> self
  *
- *  Removes all elements and returns self.
+ *  Returns +self+ with all elements removed:
  *
- *    set = Set[1, 'c', :s]             #=> Set[1, "c", :s]
- *    set.clear                         #=> Set[]
- *    set                               #=> Set[]
+ *    Set[1, :one, 'one', 1.0].clear # => Set[]
+ *
+ *  Related: see {Methods for Deleting}[rdoc-ref:Set@Methods+for+Deleting].
  */
 static VALUE
 set_i_clear(VALUE set)

From d7e931657babdfcb0ec7f85f3b6b93944daf4b74 Mon Sep 17 00:00:00 2001
From: Burdette Lamar <BurdetteLamar@Yahoo.com>
Date: Sat, 27 Jun 2026 11:20:21 -0500
Subject: [PATCH 2/3] [DOC] Update Set#collect! documentation

---
 set.c | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/set.c b/set.c
index d68dc97bd79b98..e7678ecfa33943 100644
--- a/set.c
+++ b/set.c
@@ -1474,11 +1474,18 @@ set_collect_i(st_data_t key, st_data_t data)
 
 /*
  *  call-seq:
- *    collect! { |o| ... } -> self
+ *    collect! {|element| ... } -> self
  *    collect! -> enumerator
  *
- *  Replaces the elements with ones returned by +collect+.
- *  Returns an enumerator if no block is given.
+ *  With a block given, calls the block with each element in +self+;
+ *  replaces the element with the block's return value:
+ *
+ *    Set[1, :one, 'one', 1.0].collect! {|element| element.class }
+ *    # => Set[Integer, Symbol, String, Float]
+ *
+ *  With no block given, returns an Enumerator.
+ *
+ *  Related: see {Methods for Converting}[rdoc-ref:Set@Methods+for+Converting].
  */
 static VALUE
 set_i_collect(VALUE set)

From f90fa4bd57fd11347fb9870839fbde20db0984c2 Mon Sep 17 00:00:00 2001
From: Burdette Lamar <BurdetteLamar@Yahoo.com>
Date: Sat, 27 Jun 2026 11:35:43 -0500
Subject: [PATCH 3/3] [DOC] Update Set#delete documentation

---
 set.c | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/set.c b/set.c
index e7678ecfa33943..2f853d2a61a76e 100644
--- a/set.c
+++ b/set.c
@@ -778,10 +778,16 @@ set_i_add_p(VALUE set, VALUE item)
 
 /*
  *  call-seq:
- *    delete(obj) -> self
+ *    delete(object) -> self
  *
- *  Deletes the given object from the set and returns self. Use subtract
- *  to delete many items at once.
+ *  Removes the given +object+ from +self+, if +self+ includes the object;
+ *  returns +self+:
+ *
+ *    set = Set[0, 'zero', :zero]
+ *    set.delete(0)       # => Set["zero", :zero]
+ *    set.delete(:nosuch) # => Set["zero", :zero]
+ *
+ *  Related: see {Methods for Deleting}[rdoc-ref:Set@Methods+for+Deleting].
  */
 static VALUE
 set_i_delete(VALUE set, VALUE item)