From 9d6e8a56534f28fed694058b606bba120df8db69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= <kocsismate@woohoolabs.com>
Date: Mon, 27 Dec 2021 19:58:34 +0100
Subject: [PATCH 1/7] Update the signature of dba_open() and dba_popen()

---
 reference/dba/functions/dba-open.xml  | 54 +++++++++++++------
 reference/dba/functions/dba-popen.xml | 76 ++++++++++++++++++++++-----
 2 files changed, 101 insertions(+), 29 deletions(-)

diff --git a/reference/dba/functions/dba-open.xml b/reference/dba/functions/dba-open.xml
index cdb6c6c2008e..09fece932bde 100644
--- a/reference/dba/functions/dba-open.xml
+++ b/reference/dba/functions/dba-open.xml
@@ -11,8 +11,9 @@
    <type class="union"><type>resource</type><type>false</type></type><methodname>dba_open</methodname>
    <methodparam><type>string</type><parameter>path</parameter></methodparam>
    <methodparam><type>string</type><parameter>mode</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>handler</parameter></methodparam>
-   <methodparam rep="repeat"><type>string</type><parameter>args</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>permission</parameter><initializer>0644</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>map_size</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>dba_open</function> establishes a database instance for
@@ -20,6 +21,7 @@
    <parameter>handler</parameter>.
   </para>
  </refsect1>
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -156,40 +158,57 @@
        The name of the <link linkend="dba.requirements">handler</link> which
        shall be used for accessing <parameter>path</parameter>. It is passed 
        all optional parameters given to <function>dba_open</function> and 
-       can act on behalf of them.
+       can act on behalf of them. If <parameter>handler</parameter> is &null;,
+       then either the default handler is invoked, or &false; is returned
+       along with triggering an <literal>E_WARNING</literal>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>args</parameter></term>
+     <term><parameter>permission</parameter></term>
      <listitem>
       <para>
-       Optional &string; parameters which are passed to the driver.
+       Optional &integer; parameter which is passed to the driver. It has the same meaning as
+       the <parameter>permissions</parameter> parameter of <function>chmod</function>,
+       and defaults to <literal>0644</literal>.
       </para>
       <para>
        The <literal>cdb</literal>, <literal>cdb_make</literal>, <literal>flatfile</literal>,
        <literal>inifile</literal>, <literal>qdbm</literal> and <literal>tcadb</literal> drivers
-       do not support additional parameters.
+       do not support the <parameter>permission</parameter> parameter.
       </para>
       <para>
        The <literal>db1</literal>, <literal>db2</literal>, <literal>db3</literal>,
        <literal>db4</literal>, <literal>dbm</literal>, <literal>gdbm</literal>,
-       and <literal>ndbm</literal> drivers supports a single additional parameter <literal>$filemode</literal>,
-       which has the same meaning as the <literal>$mode</literal> parameter of <function>chmod</function>,
-       and defaults to <literal>0644</literal>.
+       <literal>ndbm</literal>, and <literal>lmdb</literal> drivers support the
+       <parameter>permission</parameter> parameter.
       </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>map_size</parameter></term>
+     <listitem>
       <para>
-       The <literal>lmdb</literal> driver accepts two additional parameters. The first
-       allows to specify the <literal>$filemode</literal> (see description above), and the
-       second to specify the <literal>$mapsize</literal>, where the value should be a multiple
-       of the page size of the OS, or zero, to use the default mapsize. The <literal>$mapsize</literal>
+       Optional &integer; parameter which is passed to the driver. Its value should be a multiple of the
+       page size of the OS, or zero, to use the default map size. The <parameter>map_size</parameter>
        parameter is supported as of PHP 7.3.14 and 7.4.2, respectively.
       </para>
+      <para>
+       The <literal>cdb</literal>, <literal>cdb_make</literal>, <literal>flatfile</literal>,
+       <literal>inifile</literal>, <literal>qdbm</literal>, <literal>tcadb</literal>,
+       <literal>db1</literal>, <literal>db2</literal>, <literal>db3</literal>,
+       <literal>db4</literal>, <literal>dbm</literal>, <literal>gdbm</literal>,
+       and <literal>ndbm</literal> drivers don't support the <parameter>map_size</parameter> parameter.
+      </para>
+      <para>
+       The <literal>lmdb</literal> driver accepts the <parameter>map_size</parameter> parameter.
+      </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -208,10 +227,16 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.1.0</entry>
+      <entry>
+       <parameter>handler</parameter> is now nullable.
+      </entry>
+     </row>
      <row>
       <entry>7.3.14, 7.4.2</entry>
       <entry>
