From 899361f44ac82d89f092588e1f117cb9f464f078 Mon Sep 17 00:00:00 2001
From: o0h <dev@o0h.in>
Date: Sun, 24 Nov 2024 15:22:06 +0900
Subject: [PATCH 1/4] [WIP] work on php/doc-en#4063


From 5d6470f3deeb0d37f26967dfe8bc8c20b3ca2c54 Mon Sep 17 00:00:00 2001
From: o0h <dev@o0h.in>
Date: Sun, 24 Nov 2024 23:54:23 +0900
Subject: [PATCH 2/4] #191 Insert original content

ref: https://github.com/php/doc-en/commit/72b70d7c3c3b2b87423641906da2db407c32c3c3
---
 .../errorfunc/functions/trigger-error.xml     | 33 +++++++++++++++++--
 1 file changed, 30 insertions(+), 3 deletions(-)

diff --git a/reference/errorfunc/functions/trigger-error.xml b/reference/errorfunc/functions/trigger-error.xml
index 323074849d..87969cf334 100644
--- a/reference/errorfunc/functions/trigger-error.xml
+++ b/reference/errorfunc/functions/trigger-error.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 210d382b5b139444fe2e16a5a3211076a65ff2ba Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 72b70d7c3c3b2b87423641906da2db407c32c3c3 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi -->
 <refentry xml:id="function.trigger-error" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -46,6 +46,14 @@
     </varlistentry>
    </variablelist>
   </para>
+  <warning>
+   <simpara>
+    Passing <constant>E_USER_ERROR</constant> as the
+    <parameter>error_level</parameter> is now deprecated.
+    Throw an <exceptionname>Exception</exceptionname> or
+    call <function>exit</function> instead.
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -77,6 +85,22 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Passing <constant>E_USER_ERROR</constant> as the
+       <parameter>error_level</parameter> is now deprecated.
+       Throw an <exceptionname>Exception</exceptionname> or
+       call <function>exit</function> instead.
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       The function now has a return type of <type>true</type>
+       instead of <type>bool</type>.
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>
@@ -102,9 +126,11 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-if ($divisor == 0) {
-    trigger_error("ゼロで割ることはできません", E_USER_ERROR);
+$password = $_POST['password'] ?? '';
+if ($password === '') {
+  trigger_error("Using an empty password is unsafe", E_USER_WARNING);
 }
+$hash = password_hash($password, PASSWORD_DEFAULT);
 ?>
 ]]>
     </programlisting>
@@ -129,6 +155,7 @@ if ($divisor == 0) {
     <member><function>set_error_handler</function></member>
     <member><function>restore_error_handler</function></member>
     <member><link linkend="errorfunc.constants">エラーレベル定数</link></member>
+    <member>The <classname>Deprecated</classname> attribute</member>
    </simplelist>
   </para>
  </refsect1>

From c09c0ce730104df4bf00ead87b19fdeb1a8736e4 Mon Sep 17 00:00:00 2001
From: o0h <dev@o0h.in>
Date: Mon, 25 Nov 2024 00:17:53 +0900
Subject: [PATCH 3/4] #191 Translate

---
 .../errorfunc/functions/trigger-error.xml     | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/reference/errorfunc/functions/trigger-error.xml b/reference/errorfunc/functions/trigger-error.xml
index 87969cf334..517c1b7255 100644
--- a/reference/errorfunc/functions/trigger-error.xml
+++ b/reference/errorfunc/functions/trigger-error.xml
@@ -48,10 +48,10 @@
   </para>
   <warning>
    <simpara>
-    Passing <constant>E_USER_ERROR</constant> as the
-    <parameter>error_level</parameter> is now deprecated.
-    Throw an <exceptionname>Exception</exceptionname> or
-    call <function>exit</function> instead.
+    <parameter>error_level</parameter> として
+    <constant>E_USER_ERROR</constant> を指定するのは非推奨となりました。
+    かわりに、<exceptionname>Exception</exceptionname> をスローするか、
+    <function>exit</function> を呼び出してください。
    </simpara>
   </warning>
  </refsect1>
@@ -88,17 +88,17 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Passing <constant>E_USER_ERROR</constant> as the
-       <parameter>error_level</parameter> is now deprecated.
-       Throw an <exceptionname>Exception</exceptionname> or
-       call <function>exit</function> instead.
+       <parameter>error_level</parameter> として
+       <constant>E_USER_ERROR</constant> を指定するのは非推奨となりました。
+       かわりに、<exceptionname>Exception</exceptionname> をスローするか、
+       <function>exit</function> を呼び出してください。
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
-       The function now has a return type of <type>true</type>
-       instead of <type>bool</type>.
+       戻り値の型が、<type>bool</type> ではなく
+       <type>true</type> に変更されました。
       </entry>
      </row>
      <row>
@@ -128,7 +128,7 @@
 <?php
 $password = $_POST['password'] ?? '';
 if ($password === '') {
-  trigger_error("Using an empty password is unsafe", E_USER_WARNING);
+  trigger_error("空のパスワードを使用することは安全ではありません", E_USER_WARNING);
 }
 $hash = password_hash($password, PASSWORD_DEFAULT);
 ?>
@@ -155,7 +155,7 @@ $hash = password_hash($password, PASSWORD_DEFAULT);
     <member><function>set_error_handler</function></member>
     <member><function>restore_error_handler</function></member>
     <member><link linkend="errorfunc.constants">エラーレベル定数</link></member>
-    <member>The <classname>Deprecated</classname> attribute</member>
+    <member><classname>Deprecated</classname> アトリビュート</member>
    </simplelist>
   </para>
  </refsect1>

From dae9dfefd6b58d0ce10e0097fe45d100753cf0fd Mon Sep 17 00:00:00 2001
From: o0h <dev@o0h.in>
Date: Mon, 25 Nov 2024 21:07:45 +0900
Subject: [PATCH 4/4] #194 Fix element position

---
 reference/errorfunc/functions/trigger-error.xml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/reference/errorfunc/functions/trigger-error.xml b/reference/errorfunc/functions/trigger-error.xml
index 517c1b7255..28efbebf95 100644
--- a/reference/errorfunc/functions/trigger-error.xml
+++ b/reference/errorfunc/functions/trigger-error.xml
@@ -42,18 +42,18 @@
       <para>
        このエラーに割り当てられたエラー型です。<constant>E_USER_<replaceable>*</replaceable></constant> の定数のみが指定可能で、デフォルトは <constant>E_USER_NOTICE</constant> です。
       </para>
+      <warning>
+       <simpara>
+        <parameter>error_level</parameter> として
+        <constant>E_USER_ERROR</constant> を指定するのは非推奨となりました。
+        かわりに、<exceptionname>Exception</exceptionname> をスローするか、
+        <function>exit</function> を呼び出してください。
+       </simpara>
+      </warning>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
-  <warning>
-   <simpara>
-    <parameter>error_level</parameter> として
-    <constant>E_USER_ERROR</constant> を指定するのは非推奨となりました。
-    かわりに、<exceptionname>Exception</exceptionname> をスローするか、
-    <function>exit</function> を呼び出してください。
-   </simpara>
-  </warning>
  </refsect1>
 
  <refsect1 role="returnvalues">