From fae8778c2f23def63ddd2b972721d962f73efa20 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Fri, 29 May 2026 07:56:37 +0200 Subject: [PATCH 1/3] Translate Pcntl\\QosClass enum and four pcntl functions - pcntl.qosclass.xml: fixes the missing entity referenced in reference/pcntl/book.xml line 49 (was breaking the build, #204). - pcntl_getqos_class, pcntl_setqos_class, pcntl_async_signals, pcntl_get_last_error: translate the related newcomer functions while we're already touching the pcntl tree. All five files set Maintainer: lacatoire / Status: ready and use the impersonal tone now recommended for new translations. Fixes #204 --- .../pcntl/functions/pcntl-async-signals.xml | 98 ++++++++++++ .../pcntl/functions/pcntl-get-last-error.xml | 96 ++++++++++++ .../pcntl/functions/pcntl_getqos_class.xml | 72 +++++++++ .../pcntl/functions/pcntl_setqos_class.xml | 143 ++++++++++++++++++ reference/pcntl/pcntl.qosclass.xml | 89 +++++++++++ 5 files changed, 498 insertions(+) create mode 100644 reference/pcntl/functions/pcntl-async-signals.xml create mode 100644 reference/pcntl/functions/pcntl-get-last-error.xml create mode 100644 reference/pcntl/functions/pcntl_getqos_class.xml create mode 100644 reference/pcntl/functions/pcntl_setqos_class.xml create mode 100644 reference/pcntl/pcntl.qosclass.xml diff --git a/reference/pcntl/functions/pcntl-async-signals.xml b/reference/pcntl/functions/pcntl-async-signals.xml new file mode 100644 index 000000000..039a65434 --- /dev/null +++ b/reference/pcntl/functions/pcntl-async-signals.xml @@ -0,0 +1,98 @@ + + + + + + pcntl_async_signals + Aktiviert oder deaktiviert die asynchrone Signalverarbeitung oder gibt die vorherige Einstellung zurück + + + + &reftitle.description; + + boolpcntl_async_signals + boolnullenable&null; + + + Ist der Parameter enable gleich &null;, gibt + pcntl_async_signals zurück, ob die asynchrone + Signalverarbeitung aktiviert ist. Andernfalls wird die asynchrone + Signalverarbeitung aktiviert oder deaktiviert. + + + + + &reftitle.parameters; + + + enable + + + Gibt an, ob die asynchrone Signalverarbeitung aktiviert werden soll. + + + + + + + + &reftitle.returnvalues; + + Bei Verwendung als Getter (enable ist &null;) wird + zurückgegeben, ob die asynchrone Signalverarbeitung aktiviert ist. Bei + Verwendung als Setter (enable ist nicht &null;) + wird zurückgegeben, ob die asynchrone Signalverarbeitung + vor dem Funktionsaufruf aktiviert war. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + enable akzeptiert nun &null;. + + + + + + + + + &reftitle.seealso; + + declare + + + + + diff --git a/reference/pcntl/functions/pcntl-get-last-error.xml b/reference/pcntl/functions/pcntl-get-last-error.xml new file mode 100644 index 000000000..b43da04ec --- /dev/null +++ b/reference/pcntl/functions/pcntl-get-last-error.xml @@ -0,0 +1,96 @@ + + + + + + + pcntl_get_last_error + Gibt die Fehlernummer der zuletzt fehlgeschlagenen pcntl-Funktion zurück + + + + &reftitle.description; + + intpcntl_get_last_error + + + + Gibt die Fehlernummer (errno) zurück, die durch die + zuletzt fehlgeschlagene pcntl-Funktion gesetzt wurde. Die zugehörige + System-Fehlermeldung lässt sich mit pcntl_strerror + abfragen. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Gibt die Fehlernummer (errno) zurück, die durch die + zuletzt fehlgeschlagene pcntl-Funktion gesetzt wurde. Trat kein Fehler + auf, wird 0 zurückgegeben. + + + + + &reftitle.examples; + + Beispiel für <function>pcntl_get_last_error</function> + + Dieses Beispiel versucht, auf Kindprozesse zu warten, obwohl keiner + existiert, und gibt anschließend die zugehörige Fehlermeldung aus. + + + + + &example.outputs.similar; + + + + + + + + &reftitle.seealso; + + pcntl_strerror + + + + + + diff --git a/reference/pcntl/functions/pcntl_getqos_class.xml b/reference/pcntl/functions/pcntl_getqos_class.xml new file mode 100644 index 000000000..14c869e01 --- /dev/null +++ b/reference/pcntl/functions/pcntl_getqos_class.xml @@ -0,0 +1,72 @@ + + + + + + pcntl_getqos_class + Gibt die QoS-Klasse des aktuellen Threads zurück + + + + &reftitle.description; + + Pcntl\QosClasspcntl_getqos_class + + + + Ermittelt die QoS-Klasse. + + + Diese Funktion ist nur auf Apple-Plattformen verfügbar. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Gibt die Pcntl\QosClass zurück. + + + + + &reftitle.errors; + + Wirft einen Error, wenn der zugrunde liegende Aufruf von + pthread_get_qos_class_np() fehlschlägt. + + + + + &reftitle.seealso; + + pcntl_setqos_class + Pcntl\QosClass + + + + + diff --git a/reference/pcntl/functions/pcntl_setqos_class.xml b/reference/pcntl/functions/pcntl_setqos_class.xml new file mode 100644 index 000000000..3ca33b8c6 --- /dev/null +++ b/reference/pcntl/functions/pcntl_setqos_class.xml @@ -0,0 +1,143 @@ + + + + + + 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 antreiben 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 + + + + + diff --git a/reference/pcntl/pcntl.qosclass.xml b/reference/pcntl/pcntl.qosclass.xml new file mode 100644 index 000000000..0cf264abf --- /dev/null +++ b/reference/pcntl/pcntl.qosclass.xml @@ -0,0 +1,89 @@ + + + + + Die Aufzählung Pcntl\QosClass + Pcntl\QosClass + + +
+ &reftitle.intro; + + Die Aufzählung Pcntl\QosClass wird verwendet, um + die Priorität von Benutzerprozessen über + pcntl_setqos_class festzulegen. + +
+ +
+ &reftitle.enumsynopsis; + + Pcntl + + + QosClass + + + UserInteractive + + Führt den Prozess mit der höchsten Prioritätsstufe aus. + + + + + UserInitiated + + Führt den Prozess mit hoher Prioritätsstufe aus, aber unterhalb der + UserInteractive-Prozesse. + + + + + Default + + Führt den Prozess nach allen hochprioritären Prozessen aus, jedoch + vor den niedrigprioritären. + + + + + Utility + + Niedrigere Priorität, vorgesehen für länger laufende Arbeiten, die + dem Benutzer bewusst sind, auf die er aber nicht aktiv wartet. + Energieeffizient eingeplant. + + + + + Background + + Führt den Prozess aus, nachdem alle hochprioritären Prozesse + abgearbeitet wurden. + + + + +
+ + + From 89440559c5927ee28f9f666b0e0e6bc78c4e0194 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Fri, 29 May 2026 19:02:04 +0200 Subject: [PATCH 2/3] Update reference/pcntl/functions/pcntl_setqos_class.xml Co-authored-by: Martin Samesch --- reference/pcntl/functions/pcntl_setqos_class.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/pcntl/functions/pcntl_setqos_class.xml b/reference/pcntl/functions/pcntl_setqos_class.xml index 3ca33b8c6..08ff88be1 100644 --- a/reference/pcntl/functions/pcntl_setqos_class.xml +++ b/reference/pcntl/functions/pcntl_setqos_class.xml @@ -38,7 +38,7 @@ Höchste Priorität. Vorgesehen für Arbeiten, die unmittelbar - eine Benutzeroberfläche antreiben und nahezu sofort abgeschlossen + eine Benutzeroberfläche steuern und nahezu sofort abgeschlossen sein müssen, um spürbare Verzögerungen zu vermeiden, etwa Ereignisverarbeitung oder Zeichnen. From ca952f5307fbe2b67efcf9aa2e9098b2231f4f26 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Fri, 29 May 2026 19:02:14 +0200 Subject: [PATCH 3/3] Update reference/pcntl/pcntl.qosclass.xml Co-authored-by: Martin Samesch --- reference/pcntl/pcntl.qosclass.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/pcntl/pcntl.qosclass.xml b/reference/pcntl/pcntl.qosclass.xml index 0cf264abf..a141fded9 100644 --- a/reference/pcntl/pcntl.qosclass.xml +++ b/reference/pcntl/pcntl.qosclass.xml @@ -41,8 +41,8 @@ Default - Führt den Prozess nach allen hochprioritären Prozessen aus, jedoch - vor den niedrigprioritären. + Führt den Prozess nach allen Prozessen mit hoher Priorität, aber + vor solchen mit niedriger Priorität.