From 5589cbb636acd2c604a7f347894495c1623dbe79 Mon Sep 17 00:00:00 2001
From: George Peter Banyard <girgias@php.net>
Date: Mon, 11 Oct 2021 00:39:34 +0100
Subject: [PATCH] Couple of nits to pgsql docs

Redundant paragraph
Add <constant> markup and normalize
Fix parameter name
---
 reference/pgsql/functions/pg-insert.xml   | 17 ++++++++---------
 reference/pgsql/functions/pg-lo-close.xml |  2 +-
 reference/pgsql/functions/pg-update.xml   | 19 +++++++------------
 3 files changed, 16 insertions(+), 22 deletions(-)

diff --git a/reference/pgsql/functions/pg-insert.xml b/reference/pgsql/functions/pg-insert.xml
index 1206badcf8..342a7407b1 100644
--- a/reference/pgsql/functions/pg-insert.xml
+++ b/reference/pgsql/functions/pg-insert.xml
@@ -21,20 +21,19 @@
   <para>
    <function>pg_insert</function> inserts the values
    of <parameter>values</parameter> into the table specified
-   by <parameter>table_name</parameter>. If <parameter>flags</parameter>
-   is specified, <function>pg_convert</function> is applied
-   to <parameter>values</parameter> with the specified options.
+   by <parameter>table_name</parameter>.
   </para>
-  <para>If <parameter>flags</parameter> is specified,
+  <para>
+   If <parameter>flags</parameter> is specified,
    <function>pg_convert</function> is applied to
    <parameter>values</parameter> with the specified flags.
   </para>
   <para>
-   By default <function>pg_insert</function> passes raw values. Values
-   must be escaped or PGSQL_DML_ESCAPE option must be
-   specified. PGSQL_DML_ESCAPE quotes and escapes
-   parameters/identifiers. Therefore, table/column names became case
-   sensitive.
+   By default <function>pg_update</function> passes raw values.
+   Values must be escaped or the <constant>PGSQL_DML_ESCAPE</constant> flag
+   must be specified in <parameter>flags</parameter>.
+   <constant>PGSQL_DML_ESCAPE</constant> quotes and escapes parameters/identifiers.
+   Therefore, table/column names become case sensitive.
   </para>
   <para>
    Note that neither escape nor prepared query can protect LIKE query,
diff --git a/reference/pgsql/functions/pg-lo-close.xml b/reference/pgsql/functions/pg-lo-close.xml
index 0699d2f2f2..00171b635f 100644
--- a/reference/pgsql/functions/pg-lo-close.xml
+++ b/reference/pgsql/functions/pg-lo-close.xml
@@ -34,7 +34,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>result</parameter></term>
+     <term><parameter>lob</parameter></term>
      <listitem>
       <para>
        PostgreSQL large object (LOB) resource, returned by <function>pg_lo_open</function>.
diff --git a/reference/pgsql/functions/pg-update.xml b/reference/pgsql/functions/pg-update.xml
index 938f2d99ec..09de1e9a4d 100644
--- a/reference/pgsql/functions/pg-update.xml
+++ b/reference/pgsql/functions/pg-update.xml
@@ -21,24 +21,19 @@
   </methodsynopsis>
   <para>
    <function>pg_update</function> updates records that matches
-   <parameter>conditions</parameter> with <parameter>values</parameter>. If
-   <parameter>flags</parameter> is specified,
-   <function>pg_convert</function> is applied to
-   <parameter>values</parameter> with specified options.
+   <parameter>conditions</parameter> with <parameter>values</parameter>.
   </para>
   <para>
-   <function>pg_update</function> updates records.
-  </para>
-  <para>If <parameter>flags</parameter> is specified,
+   If <parameter>flags</parameter> is specified,
    <function>pg_convert</function> is applied to
    <parameter>values</parameter> with the specified flags.
   </para>
   <para>
-   By default <function>pg_update</function> passes raw values. Values
-   must be escaped or PGSQL_DML_ESCAPE option must be
-   specified. PGSQL_DML_ESCAPE quotes and escapes
-   parameters/identifiers. Therefore, table/column names became case
-   sensitive.
+   By default <function>pg_update</function> passes raw values.
+   Values must be escaped or the <constant>PGSQL_DML_ESCAPE</constant> flag
+   must be specified in <parameter>flags</parameter>.
+   <constant>PGSQL_DML_ESCAPE</constant> quotes and escapes parameters/identifiers.
+   Therefore, table/column names become case sensitive.
   </para>
   <para>
    Note that neither escape nor prepared query can protect LIKE query,