Skip to content

Commit be4e850

Browse files
GirgiasGirgias
committed
pthreads : fix XML by converting para to simpara tags via script
1 parent e9e4903 commit be4e850

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

43 files changed

+428
-448
lines changed

‎reference/pthreads/book.xml‎

Lines changed: 78 additions & 80 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,20 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 12424df3c8140290d9e5c4912cbdb260aae055f4 Maintainer: yannick Status: ready -->
3+
<!-- EN-Revision: bf92d8bd839301de7c837d20ab1dac6c14f83bbf Maintainer: yannick Status: ready -->
44
<!-- Reviewed: no -->
5-
6-
<book xml:id="book.pthreads" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.pthreads">
76
<?phpdoc extension-membership="pecl" ?>
87
<title>pthreads</title>
98
<titleabbrev>pthreads</titleabbrev>
10-
9+
1110
<preface xml:id="intro.pthreads">
1211
&reftitle.intro;
13-
<para>
14-
pthreads est une API orientée objet qui apporte tous les outils nécessaires pour
15-
le multithreading en PHP.
12+
<simpara>
13+
pthreads est une API orientée objet qui apporte tous les outils nécessaires pour
14+
le multithreading en PHP.
1615
Les applications PHP peuvent créer, lire, écrire, exécuter
1716
et synchroniser des Threads, des Workers, et des objets Threaded.
18-
</para>
17+
</simpara>
1918
<warning>
2019
<simpara>
2120
Cette extension est considéré non maintenue et morte.
@@ -27,85 +26,85 @@
2726
</simpara>
2827
</tip>
2928
<warning>
30-
<para>
31-
L'extension pthreads ne peut pas être utilisée dans un environnement de
32-
serveur Web. Le Threading en PHP est donc limité aux applications basées
29+
<simpara>
30+
L'extension pthreads ne peut pas être utilisée dans un environnement de
31+
serveur Web. Le Threading en PHP est donc limité aux applications basées
3332
sur CLI uniquement.
34-
</para>
33+
</simpara>
3534
</warning>
3635
<warning>
37-
<para>
38-
pthreads (v3) peut être utilisé uniquement avec PHP 7.2+ à cause d'un
36+
<simpara>
37+
pthreads (v3) peut être utilisé uniquement avec PHP 7.2+ à cause d'un
3938
mode ZTS dangereux en PHP 7.0 et 7.1.
40-
</para>
39+
</simpara>
4140
</warning>
42-
<para>
43-
La classe <classname>Threaded</classname> constitue la base de la
44-
fonctionnalité qui permet à pthreads de fonctionner. Il expose les méthodes
41+
<simpara>
42+
La classe <classname>Threaded</classname> constitue la base de la
43+
fonctionnalité qui permet à pthreads de fonctionner. Il expose les méthodes
4544
de synchronisation et quelques interfaces utiles pour le programmeur.
46-
</para>
47-
<para>
48-
La classe <classname>Thread</classname> permet de créer des threads en
49-
l'étendant simplement et en implémentant une méthode <literal>run</literal>.
50-
Tous les membres peuvent être écrits et lus par n'importe quel contexte avec
51-
une référence au thread. Tout contexte peut également exécuter toutes les
52-
méthodes publiques et protégées. Le corps de la méthode run sera exécuté
53-
dans un thread séparé lorsque la méthode <methodname>Thread::start</methodname>
54-
de l'implémentation est appelée à partir du contexte qui l'a créé. Seul le
45+
</simpara>
46+
<simpara>
47+
La classe <classname>Thread</classname> permet de créer des threads en
48+
l'étendant simplement et en implémentant une méthode <literal>run</literal>.
49+
Tous les membres peuvent être écrits et lus par n'importe quel contexte avec
50+
une référence au thread. Tout contexte peut également exécuter toutes les
51+
méthodes publiques et protégées. Le corps de la méthode run sera exécuté
52+
dans un thread séparé lorsque la méthode <methodname>Thread::start</methodname>
53+
de l'implémentation est appelée à partir du contexte qui l'a créé. Seul le
5554
contexte qui crée un thread peut le démarrer et le rejoindre.
56-
</para>
57-
<para>
58-
La classe <classname>Worker</classname> a un état persistant et sera
59-
disponible à partir de l'appel à <methodname>Thread::start</methodname> (une
60-
méthode héritée) jusqu'à ce que l'objet soit hors de portée, ou soit
61-
explicitement arreté (via <methodname>Worker::shutdown</methodname>). Tout
62-
contexte avec une référence à l'objet Worker peut empiler des tâches sur le
63-
Worker (via <methodname>Worker::stack</methodname>), où ces tâches seront
64-
exécutées par le Worker dans un thread séparé. La méthode
65-
<literal>run</literal> d'un objet worker est exécutée avant tout objet de la
66-
pile du worker, ce qui permet aux ressources d'être initialisées pour que
55+
</simpara>
56+
<simpara>
57+
La classe <classname>Worker</classname> a un état persistant et sera
58+
disponible à partir de l'appel à <methodname>Thread::start</methodname> (une
59+
méthode héritée) jusqu'à ce que l'objet soit hors de portée, ou soit
60+
explicitement arreté (via <methodname>Worker::shutdown</methodname>). Tout
61+
contexte avec une référence à l'objet Worker peut empiler des tâches sur le
62+
Worker (via <methodname>Worker::stack</methodname>), où ces tâches seront
63+
exécutées par le Worker dans un thread séparé. La méthode
64+
<literal>run</literal> d'un objet worker est exécutée avant tout objet de la
65+
pile du worker, ce qui permet aux ressources d'être initialisées pour que
6766
les objets à exécuter puissent les utiliser.
68-
</para>
69-
<para>
70-
La classe <classname>Pool</classname> est utilisée pour créer un groupe de
71-
worker pour distribuer des objets <classname>Threaded</classname> parmi eux.
72-
Il est le moyen le plus facile et le plus efficace d'utiliser plusieurs
67+
</simpara>
68+
<simpara>
69+
La classe <classname>Pool</classname> est utilisée pour créer un groupe de
70+
worker pour distribuer des objets <classname>Threaded</classname> parmi eux.
71+
Il est le moyen le plus facile et le plus efficace d'utiliser plusieurs
7372
threads dans les applications PHP.
74-
</para>
73+
</simpara>
7574
<caution>
76-
<para>
77-
La classe <classname>Pool</classname> n'étend pas la classe
78-
<classname>Threaded</classname>, et donc les objets basés sur pool sont
75+
<simpara>
76+
La classe <classname>Pool</classname> n'étend pas la classe
77+
<classname>Threaded</classname>, et donc les objets basés sur pool sont
7978
considérés comme des objets PHP normaux. En tant que tel, ses instances ne d
8079
doivent pas être partagées entre des contextes différents.
81-
</para>
80+
</simpara>
8281
</caution>
83-
<para>
84-
La classe <classname>Volatile</classname> est nouvelle pour pthreads v3.
85-
Elle est utilisée pour désigner les propriétés <classname>Threaded</classname>
86-
mutable des classes <classname>Threaded</classname> (car celles-ci sont
87-
désormais immuables par défaut). Elle est également utilisé pour stocker
82+
<simpara>
83+
La classe <classname>Volatile</classname> est nouvelle pour pthreads v3.
84+
Elle est utilisée pour désigner les propriétés <classname>Threaded</classname>
85+
mutable des classes <classname>Threaded</classname> (car celles-ci sont
86+
désormais immuables par défaut). Elle est également utilisé pour stocker
8887
des tableaux PHP dans des contextes <classname>Threaded</classname>.
89-
</para>
90-
<para>
91-
La synchronisation est une capacité importante lors du Threading. Tous les
92-
objets créés par pthreads ont été construits en synchronisation dans la
88+
</simpara>
89+
<simpara>
90+
La synchronisation est une capacité importante lors du Threading. Tous les
91+
objets créés par pthreads ont été construits en synchronisation dans la
9392
forme (qui sera familière aux programmeurs Java) de
9493
<methodname>Threaded::wait</methodname> et
95-
<methodname>Threaded::notify</methodname>. L'appel de
96-
<methodname>Threaded::wait</methodname> sur un objet entraînera le contexte
94+
<methodname>Threaded::notify</methodname>. L'appel de
95+
<methodname>Threaded::wait</methodname> sur un objet entraînera le contexte
9796
à attendre qu'un autre contexte appelle
98-
<methodname>Threaded::notify</methodname> sur le même objet. Ce mécanisme
99-
permet une synchronisation puissante entre les objets
97+
<methodname>Threaded::notify</methodname> sur le même objet. Ce mécanisme
98+
permet une synchronisation puissante entre les objets
10099
<classname>Threaded</classname> en PHP.
101-
</para>
100+
</simpara>
102101
<caution>
103-
<para>
104-
Tout objet prévu pour être utilisé dans une partie multithreadé de votre
102+
<simpara>
103+
Tout objet prévu pour être utilisé dans une partie multithreadé de votre
105104
application doit étendre <classname>Threaded</classname>.
106-
</para>
105+
</simpara>
107106
</caution>
108-
<para>
107+
<simpara>
109108
Stockage des données : En règle générale, tous les types de données pouvant être sérialisés peuvent
110109
être utilisés comme membre d'un objet Threadé, ils peuvent être lus, et écrits depuis n'importe quel
111110
contexte avec une référence vers l'objet Threadé. Tous les types de données ne sont pas stockés
@@ -115,39 +114,39 @@
115114
A l'exception des objets Threadés, toute référence utilisée pour définir un membre d'un objet Threadé
116115
est séparé de la référence dans l'objet Threadé ; les mêmes données peuvent être lues directement
117116
depuis l'objet Threadé à tout moment par n'importe quel contexte avec une référence vers l'objet Threadé.
118-
</para>
119-
<para>
120-
Membres statiques : Lorsqu'un nouveau contexte est créé (Thread ou Worker),
121-
ils sont généralement copiés, mais les ressources et objects avec un état
117+
</simpara>
118+
<simpara>
119+
Membres statiques : Lorsqu'un nouveau contexte est créé (Thread ou Worker),
120+
ils sont généralement copiés, mais les ressources et objects avec un état
122121
interne sont nullifiés (pour des raisons de sécurité). Ceci permet alors à la fonction une sorte de stockage local
123122
au niveau du thread. Par exemple, lors du démarrage du contexte, une classe dont les membres statiques
124123
incluent des informations de connexion vers un serveur de base de données, seules les informations
125124
seront copiées, et non la connexion en tant que telle. Ceci permet au nouveau contexte d'initialiser
126125
une connexion de la même façon que le contexte qui l'a créé, stockant la connexion au même endroit
127126
sans pour autant affecter le contexte original.
128-
</para>
127+
</simpara>
129128
<caution>
130-
<para>
129+
<simpara>
131130
Lorsque print_r, var_dump et d'autres fonctions de débogage sont exécutées, elles n'incluent pas
132131
de protection contre la récursion.
133-
</para>
132+
</simpara>
134133
</caution>
135134
<note>
136-
<para>
135+
<simpara>
137136
Ressources : Les extensions et les fonctionnalités qui définissent des ressoures en PHP ne sont pas préparées
138137
pour ce type d'environnement ; pthreads prend des dispositions en matière de ressource à partager entre
139138
les contextes, cependant, pour la plupart des ressources, elles devront être considérées comme dangereuses.
140139
Un soin et une extrème prudence devront être de mise pour partager les ressources entre les contextes.
141-
</para>
140+
</simpara>
142141
</note>
143142
<caution>
144-
<para>
143+
<simpara>
145144
Dans l'environnement d'exécution de pthreads, des restrictions et des limitations sont nécessaires afin de
146145
fournir un environnement stable.
147-
</para>
146+
</simpara>
148147
</caution>
149148
</preface>
150-
149+
151150
&reference.pthreads.setup;
152151
&reference.pthreads.constants;
153152
&reference.pthreads.threaded;
@@ -156,9 +155,8 @@
156155
&reference.pthreads.collectable;
157156
&reference.pthreads.pool;
158157
&reference.pthreads.volatile;
159-
160-
</book>
161158

