戻り値型 bool→true 同期・return type sync 40 件 (#357)

## 翻訳内容

### reference/image（34件）— return type アノテーション修正

- reference/image/functions/imageresolution.xml — 戻り値型を `array|bool` から `array|true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagealphablending.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imageantialias.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagearc.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagechar.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagecharup.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagecolordeallocate.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagecolormatch.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagecopy.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagecopymerge.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagecopymergegray.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagecopyresampled.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagecopyresized.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagedashedline.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagedestroy.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imageellipse.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagefill.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagefilledarc.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagefilledellipse.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagefilledrectangle.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagefilltoborder.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imageflip.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagegammacorrect.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagelayereffect.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imageline.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagerectangle.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagesavealpha.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagesetbrush.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagesetclip.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagesetpixel.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagesetthickness.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagesettile.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagestring.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214
- reference/image/functions/imagestringup.xml — 戻り値型を `bool` から `true` に修正
  1. php/doc-en@fcd9214

### 独立ファイル

- reference/array/functions/array-multisort.xml — 戻り値型を `bool` から `true` に変更、8.5.0 changelog 追加
  1. php/doc-en@5b76466
- reference/fileinfo/functions/finfo-close.xml — 戻り値型を `true` に変更、NOP化・非推奨の changelog 追加
  1. php/doc-en@fcd9214
  2. php/doc-en@34bd6f0
  3. php/doc-en@5b76466
- reference/ftp/functions/ftp-set-option.xml — 戻り値型を `true` に変更、errors セクション追加、8.5.0 changelog 追加
  1. php/doc-en@fcd9214
  2. php/doc-en@5b76466
- reference/sem/functions/shm-detach.xml — 戻り値型を `bool` から `true` に変更、8.5.0 changelog 追加
  1. php/doc-en@5b76466
- reference/pcntl/functions/pcntl-exec.xml — 戻り値型を `bool` から `false` に修正、エンティティエンコーディング修正
  1. php/doc-en@fcd9214
- reference/libxml/functions/libxml-set-external-entity-loader.xml — 戻り値型を `bool` から `true` に変更、8.5.0 changelog 追加
  1. php/doc-en@5b76466

Author: KentarouTakeda

reference/array/functions/array-multisort.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 5b7646656eb183ea568b8261d6d87a10a1b961c7 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi,mumumu -->
 <refentry xml:id="function.array-multisort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>array_multisort</methodname>
+   <type>true</type><methodname>array_multisort</methodname>
    <methodparam><type>array</type><parameter role="reference">array1</parameter></methodparam>
    <methodparam choice="opt"><type>mixed</type><parameter>array1_sort_order</parameter><initializer>SORT_ASC</initializer></methodparam>
    <methodparam choice="opt"><type>mixed</type><parameter>array1_sort_flags</parameter><initializer>SORT_REGULAR</initializer></methodparam>
@@ -118,10 +118,32 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </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.5.0</entry>
+      <entry>
+       戻り値の型が、&true; になりました。これより前のバージョンでは、<type>bool</type> でした。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

reference/fileinfo/functions/finfo-close.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 82ddd2ec8ad195035dcb57dd8f97d27b83ddc126 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: takagi Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-close">
  <refnamediv>
   <refname>finfo_close</refname>
@@ -13,12 +13,14 @@
   &reftitle.description;
   <methodsynopsis>
    <modifier role="attribute">#[\Deprecated]</modifier>
-   <type>bool</type><methodname>finfo_close</methodname>
+   <type>true</type><methodname>finfo_close</methodname>
    <methodparam><type>finfo</type><parameter>finfo</parameter></methodparam>
   </methodsynopsis>
 
   <simpara>
-   この関数は、<function>finfo_open</function> がオープンしたインスタンスを閉じます。
+   この関数は、PHP 7.4 までは <function>finfo_open</function> がオープンしたインスタンスを閉じていましたが、
+   PHP 8.0 で <classname>finfo</classname> がリソースからオブジェクトに変換されて以降は何もしない関数（no-op）になっており、
+   PHP 8.5 で非推奨になりました。
   </simpara>
 
  </refsect1>
@@ -36,7 +38,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   &return.success;
+   &return.true.always;
   </simpara>
  </refsect1>
 
@@ -51,6 +53,24 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       この関数は非推奨になりました。
+      </entry>
+     </row>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       戻り値の型が、&true; になりました。これより前のバージョンでは、<type>bool</type> でした。
+      </entry>
+     </row>
+     <row>
+      <entry>8.1.0</entry>
+      <entry>
+       この関数は <acronym>NOP</acronym>（何もしない関数）になりました。
+      </entry>
+     </row>
      &fileinfo.changelog.finfo-object;
     </tbody>
    </tgroup>

reference/ftp/functions/ftp-set-option.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4d1c34c9b7a30cfc3a59641122c707a2812cfed7 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi,mumumu -->
 <refentry xml:id="function.ftp-set-option" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>ftp_set_option</methodname>
+   <type>true</type><methodname>ftp_set_option</methodname>
    <methodparam><type>FTP\Connection</type><parameter>ftp</parameter></methodparam>
    <methodparam><type>int</type><parameter>option</parameter></methodparam>
    <methodparam><type class="union"><type>int</type><type>bool</type></type><parameter>value</parameter></methodparam>
@@ -84,13 +84,22 @@
    </variablelist>
   </para>
  </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   オプションが設定できた場合に &true; 、そうでない場合に &false; を返します。
-   <parameter>option</parameter> がサポートされていなかった場合や
-   <parameter>option</parameter> が想定していない値を <parameter>value</parameter>
-   に渡した場合は警告メッセージが発生します。
+   &return.true.always;
+  </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   <parameter>option</parameter> がサポートされていない場合、
+   <exceptionname>ValueError</exceptionname> がスローされます。
+   渡された <parameter>value</parameter> が指定された <parameter>option</parameter>
+   に対して期待される型と一致しない場合、
+   <exceptionname>TypeError</exceptionname> がスローされます。
   </para>
  </refsect1>
 
@@ -105,6 +114,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       戻り値の型が、&true; になりました。これより前のバージョンでは、<type>bool</type> でした。
+      </entry>
+     </row>
      &ftp.changelog.ftp-param;
     </tbody>
    </tgroup>

reference/image/functions/imagealphablending.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xml:id="function.imagealphablending" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>imagealphablending</methodname>
+   <type>true</type><methodname>imagealphablending</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
    <methodparam><type>bool</type><parameter>enable</parameter></methodparam>
   </methodsynopsis>
@@ -46,7 +46,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 

reference/image/functions/imageantialias.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,takagi,mumumu -->
 <refentry xml:id="function.imageantialias" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>imageantialias</methodname>
+   <type>true</type><methodname>imageantialias</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
    <methodparam><type>bool</type><parameter>enable</parameter></methodparam>
   </methodsynopsis>
@@ -48,7 +48,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 

reference/image/functions/imagearc.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imagearc" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>imagearc</methodname>
+   <type>true</type><methodname>imagearc</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
    <methodparam><type>int</type><parameter>center_x</parameter></methodparam>
    <methodparam><type>int</type><parameter>center_y</parameter></methodparam>
@@ -92,7 +92,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 

reference/image/functions/imagechar.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: a7e5e563d2d2269a6d7ccff506715a3e1a6f3902 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imagechar" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>imagechar</methodname>
+   <type>true</type><methodname>imagechar</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
    <methodparam><type class="union"><type>GdFont</type><type>int</type></type><parameter>font</parameter></methodparam>
    <methodparam><type>int</type><parameter>x</parameter></methodparam>
@@ -69,7 +69,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 

reference/image/functions/imagecharup.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: a7e5e563d2d2269a6d7ccff506715a3e1a6f3902 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imagecharup" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>imagecharup</methodname>
+   <type>true</type><methodname>imagecharup</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
    <methodparam><type class="union"><type>GdFont</type><type>int</type></type><parameter>font</parameter></methodparam>
    <methodparam><type>int</type><parameter>x</parameter></methodparam>
@@ -67,7 +67,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 

reference/image/functions/imagecolordeallocate.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 593ea510e853ff034e03f78a4be0daa41661c9d4 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imagecolordeallocate" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>imagecolordeallocate</methodname>
+   <type>true</type><methodname>imagecolordeallocate</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
    <methodparam><type>int</type><parameter>color</parameter></methodparam>
   </methodsynopsis>
@@ -38,7 +38,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 

reference/image/functions/imagecolormatch.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imagecolormatch" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>imagecolormatch</methodname>
+   <type>true</type><methodname>imagecolormatch</methodname>
    <methodparam><type>GdImage</type><parameter>image1</parameter></methodparam>
    <methodparam><type>GdImage</type><parameter>image2</parameter></methodparam>
   </methodsynopsis>
@@ -45,7 +45,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>