Skip to content

Commit bc4c0e0

Browse files
GirgiasGirgias
committed
parallel : fix XML by converting para to simpara tags via script
1 parent a067602 commit bc4c0e0

6 files changed

Lines changed: 58 additions & 67 deletions

File tree

‎reference/parallel/book.xml‎

Lines changed: 27 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,32 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: bbfa9738785f054752e6cb565cd0a58e71015bc6 Maintainer: mproshchuk Status: ready -->
3-
<book xml:id="book.parallel" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
2+
<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
3+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="book.parallel">
44
<?phpdoc extension-membership="pecl" ?>
55
<title>parallel</title>
66
<titleabbrev>parallel</titleabbrev>
77

88
<preface xml:id="intro.parallel">
99
&reftitle.intro;
10-
<para>
10+
<simpara>
1111
Розширення parallel дозволяє виконувати PHP-код в паралельних потоках.
1212
Воно доступне в PHP ≥ 7.2.0. Для parallel ≥ 1.2.0 потрібна версія PHP ≥ 8.0.0.
13-
</para>
14-
<para>
13+
</simpara>
14+
<simpara>
1515
Це стислий опис загального алгоритму parallel. Більше інформації є в
1616
наступних частинах розділу.
17-
</para>
17+
</simpara>
1818
<simplesect>
1919
<title>Клас Runtime</title>
20-
<para>
20+
<simpara>
2121
Клас <classname>parallel\Runtime</classname> представляє потік
2222
інтерпретатора PHP. Клас <classname>parallel\Runtime</classname>
2323
можна налаштувати за допомогою необов'язкового файлу ініціалізації, який
2424
потрібно передати в метод
2525
<methodname>parallel\Runtime::__construct</methodname>. Зазвичай цей файл є
2626
автозавантажувачем чи чимсь на кшталт процедури попереднього завантаження:
2727
він буде підключатися перед виконанням кожного завдання.
28-
</para>
29-
<para>
28+
</simpara>
29+
<simpara>
3030
Після створення, примірник <classname>parallel\Runtime</classname>
3131
залишається доступним, допоки його не закриють чи знищать відповідно до
3232
правил визначення області видимості об'єктів PHP. Метод
@@ -35,16 +35,16 @@
3535
<classname>parallel\Runtime</classname> послуговується принципом FIFO
3636
(перший прийшов — перший вийшов), тобто завдання виконуються в тій
3737
послідовності, у якій вони були заплановані.
38-
</para>
38+
</simpara>
3939
</simplesect>
4040
<simplesect>
4141
<title>Функціональний API</title>
42-
<para>
42+
<simpara>
4343
parallel реалізує функціональний API вищого рівня поверх
4444
<classname>parallel\Runtime</classname>, надаючи єдину функціональну точку
4545
входу для паралельного виконання коду з автоматичним плануванням — функцію
4646
<function>parallel\run</function>.
47-
</para>
47+
</simpara>
4848
</simplesect>
4949
<simplesect>
5050
<title>Завдання</title>
@@ -55,41 +55,41 @@
5555
вкладені замикання. Проте є інструкції, заборонені в завданнях:
5656
<itemizedlist>
5757
<listitem>
58-
<para>yield</para>
58+
<simpara>yield</simpara>
5959
</listitem>
6060
<listitem>
61-
<para>посилання</para>
61+
<simpara>посилання</simpara>
6262
</listitem>
6363
<listitem>
64-
<para>оголошення класу</para>
64+
<simpara>оголошення класу</simpara>
6565
</listitem>
6666
<listitem>
67-
<para>оголошення функції з назвою</para>
67+
<simpara>оголошення функції з назвою</simpara>
6868
</listitem>
6969
</itemizedlist>
7070
</para>
7171
<note>
72-
<para>
72+
<simpara>
7373
Вкладеним замиканням дозволяється містити інструкції yield або посилання,
7474
але не оголошення класів чи функцій з назвами.
75-
</para>
75+
</simpara>
7676
</note>
7777
<note>
78-
<para>
78+
<simpara>
7979
Скрипти, що підключені в завданнях, жодних обмежень не мають.
80-
</para>
80+
</simpara>
8181
</note>
8282
</simplesect>
8383
<simplesect>
8484
<title>Ф'ючерс</title>
85-
<para>
85+
<simpara>
8686
Клас <classname>parallel\Future</classname> використовується для доступу до
8787
значень, що повертає завдання, і надає API для скасування завдання.
88-
</para>
88+
</simpara>
8989
</simplesect>
9090
<simplesect>
9191
<title>Канал</title>
92-
<para>
92+
<simpara>
9393
Завдання можна можна додати в чергу, вказати йому параметри, використовувати
9494
змінні лексичної області (тобто за значенням), та отримати результат
9595
виконання (через клас <classname>parallel\Future</classname>), таким чином
@@ -99,11 +99,11 @@
9999
<classname>parallel\Channel</classname>, який утворює сокет-подібний зв'язок
100100
між завданнями, який програміст може використовувати для надсилання та
101101
отримання даних.
102-
</para>
102+
</simpara>
103103
</simplesect>
104104
<simplesect>
105105
<title>Події</title>
106-
<para>
106+
<simpara>
107107
API <classname>parallel\Events</classname> реалізує власний цикл подій
108108
(<classname>Traversable</classname>) та метод
109109
<methodname>parallel\Events::poll</methodname>. Це дозволяє програмісту
@@ -115,12 +115,12 @@
115115
об'єкти, коли вони стануть доступні, створюючи примірники
116116
<classname>parallel\Events\Event</classname>, що описують операції, які
117117
відбулися.
118-
</para>
118+
</simpara>
119119
</simplesect>
120120
<simplesect role="seealso">
121121
&reftitle.seealso;
122122
<simplelist>
123-
<member><xref linkend="philosophy.parallel" /></member>
123+
<member><xref linkend="philosophy.parallel"/></member>
124124
</simplelist>
125125
</simplesect>
126126
</preface>
@@ -140,7 +140,6 @@
140140
<!--&reference.parallel.examples;-->
141141

