From 1b755a2a4ea6084c02cd1b7f5da643004664737b Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 15 Jun 2026 11:17:56 +0200 Subject: [PATCH] [Sync EN] pcntl: Fix duplicate documentation for pcntl_getqos_class and pcntl_setqos_class --- ...etqos_class.xml => pcntl-getqos-class.xml} | 16 +- .../pcntl/functions/pcntl-setqos-class.xml | 142 +++++++++++++++++ .../pcntl/functions/pcntl_setqos_class.xml | 143 ------------------ 3 files changed, 151 insertions(+), 150 deletions(-) rename reference/pcntl/functions/{pcntl_getqos_class.xml => pcntl-getqos-class.xml} (78%) create mode 100644 reference/pcntl/functions/pcntl-setqos-class.xml delete mode 100644 reference/pcntl/functions/pcntl_setqos_class.xml diff --git a/reference/pcntl/functions/pcntl_getqos_class.xml b/reference/pcntl/functions/pcntl-getqos-class.xml similarity index 78% rename from reference/pcntl/functions/pcntl_getqos_class.xml rename to reference/pcntl/functions/pcntl-getqos-class.xml index 14c869e01..38478baf4 100644 --- a/reference/pcntl/functions/pcntl_getqos_class.xml +++ b/reference/pcntl/functions/pcntl-getqos-class.xml @@ -1,6 +1,5 @@ - - + pcntl_getqos_class @@ -14,7 +13,8 @@ - Ermittelt die QoS-Klasse. + Ermittelt die Quality-of-Service-Klasse (QoS) des + aktuellen Threads. Diese Funktion ist nur auf Apple-Plattformen verfügbar. @@ -29,15 +29,17 @@ &reftitle.returnvalues; - Gibt die Pcntl\QosClass zurück. + Gibt die aktuelle QoS-Klasse als + Pcntl\QosClass zurück. &reftitle.errors; - Wirft einen Error, wenn der zugrunde liegende Aufruf von - pthread_get_qos_class_np() fehlschlägt. + Wirft einen Error, wenn der zugrunde + liegende Aufruf von pthread_get_qos_class_np() + fehlschlägt. @@ -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 ---> +--> \ No newline at end of file diff --git a/reference/pcntl/functions/pcntl-setqos-class.xml b/reference/pcntl/functions/pcntl-setqos-class.xml new file mode 100644 index 000000000..7efb49565 --- /dev/null +++ b/reference/pcntl/functions/pcntl-setqos-class.xml @@ -0,0 +1,142 @@ + + + + + pcntl_setqos_class + Setzt die QoS-Klasse des aktuellen Threads + + + + &reftitle.description; + + voidpcntl_setqos_class + Pcntl\QosClassqos_classPcntl\QosClass::Default + + + Legt die Quality-of-Service-Klasse (QoS) des aktuellen + Threads fest. + + + + + &reftitle.parameters; + + + qos_class + + + 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 + Pcntl\QosClass aufgeführt. + + + + Pcntl\QosClass::UserInteractive + + + 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. + + + + + Pcntl\QosClass::UserInitiated + + + Hohe Priorität, knapp unterhalb von + UserInteractive. Vorgesehen für Arbeiten, die + der Benutzer explizit angestoßen hat und auf deren Ergebnis er + aktiv wartet; Abschluss innerhalb weniger Sekunden zu erwarten. + + + + + Pcntl\QosClass::Default + + + Standardpriorität, wenn keine spezifischere Klasse passt. Wird nach + höher priorisierten Arbeiten ausgeführt, aber vor + Utility und Background. + + + + + Pcntl\QosClass::Utility + + + 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. + + + + + Pcntl\QosClass::Background + + + 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. + + + + + + + + + Diese Funktion ist nur auf Apple-Plattformen verfügbar. + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + Wirft einen Error, wenn der zugrunde + liegende Aufruf von pthread_set_qos_class_self_np() + fehlschlägt. + + + + + &reftitle.seealso; + + pcntl_getqos_class + Pcntl\QosClass + + + + + \ No newline at end of file diff --git a/reference/pcntl/functions/pcntl_setqos_class.xml b/reference/pcntl/functions/pcntl_setqos_class.xml deleted file mode 100644 index 08ff88be1..000000000 --- a/reference/pcntl/functions/pcntl_setqos_class.xml +++ /dev/null @@ -1,143 +0,0 @@ - - - - - - pcntl_setqos_class - Setzt die QoS-Klasse des aktuellen Threads - - - - &reftitle.description; - - voidpcntl_setqos_class - Pcntl\QosClassqos_classPcntl\QosClass::Default - - - Legt die QoS-Klasse fest. - - - - - &reftitle.parameters; - - - qos_class - - - 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 - Pcntl\QosClass aufgeführt. - - - - - Pcntl\QosClass::UserInteractive - - - 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. - - - - - Pcntl\QosClass::UserInitiated - - - Hohe Priorität, knapp unterhalb von - UserInteractive. Vorgesehen für Arbeiten, - die der Benutzer explizit angestoßen hat und auf deren Ergebnis - er aktiv wartet; Abschluss innerhalb weniger Sekunden zu erwarten. - - - - - Pcntl\QosClass::Default - - - Standardpriorität, wenn keine spezifischere Klasse passt. Wird - nach höher priorisierten Arbeiten ausgeführt, aber vor - Utility und Background. - - - - - Pcntl\QosClass::Utility - - - 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. - - - - - Pcntl\QosClass::Background - - - 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. - - - - - - - - - - Diese Funktion ist nur auf Apple-Plattformen verfügbar. - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - Wirft einen Error, wenn der zugrunde liegende Aufruf von - pthread_set_qos_class_self_np() fehlschlägt. - - - - - &reftitle.seealso; - - pcntl_getqos_class - Pcntl\QosClass - - - - -