Skip to content

Commit 1e9b0be

Browse files
GirgiasGirgias
committed
sem: fix XML by converting para to simpara tags via script
1 parent f0b6b6b commit 1e9b0be

26 files changed

Lines changed: 247 additions & 246 deletions

‎reference/sem/book.xml‎

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,23 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
3-
4-
<book xml:id="book.sem" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: leonardolara Status: ready -->
3+
<!-- CREDITS: leonardolara -->
4+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.sem">
55
<?phpdoc extension-membership="bundled" ?>
66
<title>Semáforos, Memória Compartilhada e Comunicação entre Processos</title>
77
<titleabbrev>Semaphore</titleabbrev>
88

99
<!-- {{{ preface -->
1010
<preface xml:id="intro.sem">
1111
&reftitle.intro;
12-
<para>
12+
<simpara>
1313
Esses módulos fornecem encapsulamento para a família de funções IPC do System V.
1414
Inclui semáforos, memória compartilhada e mensagens entre processos (IPC).
15-
</para>
16-
<para>
15+
</simpara>
16+
<simpara>
1717
Semáforos podem ser usados ​​para fornecer acesso exclusivo a
1818
recursos na máquina atual ou para limitar o número de
1919
processos que podem usar um recurso simultaneamente.
20-
</para>
20+
</simpara>
2121
<para>
2222
Este módulo também fornece funções de memória compartilhada usando a memória
2323
compartilhada do System V. A memória compartilhada pode ser usada para fornecer acesso a
@@ -54,12 +54,12 @@
5454
</tgroup>
5555
</table>
5656
</para>
57-
<para>
57+
<simpara>
5858
As funções de mensagens podem ser usadas para enviar e receber mensagens de/para
5959
outros processos. Elas fornecem um meio simples e eficaz de trocar
6060
dados entre processos, sem a necessidade de configurar uma alternativa
6161
usando soquetes de domínio Unix.
62-
</para>
62+
</simpara>
6363
<note>
6464
<simpara>
6565
Somente as funções de memória compartilhada e <function>ftok</function> estão disponíveis
@@ -79,7 +79,6 @@
7979
&reference.sem.sysvsharedmemory;
8080

8181
</book>
82-
8382
<!-- Keep this comment at the end of the file
8483
Local variables:
8584
mode: sgml
@@ -100,4 +99,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
10099
vim: et tw=78 syn=sgml
101100
vi: ts=1 sw=1
102101
-->
103-

‎reference/sem/configure.xml‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
3-
<section xml:id="sem.installation" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: leonardolara Status: ready -->
3+
<!-- CREDITS: leonardolara -->
4+
<section xmlns="http://docbook.org/ns/docbook" xml:id="sem.installation">
45
&reftitle.install;
5-
<para>
6+
<simpara>
67
O suporte para essas funções não está habilitado por padrão.
78
Para habilitar o suporte a semáforos do System V, compile o PHP com a opção
89
<option role="configure">--enable-sysvsem</option>.
910
Para habilitar o suporte a memória compartilhada do System V, compile o PHP com a opção
1011
<option role="configure">--enable-sysvshm</option>.
1112
Para habilitar o suporte a mensagens do System V, compile o PHP com a opção
1213
<option role="configure">--enable-sysvmsg</option>.
13-
</para>
14+
</simpara>
1415
</section>
15-
1616
<!-- Keep this comment at the end of the file
1717
Local variables:
1818
mode: sgml
@@ -33,4 +33,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
3333
vim: et tw=78 syn=sgml
3434
vi: ts=1 sw=1
3535
-->
36-

‎reference/sem/functions/ftok.xml‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 9f2874ae15e66f4d828e8a4e7965cf03e4ed4ef7 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: leonardolara Status: ready -->
33
<!-- CREDITS: leonardolara -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ftok">
55
<refnamediv>
@@ -14,12 +14,12 @@
1414
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
1515
<methodparam><type>string</type><parameter>project_id</parameter></methodparam>
1616
</methodsynopsis>
17-
<para>
17+
<simpara>
1818
A função converte o <parameter>filename</parameter> de um arquivo acessível existente
1919
e um identificador de projeto em um
2020
<literal>integer</literal> para uso com, por exemplo,
2121
<function>shmop_open</function> e outras chaves IPC do System V.
22-
</para>
22+
</simpara>
2323
</refsect1>
2424

2525
<refsect1 role="parameters">
@@ -28,28 +28,28 @@
2828
<varlistentry>
2929
<term><parameter>filename</parameter></term>
3030
<listitem>
31-
<para>
31+
<simpara>
3232
Caminho para um arquivo acessível.
33-
</para>
33+
</simpara>
3434
</listitem>
3535
</varlistentry>
3636
<varlistentry>
3737
<term><parameter>project_id</parameter></term>
3838
<listitem>
39-
<para>
39+
<simpara>
4040
Identificador do projeto. Deve ser uma string de um caractere.
41-
</para>
41+
</simpara>
4242
</listitem>
4343
</varlistentry>
4444
</variablelist>
4545
</refsect1>
4646

4747
<refsect1 role="returnvalues">
4848
&reftitle.returnvalues;
49-
<para>
49+
<simpara>
5050
Em caso de sucesso, o valor de retorno será o valor da chave criada; caso contrário,
5151
<literal>-1</literal> será retornado.
52-
</para>
52+
</simpara>
5353
</refsect1>
5454

5555
<refsect1 role="seealso">

‎reference/sem/functions/msg-get-queue.xml‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 9f2874ae15e66f4d828e8a4e7965cf03e4ed4ef7 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: leonardolara Status: ready -->
33
<!-- CREDITS: leonardolara -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-get-queue">
55
<refnamediv>
@@ -14,7 +14,7 @@
1414
<methodparam><type>int</type><parameter>key</parameter></methodparam>
1515
<methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
1616
</methodsynopsis>
17-
<para>
17+
<simpara>
1818
<function>msg_get_queue</function> retorna um ID que pode ser usado para
1919
acessar a fila de mensagens do System V com a
2020
chave <parameter>key</parameter> fornecida. A primeira chamada cria a fila de mensagens com
@@ -23,7 +23,7 @@
2323
<parameter>key</parameter> retornará um identificador de fila de mensagens
2424
diferente, mas ambos os identificadores acessam a mesma fila de mensagens
2525
subjacente.
26-
</para>
26+
</simpara>
2727
</refsect1>
2828

2929
<refsect1 role="parameters">
@@ -32,29 +32,29 @@
3232
<varlistentry>
3333
<term><parameter>key</parameter></term>
3434
<listitem>
35-
<para>
35+
<simpara>
3636
ID numérico da fila de mensagens
37-
</para>
37+
</simpara>
3838
</listitem>
3939
</varlistentry>
4040
<varlistentry>
4141
<term><parameter>permissions</parameter></term>
4242
<listitem>
43-
<para>
43+
<simpara>
4444
Permissões da fila. O padrão é 0666. Se a fila de mensagens já
4545
existir, o parâmetro <parameter>permissions</parameter> será ignorado.
46-
</para>
46+
</simpara>
4747
</listitem>
4848
</varlistentry>
4949
</variablelist>
5050
</refsect1>
5151

5252
<refsect1 role="returnvalues">
5353
&reftitle.returnvalues;
54-
<para>
54+
<simpara>
5555
Retorna a instância de <classname>SysvMessageQueue</classname> que pode ser usada para acessar a fila de mensagens do System V,
5656
&return.falseforfailure;.
57-
</para>
57+
</simpara>
5858
</refsect1>
5959

6060
<refsect1 role="changelog">

‎reference/sem/functions/msg-queue-exists.xml‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 9f2874ae15e66f4d828e8a4e7965cf03e4ed4ef7 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: leonardolara Status: ready -->
33
<!-- CREDITS: leonardolara -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-queue-exists">
55
<refnamediv>
@@ -13,9 +13,9 @@
1313
<type>bool</type><methodname>msg_queue_exists</methodname>
1414
<methodparam><type>int</type><parameter>key</parameter></methodparam>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
Verifica se a fila de mensagens <parameter>key</parameter> existe.
18-
</para>
18+
</simpara>
1919
</refsect1>
2020

2121
<refsect1 role="parameters">
@@ -24,19 +24,19 @@
2424
<varlistentry>
2525
<term><parameter>key</parameter></term>
2626
<listitem>
27-
<para>
27+
<simpara>
2828
Chave da fila.
29-
</para>
29+
</simpara>
3030
</listitem>
3131
</varlistentry>
3232
</variablelist>
3333
</refsect1>
3434

3535
<refsect1 role="returnvalues">
3636
&reftitle.returnvalues;
37-
<para>
37+
<simpara>
3838
&return.success;
39-
</para>
39+
</simpara>
4040
</refsect1>
4141

4242
<refsect1 role="seealso">

‎reference/sem/functions/msg-receive.xml‎

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 9f2874ae15e66f4d828e8a4e7965cf03e4ed4ef7 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: leonardolara Status: ready -->
33
<!-- CREDITS: leonardolara -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-receive">
55
<refnamediv>
@@ -20,11 +20,11 @@
2020
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
2121
<methodparam choice="opt"><type>int</type><parameter role="reference">error_code</parameter><initializer>&null;</initializer></methodparam>
2222
</methodsynopsis>
23-
<para>
23+
<simpara>
2424
<function>msg_receive</function> receberá a primeira mensagem da
2525
fila <parameter>queue</parameter> especificada, do tipo especificado por
2626
<parameter>desired_message_type</parameter>.
27-
</para>
27+
</simpara>
2828
</refsect1>
2929

3030
<refsect1 role="parameters">
@@ -33,15 +33,15 @@
3333
<varlistentry>
3434
<term><parameter>queue</parameter></term>
3535
<listitem>
36-
<para>
36+
<simpara>
3737
A fila de mensagens.
38-
</para>
38+
</simpara>
3939
</listitem>
4040
</varlistentry>
4141
<varlistentry>
4242
<term><parameter>desired_message_type</parameter></term>
4343
<listitem>
44-
<para>
44+
<simpara>
4545
Se <parameter>desired_message_type</parameter> for 0, a mensagem do início
4646
da fila será retornada. Se <parameter>desired_message_type</parameter> for
4747
maior que 0, a primeira mensagem desse tipo será retornada.
@@ -52,53 +52,53 @@
5252
mensagem adequada chegue à fila. Pode-se impedir que o script bloqueie
5353
especificando <constant>MSG_IPC_NOWAIT</constant> no
5454
parâmetro <parameter>flags</parameter>.
55-
</para>
55+
</simpara>
5656
</listitem>
5757
</varlistentry>
5858
<varlistentry>
5959
<term><parameter>received_message_type</parameter></term>
6060
<listitem>
61-
<para>
61+
<simpara>
6262
O tipo de mensagem recebida será armazenado neste
6363
parâmetro.
64-
</para>
64+
</simpara>
6565
</listitem>
6666
</varlistentry>
6767
<varlistentry>
6868
<term><parameter>max_message_size</parameter></term>
6969
<listitem>
70-
<para>
70+
<simpara>
7171
O tamanho máximo da mensagem a ser aceita é especificado pelo
7272
<parameter>max_message_size</parameter>; se a mensagem na fila for maior
7373
que esse tamanho, a função falhará (a menos que se defina
7474
<parameter>flags</parameter> conforme descrito abaixo).
75-
</para>
75+
</simpara>
7676
</listitem>
7777
</varlistentry>
7878
<varlistentry>
7979
<term><parameter>message</parameter></term>
8080
<listitem>
81-
<para>
81+
<simpara>
8282
A mensagem recebida será armazenada em <parameter>message</parameter>,
8383
a menos que tenham ocorridos erros no recebimento da mensagem.
84-
</para>
84+
</simpara>
8585
</listitem>
8686
</varlistentry>
8787
<varlistentry>
8888
<term><parameter>unserialize</parameter></term>
8989
<listitem>
90-
<para>
90+
<simpara>
9191
Se definido como
9292
&true;, a mensagem será tratada como se tivesse sido serializada usando o
9393
mesmo mecanismo do módulo de sessão. A mensagem será desserializada
9494
e então retornada ao script. Isso permite que se receba facilmente
9595
arrays ou estruturas de objetos complexas de outros scripts PHP, ou se
9696
estiver sendo usado o serializador WDDX, de qualquer fonte compatível com WDDX.
97-
</para>
98-
<para>
97+
</simpara>
98+
<simpara>
9999
Se <parameter>unserialize</parameter> for &false;, a mensagem será
100100
retornada como uma string binária segura.
101-
</para>
101+
</simpara>
102102
</listitem>
103103
</varlistentry>
104104
<varlistentry>
@@ -144,26 +144,26 @@
144144
<varlistentry>
145145
<term><parameter>error_code</parameter></term>
146146
<listitem>
147-
<para>
147+
<simpara>
148148
Se a função falhar, o parâmetro opcional <parameter>error_code</parameter>
149149
será definido como o valor da variável "errno" do sistema.
150-
</para>
150+
</simpara>
151151
</listitem>
152152
</varlistentry>
153153
</variablelist>
154154
</refsect1>
155155

156156
<refsect1 role="returnvalues">
157157
&reftitle.returnvalues;
158-
<para>
158+
<simpara>
159159
&return.success;
160-
</para>
161-
<para>
160+
</simpara>
161+
<simpara>
162162
Após a conclusão bem-sucedida, a estrutura de dados da fila de mensagens é atualizada
163163
da seguinte forma: <literal>msg_lrpid</literal> é definido como o ID do
164164
processo do processo chamador, <literal>msg_qnum</literal> é decrementado em 1 e
165165
<literal>msg_rtime</literal> é definido como a hora atual.
166-
</para>
166+
</simpara>
167167
</refsect1>
168168

169169
<refsect1 role="changelog">

0 commit comments

Comments
 (0)