Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions reference/datetime/dateinterval/createfromdatestring.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9eb962113cadccc164d196003062ff5d893de3a5 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: 82f00c8d4d4f09fa5a363bc0c6f48e0c80eea72d Maintainer: lacatoire Status: ready -->
<refentry xml:id="dateinterval.createfromdatestring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateInterval::createFromDateString</refname>
Expand Down Expand Up @@ -85,6 +84,8 @@
A désormais un type de retour provisoire de <type>DateInterval</type>.
Auparavant, il était <type class="union"><type>DateInterval</type><type>false</type></type>.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
<methodname>DateInterval::createFromDateString</methodname> lance désormais
Expand Down
25 changes: 17 additions & 8 deletions reference/pcntl/functions/pcntl-getqos-class.xml
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: acb474ea92ab6226eaf419a85de05f68c6715a9f 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>
<refpurpose>Récupère la classe de qualité de service actuelle du processus</refpurpose>
<refpurpose>Récupère la classe de QoS du thread courant</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand All @@ -14,10 +13,11 @@
<void/>
</methodsynopsis>
<simpara>
Retourne la classe de qualité de service (<acronym>QoS</acronym>) actuelle du processus appelant.
Cette fonction n'est disponible que sur macOS, qui utilise les classes <acronym>QoS</acronym> pour
gérer l'efficacité énergétique et les performances.
Récupère la classe de qualité de service (<acronym>QoS</acronym>) du thread courant.
</simpara>
<note>
<simpara>Cette fonction n'est disponible que sur les plateformes Apple.</simpara>
</note>
</refsect1>

<refsect1 role="parameters">
Expand All @@ -28,15 +28,24 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Retourne une valeur de l'énumération <classname>Pcntl\QosClass</classname> représentant
la classe <acronym>QoS</acronym> actuelle.
Retourne la classe <acronym>QoS</acronym> actuelle sous la forme d'une
<enumname>Pcntl\QosClass</enumname>.
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Une <exceptionname>Error</exceptionname> est levée si l'appel sous-jacent à
<literal>pthread_get_qos_class_np()</literal> échoue.
</simpara>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>pcntl_setqos_class</function></member>
<member><enumname>Pcntl\QosClass</enumname></member>
</simplelist>
</refsect1>

Expand Down
95 changes: 79 additions & 16 deletions reference/pcntl/functions/pcntl-setqos-class.xml
Original file line number Diff line number Diff line change
@@ -1,22 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: acb474ea92ab6226eaf419a85de05f68c6715a9f Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<!-- 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>Définit la classe de qualité de service du processus</refpurpose>
<refpurpose>Définit la classe de QoS du thread courant</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>Pcntl\QosClass::Default</initializer></methodparam>
<methodparam choice="opt"><type>Pcntl\QosClass</type><parameter>qos_class</parameter><initializer><constant>Pcntl\QosClass::Default</constant></initializer></methodparam>
</methodsynopsis>
<simpara>
Définit la classe de qualité de service (<acronym>QoS</acronym>) du processus appelant.
Cette fonction n'est disponible que sur macOS, qui utilise les classes <acronym>QoS</acronym> pour
gérer l'efficacité énergétique et les performances.
Définit la classe de qualité de service (<acronym>QoS</acronym>) du thread
courant.
</simpara>
</refsect1>

Expand All @@ -27,19 +25,75 @@
<term><parameter>qos_class</parameter></term>
<listitem>
<simpara>
La classe <acronym>QoS</acronym> à définir. Doit être l'une des
valeurs de l'énumération <classname>Pcntl\QosClass</classname> :
La classe de qualité de service à assigner au thread courant. Le système
d'exploitation l'utilise comme une indication pour planifier le temps
<acronym>CPU</acronym>, la priorité d'<acronym>E/S</acronym> et la
consommation d'énergie, les classes supérieures étant prioritaires sur
les inférieures. Voir <enumname>Pcntl\QosClass</enumname> pour les cas
disponibles.
</simpara>
<simplelist>
<member><literal>Pcntl\QosClass::UserInteractive</literal></member>
<member><literal>Pcntl\QosClass::UserInitiated</literal></member>
<member><literal>Pcntl\QosClass::Default</literal></member>
<member><literal>Pcntl\QosClass::Utility</literal></member>
<member><literal>Pcntl\QosClass::Background</literal></member>
</simplelist>
<variablelist>
<varlistentry>
<term><constant>Pcntl\QosClass::UserInteractive</constant></term>
<listitem>
<simpara>
Priorité la plus élevée. Destinée au travail qui pilote directement une
interface utilisateur et qui doit s'achever quasiment instantanément
pour éviter tout délai perçu, comme la gestion d'événements ou le
dessin.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::UserInitiated</constant></term>
<listitem>
<simpara>
Priorité élevée, juste en dessous de
<constant>UserInteractive</constant>. Destinée au travail que
l'utilisateur a explicitement initié et qu'il attend activement, censé
s'achever en quelques secondes.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::Default</constant></term>
<listitem>
<simpara>
Priorité standard, utilisée lorsqu'aucune classe plus spécifique ne
s'applique. S'exécute après le travail de priorité supérieure mais
avant <constant>Utility</constant> et <constant>Background</constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::Utility</constant></term>
<listitem>
<simpara>
Priorité inférieure, destinée au travail de longue durée dont
l'utilisateur a conscience mais qu'il n'attend pas activement, comme
les téléchargements, les imports ou les calculs en masse. Planifiée de
manière économe en énergie.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>Pcntl\QosClass::Background</constant></term>
<listitem>
<simpara>
Priorité la plus basse, destinée au travail dont l'utilisateur n'a pas
conscience, comme le préchargement, l'indexation ou la maintenance.
Fortement optimisée pour l'efficacité énergétique et pouvant être
différée lorsque le système est sous charge.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
<note>
<simpara>Cette fonction n'est disponible que sur les plateformes Apple.</simpara>
</note>
</refsect1>

<refsect1 role="returnvalues">
Expand All @@ -49,10 +103,19 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Une <exceptionname>Error</exceptionname> est levée si l'appel sous-jacent à
<literal>pthread_set_qos_class_self_np()</literal> échoue.
</simpara>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>pcntl_getqos_class</function></member>
<member><enumname>Pcntl\QosClass</enumname></member>
</simplelist>
</refsect1>

Expand Down
Loading