parallel : fix XML by converting para to simpara tags via script

2026-03-23 22:52:14 +01:00 · 2026-01-19 03:29:25 +00:00
parent a067602095
commit bc4c0e0d8f
6 changed files with 58 additions and 67 deletions
--- a/reference/parallel/book.xml
+++ b/reference/parallel/book.xml
@@ -1,23 +1,23 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: bbfa9738785f054752e6cb565cd0a58e71015bc6 Maintainer: mproshchuk Status: ready -->
-<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">
+<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
+<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">
 <?phpdoc extension-membership="pecl" ?>
 <title>parallel</title>
 <titleabbrev>parallel</titleabbrev>

 <preface xml:id="intro.parallel">
  &reftitle.intro;
-  <para>
+  <simpara>
  Розширення parallel дозволяє виконувати PHP-код в паралельних потоках.
  Воно доступне в PHP ≥ 7.2.0. Для parallel ≥ 1.2.0 потрібна версія PHP ≥ 8.0.0.
-  </para>
-  <para>
+  </simpara>
+  <simpara>
   Це стислий опис загального алгоритму parallel. Більше інформації є в
   наступних частинах розділу.
-  </para>
+  </simpara>
  <simplesect>
   <title>Клас Runtime</title>
-   <para>
+   <simpara>
    Клас <classname>parallel\Runtime</classname> представляє потік
    інтерпретатора PHP. Клас <classname>parallel\Runtime</classname>
    можна налаштувати за допомогою необов'язкового файлу ініціалізації, який
@@ -25,8 +25,8 @@
    <methodname>parallel\Runtime::__construct</methodname>. Зазвичай цей файл є
    автозавантажувачем чи чимсь на кшталт процедури попереднього завантаження:
    він буде підключатися перед виконанням кожного завдання.
-   </para>
-   <para>
+   </simpara>
+   <simpara>
    Після створення, примірник <classname>parallel\Runtime</classname>
    залишається доступним, допоки його не закриють чи знищать відповідно до
    правил визначення області видимості об'єктів PHP. Метод
@@ -35,16 +35,16 @@
    <classname>parallel\Runtime</classname> послуговується принципом FIFO
    (перший прийшов — перший вийшов), тобто завдання виконуються в тій
    послідовності, у якій вони були заплановані.
-   </para>
+   </simpara>
  </simplesect>
  <simplesect>
   <title>Функціональний API</title>
-   <para>
+   <simpara>
    parallel реалізує функціональний API вищого рівня поверх
    <classname>parallel\Runtime</classname>, надаючи єдину функціональну точку
    входу для паралельного виконання коду з автоматичним плануванням — функцію
    <function>parallel\run</function>.
-   </para>
+   </simpara>
  </simplesect>
  <simplesect>
   <title>Завдання</title>
@@ -55,41 +55,41 @@
    вкладені замикання. Проте є інструкції, заборонені в завданнях:
    <itemizedlist>
     <listitem>
-     <para>yield</para>
+     <simpara>yield</simpara>
     </listitem>
     <listitem>
-     <para>посилання</para>
+     <simpara>посилання</simpara>
     </listitem>
     <listitem>
-     <para>оголошення класу</para>
+     <simpara>оголошення класу</simpara>
     </listitem>
     <listitem>
-     <para>оголошення функції з назвою</para>
+     <simpara>оголошення функції з назвою</simpara>
     </listitem>
    </itemizedlist>
   </para>
   <note>
-    <para>
+    <simpara>
     Вкладеним замиканням дозволяється містити інструкції yield або посилання,
     але не оголошення класів чи функцій з назвами.
-    </para>
+    </simpara>
   </note>
   <note>
-    <para>
+    <simpara>
     Скрипти, що підключені в завданнях, жодних обмежень не мають.
-    </para>
+    </simpara>
   </note>
  </simplesect>
  <simplesect>
   <title>Ф'ючерс</title>
-   <para>
+   <simpara>
    Клас <classname>parallel\Future</classname> використовується для доступу до
    значень, що повертає завдання, і надає API для скасування завдання.
-   </para>
+   </simpara>
  </simplesect>
  <simplesect>
   <title>Канал</title>
-   <para>
+   <simpara>
    Завдання можна можна додати в чергу, вказати йому параметри, використовувати
    змінні лексичної області (тобто за значенням), та отримати результат
    виконання (через клас <classname>parallel\Future</classname>), таким чином
@@ -99,11 +99,11 @@
    <classname>parallel\Channel</classname>, який утворює сокет-подібний зв'язок
    між завданнями, який програміст може використовувати для надсилання та
    отримання даних.
-   </para>
+   </simpara>
  </simplesect>
  <simplesect>
   <title>Події</title>
-   <para>
+   <simpara>
    API <classname>parallel\Events</classname> реалізує власний цикл подій
    (<classname>Traversable</classname>) та метод
    <methodname>parallel\Events::poll</methodname>. Це дозволяє програмісту
@@ -115,12 +115,12 @@
    об'єкти, коли вони стануть доступні, створюючи примірники
    <classname>parallel\Events\Event</classname>, що описують операції, які
    відбулися.
