Skip to content

Commit d76d9e4

Browse files
GirgiasGirgias
committed
sync : fix XML by converting para to simpara tags via script
1 parent 3218a79 commit d76d9e4

28 files changed

Lines changed: 295 additions & 322 deletions

‎reference/sync/book.xml‎

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,38 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 4110331afec1fc2bfe27525341a5f96e0804692f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
3-
4-
<book xml:id="book.sync" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: f0edac3006cc81cc9cd06fd21d4f4bdc244e10c9 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.sync">
55
<?phpdoc extension-membership="pecl" ?>
66
<title>Sync</title>
77
<titleabbrev>Sync</titleabbrev>
88

99
<preface xml:id="intro.sync">
1010
&reftitle.intro;
11-
<para>
11+
<simpara>
1212
A extensão <literal>sync</literal> introduz objetos de sincronização multiplataforma no PHP.
1313
Objetos de Mutex, Semaphore, Event, Reader-Writer e Shared Memory nomeados e não nomeados
1414
fornecem sincronização em nível de sistema operacional em plataformas POSIX (por exemplo, Linux)
1515
e Windows.
16-
</para>
17-
<para>
16+
</simpara>
17+
<simpara>
1818
A limpeza automática de objetos de sincronização adquiridos ocorre durante a desmontagem
1919
da extensão. Isso significa que se o PHP encerrar prematuramente um script (por exemplo,
2020
o tempo de execução do script for excedido), os objetos não serão deixados em um estado desconhecido. A
2121
única exceção a isso é se o próprio PHP travar (por exemplo, uma sobrecarga de buffer interna).
22-
</para>
23-
<para>
22+
</simpara>
23+
<simpara>
2424
Objetos de sincronização não nomeados não têm muita utilidade fora de um cenário
2525
multithread. Objetos não nomeados são mais úteis em conjunto com a extensão pthreads
2626
do PECL.
27-
</para>
27+
</simpara>
2828
<note>
29-
<para>
29+
<simpara>
3030
Objetos nomeados requerem cuidados adicionais para serem usados em todos os sistemas.
3131
Se um objeto for instanciado com um conjunto específico de parâmetros, ele sempre deve
3232
ser instanciado com esses parâmetros, caso contrário, o objeto provavelmente acabará em um
3333
estado inconsistente até a próxima reinicialização ou até que um administrador de sistema limpe
3434
a bagunça.
35-
</para>
35+
</simpara>
3636
</note>
3737
</preface>
3838

@@ -44,7 +44,6 @@
4444
&reference.sync.syncsharedmemory;
4545

4646
</book>
47-
4847
<!-- Keep this comment at the end of the file
4948
Local variables:
5049
mode: sgml

‎reference/sync/configure.xml‎

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

7-
<para>
7+
<simpara>
88
&pecl.info;
99
<link xlink:href="&url.pecl.package;sync">&url.pecl.package;sync</link>
10-
</para>
10+
</simpara>
1111

1212
</section>
13-
1413
<!-- Keep this comment at the end of the file
1514
Local variables:
1615
mode: sgml

‎reference/sync/setup.xml‎

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,25 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
3-
4-
<chapter xml:id="sync.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: f0edac3006cc81cc9cd06fd21d4f4bdc244e10c9 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sync.setup">
55
&reftitle.setup;
66

77
<section xml:id="sync.requirements">
88
&reftitle.required;
9-
<para>
9+
<simpara>
1010
Um sistema com suporte para memória compartilhada POSIX (shm_open()) ou executando Windows.
11-
</para>
11+
</simpara>
1212
</section>
1313

1414
<section xml:id="sync.installation">
1515
&reftitle.install;
16-
<para>
16+
<simpara>
1717
&pecl.info;
1818
<link xlink:href="&url.pecl.package;sync">&url.pecl.package;sync</link>.
19-
</para>
19+
</simpara>
2020
</section>
2121

2222
</chapter>
23-
2423
<!-- Keep this comment at the end of the file
2524
Local variables:
2625
mode: sgml

‎reference/sync/syncevent.xml‎

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 8690c4193b8d86dc5494de23db1f80d53ce37adc Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
3-
4-
<reference xml:id="class.syncevent" role="class" 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: f0edac3006cc81cc9cd06fd21d4f4bdc244e10c9 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<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.syncevent" role="class">
55