-       The <literal>lmdb</literal> driver now supports an additional <literal>$mapsize</literal>
+       The <literal>lmdb</literal> driver now supports an additional <parameter>map_size</parameter>
        parameter.
       </entry>
      </row>
@@ -230,7 +255,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/dba/functions/dba-popen.xml b/reference/dba/functions/dba-popen.xml
index 3b4f0c9ae9bc..60cb651b35d8 100644
--- a/reference/dba/functions/dba-popen.xml
+++ b/reference/dba/functions/dba-popen.xml
@@ -11,8 +11,9 @@
    <type class="union"><type>resource</type><type>false</type></type><methodname>dba_popen</methodname>
    <methodparam><type>string</type><parameter>path</parameter></methodparam>
    <methodparam><type>string</type><parameter>mode</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>handler</parameter></methodparam>
-   <methodparam rep="repeat"><type>mixed</type><parameter>args</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>permission</parameter><initializer>0644</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>map_size</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>dba_popen</function> establishes a persistent database instance
@@ -20,6 +21,7 @@
    <parameter>handler</parameter>.
   </para>
  </refsect1>
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -50,46 +52,93 @@
        The name of the <link linkend="dba.requirements">handler</link> which
        shall be used for accessing <parameter>path</parameter>. It is passed 
        all optional parameters given to <function>dba_popen</function> and 
-       can act on behalf of them.
+       can act on behalf of them. If <parameter>handler</parameter> is &null;,
+       then either the default handler is invoked, or &false; is returned
+       along with triggering an <literal>E_WARNING</literal>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>args</parameter></term>
+     <term><parameter>permission</parameter></term>
      <listitem>
       <para>
-       Optional &string; parameters which are passed to the driver.
+       Optional &integer; parameter which is passed to the driver. It has the same meaning as
+       the <parameter>permissions</parameter> parameter of <function>chmod</function>,
+       and defaults to <literal>0644</literal>.
       </para>
       <para>
        The <literal>cdb</literal>, <literal>cdb_make</literal>, <literal>flatfile</literal>,
        <literal>inifile</literal>, <literal>qdbm</literal> and <literal>tcadb</literal> drivers
-       do not support additional parameters.
+       do not support the <parameter>permission</parameter> parameter.
       </para>
       <para>
        The <literal>db1</literal>, <literal>db2</literal>, <literal>db3</literal>,
        <literal>db4</literal>, <literal>dbm</literal>, <literal>gdbm</literal>,
-       and <literal>ndbm</literal> drivers supports a single additional parameter <literal>$filemode</literal>,
-       which has the same meaning as the <literal>$mode</literal> parameter of <function>chmod</function>,
-       and defaults to <literal>0644</literal>.
+       <literal>ndbm</literal>, and <literal>lmdb</literal> drivers support the
+       <parameter>permission</parameter> parameter.
       </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>map_size</parameter></term>
+     <listitem>
       <para>
-       The <literal>lmdb</literal> driver accepts two additional parameters. The first
-       allows to specify the <literal>$filemode</literal> (see description above), and the
-       second to specify the <literal>$mapsize</literal>, where the value should be a multiple
-       of the page size of the OS, or zero, to use the default mapsize. The <literal>$mapsize</literal>
+       Optional &integer; parameter which is passed to the driver. Its value should be a multiple of the
+       page size of the OS, or zero, to use the default mapsize. The <parameter>map_size</parameter>
        parameter is supported as of PHP 7.3.14 and 7.4.2, respectively.
       </para>
+      <para>
+       The <literal>cdb</literal>, <literal>cdb_make</literal>, <literal>flatfile</literal>,
+       <literal>inifile</literal>, <literal>qdbm</literal>, <literal>tcadb</literal>,
+       <literal>db1</literal>, <literal>db2</literal>, <literal>db3</literal>,
+       <literal>db4</literal>, <literal>dbm</literal>, <literal>gdbm</literal>,
+       and <literal>ndbm</literal> drivers don't support the <parameter>map_size</parameter> parameter.
+      </para>
+      <para>
+       The <literal>lmdb</literal> driver accepts the <parameter>map_size</parameter> parameter.
+      </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    Returns a positive handle on success&return.falseforfailure;.
   </para>
  </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.1.0</entry>