159+
</book>
162160
<!-- Keep this comment at the end of the file
163161
Local variables:
164162
mode: sgml

‎reference/pthreads/collectable.xml‎

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,19 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 12424df3c8140290d9e5c4912cbdb260aae055f4 Maintainer: yannick Status: ready -->
3+
<!-- EN-Revision: bf92d8bd839301de7c837d20ab1dac6c14f83bbf Maintainer: yannick Status: ready -->
44
<!-- Reviewed: no -->
5-
6-
<reference xml:id="class.collectable" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.collectable" role="class">
76

87
<title>L'interface Collectable</title>
98
<titleabbrev>Collectable</titleabbrev>
10-
9+
1110
<partintro>
1211
<!-- {{{ Collectable intro -->
1312
<section xml:id="collectable.intro">
1413
&reftitle.intro;
15-
<para>
14+
<simpara>
1615
Représente un objet de collecte de données obsolètes.
17-
</para>
16+
</simpara>
1817
</section>
1918
<!-- }}} -->
2019

@@ -32,9 +31,9 @@
3231
</oointerface>
3332
</classsynopsisinfo>
3433
<!-- }}} -->
35-
34+
3635
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
37-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.collectable')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
36+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.collectable')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
3837

3938
</classsynopsis>
4039
<!-- }}} -->
@@ -46,7 +45,6 @@
4645
&reference.pthreads.entities.collectable;
4746

4847
</reference>
49-
5048
<!-- Keep this comment at the end of the file
5149
Local variables:
5250
mode: sgml

‎reference/pthreads/collectable/isgarbage.xml‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 1f3517218031b663f773061056a873cf2a03f32d Maintainer: yannick Status: ready -->
3+
<!-- EN-Revision: bf92d8bd839301de7c837d20ab1dac6c14f83bbf Maintainer: yannick Status: ready -->
44
<!-- Reviewed: no -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="collectable.isgarbage">
66
<refnamediv>
@@ -14,10 +14,10 @@
1414
<modifier>public</modifier> <type>true</type><methodname>Collectable::isGarbage</methodname>
1515
<void/>
1616
</methodsynopsis>
17-
<para>
17+
<simpara>
1818
Peut être appelé dans <methodname>Pool::collect</methodname>
1919
pour déterminer si cet objet est obsolète.
20-
</para>
20+
</simpara>
2121
</refsect1>
2222

2323
<refsect1 role="parameters">
@@ -27,9 +27,9 @@
2727

2828
<refsect1 role="returnvalues">
2929
&reftitle.returnvalues;
30-
<para>
30+
<simpara>
3131
&return.true.always;
32-
</para>
32+
</simpara>
3333
</refsect1>
3434

3535
<refsect1 role="changelog">