66
<title>A classe SyncEvent</title>
77
<titleabbrev>SyncEvent</titleabbrev>
@@ -11,17 +11,17 @@
1111
<!-- {{{ SyncEvent intro -->
1212
<section xml:id="syncevent.intro">
1313
&reftitle.intro;
14-
<para>
14+
<simpara>
1515
Uma implementação nativa e multiplataforma de objetos de evento nomeados e não nomeados.
1616
Ambos os objetos de evento automáticos e manuais são suportados.
17-
</para>
18-
<para>
17+
</simpara>
18+
<simpara>
1919
Um objeto de evento espera, sem fazer polling, que o objeto seja acionado/configurado.
2020
Uma instância aguarda o objeto de evento enquanto outra instancia o
2121
aciona/configura. Objetos de evento são úteis onde um processo em execução contínua,
2222
de outra forma, faria polling em um recurso (por exemplo, verificando se dados enviados precisam
2323
ser processados).
24-
</para>
24+
</simpara>
2525
</section>
2626
<!-- }}} -->
2727

@@ -41,7 +41,7 @@
4141
<!-- }}} -->
4242

4343
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
44-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.syncevent')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
44+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.syncevent')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
4545
</classsynopsis>
4646
<!-- }}} -->
4747

@@ -52,7 +52,6 @@
5252
&reference.sync.entities.syncevent;
5353

5454
</reference>
55-
5655
<!-- Keep this comment at the end of the file
5756
Local variables:
5857
mode: sgml

‎reference/sync/syncevent/construct.xml‎

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 0aba4b20cc0b96b2c7672d246a7d93ea2fff8335 Maintainer: fernandowobeto Status: ready -->
2+
<!-- EN-Revision: f0edac3006cc81cc9cd06fd21d4f4bdc244e10c9 Maintainer: fernandowobeto Status: ready -->
33
<!-- CREDITS: fernandowobeto -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="syncevent.construct">
55
<refnamediv>
@@ -15,9 +15,9 @@
1515
<methodparam choice="opt"><type>bool</type><parameter>manual</parameter><initializer>&false;</initializer></methodparam>
1616
<methodparam choice="opt"><type>bool</type><parameter>prefire</parameter><initializer>&false;</initializer></methodparam>
1717
</methodsynopsis>
18-
<para>
18+
<simpara>
1919
Constrói um objeto de evento nomeado ou sem nome.
20-
</para>
20+
</simpara>
2121
</refsect1>
2222

2323
<refsect1 role="parameters">
@@ -26,42 +26,42 @@
2626
<varlistentry>
2727
<term><parameter>name</parameter></term>
2828
<listitem>
29-
<para>
29+
<simpara>
3030
O nome do evento se este for um objeto de evento nomeado.
31-
</para>
31+
</simpara>
3232
<note>
33-
<para>
33+
<simpara>
3434
Se o nome já existir, ele deve poder ser aberto pelo usuário atual que
3535
o processo está executando, caso contrário uma exceção será lançada com uma
3636
mensagem de erro sem sentido.
37-
</para>
37+
</simpara>
3838
</note>
3939
</listitem>
4040
</varlistentry>
4141
<varlistentry>
4242
<term><parameter>manual</parameter></term>
4343
<listitem>
44-
<para>
44+
<simpara>
4545
Especifica se o objeto de evento deve ser redefinido manualmente ou não.
46-
</para>
46+
</simpara>
4747
<note>
48-
<para>
48+
<simpara>
4949
Objetos de evento com redefinição manual permitem que todos os processos em espera passem até que o
5050
objeto seja redefinido.
51-
</para>
51+
</simpara>
5252
</note>
5353
</listitem>
5454
</varlistentry>
5555
<varlistentry>
5656
<term><parameter>prefire</parameter></term>
5757
<listitem>
58-
<para>
58+
<simpara>
5959
Especifica se o objeto de evento deve ser pré-ativado (sinalizado) ou não.
60-
</para>
60+
</simpara>
6161
<note>
62-
<para>
62+
<simpara>
6363
Só tem impacto se o processo/thread chamador for o primeiro a criar o objeto.
64-
</para>
64+
</simpara>
6565
</note>
6666
</listitem>
6767
</varlistentry>
@@ -70,16 +70,16 @@
7070

