com doc/ja: Fix signatures of some GD functions wrt. PHP 8.0: reference/image/functions/imagegrabwindow.xml
reference/image/functions/imageinterlace.xml reference/image/functions/imagerotate.xml

Commit: 625beca05b31860bc72ad6c876bb9eebdc516fd3 Author: Yoshinari Takaoka <mumumu@mumumu.org> Fri, 19 Mar 2021 02:15:20 +0900 Parents: 6973eafcdb10f7495f3c7ba8c949e9ecc86297cc Branches: master Link: http://git.php.net/?p=doc/ja.git;a=commitdiff;h=625beca05b31860bc72ad6c876bb9eebdc516fd3 Log: Fix signatures of some GD functions wrt. PHP 8.0 Regarding the return type of imageinterlace(), see <php/php-src@c174344>. Changed paths: M reference/image/functions/imagegrabwindow.xml M reference/image/functions/imageinterlace.xml M reference/image/functions/imagerotate.xml Diff: diff --git a/reference/image/functions/imagegrabwindow.xml b/reference/image/functions/imagegrabwindow.xml index 6fb18dec8e..5f32d72695 100644 --- a/reference/image/functions/imagegrabwindow.xml +++ b/reference/image/functions/imagegrabwindow.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: takagi Status: ready --> +<!-- EN-Revision: 34316e9ecfcffa5ebefe7cd37f5fbd629d50e5f9 Maintainer: takagi Status: ready --> <!-- Credits: mumumu --> <refentry xml:id="function.imagegrabwindow" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -13,7 +13,7 @@ <methodsynopsis> <type>resource</type><methodname>imagegrabwindow</methodname> <methodparam><type>int</type><parameter>window_handle</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>client_area</parameter><initializer>0</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>client_area</parameter><initializer>0</initializer></methodparam> </methodsynopsis> <para> ウィンドウあるいはそのクライアント領域のキャプチャを、 @@ -65,6 +65,30 @@ </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>client_area</parameter> は、 + <type>bool</type> を期待するようになりました。 + これより前のバージョンでは、数値型を期待していました。 + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/image/functions/imageinterlace.xml b/reference/image/functions/imageinterlace.xml index 5c48613769..96b69fd146 100644 --- a/reference/image/functions/imageinterlace.xml +++ b/reference/image/functions/imageinterlace.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: c352a8f0a701804a3446203867bc40e1690800f4 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 34316e9ecfcffa5ebefe7cd37f5fbd629d50e5f9 Maintainer: hirokawa Status: ready --> <!-- Credits: mumumu --> <refentry xml:id="function.imageinterlace" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -12,7 +12,7 @@ <methodsynopsis> <type>int</type><methodname>imageinterlace</methodname> <methodparam><type>resource</type><parameter>image</parameter></methodparam> - <methodparam choice="opt"><type class="union"><type>bool</type><type>null</type></type><parameter>interlace</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>bool</type><type>null</type></type><parameter>enable</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <function>imageinterlace</function> は、インターレースビットをon @@ -44,10 +44,45 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - 画像のインターレースビットが設定されている場合に 1、 - それ以外の場合に 0 を返します。 + 画像のインターレースビットが設定されている場合に &true; 、 + それ以外の場合に &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.5</entry> + <entry> + <function>imageinterlace</function> は、 + <type>bool</type> を返すようになりました。 + これより前のバージョンでは、<type>int</type> を返していました。 + (インターレース画像の場合は 0 でない値を、 + そうでない場合は 0 を返していました) + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>enable</parameter> は、 + <type>bool</type> の値を期待するようになりました。 + これより前のバージョンでは、数値型を期待していました。 + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/image/functions/imagerotate.xml b/reference/image/functions/imagerotate.xml index ffdc050030..44c77c39d0 100644 --- a/reference/image/functions/imagerotate.xml +++ b/reference/image/functions/imagerotate.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 34316e9ecfcffa5ebefe7cd37f5fbd629d50e5f9 Maintainer: hirokawa Status: ready --> <!-- CREDITS: shimooka,mumumu --> <refentry xml:id="function.imagerotate" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -14,7 +14,7 @@ <methodparam><type>resource</type><parameter>image</parameter></methodparam> <methodparam><type>float</type><parameter>angle</parameter></methodparam> <methodparam><type>int</type><parameter>bgd_color</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>dummy</parameter><initializer>0</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>ignore_transparent</parameter><initializer>&false;</initializer></methodparam> </methodsynopsis> <para> 画像 <parameter>image</parameter> を、 @@ -47,7 +47,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>dummy</parameter></term> + <term><parameter>ignore_transparent</parameter></term> <listitem> <para> この引数は使われていません。 @@ -64,6 +64,31 @@ </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>ignore_transparent</parameter> は、 + <type>bool</type> を期待するようになりました。 + これより前のバージョンでは、数値型を期待していました。 + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para>