[DOC] Tweaks for String#capitalize!

string.c

@@ -8242,22 +8242,14 @@ rb_str_downcase(int argc, VALUE *argv, VALUE str)
 
 /*
  *  call-seq:
- *    capitalize!(mapping) -> self or nil
+ *    capitalize!(mapping = :ascii) -> self or nil
  *
- *  Upcases the first character in +self+;
+ *  Like String#capitalize, except that:
- *  downcases the remaining characters;
- *  returns +self+ if any changes were made, +nil+ otherwise:
  *
- *    s = 'hello World!' # => "hello World!"
+ *  - Changes character casings in +self+ (not in a copy of +self+).
- *    s.capitalize!      # => "Hello world!"
+ *  - Returns +self+ if any changes are made, +nil+ otherwise.
- *    s                  # => "Hello world!"
- *    s.capitalize!      # => nil
- *
- *  The casing may be affected by the given +mapping+;
- *  see {Case Mapping}[rdoc-ref:case_mapping.rdoc].
- *
- *  Related: String#capitalize.
  *
+ *  Related: See {Modifying}[rdoc-ref:String@Modifying].
  */
 
 static VALUE