+      <entry>
+       <parameter>handler</parameter> is now nullable.
+      </entry>
+     </row>
+     <row>
+      <entry>7.3.14, 7.4.2</entry>
+      <entry>
+       The <literal>lmdb</literal> driver now supports an additional <parameter>map_size</parameter>
+       parameter.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -100,7 +149,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

From 181c65a14682e6d233535eb9f2e4a93bdd1c95ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= <kocsismate@woohoolabs.com>
Date: Fri, 4 Nov 2022 19:39:53 +0100
Subject: [PATCH 2/7] Add the flags parameter

---
 reference/dba/functions/dba-open.xml  | 16 ++++++++++++++++
 reference/dba/functions/dba-popen.xml | 16 ++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/reference/dba/functions/dba-open.xml b/reference/dba/functions/dba-open.xml
index 09fece932bde..1de91c16462a 100644
--- a/reference/dba/functions/dba-open.xml
+++ b/reference/dba/functions/dba-open.xml
@@ -14,6 +14,7 @@
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>permission</parameter><initializer>0644</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>map_size</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>flags</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>dba_open</function> establishes a database instance for
@@ -205,6 +206,15 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>flags</parameter></term>
+     <listitem>
+      <para>
+       Allows to pass flags to the DB drivers. Currently, only LMDB with
+       <constant>DBA_LMDB_USE_SUB_DIR</constant> and <constant>DBA_LMDB_NO_SUB_DIR</constant> are supported.
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -227,6 +237,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.2.0</entry>
+      <entry>
+       <parameter>flags</parameter> is added.
+      </entry>
+     </row>
      <row>
       <entry>8.1.0</entry>
       <entry>
diff --git a/reference/dba/functions/dba-popen.xml b/reference/dba/functions/dba-popen.xml
index 60cb651b35d8..dc36e72805ba 100644
--- a/reference/dba/functions/dba-popen.xml
+++ b/reference/dba/functions/dba-popen.xml
@@ -14,6 +14,7 @@
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>permission</parameter><initializer>0644</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>map_size</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>flags</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>dba_popen</function> establishes a persistent database instance
@@ -99,6 +100,15 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>flags</parameter></term>
+     <listitem>
+      <para>
+       Allows to pass flags to the DB drivers. Currently, only LMDB with
+       <constant>DBA_LMDB_USE_SUB_DIR</constant> and <constant>DBA_LMDB_NO_SUB_DIR</constant> are supported.
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -121,6 +131,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.2.0</entry>
+      <entry>
+       <parameter>flags</parameter> is added.
+      </entry>
+     </row>
      <row>
       <entry>8.1.0</entry>
       <entry>

From b097591a5491d28787ea8595d6a65757a8ac442c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= <kocsismate@woohoolabs.com>
Date: Fri, 4 Nov 2022 19:44:12 +0100
Subject: [PATCH 3/7] Update reference/dba/functions/dba-open.xml

Co-authored-by: George Peter Banyard <girgias@php.net>
---
 reference/dba/functions/dba-open.xml | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/reference/dba/functions/dba-open.xml b/reference/dba/functions/dba-open.xml
index 1de91c16462a..ddd8415877ef 100644
--- a/reference/dba/functions/dba-open.xml
+++ b/reference/dba/functions/dba-open.xml
@@ -195,14 +195,7 @@
        parameter is supported as of PHP 7.3.14 and 7.4.2, respectively.
       </para>
       <para>
-       The <literal>cdb</literal>, <literal>cdb_make</literal>, <literal>flatfile</literal>,
-       <literal>inifile</literal>, <literal>qdbm</literal>, <literal>tcadb</literal>,
-       <literal>db1</literal>, <literal>db2</literal>, <literal>db3</literal>,
-       <literal>db4</literal>, <literal>dbm</literal>, <literal>gdbm</literal>,
-       and <literal>ndbm</literal> drivers don't support the <parameter>map_size</parameter> parameter.
-      </para>
-      <para>
-       The <literal>lmdb</literal> driver accepts the <parameter>map_size</parameter> parameter.
+       Only the <literal>lmdb</literal> driver accepts the <parameter>map_size</parameter> parameter.
       </para>
      </listitem>
     </varlistentry>