7171
<refsect1 role="returnvalues">
7272
&reftitle.returnvalues;
73-
<para>
73+
<simpara>
7474
O novo objeto <classname>SyncEvent</classname>.
75-
</para>
75+
</simpara>
7676
</refsect1>
7777

7878
<refsect1 role="errors">
7979
&reftitle.errors;
80-
<para>
80+
<simpara>
8181
Uma exceção é lançada se o objeto de evento não puder ser criado ou aberto.
82-
</para>
82+
</simpara>
8383
</refsect1>
8484

8585
<refsect1 role="examples">
@@ -116,9 +116,9 @@ $event->wait();
116116
<row>
117117
<entry>PECL sync 1.1.0</entry>
118118
<entry>
119-
<para>
119+
<simpara>
120120
Adicionado <parameter>prefire</parameter>.
121-
</para>
121+
</simpara>
122122
</entry>
123123
</row>
124124
</tbody>

‎reference/sync/syncevent/fire.xml‎

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 0da76b0197f60f498c56cc7a57c243b3865ce6b7 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
3-
4-
<refentry xml:id="syncevent.fire" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: f0edac3006cc81cc9cd06fd21d4f4bdc244e10c9 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="syncevent.fire">
55
<refnamediv>
66
<refname>SyncEvent::fire</refname>
77
<refpurpose>Ativa/configura o evento</refpurpose>
@@ -11,12 +11,12 @@
1111
&reftitle.description;
1212
<methodsynopsis>
1313
<modifier>public</modifier> <type>bool</type><methodname>SyncEvent::fire</methodname>
14-
<void />
14+
<void/>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
Ativa/configura um objeto <classname>SyncEvent</classname>. Permite que múltiplos threads que estão esperando passem
1818
se o objeto de evento foi criado com um valor manual de &true;.
19-
</para>
19+
</simpara>
2020
</refsect1>
2121

2222
<refsect1 role="parameters">
@@ -26,9 +26,9 @@
2626

2727
<refsect1 role="returnvalues">
2828
&reftitle.returnvalues;
29-
<para>
29+
<simpara>
3030
&return.success;
31-
</para>
31+
</simpara>
3232
</refsect1>
3333

3434
<refsect1 role="examples">
@@ -60,7 +60,6 @@ $event->wait();
6060
</refsect1>
6161

6262
</refentry>
63-
6463
<!-- Keep this comment at the end of the file
6564
Local variables:
6665
mode: sgml

‎reference/sync/syncevent/reset.xml‎

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 0da76b0197f60f498c56cc7a57c243b3865ce6b7 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
3-
4-
<refentry xml:id="syncevent.reset" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: f0edac3006cc81cc9cd06fd21d4f4bdc244e10c9 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="syncevent.reset">
55
<refnamediv>
66
<refname>SyncEvent::reset</refname>
77
<refpurpose>Redefine um evento manual</refpurpose>
@@ -11,11 +11,11 @@
1111
&reftitle.description;
1212
<methodsynopsis>
1313
<modifier>public</modifier> <type>bool</type><methodname>SyncEvent::reset</methodname>
14-
<void />
14+
<void/>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
Redefine um objeto <classname>SyncEvent</classname> que foi ativado/configurado. Válido apenas para objetos de evento manual.
18-
</para>
18+
</simpara>
1919
</refsect1>
2020

2121
<refsect1 role="parameters">
@@ -25,9 +25,9 @@
2525

2626
<refsect1 role="returnvalues">
2727
&reftitle.returnvalues;
28-
<para>
28+
<simpara>
2929
&return.success;
30-
</para>
30+
</simpara>
3131
</refsect1>
3232

3333
<refsect1 role="examples">
@@ -62,7 +62,6 @@ $event->fire();
6262
</refsect1>
6363

6464
</refentry>
65-
6665
<!-- Keep this comment at the end of the file
6766
Local variables:
6867
mode: sgml

0 commit comments

Comments
 (0)