diff --git a/hash.c b/hash.c index 534280f5f0..0b211df3b3 100644 --- a/hash.c +++ b/hash.c @@ -6899,27 +6899,28 @@ static const rb_data_type_t env_data_type = { }; /* - * A +Hash+ maps each of its unique keys to a specific value. + * A \Hash object maps each of its unique keys to a specific value. * - * A +Hash+ has certain similarities to an Array, but: - * - An Array index is always an Integer. - * - A +Hash+ key can be (almost) any object. + * A hash has certain similarities to an Array, but: + + * - An array index is always an integer. + * - A hash key can be (almost) any object. * - * === +Hash+ \Data Syntax + * === \Hash \Data Syntax * - * The older syntax for +Hash+ data uses the "hash rocket," =>: + * The original syntax for a hash entry uses the "hash rocket," =>: * * h = {:foo => 0, :bar => 1, :baz => 2} * h # => {foo: 0, bar: 1, baz: 2} * - * Alternatively, but only for a +Hash+ key that's a Symbol, + * Alternatively, but only for a key that's a symbol, * you can use a newer JSON-style syntax, - * where each bareword becomes a Symbol: + * where each bareword becomes a symbol: * * h = {foo: 0, bar: 1, baz: 2} * h # => {foo: 0, bar: 1, baz: 2} * - * You can also use a String in place of a bareword: + * You can also use a string in place of a bareword: * * h = {'foo': 0, 'bar': 1, 'baz': 2} * h # => {foo: 0, bar: 1, baz: 2} @@ -6930,12 +6931,12 @@ static const rb_data_type_t env_data_type = { * h # => {foo: 0, bar: 1, baz: 2} * * But it's an error to try the JSON-style syntax - * for a key that's not a bareword or a String: + * for a key that's not a bareword or a string: * * # Raises SyntaxError (syntax error, unexpected ':', expecting =>): * h = {0: 'zero'} * - * +Hash+ value can be omitted, meaning that value will be fetched from the context + * The value can be omitted, meaning that value will be fetched from the context * by the name of the key: * * x = 0