Fix vague comment in jsonb documentation

akorotkov · akorotkov · commit 6540cc517dd4 · 2021-03-09T18:16:03.000+03:00
The sample query fails because of an attempt to update the key of a numeric.
But the comment says it's just because of the missing object key.  That's not
correct because jsonb subscription automatically adds missing keys.

Reported-by: Nikita Konev
diff --git a/doc/src/sgml/json.sgml b/doc/src/sgml/json.sgml
@@ -648,7 +648,8 @@ SELECT ('[1, "2", null]'::jsonb)[1];
 UPDATE table_name SET jsonb_field['key'] = '1';
 
 -- This will raise an error if any record's jsonb_field['a']['b'] is something
--- other than an object. For example, the value {"a": 1} has no 'b' key.
+-- other than an object. For example, the value {"a": 1} has a numeric value
+-- of the key 'a'.
 UPDATE table_name SET jsonb_field['a']['b']['c'] = '1';
 
 -- Filter records using a WHERE clause with subscripting. Since the result of
