From 5ad34a5a05e03d50e50d32d2f5dbfb6ada7b328e Mon Sep 17 00:00:00 2001
From: Jakub Vrana <vrana@php.net>
Date: Thu, 1 Feb 2018 11:55:49 +0000
Subject: [PATCH] Document pg_last_notice(, option)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@344147 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/pgsql/constants.xml                | 37 ++++++++++++++++++++
 reference/pgsql/functions/pg-last-notice.xml | 18 ++++++++--
 2 files changed, 53 insertions(+), 2 deletions(-)

diff --git a/reference/pgsql/constants.xml b/reference/pgsql/constants.xml
index 1254c94938..4a827dbb55 100644
--- a/reference/pgsql/constants.xml
+++ b/reference/pgsql/constants.xml
@@ -508,6 +508,43 @@
    </listitem>
   </varlistentry>
 
+  <varlistentry xml:id="constant.pgsql-notice-last">
+   <term>
+    <constant>PGSQL_NOTICE_LAST</constant> 
+    (<type>integer</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Used by <function>pg_last_notice</function>.
+     Available since PHP 7.1.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.pgsql-notice-all">
+   <term>
+    <constant>PGSQL_NOTICE_ALL</constant> 
+    (<type>integer</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Used by <function>pg_last_notice</function>.
+     Available since PHP 7.1.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.pgsql-notice-clear">
+   <term>
+    <constant>PGSQL_NOTICE_CLEAR</constant> 
+    (<type>integer</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Used by <function>pg_last_notice</function>.
+     Available since PHP 7.1.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+
   <varlistentry xml:id="constant.pgsql-status-long">
    <term>
     <constant>PGSQL_STATUS_LONG</constant> 
diff --git a/reference/pgsql/functions/pg-last-notice.xml b/reference/pgsql/functions/pg-last-notice.xml
index 1a11d5649e..4da9745e8f 100644
--- a/reference/pgsql/functions/pg-last-notice.xml
+++ b/reference/pgsql/functions/pg-last-notice.xml
@@ -12,7 +12,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>pg_last_notice</methodname>
+   <type>mixed</type><methodname>pg_last_notice</methodname>
    <methodparam><type>resource</type><parameter>connection</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>option</parameter><initializer>PGSQL_NOTICE_LAST</initializer></methodparam>
   </methodsynopsis>
@@ -51,6 +51,16 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>option</parameter></term>
+     <listitem>
+      <para>
+       One of <constant>PGSQL_NOTICE_LAST</constant> (to return last notice),
+       <constant>PGSQL_NOTICE_ALL</constant> (to return all notices),
+       or <constant>PGSQL_NOTICE_CLEAR</constant> (to clear notices).
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -59,7 +69,11 @@
   &reftitle.returnvalues;
   <para>
    A <type>string</type> containing the last notice on the 
-   given <parameter>connection</parameter>, or &false; on error.
+   given <parameter>connection</parameter> with
+   <constant>PGSQL_NOTICE_LAST</constant>,
+   an <type>array</type> with <constant>PGSQL_NOTICE_ALL</constant>,
+   a <type>boolean</type> with <constant>PGSQL_NOTICE_CLEAR</constant>,
+   or &false; on error.
   </para>
  </refsect1>