142142
</book>
143-
144143
<!-- Keep this comment at the end of the file
145144
Local variables:
146145
mode: sgml

‎reference/parallel/configure.xml‎

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,19 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 3985f162bcb7f71764c8ea1c637d70303c01847c Maintainer: mproshchuk Status: ready -->
3-
4-
<section xml:id="parallel.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
3+
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel.installation">
54
&reftitle.install;
65

7-
<para>
6+
<simpara>
87
Використовується опція <option role="configure">--with-parallel[=DIR]</option>
98
під час компіляції PHP.
10-
</para>
9+
</simpara>
1110

12-
<para>
11+
<simpara>
1312
Користувачам Windows необхідно підключити
1413
<filename>php_parallel.dll</filename> в файлі &php.ini;
15-
</para>
14+
</simpara>
1615

1716
</section>
18-
19-
2017
<!-- Keep this comment at the end of the file
2118
Local variables:
2219
mode: sgml

‎reference/parallel/functional.xml‎

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,22 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: d9ecfba6ad07e4e0b1b13ed1f0592f09d2e2f5c9 Maintainer: mproshchuk Status: ready -->
3-
4-
<reference xml:id="functional.parallel" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
3+
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="functional.parallel">
54
<title>Функціональний API</title>
65
<partintro>
7-
<para>
6+
<simpara>
87
API <classname>parallel\Runtime</classname> надає широкі можливості керування
98
досвідченому PHP-програмісту і то́му, хто добре знайомий з написанням програм,
109
які використовують паралелізм та конкурентність.
11-
</para>
10+
</simpara>
1211
<para>
1312
А от функціональний API дає менше контролю в обмін на здатність ухвалювати
1413
рішення замість програміста:
1514
<itemizedlist>
1615
<listitem>
17-
<para>усі середовища виконання завантажуються однаково</para>
16+
<simpara>усі середовища виконання завантажуються однаково</simpara>
1817
</listitem>
1918
<listitem>
20-
<para>планування здійснює API, а не програміст</para>
19+
<simpara>планування здійснює API, а не програміст</simpara>
2120
</listitem>
2221
</itemizedlist>
2322
Функція <function>parallel\run</function> гарантує, що завдання почне
@@ -30,7 +29,6 @@
3029
&reference.parallel.functions.parallel.bootstrap;
3130
&reference.parallel.functions.parallel.run;
3231
</reference>
33-
3432
<!-- Keep this comment at the end of the file
3533
Local variables:
3634
mode: sgml

