Skip to content

Commit fa5a553

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

44 files changed

Lines changed: 454 additions & 528 deletions

Some content is hidden

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

‎reference/parallel/book.xml‎

Lines changed: 28 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,38 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: bbfa9738785f054752e6cb565cd0a58e71015bc6 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
3-
4-
<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: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<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">
55
<?phpdoc extension-membership="pecl" ?>
66
<title>parallel</title>
77
<titleabbrev>parallel</titleabbrev>
88

99
<preface xml:id="intro.parallel">
1010
&reftitle.intro;
11-
<para>
11+
<simpara>
1212
parallel é uma extensão de simultaneidade paralela para PHP ≥ 7.2.0.
1313
A partir do parallel 1.2.0, PHP ≥ 8.0.0 é necessário.
14-
</para>
15-
<para>
14+
</simpara>
15+
<simpara>
1616
Segue uma breve descrição dos conceitos básicos do parallel; informações mais detalhadas podem ser encontradas nesta seção do manual.
17-
</para>
17+
</simpara>
1818
<simplesect>
1919
<title>Runtime</title>
20-
<para>
20+
<simpara>
2121
Um <classname>parallel\Runtime</classname> representa um thread interpretador de PHP. Um <classname>parallel\Runtime</classname> é configurado com um arquivo de bootstrap opcional passado para <methodname>parallel\Runtime::__construct</methodname>, normalmente é um autoloader
2222
ou alguma outra rotina de pré-carregamento: O arquivo de bootstrap irá ser incluído antes de qualquer tarefa ser executada.
23-
</para>
24-
<para>
23+
</simpara>
24+
<simpara>
2525
Após a construção, o <classname>parallel\Runtime</classname> permanece disponível até ser fechado, eliminado ou destruído pelas regras normais de escopo dos objetos PHP.
2626
<methodname>parallel\Runtime::run</methodname> permite ao programador agendar tarefas para execução em paralelo.
2727
Um <classname>parallel\Runtime</classname> possui um agendamento FIFO, as tarefas serão executadas na ordem em que foram agendadas.
28-
</para>
28+
</simpara>
2929
</simplesect>
3030
<simplesect>
3131
<title>API funcional</title>
32-
<para>
32+
<simpara>
3333
parallel implementa uma API funcional de nível superior sobre <classname>parallel\Runtime</classname> que fornece um único ponto de entrada de função para executar código paralelo
3434
com agendamento automático: <function>parallel\run</function>.
35-
</para>
35+
</simpara>
3636
</simplesect>
3737
<simplesect>
3838
<title>Task</title>
@@ -41,58 +41,58 @@
4141
Porém, existem algumas instruções que são proibidas nas tarefas:
4242
<itemizedlist>
4343
<listitem>
44-
<para>yield</para>
44+
<simpara>yield</simpara>
4545
</listitem>
4646
<listitem>
47-
<para>operador 'use' por referência</para>
47+
<simpara>operador 'use' por referência</simpara>
4848
</listitem>
4949
<listitem>
50-
<para>declaração de classe</para>
50+
<simpara>declaração de classe</simpara>
5151
</listitem>
5252
<listitem>
53-
<para>declaração de função com nome</para>
53+
<simpara>declaração de função com nome</simpara>
5454
</listitem>
5555
</itemizedlist>
5656
</para>
5757
<note>
58-
<para>
58+
<simpara>
5959
Closures aninhados podem ter 'use' por referência ou 'yield', mas não devem conter declarações de classe ou de função nomeada.
60-
</para>
60+
</simpara>
6161
</note>
6262
<note>
63-
<para>
63+
<simpara>
6464
Nenhuma instrução é proibida nos arquivos que a tarefa pode incluir.
65-
</para>
65+
</simpara>
6666
</note>
6767
</simplesect>
6868
<simplesect>
6969
<title>Future</title>
70-
<para>
70+
<simpara>
7171
<classname>parallel\Future</classname> é usado para acessar o valor de retorno da tarefa e expõe uma API para cancelamento da tarefa.
72-
</para>
72+
</simpara>
7373
</simplesect>
7474
<simplesect>
7575
<title>Channel</title>
76-
<para>
76+
<simpara>
7777
Uma tarefa pode ser agendada com argumentos, usar variáveis de escopo léxico (por valor) e retornar um valor (através de um <classname>parallel\Future</classname>), mas estes só permitem comunicação unidirecional:
7878
Eles permitem que o programador envie e recupere dados de uma tarefa, mas não permitem a comunicação bidirecional entre tarefas.
7979
A API <classname>parallel\Channel</classname> permite a comunicação bidirecional entre tarefas, um <classname>parallel\Channel</classname> é uma conexão entre tarefas semelhante a um soquete que o programador pode usar para enviar e receber dados.
80-
</para>
80+
</simpara>
8181
</simplesect>
8282
<simplesect>
8383
<title>Events</title>
84-
<para>
84+
<simpara>
8585
A API <classname>parallel\Events</classname> implementa um loop de eventos de sensação nativa (<classname>Traversable</classname>) e um método <methodname>parallel\Events::poll</methodname>.
8686
Permite ao programador trabalhar com conjuntos de channels e/ou futures.
8787
O programador simplesmente adiciona channels e futures ao loop de eventos, opcionalmente definindo a entrada para gravações com <methodname>parallel\Events::setInput</methodname>,
8888
e entra em um foreach: parallel irá ler e escrever em objetos à medida que eles se tornam disponíveis produzindo objetos <classname>parallel\Events\Event</classname>
8989
que descrevem as operações que ocorreram.
90-
</para>
90+
</simpara>
9191
</simplesect>
9292
<simplesect role="seealso">
9393
&reftitle.seealso;
9494
<simplelist>
95-
<member><xref linkend="philosophy.parallel" /></member>
95+
<member><xref linkend="philosophy.parallel"/></member>
9696
</simplelist>
9797
</simplesect>
9898
</preface>
@@ -112,7 +112,6 @@
112112
<!--&reference.parallel.examples;-->
113113

