Couple of nits to pgsql docs

Redundant paragraph
Add <constant> markup and normalize
Fix parameter name
This commit is contained in:
George Peter Banyard 2021-10-11 00:39:34 +01:00
parent 58645a79f1
commit 5589cbb636
No known key found for this signature in database
GPG key ID: D49A095D7329F6DC
3 changed files with 16 additions and 22 deletions

View file

@ -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,

View file

@ -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>.

View file

@ -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,