‎reference/parallel/parallel/input/add.xml‎

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 5d927c376e2d53433ff435eea53e546b51d9834b Maintainer: mproshchuk Status: ready -->
3-
<refentry xml:id="parallel-events-input.add" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel-events-input.add">
44
<refnamediv>
55
<refname>parallel\Events\Input::add</refname>
66
<refpurpose>Вхідні дані</refpurpose>
@@ -13,29 +13,28 @@
1313
<methodparam><type>string</type><parameter>target</parameter></methodparam>
1414
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
Задає вхідні дані для обраної цілі.
18-
</para>
18+
</simpara>
1919
</refsect1>
2020

2121
<refsect1 role="exceptions">
2222
<title>Виключення</title>
2323
<warning>
24-
<para>
24+
<simpara>
2525
Кидає <type>parallel\Events\Input\Error\Existence</type>, якщо вхідні дані
2626
для цілі вже задано.
27-
</para>
27+
</simpara>
2828
</warning>
2929
<warning>
30-
<para>
30+
<simpara>
3131
Кидає <type>parallel\Events\Input\Error\IllegalValue</type>, якщо значення
3232
неправильне (&object;, &null;).
33-
</para>
33+
</simpara>
3434
</warning>
3535
</refsect1>
3636

3737
</refentry>
38-
3938
<!-- Keep this comment at the end of the file
4039
Local variables:
4140
mode: sgml

‎reference/parallel/parallel/input/clear.xml‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: d9ecfba6ad07e4e0b1b13ed1f0592f09d2e2f5c9 Maintainer: mproshchuk Status: ready -->
3-
<refentry xml:id="parallel-events-input.clear" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel-events-input.clear">
44
<refnamediv>
55
<refname>parallel\Events\Input::clear</refname>
66
<refpurpose>Вхідні дані</refpurpose>
@@ -10,15 +10,14 @@
1010
&reftitle.description;
1111
<methodsynopsis>
1212
<modifier>public</modifier> <type>void</type><methodname>parallel\Events\Input::clear</methodname>
13-
<void />
13+
<void/>
1414
</methodsynopsis>
15-
<para>
15+
<simpara>
1616
Вилучає вхідні дані з усіх цілей.
17-
</para>
17+
</simpara>
1818
</refsect1>
1919

2020
</refentry>
21-
2221
<!-- Keep this comment at the end of the file
2322
Local variables:
2423
mode: sgml

‎reference/parallel/parallel/input/remove.xml‎

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 52bf027d4cb01fee7d4e33095d3c5ecd6f76fff1 Maintainer: mproshchuk Status: ready -->
3-
<refentry xml:id="parallel-events-input.remove" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel-events-input.remove">
44
<refnamediv>
55
<refname>parallel\Events\Input::remove</refname>
66
<refpurpose>Вхідні дані</refpurpose>
@@ -12,23 +12,22 @@
1212
<modifier>public</modifier> <type>void</type><methodname>parallel\Events\Input::remove</methodname>
1313
<methodparam><type>string</type><parameter>target</parameter></methodparam>
1414
</methodsynopsis>
15-
<para>
15+
<simpara>
1616
Вилучає вхідні дані з обраної цілі.
17-
</para>
17+
</simpara>
1818
</refsect1>
1919

2020
<refsect1 role="exceptions">
2121
<title>Виключення</title>
2222
<warning>
23-
<para>
23+
<simpara>
2424
Кидає <type>parallel\Events\Input\Error\Existence</type>, якщо вхідні дані
2525
для цілі не задано.
26-
</para>
26+
</simpara>
2727
</warning>
2828
</refsect1>
2929

3030
</refentry>
31-
3231
<!-- Keep this comment at the end of the file
3332
Local variables:
3433
mode: sgml

0 commit comments

Comments
 (0)