Skip to content

Commit c8edc75

Browse files
GirgiasGirgias
committed
sem: fix XML by converting para to simpara tags via script
1 parent 3708a7b commit c8edc75

26 files changed

Lines changed: 238 additions & 243 deletions

‎reference/sem/book.xml‎

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,24 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: PhilDaiguille Status: ready -->
2+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
33
<!-- Reviewed: yes -->
4-
5-
<book xml:id="book.sem" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.sem">
65
<?phpdoc extension-membership="bundled" ?>
76
<title>Sémaphore, Memoria Compartida e IPC (Comunicación Inter-Proceso)</title>
87
<titleabbrev>Semaphore</titleabbrev>
98

109
<!-- {{{ preface -->
1110
<preface xml:id="intro.sem">
1211
&reftitle.intro;
13-
<para>
12+
<simpara>
1413
Estos módulos proporcionan una interfaz para las funciones de tipo System V IPC.
1514
Esto incluye los semáforos, la memoria compartida y el sistema de
1615
comunicación inter-proceso (IPC).
17-
</para>
18-
<para>
16+
</simpara>
17+
<simpara>
1918
Los semáforos pueden ser utilizados para proporcionar acceso exclusivo
2019
a ciertos recursos de la máquina, o para limitar el
2120
número de procesos que utilizan al mismo tiempo un recurso.
22-
</para>
21+
</simpara>
2322
<para>
2423
Estos módulos proporcionan también un sistema de memoria compartida,
2524
que utiliza la memoria compartida System V.
@@ -64,11 +63,11 @@
6463
</tgroup>
6564
</table>
6665
</para>
67-
<para>
66+
<simpara>
6867
Estas funciones permiten enviar y recibir mensajes de/para otros procesos.
6968
Ofrecen una interfaz simple y eficiente para intercambiar datos entre procesos,
7069
sin necesidad de utilizar otro socket UNIX.
71-
</para>
70+
</simpara>
7271
<note>
7372
<simpara>
7473
Solamente las funciones de memoria compartida y <function>ftok</function>

‎reference/sem/configure.xml‎

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
4-
<section xml:id="sem.installation" xmlns="http://docbook.org/ns/docbook">
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: seros Status: ready -->
4+
<section xmlns="http://docbook.org/ns/docbook" xml:id="sem.installation">
55
&reftitle.install;
6-
<para>
6+
<simpara>
77
Por defecto, el soporte para estas funciones no está disponible.
88
Para habilitar el soporte del semáforo de System V compile PHP con la opción
99
<option role="configure">--enable-sysvsem</option>.
1010
Para habilitar el soporte de la memoria compartida de System V compile PHP con la opción
1111
<option role="configure">--enable-sysvshm</option>.
1212
Para habilitar el soporte de mensajes de System V compile PHP con la opción
1313
<option role="configure">--enable-sysvmsg</option>.
14-
</para>
14+
</simpara>
1515
</section>
16-
1716
<!-- Keep this comment at the end of the file
1817
Local variables:
1918
mode: sgml
@@ -34,4 +33,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
3433
vim: et tw=78 syn=sgml
3534
vi: ts=1 sw=1
3635
-->
37-

‎reference/sem/functions/ftok.xml‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 9f2874ae15e66f4d828e8a4e7965cf03e4ed4ef7 Maintainer: PhilDaiguille Status: ready -->
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
44
<!-- Reviewed: yes -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ftok">
66
<refnamediv>
@@ -15,13 +15,13 @@
1515
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
1616
<methodparam><type>string</type><parameter>project_id</parameter></methodparam>
1717
</methodsynopsis>
18-
<para>
18+
<simpara>
1919
Convierte el argumento <parameter>filename</parameter>
2020
de un fichero existente, y el identificador de proyecto
2121
<parameter>proj</parameter>, en un entero <literal>integer</literal> para ser utilizado
2222
con la función <function>shmop_open</function> y otras funciones
2323
System V IPC.
24-
</para>
24+
</simpara>
2525
</refsect1>
2626

2727
<refsect1 role="parameters">
@@ -30,28 +30,28 @@
3030
<varlistentry>
3131
<term><parameter>filename</parameter></term>
3232
<listitem>
33-
<para>
33+
<simpara>
3434
Ruta hacia un fichero accesible.
35-
</para>
35+
</simpara>
3636
</listitem>
3737
</varlistentry>
3838
<varlistentry>
3939
<term><parameter>project_id</parameter></term>
4040
<listitem>
41-
<para>
41+
<simpara>
4242
Identificador del proyecto. Debe ser un solo carácter.
43-
</para>
43+
</simpara>
4444
</listitem>
4545
</varlistentry>
4646
</variablelist>
4747
</refsect1>
4848

4949
<refsect1 role="returnvalues">
5050
&reftitle.returnvalues;
51-
<para>
51+
<simpara>
5252
En caso de éxito, el valor devuelto será el valor de la clave creada,
5353
de lo contrario, se devolverá <literal>-1</literal>.
54-
</para>
54+
</simpara>
5555
</refsect1>
5656

5757
<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,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 9f2874ae15e66f4d828e8a4e7965cf03e4ed4ef7 Maintainer: PhilDaiguille Status: ready -->
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
44
<!-- Reviewed: yes -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-get-queue">
66
<refnamediv>
@@ -15,15 +15,15 @@
1515
<methodparam><type>int</type><parameter>key</parameter></methodparam>
1616
<methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
1717
</methodsynopsis>
18-
<para>
18+
<simpara>
1919
<function>msg_get_queue</function> devuelve un recurso que puede
2020
ser utilizado con las colas de mensajes System V y la
2121
clave <parameter>key</parameter>. La primera llamada a la función va a crear
2222
la cola de mensajes, con los permisos opcionales de <parameter>permissions</parameter>.
2323
Una segunda llamada a <function>msg_get_queue</function> con
2424
la misma clave <parameter>key</parameter> devolverá otro recurso de cola de mensajes, pero los dos identificadores conducen a
2525
la misma cola de mensajes.
26-
</para>
26+
</simpara>
2727
</refsect1>
2828

2929
<refsect1 role="parameters">
@@ -32,33 +32,33 @@
3232
<varlistentry>
3333
<term><parameter>key</parameter></term>
3434
<listitem>
35-
<para>
35+
<simpara>
3636
Identificador numérico de la cola de mensajes.
37-
</para>
37+
</simpara>
3838
</listitem>
3939
</varlistentry>
4040
<varlistentry>
4141
<term><parameter>permissions</parameter></term>
4242
<listitem>
43-
<para>
43+
<simpara>
4444
Permisos en la cola. Por omisión, vale 0666. Si la cola de
4545
mensajes ya existe, el argumento <parameter>permissions</parameter>
4646
será ignorado.
47-
</para>
47+
</simpara>
4848
</listitem>
4949
</varlistentry>
5050
</variablelist>
5151
</refsect1>
5252

5353
<refsect1 role="returnvalues">
5454
&reftitle.returnvalues;
55-
<para>
55+
<simpara>
5656
Devuelve un recurso que puede ser utilizado para acceder a la cola de
5757
mensajes System V.
5858
Devuelve una instancia de <classname>SysvMessageQueue</classname> que puede
5959
ser utilizada para acceder a la cola de mensajes System V,
6060
&return.falseforfailure;.
61-
</para>
61+
</simpara>
6262
</refsect1>
6363

6464
<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,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 9f2874ae15e66f4d828e8a4e7965cf03e4ed4ef7 Maintainer: seros Status: ready -->
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: seros Status: ready -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-queue-exists">
55
<refnamediv>
66
<refname>msg_queue_exists</refname>
@@ -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 si la clave dada por el parámetro <parameter>key</parameter> de la cola de mensajes 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
La clave de la cola.
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,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 9f2874ae15e66f4d828e8a4e7965cf03e4ed4ef7 Maintainer: PhilDaiguille Status: ready -->
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
44
<!-- Reviewed: yes -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-receive">
66
<refnamediv>
@@ -21,11 +21,11 @@
2121
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
2222
<methodparam choice="opt"><type>int</type><parameter role="reference">error_code</parameter><initializer>&null;</initializer></methodparam>
2323
</methodsynopsis>
24-
<para>
24+
<simpara>
2525
<function>msg_receive</function> recibe el primer mensaje de la
2626
cola <parameter>queue</parameter>, cuyo tipo está especificado por
2727
<parameter>desired_message_type</parameter>.
28-
</para>
28+
</simpara>
2929
</refsect1>
3030

3131
<refsect1 role="parameters">
@@ -34,15 +34,15 @@
3434
<varlistentry>
3535
<term><parameter>queue</parameter></term>
3636
<listitem>
37-
<para>
37+
<simpara>
3838
Descriptor de recurso de cola de mensajes
39-
</para>
39+
</simpara>
4040
</listitem>
4141
</varlistentry>
4242
<varlistentry>
4343
<term><parameter>desired_message_type</parameter></term>
4444
<listitem>
45-
<para>
45+
<simpara>
4646
Si <parameter>desired_message_type</parameter> vale 0, se devuelve el primer mensaje
4747
de la cola. Si <parameter>desired_message_type</parameter> vale
4848
más que 0, entonces se devolverá el primer mensaje de ese tipo.
@@ -53,51 +53,51 @@
5353
de ese tipo a la cola. Este bloqueo puede evitarse especificando la opción
5454
<constant>MSG_IPC_NOWAIT</constant> en el parámetro
5555
<parameter>flags</parameter>.
56-
</para>
56+
</simpara>
5757
</listitem>
5858
</varlistentry>
5959
<varlistentry>
6060
<term><parameter>received_message_type</parameter></term>
6161
<listitem>
62-
<para>
62+
<simpara>
6363
El tipo de mensaje recibido se almacenará en este 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
El tamaño máximo de mensaje se establece mediante
7272
<parameter>max_message_size</parameter>; si el mensaje de la cola es más grande
7373
que este tamaño, la función fallará (a menos que se utilice una opción
7474
<parameter>flags</parameter>, descrita a continuación).
75-
</para>
75+
</simpara>
7676
</listitem>
7777
</varlistentry>
7878
<varlistentry>
7979
<term><parameter>message</parameter></term>
8080
<listitem>
81-
<para>
81+
<simpara>
8282
El mensaje recibido se almacenará en el parámetro <parameter>message</parameter>,
8383
a menos que haya habido errores al recibir el mensaje.
84-
</para>
84+
</simpara>
8585
</listitem>
8686
</varlistentry>
8787
<varlistentry>
8888
<term><parameter>unserialize</parameter></term>
8989
<listitem>
90-
<para>
90+
<simpara>
9191
Cuando esto es cierto, el mensaje se trata como si hubiera sido serializado
9292
con el mismo mecanismo que el módulo de sesión. El mensaje será entonces
9393
deserializado y devuelto al script. Esto permitirá recibir fácilmente
9494
arrays u objetos complejos en su script, enviados por otros scripts PHP,
9595
o, si se utiliza WDDX, desde cualquier fuente compatible con WDDX.
96-
</para>
97-
<para>
96+
</simpara>
97+
<simpara>
9898
Si <parameter>unserialize</parameter> vale &false;,
9999
el mensaje se devolverá intacto, sin modificar los valores binarios.
100-
</para>
100+
</simpara>
101101
</listitem>
102102
</varlistentry>
103103
<varlistentry>
@@ -143,27 +143,27 @@
143143
<varlistentry>
144144
<term><parameter>errorcode</parameter></term>
145145
<listitem>
146-
<para>
146+
<simpara>
147147
Si la función falla, el parámetro opcional
148148
<parameter>error_code</parameter> se establecerá al valor
149149
de la variable del sistema errno.
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
Al recibir un mensaje con éxito, la cola se actualiza
163163
de la siguiente manera: <literal>msg_lrpid</literal> toma el valor del identificador
164164
de proceso del proceso llamante, <literal>msg_qnum</literal> se decrementa en
165165
1 y <literal>msg_rtime</literal> toma la fecha y hora actuales.
166-
</para>
166+
</simpara>
167167
</refsect1>
168168

169169
<refsect1 role="changelog">

0 commit comments

Comments
 (0)