From 96d453af47165ca0bd93330c94ad50aee48e1b48 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= <kocsismate@woohoolabs.com>
Date: Fri, 4 Nov 2022 19:55:26 +0100
Subject: [PATCH 4/7] Address review comments

---
 reference/dba/functions/dba-open.xml  | 20 +++++++++++---------
 reference/dba/functions/dba-popen.xml | 23 +++++++++--------------
 2 files changed, 20 insertions(+), 23 deletions(-)

diff --git a/reference/dba/functions/dba-open.xml b/reference/dba/functions/dba-open.xml
index ddd8415877ef..fe7bc8c3f41c 100644
--- a/reference/dba/functions/dba-open.xml
+++ b/reference/dba/functions/dba-open.xml
@@ -157,11 +157,10 @@
      <listitem>
       <para>
        The name of the <link linkend="dba.requirements">handler</link> which
-       shall be used for accessing <parameter>path</parameter>. It is passed 
-       all optional parameters given to <function>dba_open</function> and 
+       shall be used for accessing <parameter>path</parameter>. It is passed
+       all optional parameters given to <function>dba_open</function> and
        can act on behalf of them. If <parameter>handler</parameter> is &null;,
-       then either the default handler is invoked, or &false; is returned
-       along with triggering an <literal>E_WARNING</literal>.
+       then the default handler is invoked.
       </para>
      </listitem>
     </varlistentry>
@@ -173,11 +172,6 @@
        the <parameter>permissions</parameter> parameter of <function>chmod</function>,
        and defaults to <literal>0644</literal>.
       </para>
-      <para>
-       The <literal>cdb</literal>, <literal>cdb_make</literal>, <literal>flatfile</literal>,
-       <literal>inifile</literal>, <literal>qdbm</literal> and <literal>tcadb</literal> drivers
-       do not support the <parameter>permission</parameter> parameter.
-      </para>
       <para>
        The <literal>db1</literal>, <literal>db2</literal>, <literal>db3</literal>,
        <literal>db4</literal>, <literal>dbm</literal>, <literal>gdbm</literal>,
@@ -219,6 +213,14 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   &false; is returned and an <constant>E_WARNING</constant> level error is issued when
+   <parameter>handler</parameter> is &null;, but there is no default handler.
+  </para>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
diff --git a/reference/dba/functions/dba-popen.xml b/reference/dba/functions/dba-popen.xml
index dc36e72805ba..6a8ac01661ee 100644
--- a/reference/dba/functions/dba-popen.xml
+++ b/reference/dba/functions/dba-popen.xml
@@ -54,8 +54,7 @@
        shall be used for accessing <parameter>path</parameter>. It is passed 
        all optional parameters given to <function>dba_popen</function> and 
        can act on behalf of them. If <parameter>handler</parameter> is &null;,
-       then either the default handler is invoked, or &false; is returned
-       along with triggering an <literal>E_WARNING</literal>.
+       then the default handler is invoked.
       </para>
      </listitem>
     </varlistentry>
@@ -67,11 +66,6 @@
        the <parameter>permissions</parameter> parameter of <function>chmod</function>,
        and defaults to <literal>0644</literal>.
       </para>
-      <para>
-       The <literal>cdb</literal>, <literal>cdb_make</literal>, <literal>flatfile</literal>,
-       <literal>inifile</literal>, <literal>qdbm</literal> and <literal>tcadb</literal> drivers
-       do not support the <parameter>permission</parameter> parameter.
-      </para>
       <para>
        The <literal>db1</literal>, <literal>db2</literal>, <literal>db3</literal>,
        <literal>db4</literal>, <literal>dbm</literal>, <literal>gdbm</literal>,
@@ -88,13 +82,6 @@
        page size of the OS, or zero, to use the default mapsize. The <parameter>map_size</parameter>
        parameter is supported as of PHP 7.3.14 and 7.4.2, respectively.
       </para>
