[Sync EN] pcntl: Fix duplicate documentation for pcntl_getqos_class and pcntl_setqos_class

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

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 30b0c51175bb9bc5a329d7924b0ca5eff1f1f9ad Maintainer: lacatoire Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: 28192e830f2c204570cc140c24341d07807df8bc Maintainer: lacatoire Status: ready -->
 <refentry xml:id="function.pcntl-getqos-class" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>pcntl_getqos_class</refname>
@@ -14,7 +13,8 @@
    <void/>
   </methodsynopsis>
   <simpara>
-   Ermittelt die QoS-Klasse.
+   Ermittelt die Quality-of-Service-Klasse (<acronym>QoS</acronym>) des
+   aktuellen Threads.
   </simpara>
   <note>
    <simpara>Diese Funktion ist nur auf Apple-Plattformen verfügbar.</simpara>
@@ -29,15 +29,17 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Gibt die <enumname>Pcntl\QosClass</enumname> zurück.
+   Gibt die aktuelle <acronym>QoS</acronym>-Klasse als
+   <enumname>Pcntl\QosClass</enumname> zurück.
   </simpara>
  </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;
   <simpara>
-   Wirft einen <classname>Error</classname>, wenn der zugrunde liegende Aufruf von
-   <literal>pthread_get_qos_class_np()</literal> fehlschlägt.
+   Wirft einen <exceptionname>Error</exceptionname>, wenn der zugrunde
+   liegende Aufruf von <literal>pthread_get_qos_class_np()</literal>
+   fehlschlägt.
   </simpara>
  </refsect1>
 
@@ -69,4 +71,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->

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

@@ -0,0 +1,142 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 28192e830f2c204570cc140c24341d07807df8bc Maintainer: lacatoire Status: ready -->
+<refentry xml:id="function.pcntl-setqos-class" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>pcntl_setqos_class</refname>
+  <refpurpose>Setzt die QoS-Klasse des aktuellen Threads</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>
+   Legt die Quality-of-Service-Klasse (<acronym>QoS</acronym>) des aktuellen
+   Threads fest.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>qos_class</parameter></term>
+    <listitem>
+     <simpara>
+      Die Quality-of-Service-Klasse, die dem aktuellen Thread zugewiesen
+      werden soll. Das Betriebssystem nutzt sie als Hinweis für die Planung
+      von CPU-Zeit, E/A-Priorität und Energieverbrauch; höhere Klassen
+      verdrängen niedrigere. Die verfügbaren Werte sind unter
+      <enumname>Pcntl\QosClass</enumname> aufgeführt.
+     </simpara>
+     <variablelist>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::UserInteractive</constant></term>
+       <listitem>
+        <simpara>
+         Höchste Priorität. Vorgesehen für Arbeiten, die unmittelbar eine
+         Benutzeroberfläche steuern und nahezu sofort abgeschlossen sein
+         müssen, um spürbare Verzögerungen zu vermeiden, etwa
+         Ereignisverarbeitung oder Zeichnen.
+        </simpara>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::UserInitiated</constant></term>
+       <listitem>
+        <simpara>
+         Hohe Priorität, knapp unterhalb von
+         <constant>UserInteractive</constant>. Vorgesehen für Arbeiten, die
+         der Benutzer explizit angestoßen hat und auf deren Ergebnis er
+         aktiv wartet; Abschluss innerhalb weniger Sekunden zu erwarten.
+        </simpara>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::Default</constant></term>
+       <listitem>
+        <simpara>
+         Standardpriorität, wenn keine spezifischere Klasse passt. Wird nach
+         höher priorisierten Arbeiten ausgeführt, aber vor
+         <constant>Utility</constant> und <constant>Background</constant>.
+        </simpara>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::Utility</constant></term>
+       <listitem>
+        <simpara>
+         Niedrigere Priorität, vorgesehen für länger laufende Arbeiten, die
+         dem Benutzer bewusst sind, auf die er aber nicht aktiv wartet, etwa
+         Downloads, Importe oder umfangreiche Berechnungen. Energieeffizient
+         eingeplant.
+        </simpara>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><constant>Pcntl\QosClass::Background</constant></term>
+       <listitem>
+        <simpara>
+         Niedrigste Priorität, vorgesehen für Arbeiten, die dem Benutzer
+         nicht bewusst sind, etwa Prefetching, Indexierung oder Wartung.
+         Stark auf Energieeffizienz optimiert; kann bei Systemlast
+         aufgeschoben werden.
+        </simpara>
+       </listitem>
+      </varlistentry>
+     </variablelist>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+  <note>
+   <simpara>Diese Funktion ist nur auf Apple-Plattformen verfügbar.</simpara>
+  </note>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   &return.void;
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Wirft einen <exceptionname>Error</exceptionname>, wenn der zugrunde
+   liegende Aufruf von <literal>pthread_set_qos_class_self_np()</literal>
+   fehlschlägt.
+  </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
+-->