From 9ab3ada4764c92cca8c41bd500aad71c6a7e7a0e Mon Sep 17 00:00:00 2001
From: "SUMIDA, Ippei" <ippey.s@gmail.com>
Date: Sat, 23 Nov 2024 15:31:22 +0900
Subject: [PATCH 1/3] =?UTF-8?q?DBA=E3=81=AE=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/dba/dba.connection.xml      | 57 +++++++++++++++++++++++++++
 reference/dba/functions/dba-open.xml  | 13 ++++--
 reference/dba/functions/dba-popen.xml | 13 ++++--
 3 files changed, 77 insertions(+), 6 deletions(-)
 create mode 100644 reference/dba/dba.connection.xml

diff --git a/reference/dba/dba.connection.xml b/reference/dba/dba.connection.xml
new file mode 100644
index 00000000000..bff5e68a7a0
--- /dev/null
+++ b/reference/dba/dba.connection.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: Ippey Status: ready -->
+<!-- CREDITS: ippey -->
+
+<reference xml:id="class.dba-connection" role="class" xmlns="http://docbook.org/ns/docbook">
+ <title>The Dba\Connection class</title>
+ <titleabbrev>Dba\Connection</titleabbrev>
+
+ <partintro>
+
+  <!-- {{{ Dba\Connection intro -->
+  <section xml:id="dba-connection.intro">
+   &reftitle.intro;
+   <para>
+    PHP 8.4.0 以降、 <literal>dba</literal> リソースを置き換える完全不透明クラスです。
+   </para>
+  </section>
+  <!-- }}} -->
+
+  <section xml:id="dba-connection.synopsis">
+   &reftitle.classsynopsis;
+
+   <!-- {{{ Synopsis -->
+   <classsynopsis class="class">
+    <ooclass>
+     <modifier>final</modifier>
+     <classname>Dba\Connection</classname>
+    </ooclass>
+   </classsynopsis>
+   <!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/dba/functions/dba-open.xml b/reference/dba/functions/dba-open.xml
index b221e0a1023..b873535bf3e 100644
--- a/reference/dba/functions/dba-open.xml
+++ b/reference/dba/functions/dba-open.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e4faf426c06f29bef4b1fbd7043d56f4756a0a50 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: mumumu Status: ready -->
 <refentry xml:id="function.dba-open" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>dba_open</refname>
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>resource</type><type>false</type></type><methodname>dba_open</methodname>
+   <type class="union"><type>Dba\Connection</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 class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
@@ -217,7 +217,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   成功した場合に正のハンドルを返します。
+   成功した場合に <classname>Dba\Connection</classname> インスタンスを返します。
    &return.falseforfailure;。
   </para>
  </refsect1>
@@ -243,6 +243,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <classname>Dba\Connection</classname> インスタンスを返すようになりました。
+       以前は &resource; を返していました。
+      </entry>
+     </row>
      <row>
       <entry>8.2.0</entry>
       <entry>
diff --git a/reference/dba/functions/dba-popen.xml b/reference/dba/functions/dba-popen.xml
index dc4db4fd425..524530fd71e 100644
--- a/reference/dba/functions/dba-popen.xml
+++ b/reference/dba/functions/dba-popen.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9264401165d31437c4afd80ec936f775ae23d367 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: mumumu Status: ready -->
 <refentry xml:id="function.dba-popen" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>dba_popen</refname>
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>resource</type><type>false</type></type><methodname>dba_popen</methodname>
+   <type class="union"><type>Dba\Connection</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 class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
@@ -110,7 +110,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   成功した場合に正のハンドルを返します。
+   成功した場合に <classname>Dba\Connection</classname> インスタンスを返します。
    &return.falseforfailure;。
   </para>
  </refsect1>
@@ -136,6 +136,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <classname>Dba\Connection</classname> インスタンスを返すようになりました。
+       以前は &resource; を返していました。
+      </entry>
+     </row>
      <row>
       <entry>8.2.0</entry>
       <entry>

From 6cde08ce2298c9d8a48905dbba1df48c64c9e47c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?=
 <takeda@youmind.jp>
Date: Sat, 23 Nov 2024 21:34:26 +0900
Subject: [PATCH 2/3] =?UTF-8?q?class.dba-connection=20=E3=83=9A=E3=83=BC?=
 =?UTF-8?q?=E3=82=B8=E3=82=BF=E3=82=A4=E3=83=88=E3=83=AB=E3=81=AE=E7=BF=BB?=
 =?UTF-8?q?=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/dba/dba.connection.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/dba/dba.connection.xml b/reference/dba/dba.connection.xml
index bff5e68a7a0..735a71204b0 100644
--- a/reference/dba/dba.connection.xml
+++ b/reference/dba/dba.connection.xml
@@ -4,7 +4,7 @@
 <!-- CREDITS: ippey -->
 
 <reference xml:id="class.dba-connection" role="class" xmlns="http://docbook.org/ns/docbook">
- <title>The Dba\Connection class</title>
+ <title>Dba\Connection クラス</title>
  <titleabbrev>Dba\Connection</titleabbrev>
 
  <partintro>

From f137db491a07005a8c104ff7861f98d387b6e397 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?=
 <takeda@youmind.jp>
Date: Sat, 23 Nov 2024 21:35:11 +0900
Subject: [PATCH 3/3] =?UTF-8?q?php/doc-en@1a53c22=20=E3=82=92=E3=83=81?=
 =?UTF-8?q?=E3=82=A7=E3=83=AA=E3=83=BC=E3=83=94=E3=83=83=E3=82=AF=E3=81=A7?=
 =?UTF-8?q?=E7=BF=BB=E8=A8=B3=E8=BF=BD=E5=8A=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/dba/book.xml | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/reference/dba/book.xml b/reference/dba/book.xml
index 32cbdec4ad8..97b01d8bdd0 100644
--- a/reference/dba/book.xml
+++ b/reference/dba/book.xml
@@ -1,13 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1a53c22773e4e08ab5b67ba3d4d91cc011047da5 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa -->
- 
 <book xml:id="book.dba" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundled" ?>
  <title>データベース (dbm 形式) 抽象化レイヤ</title>
  <titleabbrev>DBA</titleabbrev>
- 
+
  <!-- {{{ preface -->
  <preface xml:id="intro.dba">
   &reftitle.intro;
@@ -22,14 +21,17 @@
   </para>
  </preface>
  <!-- }}} -->
- 
+
  &reference.dba.setup;
  &reference.dba.constants;
  &reference.dba.examples;
+
+ <!-- Dba\Connection class -->
+ &reference.dba.dba.connection;
+ <!-- dba_*() functions -->
  &reference.dba.reference;
 
 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml