diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 68219107512..78d9469bc92 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -21986,6 +21986,9 @@ SELECT NULLIF(value, '(none)') ...
         are coerced to text; value arguments are converted as per
         <function>to_json</function> or <function>to_jsonb</function>.
         Values can be null, but keys cannot.
+        If a key appears more than once, the <type>json</type> result keeps
+        every pair, while the <type>jsonb</type> result keeps only the last
+        value for that key.
        </para></entry>
        <entry>No</entry>
       </row>
@@ -22013,8 +22016,11 @@ SELECT NULLIF(value, '(none)') ...
         Collects all the key/value pairs into a JSON object.  Key arguments
         are coerced to text; value arguments are converted as per
         <function>to_json</function> or <function>to_jsonb</function>.
-        The <parameter>key</parameter> can not be null. If the
-        <parameter>value</parameter> is null then the entry is skipped,
+        The <parameter>key</parameter> cannot be null. If the
+        <parameter>value</parameter> is null then the pair is skipped.
+        Duplicate keys are handled as for <function>json_object_agg</function>
+        and <function>jsonb_object_agg</function>, after removing any pairs
+        with null values.
        </para></entry>
        <entry>No</entry>
       </row>
@@ -22071,9 +22077,10 @@ SELECT NULLIF(value, '(none)') ...
         Collects all the key/value pairs into a JSON object.  Key arguments
         are coerced to text; value arguments are converted as per
         <function>to_json</function> or <function>to_jsonb</function>.
-        The <parameter>key</parameter> can not be null. If the
-        <parameter>value</parameter> is null then the entry is skipped.
-        If there is a duplicate key an error is thrown.
+        The <parameter>key</parameter> cannot be null. If the
+        <parameter>value</parameter> is null then the pair is skipped.
+        If there is a duplicate key (including pairs with null values)
+        an error is thrown.
        </para></entry>
        <entry>No</entry>
       </row>