Skip to content

Commit 3206a01

Browse files
GirgiasGirgias
committed
sem: fix XML by converting para to simpara tags via script
1 parent 0ca8c6a commit 3206a01

21 files changed

Lines changed: 197 additions & 204 deletions

‎reference/sem/book.xml‎

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,27 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: hholzgra Status: ready -->
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: hholzgra Status: ready -->
44
<!-- Reviewed: yes -->
55
<!-- Rev-Revision: 2d99025327523f0f00ce02156664447165307950 Reviewer: samesch -->
6-
7-
<book xml:id="book.sem" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
6+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.sem">
87
<?phpdoc extension-membership="bundled" ?>
98
<title>Semaphore, Shared Memory und IPC</title>
109
<titleabbrev>Semaphore</titleabbrev>
1110

1211
<!-- {{{ preface -->
1312
<preface xml:id="intro.sem">
1413
&reftitle.intro;
15-
<para>
14+
<simpara>
1615
Diese Erweiterungen bieten Schnittstellen zur Nutzung der Unix System V
1716
IPC-Funktionen. Sie unterstützen Semaphore, gemeinsame Speicherbereiche
1817
(Shared Memory) und den Nachrichtenaustausch zwischen Prozessen (Inter
1918
Process Communication - IPC).
20-
</para>
21-
<para>
19+
</simpara>
20+
<simpara>
2221
Semaphore können genutzt werden, um den exklusiven Zugriff auf eine
2322
Ressource zu koordinieren oder um die Anzahl der gleichzeitigen Zugriffe
2423
auf eine Ressource zu limitieren.
25-
</para>
24+
</simpara>
2625
<para>
2726
Diese Erweiterungen bieten auch Funktionen zur Nutzung von gemeinsamen
2827
Speicherbereichen. Der gemeinsamen Speicherbereich kann verwendet werden,
@@ -67,12 +66,12 @@
6766
</tgroup>
6867
</table>
6968
</para>
70-
<para>
69+
<simpara>
7170
Die Funktionen zum Nachrichtenaustausch können genutzt werden, um
7271
Nachrichten an andere Prozesse zu verschicken oder zu empfangen. Sie bieten
7372
einen einfachen und effektiven Weg zum Datenaustausch zwischen Prozessen,
7473
ohne auf Alternativen wie Unix Domain Sockets zurückgreifen zu müssen.
75-
</para>
74+
</simpara>
7675
<note>
7776
<simpara>
7877
Nur die Funktionen für gemeinsam genutzten Speicher und
@@ -93,7 +92,6 @@
9392
&reference.sem.sysvsharedmemory;
9493

9594
</book>
96-
9795
<!-- Keep this comment at the end of the file
9896
Local variables:
9997
mode: sgml

‎reference/sem/configure.xml‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,19 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: hholzgra Status: ready -->
4-
<section xml:id="sem.installation" xmlns="http://docbook.org/ns/docbook">
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: hholzgra Status: ready -->
4+
<section xmlns="http://docbook.org/ns/docbook" xml:id="sem.installation">
55
&reftitle.install;
6-
<para>
6+
<simpara>
77
Die in diesem Abschnitt dokumentierten Funktionen sind in
8-
den Standardeinstellungen nicht aktiviert.
8+
den Standardeinstellungen nicht aktiviert.
99
Unterstützung für System V Semaphore kann durch kompilieren mit der Option
1010
<option role="configure">--enable-sysvsem</option> aktiviert werden.
1111
Unterstützung für System V Shared Memory kann durch kompilieren mit der Option
1212
<option role="configure">--enable-sysvshm</option> aktiviert werden.
1313
Unterstützung für System V Nachrichten kann durch kompilieren mit der Option
1414
<option role="configure">--enable-sysvmsg</option> aktiviert werden.
15-
</para>
15+
</simpara>
1616
</section>
17-
1817
<!-- Keep this comment at the end of the file
1918
Local variables:
2019
mode: sgml
@@ -35,4 +34,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
3534
vim: et tw=78 syn=sgml
3635
vi: ts=1 sw=1
3736
-->
38-

‎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: hholzgra Status: ready -->
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: hholzgra Status: ready -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ftok">
55
<refnamediv>
66
<refname>ftok</refname>
@@ -16,14 +16,14 @@
1616
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
1717
<methodparam><type>string</type><parameter>project_id</parameter></methodparam>
1818
</methodsynopsis>
19-
<para>
19+
<simpara>
2020
Diese Funktion erzeugt aus dem <parameter>filename</parameter> einer
2121
existierenden Datei und dem Projektbezeichner
2222
<parameter>project_id</parameter> einen
2323
<literal>Integer</literal>-Schlüsselwert, der von Funktionen wie
2424
<function>shmop_open</function> und anderen als System-V-IPC-Schlüssel
2525
genutzt werden kann.
26-
</para>
26+
</simpara>
2727
</refsect1>
2828

2929
<refsect1 role="parameters">
@@ -32,28 +32,28 @@
3232
<varlistentry>
3333
<term><parameter>filename</parameter></term>
3434
<listitem>
35-
<para>
35+
<simpara>
3636
Pfad zu einer existierenden Datei.
37-
</para>
37+
</simpara>
3838
</listitem>
3939
</varlistentry>
4040
<varlistentry>
4141
<term><parameter>project_id</parameter></term>
4242
<listitem>
43-
<para>
43+
<simpara>
4444
Einbuchstabige Projekt-ID.
45-
</para>
45+
</simpara>
4646
</listitem>
4747
</varlistentry>
4848
</variablelist>
4949
</refsect1>
5050

5151
<refsect1 role="returnvalues">
5252
&reftitle.returnvalues;
53-
<para>
53+
<simpara>
5454
Bei Erfolg wird der erzeugte Schlüssel zurückgegeben. Im Fehlerfall
5555
ist der Rückgabewert stattdessen <literal>-1</literal>.
56-
</para>
56+
</simpara>
5757
</refsect1>
5858

5959
<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: hholzgra Status: ready -->
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: hholzgra Status: ready -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-get-queue">
55
<refnamediv>
66
<refname>msg_get_queue</refname>
@@ -16,7 +16,7 @@
1616
<methodparam><type>int</type><parameter>key</parameter></methodparam>
1717
<methodparam choice="opt"><type>int</type><parameter>permissions</parameter><initializer>0666</initializer></methodparam>
1818
</methodsynopsis>
19-
<para>
19+
<simpara>
2020
<function>msg_get_queue</function> gibt eine ID zurück, die verwendet
2121
werden kann, um auf die mit <parameter>key</parameter> angegebene
2222
System-V-Nachrichten-Warteschlange zuzugreifen. Existiert die
@@ -26,7 +26,7 @@
2626
<function>msg_get_queue</function> mit dem gleichen
2727
<parameter>key</parameter> liefert eine andere ID, beide IDs greifen aber
2828
intern auf die gleiche Nachrichten-Warteschlange zu.
29-
</para>
29+
</simpara>
3030
</refsect1>
3131

3232
<refsect1 role="parameters">
@@ -35,30 +35,30 @@
3535
<varlistentry>
3636
<term><parameter>key</parameter></term>
3737
<listitem>
38-
<para>
38+
<simpara>
3939
Numerische ID der Nachrichten-Warteschlange.
40-
</para>
40+
</simpara>
4141
</listitem>
4242
</varlistentry>
4343
<varlistentry>
4444
<term><parameter>permissions</parameter></term>
4545
<listitem>
46-
<para>
46+
<simpara>
4747
Zugriffsrechte der Warteschlange. Vorgabewert ist 0666. Existiert die
4848
Nachrichten-Warteschlange bereits, so wird dieser Parameter ignoriert.
49-
</para>
49+
</simpara>
5050
</listitem>
5151
</varlistentry>
5252
</variablelist>
5353
</refsect1>
5454

5555
<refsect1 role="returnvalues">
5656
&reftitle.returnvalues;
57-
<para>
57+
<simpara>
5858
Gibt eine <classname>SysvMessageQueue</classname>-Instanz für den Zugriff
5959
auf eine System-V-Nachrichten-Warteschlange zurück.
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: nobody Status: ready -->
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: nobody 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
Prüft, ob die Nachrichten-Warteschlange <parameter>key</parameter> existiert.
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
Numerische ID der Nachrichten-Warteschlange.
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: nobody Status: ready -->
3+
<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: nobody Status: ready -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.msg-receive">
55
<refnamediv>
66
<refname>msg_receive</refname>
@@ -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> liest die erste Nachricht vom Typ
2525
<parameter>desired_message_type</parameter> aus der durch
2626
<parameter>queue</parameter> angegeben Warteschlange aus.
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
Die Nachrichten-Warteschlange.
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
Wenn <parameter>desired_message_type</parameter> gleich 0 ist, wird die
4646
erste Nachricht aus der Warteschlange zurückgegeben. Wenn
4747
<parameter>desired_message_type</parameter> größer als 0 ist, wird die
@@ -54,53 +54,53 @@
5454
<constant>MSG_IPC_NOWAIT</constant> im Parameter
5555
<parameter>flags</parameter> kann das blockierende Verhalten verhindert
5656
werden.
57-
</para>
57+
</simpara>
5858
</listitem>
5959
</varlistentry>
6060
<varlistentry>
6161
<term><parameter>received_message_type</parameter></term>
6262
<listitem>
63-
<para>
63+
<simpara>
6464
In diesem Parameter wird der Typ der empfangenen Nachricht gespeichert.
65-
</para>
65+
</simpara>
6666
</listitem>
6767
</varlistentry>
6868
<varlistentry>
6969
<term><parameter>max_message_size</parameter></term>
7070
<listitem>
71-
<para>
71+
<simpara>
7272
Die maximale Größe der zu akzeptierenden Nachricht wird durch
7373
<parameter>max_message_size</parameter> angegeben; Wenn die Nachricht
7474
in der Nachrichten-Warteschlange größer ist, als dieser Wert, schlägt
7575
die Funktion fehl (es sei denn, es wird das entsprechende Flag im
7676
Parameter <parameter>flags</parameter> gesetzt).
77-
</para>
77+
</simpara>
7878
</listitem>
7979
</varlistentry>
8080
<varlistentry>
8181
<term><parameter>message</parameter></term>
8282
<listitem>
83-
<para>
83+
<simpara>
8484
Die empfangene Nachricht wird in <parameter>message</parameter>
8585
gespeichert, es sei denn es tritt ein Fehler beim Empfang auf.
86-
</para>
86+
</simpara>
8787
</listitem>
8888
</varlistentry>
8989
<varlistentry>
9090
<term><parameter>unserialize</parameter></term>
9191
<listitem>
92-
<para>
92+
<simpara>
9393
Wenn dieser Wert auf &true; gesetzt wird, wird die Nachricht behandelt,
9494
als wäre sie mit demselben Mechanismus serialisiert worden, wie das
9595
Session-Modul. Die Nachricht wird deserialisiert und zurückgegeben.
9696
Dies erlaubt einen einfachen Empfang von Arrays und komplexen
9797
Objektstrukturen von anderen PHP-Skripten. Wenn Sie den WDDX-Serializer
9898
verwenden, erlaubt es den Empfang von einer WDDX-kompatiblen Quelle.
99-
</para>
100-
<para>
99+
</simpara>
100+
<simpara>
101101
Wenn <parameter>unserialize</parameter> &false; ist, wird die Nachricht
102102
als binärsicherer String zurückgegeben.
103-
</para>
103+
</simpara>
104104
</listitem>
105105
</varlistentry>
106106
<varlistentry>
@@ -153,28 +153,28 @@
153153
<varlistentry>
154154
<term><parameter>error_code</parameter></term>
155155
<listitem>
156-
<para>
156+
<simpara>
157157
Wenn die Funktion fehlschlägt, wird der optionale
158158
<parameter>error_code</parameter> auf den Wert der
159159
System-errno-Variable gesetzt.
160-
</para>
160+
</simpara>
161161
</listitem>
162162
</varlistentry>
163163
</variablelist>
164164
</refsect1>
165165

166166
<refsect1 role="returnvalues">
167167
&reftitle.returnvalues;
168-
<para>
168+
<simpara>
169169
&return.success;
170-
</para>
171-
<para>
170+
</simpara>
171+
<simpara>
172172
Bei erfolgreicher Ausführung wird die Datenstruktur der
173173
Nachrichten-Warteschlange folgendermaßen aktualisiert:
174174
<literal>msg_lrpid</literal> wird auf die Prozess-ID des aufrufenden
175175
Prozesses gesetzt, <literal>msg_qnum</literal> wird um 1 dekrementiert, und
176176
<literal>msg_rtime</literal> wird auf die aktuelle Zeit gesetzt.
177-
</para>
177+
</simpara>
178178
</refsect1>
179179

180180
<refsect1 role="changelog">

0 commit comments

Comments
 (0)