From: BurdetteLamar <burdettelamar@yahoo.com>
Date: Wed, 9 Oct 2024 16:33:22 +0000 (-0500)
Subject: [DOC] Tweaks for Array#reverse!
X-Git-Tag: v3_4_0_rc1~1301
X-Git-Url: https://repo.or.cz/ruby.git/commitdiff_plain/1962be267cb3e7ea946f34967f42f48a01558084

[DOC] Tweaks for Array#reverse!
---

diff --git a/array.c b/array.c
index 520d3f0bb8..a4c600a472 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