‎reference/pthreads/configure.xml‎

Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,30 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 637c29c81a694e3e9f1d6293bd7af230050e5499 Maintainer: yannick Status: ready -->
3+
<!-- EN-Revision: bf92d8bd839301de7c837d20ab1dac6c14f83bbf Maintainer: yannick Status: ready -->
44
<!-- Reviewed: yes Maintainer: yannick -->
5-
6-
<section xml:id="pthreads.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="pthreads.installation">
76
&reftitle.install;
8-
9-
<para>
10-
Utiliser <option role="configure">--enable-maintainer-zts</option> lors de la
7+
8+
<simpara>
9+
Utiliser <option role="configure">--enable-maintainer-zts</option> lors de la
1110
compilation de PHP.
12-
</para>
13-
14-
<para>
15-
Les utilisateurs Windows doivent inclure <filename>php_pthreads.dll</filename>
11+
</simpara>
12+
13+
<simpara>
14+
Les utilisateurs Windows doivent inclure <filename>php_pthreads.dll</filename>
1615
dans le &php.ini;
17-
</para>
18-
16+
</simpara>
17+
1918
<note>
20-
<para>
19+
<simpara>
2120
Les utilisateurs de Windows doivent également s'assurer que
2221
<filename>pthreadVC2.dll</filename> (inclus dans la distribution)
2322
est présent dans un des dossiers spécifiés dans la variable d'environnement
2423
<envar>PATH</envar>.
25-
</para>
24+
</simpara>
2625
</note>
27-
28-
</section>
29-
3026

27+
</section>
3128
<!-- Keep this comment at the end of the file
3229
Local variables:
3330
mode: sgml

0 commit comments

Comments
 (0)