diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 2d42b1e1743..ff00d43dae2 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -10302,8 +10302,9 @@ table2-mapping
        <row>
         <entry><literal>-</literal></entry>
         <entry><type>text</type></entry>
-        <entry>Delete the field with a specified key, or element with this
-        value</entry>
+        <entry>Delete key/value pair or <emphasis>string</emphasis>
+        element from left operand.  Key/value pairs are matched based
+        on their key value.</entry>
         <entry><literal>'{"a": "b"}'::jsonb - 'a' </literal></entry>
        </row>
        <row>