hash.c: improve docs for Hash#slice

* hash.c: [DOC] clarify description for Hash#slice and remove
  a sentence that might suggest that the receiver is modified;
  improve example to also include a case where a hash with
  several elements is returned.

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@60713 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

1 files changed, 4 insertions, 5 deletions

diff --git a/hash.c b/hash.c
index a3c576d80c..c8d1406cc7 100644
--- a/hash.c
+++ b/hash.c
@@ -1329,12 +1329,11 @@ rb_hash_reject(VALUE hash)
  *  call-seq:
  *     hsh.slice(*keys) -> a_hash
  *
- *  Slices a hash to include only the given keys.
- *  Returns a hash containing the given keys.
+ *  Returns a hash containing only the given keys and their values.
  *
- *     h = { "a" => 100, "b" => 200, "c" => 300 }
- *     h.slice("a")      #=> {"a"=>100}
- *     h.slice("c", "d") #=> {"c"=>300}
+ *     h = { a: 100, b: 200, c: 300 }
+ *     h.slice(:a)           #=> {:a=>100}
+ *     h.slice(:b, :c, :d)   #=> {:b=>200, :c=>300}
  */
 
 static VALUE