-      <para>
-       The <literal>cdb</literal>, <literal>cdb_make</literal>, <literal>flatfile</literal>,
-       <literal>inifile</literal>, <literal>qdbm</literal>, <literal>tcadb</literal>,
-       <literal>db1</literal>, <literal>db2</literal>, <literal>db3</literal>,
-       <literal>db4</literal>, <literal>dbm</literal>, <literal>gdbm</literal>,
-       and <literal>ndbm</literal> drivers don't support the <parameter>map_size</parameter> parameter.
-      </para>
       <para>
        The <literal>lmdb</literal> driver accepts the <parameter>map_size</parameter> parameter.
       </para>
@@ -120,6 +107,14 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   &false; is returned and an <constant>E_WARNING</constant> level error is issued when
+   <parameter>handler</parameter> is &null;, but there is no default handler.
+  </para>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>

From 1605ad2055d558f2f992492e9b29e3153ea88bc3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= <kocsismate@woohoolabs.com>
Date: Mon, 7 Nov 2022 06:28:02 +0100
Subject: [PATCH 5/7] Update reference/dba/functions/dba-open.xml

Co-authored-by: George Peter Banyard <girgias@php.net>
---
 reference/dba/functions/dba-open.xml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/dba/functions/dba-open.xml b/reference/dba/functions/dba-open.xml
index fe7bc8c3f41c..811ab4f74666 100644
--- a/reference/dba/functions/dba-open.xml
+++ b/reference/dba/functions/dba-open.xml
@@ -185,8 +185,7 @@
      <listitem>
       <para>
        Optional &integer; parameter which is passed to the driver. Its value should be a multiple of the
-       page size of the OS, or zero, to use the default map size. The <parameter>map_size</parameter>
-       parameter is supported as of PHP 7.3.14 and 7.4.2, respectively.
+       page size of the OS, or zero, to use the default map size.
       </para>
       <para>
        Only the <literal>lmdb</literal> driver accepts the <parameter>map_size</parameter> parameter.

From 72c2ae842ddfddc0fae1f631c439308bcf90456c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= <kocsismate@woohoolabs.com>
Date: Mon, 7 Nov 2022 06:28:19 +0100
Subject: [PATCH 6/7] Update reference/dba/functions/dba-popen.xml

Co-authored-by: George Peter Banyard <girgias@php.net>
---
 reference/dba/functions/dba-popen.xml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/dba/functions/dba-popen.xml b/reference/dba/functions/dba-popen.xml
index 6a8ac01661ee..eadc3a3a3d2f 100644
--- a/reference/dba/functions/dba-popen.xml
+++ b/reference/dba/functions/dba-popen.xml
@@ -79,8 +79,7 @@
      <listitem>
       <para>
        Optional &integer; parameter which is passed to the driver. Its value should be a multiple of the
-       page size of the OS, or zero, to use the default mapsize. The <parameter>map_size</parameter>
-       parameter is supported as of PHP 7.3.14 and 7.4.2, respectively.
+       page size of the OS, or zero, to use the default mapsize.
       </para>
       <para>
        The <literal>lmdb</literal> driver accepts the <parameter>map_size</parameter> parameter.

From 31a7243d15a14363036e7e1ba05c3a5482b12dc3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= <kocsismate@woohoolabs.com>
Date: Mon, 7 Nov 2022 06:29:22 +0100
Subject: [PATCH 7/7] Update reference/dba/functions/dba-open.xml

Co-authored-by: George Peter Banyard <girgias@php.net>
---
 reference/dba/functions/dba-open.xml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/reference/dba/functions/dba-open.xml b/reference/dba/functions/dba-open.xml
index 811ab4f74666..8342ed1aa4a1 100644
--- a/reference/dba/functions/dba-open.xml
+++ b/reference/dba/functions/dba-open.xml
@@ -196,8 +196,10 @@
      <term><parameter>flags</parameter></term>
      <listitem>
       <para>
-       Allows to pass flags to the DB drivers. Currently, only LMDB with
-       <constant>DBA_LMDB_USE_SUB_DIR</constant> and <constant>DBA_LMDB_NO_SUB_DIR</constant> are supported.
+       Flags to pass to the database drivers. If &null; the default flags will be provided.
+       Currently, only the LMDB driver supports the following flags
+       <constant>DBA_LMDB_USE_SUB_DIR</constant> and
+       <constant>DBA_LMDB_NO_SUB_DIR</constant>.
       </para>
      </listitem>
     </varlistentry>