pcntl QoS ドキュメント重複の解消に追従し、reflection を同期（2モジュール完訳）

reference/pcntl/functions/pcntl_getqos_class.xml → reference/pcntl/functions/pcntl-getqos-class.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 28192e830f2c204570cc140c24341d07807df8bc Maintainer: KentarouTakeda Status: ready -->
 <refentry xml:id="function.pcntl-getqos-class" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>pcntl_getqos_class</refname>
@@ -14,7 +14,7 @@
    <void/>
   </methodsynopsis>
   <simpara>
-   QoS クラスを取得します。
+   現在のスレッドの Quality of Service (<acronym>QoS</acronym>) クラスを取得します。
   </simpara>
   <note>
    <simpara>この関数は、Apple のプラットフォームでのみ利用可能です。</simpara>
@@ -29,15 +29,16 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   <enumname>Pcntl\QosClass</enumname> を返します。
+   現在の <acronym>QoS</acronym> クラスを
+   <enumname>Pcntl\QosClass</enumname> として返します。
   </simpara>
  </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;
   <simpara>
    内部の <literal>pthread_get_qos_class_np()</literal> の呼び出しが失敗した場合、
-   <classname>Error</classname> をスローします。
+   <exceptionname>Error</exceptionname> をスローします。
   </simpara>
  </refsect1>
 

reference/pcntl/functions/pcntl-setqos-class.xml

@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 28192e830f2c204570cc140c24341d07807df8bc Maintainer: KentarouTakeda Status: ready -->
+<refentry xml:id="function.pcntl-setqos-class" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>pcntl_setqos_class</refname>
+  <refpurpose>現在のスレッドの QoS クラスを設定する</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>void</type><methodname>pcntl_setqos_class</methodname>
+   <methodparam choice="opt"><type>Pcntl\QosClass</type><parameter>qos_class</parameter><initializer><constant>Pcntl\QosClass::Default</constant></initializer></methodparam>
+  </methodsynopsis>
+  <simpara>
+   現在のスレッドの Quality of Service (<acronym>QoS</acronym>) クラスを設定します。
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>qos_class</parameter></term>
+    <listitem>
+     <simpara>
+      現在のスレッドに割り当てる Quality of Service クラス。
+      オペレーティングシステムは、これを CPU 時間の割り当て、
+      I/O 優先度、電力消費をスケジューリングする際のヒントとして使用し、
+      上位のクラスは下位のクラスに割り込んで実行されます。
+      利用可能なケースについては、<enumname>Pcntl\QosClass</enumname>
+      を参照してください。
+     </simpara>
+     <variablelist>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::UserInteractive</constant></term>
+       <listitem>
+        <simpara>
+         最も高い優先度です。ユーザーインターフェイスを直接駆動する処理向けで、
+         イベント処理や描画など、体感的な遅延を避けるために
+         ほぼ瞬時に完了する必要があるものを想定しています。
+        </simpara>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::UserInitiated</constant></term>
+       <listitem>
+        <simpara>
+         高い優先度で、<constant>UserInteractive</constant> のすぐ下です。
+         ユーザーが明示的に開始し、結果を待っている処理向けで、
+         数秒以内に完了することが期待されるものを想定しています。
+        </simpara>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::Default</constant></term>
+       <listitem>
+        <simpara>
+         標準の優先度で、より具体的なクラスが該当しない場合に使用します。
+         より優先度の高い処理の後に実行されますが、
+         <constant>Utility</constant> や <constant>Background</constant>
+         よりは先に実行されます。
+        </simpara>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::Utility</constant></term>
+       <listitem>
+        <simpara>
+         低めの優先度です。ダウンロード、インポート、
+         一括計算など、ユーザーは認識しているものの、
+         結果を待ってはいない長時間の処理向けです。
+         省電力なスケジューリングが行われます。
+        </simpara>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::Background</constant></term>
+       <listitem>
+        <simpara>
+         最も低い優先度です。プリフェッチ、インデックス作成、
+         メンテナンスなど、ユーザーが認識していない処理向けです。
+         電力効率を強く重視して最適化されており、
+         システムが高負荷の場合は実行が後回しにされる可能性があります。
+        </simpara>
+       </listitem>
+      </varlistentry>
+     </variablelist>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+  <note>
+   <simpara>この関数は、Apple のプラットフォームでのみ利用可能です。</simpara>
+  </note>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   &return.void;
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   内部の <literal>pthread_set_qos_class_self_np()</literal> の呼び出しが失敗した場合、
+   <exceptionname>Error</exceptionname> をスローします。
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>pcntl_getqos_class</function></member>
+   <member><enumname>Pcntl\QosClass</enumname></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

reference/reflection/reflectionfunctionabstract/hasreturntype.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: c3485c8f1c57caa8ea0fc2924050a175bbc7686d Maintainer: mumumu Status: ready -->
 
 <refentry xml:id="reflectionfunctionabstract.hasreturntype" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -41,7 +41,8 @@
 <![CDATA[
 <?php
 
-function to_int($param) : int {
+function to_int($param): int
+{
     return (int) $param;
 }
 
@@ -76,10 +77,6 @@ bool(false)
     </screen>
    </example>
   </para>
-  <para>
-   こうなるのは、たくさんの内部関数が引数や戻り値に型を指定していないからです。
-   よって、このメソッドはビルトイン関数に使わないのが最適です。
-  </para>
  </refsect1>
 
  <refsect1 role="seealso">