com doc/ja: Update some methodsynopses: reference/datetime/datetimeinterface/diff.xml reference/zlib/functions/gzgets.xml

[email protected] (Yoshinari Takaoka) Tue, 19 Jan 2021 21:23:02 +0000
Newsgroups php.doc.ja
Message-ID <[email protected]>
Commit:    2d014aee18a52a6a05e21a0f1d0ab6775b11e8d4
Author:    Yoshinari Takaoka <[email protected]>         Wed, 20 Jan 2021 06:23:02 +0900
Parents:   6175a53e01882a372b36fe65ce2333a8bb6711b5
Branches:  master

Link:       http://git.php.net/?p=doc/ja.git;a=commitdiff;h=2d014aee18a52a6a05e21a0f1d0ab6775b11e8d4

Log:
Update some methodsynopses

Cf.
<http://github.com/php/php-src/commit/7290dc4dcf25d4a37fc1d412a5b5a8828cc06c77>,
<http://github.com/php/php-src/commit/c31f9f7ee4fcdc07d367c41d3645e0fe3870704c>.

Changed paths:
  M  reference/datetime/datetimeinterface/diff.xml
  M  reference/zlib/functions/gzgets.xml


Diff:
diff --git a/reference/datetime/datetimeinterface/diff.xml b/reference/datetime/datetimeinterface/diff.xml
index a475b88340..00bab1cb60 100644
--- a/reference/datetime/datetimeinterface/diff.xml
+++ b/reference/datetime/datetimeinterface/diff.xml
@@ -16,17 +16,17 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="oop">
-   <modifier>public</modifier> <type class="union"><type>DateInterval</type><type>false</type></type><methodname>DateTime::diff</methodname>
+   <modifier>public</modifier> <type>DateInterval</type><methodname>DateTime::diff</methodname>
    <methodparam><type>DateTimeInterface</type><parameter>targetObject</parameter></methodparam>
    <methodparam choice="opt"><type>bool</type><parameter>absolute</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <methodsynopsis role="DateTimeImmutable">
-   <modifier>public</modifier> <type class="union"><type>DateInterval</type><type>false</type></type><methodname>DateTimeImmutable::diff</methodname>
+   <modifier>public</modifier> <type>DateInterval</type><methodname>DateTimeImmutable::diff</methodname>
    <methodparam><type>DateTimeInterface</type><parameter>targetObject</parameter></methodparam>
    <methodparam choice="opt"><type>bool</type><parameter>absolute</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <methodsynopsis role="DateTimeInterface">
-   <modifier>public</modifier> <type class="union"><type>DateInterval</type><type>false</type></type><methodname>DateTimeInterface::diff</methodname>
+   <modifier>public</modifier> <type>DateInterval</type><methodname>DateTimeInterface::diff</methodname>
    <methodparam><type>DateTimeInterface</type><parameter>targetObject</parameter></methodparam>
    <methodparam choice="opt"><type>bool</type><parameter>absolute</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
diff --git a/reference/zlib/functions/gzgets.xml b/reference/zlib/functions/gzgets.xml
index 95e2ed6593..34cc1bfd9d 100644
--- a/reference/zlib/functions/gzgets.xml
+++ b/reference/zlib/functions/gzgets.xml
@@ -12,7 +12,7 @@
   <methodsynopsis>
    <type class="union"><type>string</type><type>false</type></type><methodname>gzgets</methodname>
    <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>length</parameter><initializer>1024</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    与えられたファイルポインタから最大 length - 1 バイトの文字を読み込み、
@@ -53,6 +53,31 @@
    非圧縮の文字列、もしくはエラー時に &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.0.0</entry>
+      <entry>
+       <parameter>length</parameter> は、nullable になりました。
+       これより前のバージョンでは、
+       デフォルトは <literal>1024</literal> でした。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>