From 95f1473b200b15b3452222bd655e9e2cde8d517a Mon Sep 17 00:00:00 2001
From: Christoph Michael Becker <cmb@php.net>
Date: Fri, 17 Mar 2017 14:17:07 +0000
Subject: [PATCH] Fix and clarify parameter description, respectively

Negative values other than -1 have undefined behavior according to
<https://sqlite.org/c3ref/create_function.html>.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@342156 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/pdo_sqlite/PDO/sqliteCreateFunction.xml | 7 ++++---
 reference/sqlite3/sqlite3/createfunction.xml      | 2 +-
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/reference/pdo_sqlite/PDO/sqliteCreateFunction.xml b/reference/pdo_sqlite/PDO/sqliteCreateFunction.xml
index 976319a925..7e2e8c57c0 100644
--- a/reference/pdo_sqlite/PDO/sqliteCreateFunction.xml
+++ b/reference/pdo_sqlite/PDO/sqliteCreateFunction.xml
@@ -14,7 +14,7 @@
    <modifier>public</modifier> <type>bool</type><methodname>PDO::sqliteCreateFunction</methodname>
    <methodparam><type>string</type><parameter>function_name</parameter></methodparam>
    <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>num_args</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>num_args</parameter><initializer>-1</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   &warn.experimental.func;
@@ -60,8 +60,9 @@
      <term><parameter>num_args</parameter></term>
      <listitem>
       <para>
-       Hint to the SQLite parser if the callback function accepts a
-       predetermined number of arguments.
+       The number of arguments that the SQL function takes. If
+       this parameter is <literal>-1</literal>, then the SQL function may take
+       any number of arguments.
       </para>
      </listitem>
     </varlistentry>
diff --git a/reference/sqlite3/sqlite3/createfunction.xml b/reference/sqlite3/sqlite3/createfunction.xml
index 2aa8b969f8..acbc86fa0d 100644
--- a/reference/sqlite3/sqlite3/createfunction.xml
+++ b/reference/sqlite3/sqlite3/createfunction.xml
@@ -48,7 +48,7 @@
      <listitem>
       <para>
        The number of arguments that the SQL function takes. If
-       this parameter is negative, then the SQL function may take
+       this parameter is <literal>-1</literal>, then the SQL function may take
        any number of arguments.
       </para>
      </listitem>