114114
</book>
115-
116115
<!-- Keep this comment at the end of the file
117116
Local variables:
118117
mode: sgml

‎reference/parallel/configure.xml‎

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,18 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 3985f162bcb7f71764c8ea1c637d70303c01847c Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
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: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel.installation">
55
&reftitle.install;
66

7-
<para>
7+
<simpara>
88
Use <option role="configure">--with-parallel[=DIR]</option> ao compilar o PHP.
9-
</para>
9+
</simpara>
1010

11-
<para>
11+
<simpara>
1212
Os usuários do Windows devem incluir <filename>php_parallel.dll</filename> no &php.ini;
13-
</para>
13+
</simpara>
1414

1515
</section>
16-
17-
1816
<!-- Keep this comment at the end of the file
1917
Local variables:
2018
mode: sgml

‎reference/parallel/functional.xml‎

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: d9ecfba6ad07e4e0b1b13ed1f0592f09d2e2f5c9 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
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: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="functional.parallel">
55
<title>API funcional</title>
66
<partintro>
7-
<para>
7+
<simpara>
88
A API <classname>parallel\Runtime</classname> fornece um grande grau de controle para o programador PHP avançado e para aqueles intimamente familiarizados com a escrita de aplicativos que usam
99
simultaneidade paralela.
10-
</para>
10+
</simpara>
1111
<para>
1212
A API funcional fornece menos controle em troca da capacidade de tomar decisões para o programador:
1313
<itemizedlist>
1414
<listitem>
15-
<para>todos os tempos de execução em execução são inicializados de forma idêntica</para>
15+
<simpara>todos os tempos de execução em execução são inicializados de forma idêntica</simpara>
1616
</listitem>
1717
<listitem>
18-
<para>o agendamento é determinado pela API, não pelo programador</para>
18+
<simpara>o agendamento é determinado pela API, não pelo programador</simpara>
1919
</listitem>
2020
</itemizedlist>
2121
<function>parallel\run</function> fornece a garantia de que a tarefa começará a ser executada em paralelo assim que permitido pelas restrições de hardware e sistema operacional, sem
@@ -26,7 +26,6 @@
2626
&reference.parallel.functions.parallel.bootstrap;
2727
&reference.parallel.functions.parallel.run;
2828
</reference>
29-
3029
<!-- Keep this comment at the end of the file
3130
Local variables:
3231
mode: sgml

‎reference/parallel/functions/parallel.bootstrap.xml‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 1efc90bacb2ebf840f5416bd11c8daf8c9345e33 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 57c7669a1f5336cb17413e0b46540c52c77ee84f Maintainer: leonardolara Status: ready -->
33
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="parallel.bootstrap">
44
<refnamediv>
55
<refname>parallel\bootstrap</refname>
@@ -12,9 +12,9 @@
1212
<type>void</type><methodname>parallel\bootstrap</methodname>
1313
<methodparam><type>string</type><parameter>file</parameter></methodparam>
1414
</methodsynopsis>
15-
<para>
15+
<simpara>
1616
Usa o arquivo informado em <parameter>file</parameter> para inicializar todas as variáveis em tempo de execução criadas para agendamento automático via <function>parallel\run</function>.
17-
</para>
17+
</simpara>
1818
</refsect1>
1919

