Merge branch 'php:master' into master

Author: jdkfx

language-snippets.ent

@@ -1036,7 +1036,7 @@ $font = 'SomeFont';
 に準拠しない CSV が生成されたり、PHP の CSV
 関数を介してラウンドトリップ(往復変換)でデータが壊れる可能性があります。
 <parameter>escape</parameter>のデフォルト値は<literal>"\\"</literal>
-なので、明示的に空の文字列を指定すること推奨します。デフォルト値は、PHP 9.0
+なので、明示的に空の文字列を指定することを推奨します。デフォルト値は、PHP 9.0
 以降の将来のバージョンで変更予定です。
 </simpara></warning>'>
 

language/functions.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 74976cdb263ef841c5fc2c3f91ca7e284adce552 Maintainer: takagi Status: ready -->
-<!-- CREDITS: hirokawa,mumumu -->
+<!-- EN-Revision: 489d46bc2598784bd3711454ccab8940107cde67 Maintainer: takagi Status: ready -->
+<!-- CREDITS: hirokawa,mumumu,jdkfx -->
  <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
   <title>関数</title>
 
@@ -456,10 +456,9 @@ Making a bowl of raspberry natural yogurt.
      <code>Type $param = null</code> と書かれた引数です。
      &null; をデフォルトにすることは、
      型が暗黙のうちに nullable であることを示しています。
-     この書き方はまだ許可されていますが、
-     以下のようにして 明示的に
+     この使い方はPHP 8.4.0で非推奨となり、代わりに明示的な
      <link linkend="language.types.declarations.nullable">nullable 型</link>
-     を使うことを推奨します:
+     を使用する必要があります。
      <example>
       <title>デフォルト値を指定した引数は、必須の引数の後に宣言する</title>
       <programlisting role="php">
@@ -468,7 +467,9 @@ Making a bowl of raspberry natural yogurt.
  function foo($a = [], $b) {} // デフォルト値が使われないため、PHP 8.0.0 以降は推奨されません
  function foo($a, $b) {}      // 上のコードと機能的には同じですが、推奨されない警告は発生しません。
 
- function bar(A $a = null, $b) {} // まだ許可されています。$a は必須ですが、nullable です。
+ // PHP 8.1.0以降、$a は暗黙的に必須（必須の引数の前にあるため）ですが、
+ // デフォルトのパラメータ値が null であるため、暗黙的に nullable とみなされます（PHP 8.4.0で非推奨）。
+ function bar(A $a = null, $b) {}
  function bar(?A $a, $b) {}       // 推奨される書き方です。
  ?>
  ]]>

reference/datetime/constants.xml

@@ -1,19 +1,29 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 08757002f22252e774c2d975909a69caddf53ebe Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 7913e8b074dfaddff7d8d7446532d8a99f7b9517 Maintainer: takagi Status: ready -->
 <appendix xml:id="datetime.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  <para>
-  <link linkend="datetimeinterface.constants.types"><literal>DATE_*</literal>
-  定数</link> は、標準的な日付の書式を表します。
+  <constant>DATE_<replaceable>*</replaceable></constant>
+  定数は、標準的な日付の書式を表します。
   日付フォーマット関数（<function>date</function> など）で使用します。
  </para>
- <para>
-  以下の定数は、関数
-  <function>date_sunrise</function> および
-  <function>date_sunset</function> が返す結果の書式を指定します。
- </para>
+
  <variablelist>
+  <title>
+   <parameter>returnFormat</parameter> は
+   <function>date_sunrise</function> と
+   <function>date_sunset</function> で利用可能です。
+  </title>
+
+  <warning>
+   <simpara>
+    これらの定数は PHP 8.4.0 から非推奨となりました。
+    対応する <function>date_sunrise</function> と
+    <function>date_sunset</function> 関数は PHP 8.1.0 から非推奨となっています。
+   </simpara>
+  </warning>
+
   <varlistentry xml:id="constant.sunfuncs-ret-timestamp">
    <term>
     <constant>SUNFUNCS_RET_TIMESTAMP</constant>

reference/dba/functions/dba-key-split.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9c4c9718261c2705fef2a490e3926751134aec32 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: d34561113baaf49e9d0539c46511242941ea5a7b Maintainer: takagi Status: ready -->
 <refentry xml:id="function.dba-key-split" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>dba_key_split</refname>
@@ -43,6 +43,30 @@
    この関数は &false; を返します。
   </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.4.0</entry>
+      <entry>
+        <parameter>key</parameter> に &null; または 
+        &false; を渡すことは、非推奨となりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>