From 1962be267cb3e7ea946f34967f42f48a01558084 Mon Sep 17 00:00:00 2001
From: BurdetteLamar <burdettelamar@yahoo.com>
Date: Wed, 9 Oct 2024 11:33:22 -0500
Subject: [PATCH] [DOC] Tweaks for Array#reverse!

---
 array.c | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/array.c b/array.c
index 520d3f0bb8928c..a4c600a4726afd 100644
--- a/array.c
+++ b/array.c
@@ -3123,13 +3123,16 @@ rb_ary_reverse(VALUE ary)
 
 /*
  *  call-seq:
- *    array.reverse! -> self
+ *    reverse! -> self
  *
- *  Reverses +self+ in place:
+ *  Reverses the order of the elements of +self+;
+ *  returns +self+:
  *
- *    a = ['foo', 'bar', 'two']
- *    a.reverse! # => ["two", "bar", "foo"]
+ *    a = [0, 1, 2]
+ *    a.reverse! # => [2, 1, 0]
+ *    a          # => [2, 1, 0]
  *
+ *  Related: see {Methods for Assigning}[rdoc-ref:Array@Methods+for+Assigning].
  */
 
 static VALUE