2020
<refsect1 role="parameters">
@@ -23,32 +23,32 @@
2323
<varlistentry>
2424
<term><parameter>file</parameter></term>
2525
<listitem>
26-
<para>
26+
<simpara>
2727
Caminho para o arquivo para inicializar todas as variáveis.
28-
</para>
28+
</simpara>
2929
</listitem>
3030
</varlistentry>
3131
</variablelist>
3232
</refsect1>
3333

3434
<refsect1 role="returnvalues">
3535
&reftitle.returnvalues;
36-
<para>
36+
<simpara>
3737
&return.void;
38-
</para>
38+
</simpara>
3939
</refsect1>
4040

4141
<refsect1 role="errors">
4242
&reftitle.errors;
4343
<warning>
44-
<para>
44+
<simpara>
4545
Lança uma exceção <type>parallel\Runtime\Error\Bootstrap</type> se o método já tiver sido chamado para este processo.
46-
</para>
46+
</simpara>
4747
</warning>
4848
<warning>
49-
<para>
49+
<simpara>
5050
Lança uma exceção <type>parallel\Runtime\Error\Bootstrap</type> se chamado após <function>parallel\run</function>.
51-
</para>
51+
</simpara>
5252
</warning>
5353
</refsect1>
5454

‎reference/parallel/functions/parallel.run.xml‎

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 41445b3d771660805270f52adf0e421aa20f12ab Maintainer: leonardolara Status: ready -->
3-
4-
<refentry xml:id="parallel.run" 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: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="parallel.run">
54
<refnamediv>
65
<refname>parallel\run</refname>
76
<refpurpose>Execução</refpurpose>
@@ -13,44 +12,44 @@
1312
<type class="union"><type>Future</type><type>null</type></type><methodname>parallel\run</methodname>
1413
<methodparam><type>Closure</type><parameter>task</parameter></methodparam>
1514
</methodsynopsis>
16-
<para>
15+
<simpara>
1716
Agenda a tarefa informada em <parameter>task</parameter> para execução em paralelo.
18-
</para>
17+
</simpara>
1918
<methodsynopsis>
2019
<type class="union"><type>Future</type><type>null</type></type><methodname>parallel\run</methodname>
2120
<methodparam><type>Closure</type><parameter>task</parameter></methodparam>
2221
<methodparam><type>array</type><parameter>argv</parameter></methodparam>
2322
</methodsynopsis>
24-
<para>
23+
<simpara>
2524
Agenda a tarefa informada em <parameter>task</parameter> para execução em paralelo, passando os argumentos <parameter>argv</parameter> no momento da execução.
26-
</para>
25+
</simpara>
2726
</refsect1>
2827

2928
<refsect1 role="scheduling-characteristics">
3029
<title>Agendamento Automático</title>
31-
<para>
30+
<simpara>
3231
Se um <classname>\parallel\Runtime</classname> criado internamente e armazenado em cache por uma chamada anterior a <function>parallel\run</function> estiver ocioso,
3332
ele será usado para executar a tarefa. Se nenhum <classname>\parallel\Runtime</classname> estiver ocioso, o parallel criará e armazenará em cache um
3433
<classname>\parallel\Runtime</classname>.
35-
</para>
34+
</simpara>
3635
<note>
37-
<para>
36+
<simpara>
3837
Objetos <classname>\parallel\Runtime</classname> criados pelo programador não são usados ​​para agendamento automático.
39-
</para>
38+
</simpara>
4039
</note>
4140
</refsect1>
4241

43-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='parameters'])" />
44-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='closure-characteristics'])" />
45-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='argv-characteristics'])" />
46-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='object-characteristics'])" />
47-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='returnvalues'])" />
48-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='exceptions'])" />
42+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='parameters'])"/>
43+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='closure-characteristics'])"/>
44+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='argv-characteristics'])"/>
45+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='object-characteristics'])"/>
46+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='returnvalues'])"/>
47+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('parallel-runtime.run')/db:refsect1[@role='exceptions'])"/>
4948

5049
<refsect1 role="seealso">
5150
&reftitle.seealso;
5251
<simplelist>
53-
<member><xref linkend="parallel-runtime.run" /></member>
52+
<member><xref linkend="parallel-runtime.run"/></member>
5453
</simplelist>
5554
</refsect1>
5655

0 commit comments

Comments
 (0)