[DOC] Tweaks for Hash#slice

1 files changed, 5 insertions, 3 deletions

diff --git a/hash.c b/hash.c
index 1c34e9f4ac..da0e914afd 100644
--- a/hash.c
+++ b/hash.c
@@ -2646,11 +2646,13 @@ rb_hash_reject(VALUE hash)
  *  call-seq:
  *    slice(*keys) -> new_hash
  *
- *  Returns a new +Hash+ object containing the entries for the given +keys+:
+ *  Returns a new hash containing the entries from +self+ for the given +keys+;
+ *  ignores any keys that are not found:
+ *
  *    h = {foo: 0, bar: 1, baz: 2}
- *    h.slice(:baz, :foo) # => {baz: 2, foo: 0}
+ *    h.slice(:baz, :foo, :nosuch) # => {baz: 2, foo: 0}
  *
- *  Any given +keys+ that are not found are ignored.
+ *  Related: see {Methods for Deleting}[rdoc-ref:Hash@Methods+for+Deleting].
  */
 
 static VALUE