Bug #4760: Some documentation improvements for Hash#key

• Status: Closed
• Assignee: drbrain (Eric Hodel)
• Target version: -
• ruby -v: 1.9.2

[utkarshkukreti (Utkarsh Kukreti)]

Added some documentation for Hash#key, when a Hash contains more than one key with the same value.

[drbrain (Eric Hodel)]

• Status changed from Open to Closed
• % Done changed from 0 to 100

This issue was solved with changeset r31705.
Utkarsh, thank you for reporting this issue.
Your contribution to Ruby is greatly appreciated.
May Ruby be with you.

---

• hash.c: Improve documentation of Hash#key. Patch by Utkarsh
  Kukreti. [Ruby 1.9 - Bug #4760]

[mame (Yusuke Endoh)]

• Status changed from Closed to Open

Hello,

Returns the key of the first occurrence of a given value.

Is this really guaranteed?

Writing a rdoc means deciding a spec.
Do not decide a spec without discussion.
Eric, please be careful to review a document patch.

--
Yusuke Endoh [e-mail]

[drbrain (Eric Hodel)]

I thought this was ok since Hash is now sorted.

I will change this from "the first occurrence" to "an occurrence" since this is not guaranteed to be a specification of Hash#key.

[drbrain (Eric Hodel)]

• Status changed from Open to Closed

This issue was solved with changeset r31878.
Utkarsh, thank you for reporting this issue.
Your contribution to Ruby is greatly appreciated.
May Ruby be with you.

---

• hash.c (key_i): Change rdoc from "the first occurence" to "an
  occurrence" since first occurrence is not a specification of
  Hash#key. [Ruby 1.9 - Bug #4760]