-   </para>
+   </simpara>
  </simplesect>
   <simplesect role="seealso">
   &reftitle.seealso;
   <simplelist>
-    <member><xref linkend="philosophy.parallel" /></member>
+    <member><xref linkend="philosophy.parallel"/></member>
   </simplelist>
  </simplesect>
 </preface>
@@ -140,7 +140,6 @@
 <!--&reference.parallel.examples;-->

 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/parallel/configure.xml
+++ b/reference/parallel/configure.xml
@@ -1,22 +1,19 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3985f162bcb7f71764c8ea1c637d70303c01847c Maintainer: mproshchuk Status: ready -->
-
-<section xml:id="parallel.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
+<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel.installation">
 &reftitle.install;

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

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

 </section>
-
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/parallel/functional.xml
+++ b/reference/parallel/functional.xml
@@ -1,23 +1,22 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d9ecfba6ad07e4e0b1b13ed1f0592f09d2e2f5c9 Maintainer: mproshchuk Status: ready -->
-
-<reference xml:id="functional.parallel" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
+<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="functional.parallel">
 <title>Функціональний API</title>
 <partintro>
-  <para>
+  <simpara>
   API <classname>parallel\Runtime</classname> надає широкі можливості керування
   досвідченому PHP-програмісту і то́му, хто добре знайомий з написанням програм,
   які використовують паралелізм та конкурентність.
-  </para>
+  </simpara>
  <para>
   А от функціональний API дає менше контролю в обмін на здатність ухвалювати
   рішення замість програміста:
   <itemizedlist>
    <listitem>
-    <para>усі середовища виконання завантажуються однаково</para>
+    <simpara>усі середовища виконання завантажуються однаково</simpara>
    </listitem>
    <listitem>
-    <para>планування здійснює API, а не програміст</para>
+    <simpara>планування здійснює API, а не програміст</simpara>
    </listitem>
   </itemizedlist>
   Функція <function>parallel\run</function> гарантує, що завдання почне
@@ -30,7 +29,6 @@
 &reference.parallel.functions.parallel.bootstrap;
 &reference.parallel.functions.parallel.run;
 </reference>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/parallel/parallel/input/add.xml
+++ b/reference/parallel/parallel/input/add.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5d927c376e2d53433ff435eea53e546b51d9834b Maintainer: mproshchuk Status: ready -->
-<refentry xml:id="parallel-events-input.add" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel-events-input.add">
 <refnamediv>
  <refname>parallel\Events\Input::add</refname>
  <refpurpose>Вхідні дані</refpurpose>
@@ -13,29 +13,28 @@
   <methodparam><type>string</type><parameter>target</parameter></methodparam>
   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
  </methodsynopsis>
-  <para>
+  <simpara>
    Задає вхідні дані для обраної цілі.
-  </para>
+  </simpara>
 </refsect1>

 <refsect1 role="exceptions">
  <title>Виключення</title>
  <warning>
-   <para>
+   <simpara>
    Кидає <type>parallel\Events\Input\Error\Existence</type>, якщо вхідні дані
    для цілі вже задано.
-   </para>
+   </simpara>
  </warning>
  <warning>
-   <para>
+   <simpara>
    Кидає <type>parallel\Events\Input\Error\IllegalValue</type>, якщо значення
    неправильне (&object;, &null;).
-   </para>
+   </simpara>
  </warning>
 </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/parallel/parallel/input/clear.xml
+++ b/reference/parallel/parallel/input/clear.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d9ecfba6ad07e4e0b1b13ed1f0592f09d2e2f5c9 Maintainer: mproshchuk Status: ready -->
-<refentry xml:id="parallel-events-input.clear" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel-events-input.clear">
 <refnamediv>
  <refname>parallel\Events\Input::clear</refname>
  <refpurpose>Вхідні дані</refpurpose>
@@ -10,15 +10,14 @@
  &reftitle.description;
  <methodsynopsis>
   <modifier>public</modifier> <type>void</type><methodname>parallel\Events\Input::clear</methodname>
-   <void />
+   <void/>
  </methodsynopsis>
-  <para>
+  <simpara>
    Вилучає вхідні дані з усіх цілей.
-  </para>
+  </simpara>
 </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/parallel/parallel/input/remove.xml
+++ b/reference/parallel/parallel/input/remove.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 52bf027d4cb01fee7d4e33095d3c5ecd6f76fff1 Maintainer: mproshchuk Status: ready -->
-<refentry xml:id="parallel-events-input.remove" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: mproshchuk Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel-events-input.remove">
 <refnamediv>
  <refname>parallel\Events\Input::remove</refname>
  <refpurpose>Вхідні дані</refpurpose>
@@ -12,23 +12,22 @@
   <modifier>public</modifier> <type>void</type><methodname>parallel\Events\Input::remove</methodname>
   <methodparam><type>string</type><parameter>target</parameter></methodparam>
  </methodsynopsis>
-  <para>
+  <simpara>
    Вилучає вхідні дані з обраної цілі.
-  </para>
+  </simpara>
 </refsect1>

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

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml