Skip to content

Commit ca75bb5

Browse files
GirgiasGirgias
committed
luasandbox : fix XML by converting para to simpara tags via script
1 parent ad9ad61 commit ca75bb5

33 files changed

+325
-338
lines changed

‎reference/luasandbox/book.xml‎

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,46 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
4-
<book xml:id="book.luasandbox" 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.luasandbox">
55
<?phpdoc extension-membership="pecl" ?>
66
<title>LuaSandbox</title>
77
<titleabbrev>LuaSandbox</titleabbrev>
88

99
<preface xml:id="intro.luasandbox">
1010
&reftitle.intro;
11-
<para>
11+
<simpara>
1212
LuaSandbox est une extension pour PHP 7 et PHP 8 permettant d'exécuter
1313
en toute sécurité du code Lua 5.1 non fiable depuis PHP.
14-
</para>
14+
</simpara>
1515
<para>
1616
Les différences par rapport à l'extension <link linkend="book.lua">Lua</link> :
1717
<itemizedlist>
1818
<listitem>
19-
<para>
19+
<simpara>
2020
LuaSandbox a un support pour les limites de temps et de mémoire.
21-
</para>
21+
</simpara>
2222
</listitem>
2323
<listitem>
24-
<para>
24+
<simpara>
2525
LuaSandbox fournit un environnement par défaut sécurisé pour l'exécution de code non fiable.
2626
Les fonctions Lua standard ont été examinées pour la sécurité, et plusieurs ont été corrigées en
2727
conséquence.
28-
</para>
28+
</simpara>
2929
</listitem>
3030
<listitem>
31-
<para>
31+
<simpara>
3232
LuaSandbox a une interface PHP plus complexe, précise et puissante,
3333
mais elle est moins pratique pour les développeurs.
34-
</para>
34+
</simpara>
3535
</listitem>
3636
<listitem>
37-
<para>
37+
<simpara>
3838
LuaSandbox ne supporte que Lua 5.1. Il est difficile de changer cela, car
3939
LuaSandbox utilise des bibliothèques standard Lua fortement modifiées, et
4040
en raison du manque de compatibilité ascendante entre les principales versions de Lua.
4141
LuaSandbox vise à maximiser la compatibilité ascendante avec les scripts fournis
4242
par l'utilisateur.
43-
</para>
43+
</simpara>
4444
</listitem>
4545
</itemizedlist>
4646
</para>
@@ -63,7 +63,6 @@
6363
&reference.luasandbox.luasandboxtimeouterror;
6464

6565
</book>
66-
6766
<!-- Keep this comment at the end of the file
6867
Local variables:
6968
mode: sgml

‎reference/luasandbox/configure.xml‎

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,15 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 990521c9ca64fe7d83016a613b850177d3a90776 Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
4-
<section xml:id="luasandbox.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.installation">
55
&reftitle.install;
66

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

1212
</section>
13-
14-
1513
<!-- Keep this comment at the end of the file
1614
Local variables:
1715
mode: sgml

‎reference/luasandbox/differences.xml‎

Lines changed: 33 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,68 +1,68 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
44
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="reference.luasandbox.differences">
55
<title>Différences avec Lua standard</title>
6-
<para>
6+
<simpara>
77
LuaSandbox fournit un environnement sécurisé qui diffère de certaines manières de Lua 5.1 standard.
8-
</para>
8+
</simpara>
99

1010
<simplesect xml:id="reference.luasandbox.differences.unavailable">
1111
<title>Fonctionnalités non disponibles</title>
1212
<itemizedlist>
1313
<listitem>
14-
<para>
14+
<simpara>
1515
Les packages <literal>dofile()</literal>, <literal>loadfile()</literal>, et <literal>io</literal>, car ils permettent un accès direct au système de fichiers. Si nécessaire, l'accès au système de fichiers doit être effectué via des fonctions de rappels PHP.
16-
</para>
16+
</simpara>
1717
</listitem>
1818
<listitem>
19-
<para>
19+
<simpara>
2020
Le package <literal>package</literal>, y compris <literal>require()</literal> et <literal>module()</literal>, car il dépend fortement de l'accès direct au système de fichiers. Une réécriture pure Lua telle que celle utilisée dans l'extension MediaWiki Scribunto peut être utilisée à la place.
21-
</para>
21+
</simpara>
2222
</listitem>
2323
<listitem>
24-
<para>
24+
<simpara>
2525
<literal>load()</literal> et <literal>loadstring()</literal>, pour permettre l'analyse statique du code Lua.
26-
</para>
26+
</simpara>
2727
</listitem>
2828
<listitem>
29-
<para>
29+
<simpara>
3030
<literal>print()</literal>, depuis qu'il écrit sur la sortie standard. Si nécessaire, la sortie doit être effectuée via des fonction de rappels PHP.
31-
</para>
31+
</simpara>
3232
</listitem>
3333
<listitem>
34-
<para>
34+
<simpara>
3535
La plupart du package <literal>os</literal>, car il permet la manipulation du processus et l'exécution d'autres processus.
36-
</para>
36+
</simpara>
3737
<itemizedlist>
3838
<listitem>
39-
<para>
39+
<simpara>
4040
<literal>os.clock()</literal>, <literal>os.date()</literal>, <literal>os.difftime()</literal>, et <literal>os.time()</literal> reste disponibles.
41-
</para>
41+
</simpara>
4242
</listitem>
4343
</itemizedlist>
4444
</listitem>
4545
<listitem>
46-
<para>
46+
<simpara>
4747
La plupart du package <literal>debug</literal>, car il permet la manipulation de l'état Lua et des métadonnées de manière à pouvoir casser l'isolation.
48-
</para>
48+
</simpara>
4949
<itemizedlist>
5050
<listitem>
51-
<para>
51+
<simpara>
5252
<literal>debug.traceback()</literal> reste disponibles.
53-
</para>
53+
</simpara>
5454
</listitem>
5555
</itemizedlist>
5656
</listitem>
5757
<listitem>
58-
<para>
58+
<simpara>
5959
<literal>string.dump()</literal>, car il peut exposer des données internes.
60-
</para>
60+
</simpara>
6161
</listitem>
6262
<listitem>
63-
<para>
63+
<simpara>
6464
Le package <literal>collectgarbage()</literal>, <literal>gcinfo()</literal>, et <literal>coroutine</literal> n'ont pas été examinés pour la sécurité.
65-
</para>
65+
</simpara>
6666
</listitem>
6767
</itemizedlist>
6868
</simplesect>
@@ -71,29 +71,29 @@
7171
<title>Features that have been modified</title>
7272
<itemizedlist>
7373
<listitem>
74-
<para>
74+
<simpara>
7575
<literal>pcall()</literal> et <literal>xpcall()</literal> ne peuvent pas attraper certaines erreurs, en particulier les erreurs de délai d'attente.
76-
</para>
76+
</simpara>
7777
</listitem>
7878
<listitem>
79-
<para>
79+
<simpara>
8080
<literal>tostring()</literal> n'inclut pas les adresses de pointeur.
81-
</para>
81+
</simpara>
8282
</listitem>
8383
<listitem>
84-
<para>
84+
<simpara>
8585
<literal>string.match()</literal> a été patché pour limiter la profondeur de récursion et pour vérifier périodiquement un délai d'attente.
86-
</para>
86+
</simpara>
8787
</listitem>
8888
<listitem>
89-
<para>
89+
<simpara>
9090
<literal>math.random()</literal> et <literal>math.randomseed()</literal> sont remplacés par des versions qui ne partagent pas l'état avec <literal>rand()</literal> de PHP.
91-
</para>
91+
</simpara>
9292
</listitem>
9393
<listitem>
94-
<para>
94+
<simpara>
9595
Les méta méthodes de Lua 5.2 <literal>__pairs</literal> et <literal>__ipairs</literal> sont supportées par <literal>pairs()</literal> et <literal>ipairs()</literal>.
96-
</para>
96+
</simpara>
9797
</listitem>
9898
</itemizedlist>
9999
</simplesect>

‎reference/luasandbox/examples.xml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
44
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.examples">
55
&reftitle.examples;
66
<!-- Add one or more of these <section>'s, with one ore more <example>'s -->
77
<!-- Make sure each xml:id is unique -->
88
<section xml:id="luasandbox.examples-basic">
99
<title>Utilisation de base de LuaSandbox</title>
10-
<para>
10+
<simpara>
1111
Une fois que vous avez compilé PHP avec le support de LuaSandbox, vous pouvez commencer à utiliser LuaSandbox pour exécuter en toute sécurité du code Lua fourni par l'utilisateur.
12-
</para>
12+
</simpara>
1313
<example>
1414
<title>Excuter du code Lua</title>
1515
<programlisting role="php" xml:id="luasandbox.examples.uniqueidhere">

‎reference/luasandbox/luasandbox.xml‎

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
4-
<reference xml:id="class.luasandbox" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
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.luasandbox" role="class">
55
<title>La classe LuaSandbox</title>
66
<titleabbrev>LuaSandbox</titleabbrev>
77

@@ -10,10 +10,10 @@
1010
<!-- {{{ LuaSandbox intro -->
1111
<section xml:id="luasandbox.intro">
1212
&reftitle.intro;
13-
<para>
13+
<simpara>
1414
La classe LuaSandbox crée un environnement Lua et permet l'exécution de
1515
code Lua.
16-
</para>
16+
</simpara>
1717
</section>
1818
<!-- }}} -->
1919

@@ -52,7 +52,7 @@
5252
</fieldsynopsis>
5353

5454
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
55-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.luasandbox')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
55+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.luasandbox')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
5656
</classsynopsis>
5757
<!-- }}} -->
5858

@@ -66,27 +66,27 @@
6666
<varlistentry xml:id="luasandbox.constants.samples">
6767
<term><constant>LuaSandbox::SAMPLES</constant></term>
6868
<listitem>
69-
<para>
69+
<simpara>
7070
Utilisé avec <methodname>LuaSandbox::getProfilerFunctionReport</methodname> pour retourner les durées en échantillons.
71-
</para>
71+
</simpara>
7272
</listitem>
7373
</varlistentry>
7474

7575
<varlistentry xml:id="luasandbox.constants.seconds">
7676
<term><constant>LuaSandbox::SECONDS</constant></term>
7777
<listitem>
78-
<para>
78+
<simpara>
7979
Utilisé avec <methodname>LuaSandbox::getProfilerFunctionReport</methodname> pour retourner les durées en secondes.
80-
</para>
80+
</simpara>
8181
</listitem>
8282
</varlistentry>
8383

8484
<varlistentry xml:id="luasandbox.constants.percent">
8585
<term><constant>LuaSandbox::PERCENT</constant></term>
8686
<listitem>
87-
<para>
87+
<simpara>
8888
Utilisé avec <methodname>LuaSandbox::getProfilerFunctionReport</methodname> pour retourner les durées en pourcentages du total.
89-
</para>
89+
</simpara>
9090
</listitem>
9191
</varlistentry>
9292

@@ -100,7 +100,6 @@
100100
&reference.luasandbox.entities.luasandbox;
101101

102102
</reference>
103-
104103
<!-- Keep this comment at the end of the file
105104
Local variables:
106105
mode: sgml

‎reference/luasandbox/luasandbox/callfunction.xml‎

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.callfunction">
55
<refnamediv>
@@ -14,21 +14,21 @@
1414
<methodparam><type>string</type><parameter>name</parameter></methodparam>
1515
<methodparam rep="repeat"><type>mixed</type><parameter>args</parameter></methodparam>
1616
</methodsynopsis>
17-
<para>
17+
<simpara>
1818
Appelle une fonction dans une variable globale Lua.
19-
</para>
20-
<para>
19+
</simpara>
20+
<simpara>
2121
Si le nom contient des caractères ".", la fonction est localisée via
2222
des accès récursifs à la table, comme si le nom était une expression Lua.
23-
</para>
24-
<para>
23+
</simpara>
24+
<simpara>
2525
Si la variable n'existe pas, ou n'est pas une fonction, false sera
2626
retourné et un avertissement émis.
27-
</para>
28-
<para>
27+
</simpara>
28+
<simpara>
2929
Pour plus d'informations sur l'appel de fonctions Lua et les valeurs de retour,
3030
voir <methodname>LuaSandboxFunction::call</methodname>.
31-
</para>
31+
</simpara>
3232
</refsect1>
3333

3434
<refsect1 role="parameters">
@@ -37,27 +37,27 @@
3737
<varlistentry>
3838
<term><parameter>name</parameter></term>
3939
<listitem>
40-
<para>
40+
<simpara>
4141
Nom de la variable Lua.
42-
</para>
42+
</simpara>
4343
</listitem>
4444
</varlistentry>
4545
<varlistentry>
4646
<term><parameter>args</parameter></term>
4747
<listitem>
48-
<para>
48+
<simpara>
4949
Arguments de la fonction.
50-
</para>
50+
</simpara>
5151
</listitem>
5252
</varlistentry>
5353
</variablelist>
5454
</refsect1>
5555

5656
<refsect1 role="returnvalues">
5757
&reftitle.returnvalues;
58-
<para>
58+
<simpara>
5959
Renvoie un <type>array</type> des valeurs retournées par la fonction Lua, qui peut être vide, &return.falseforfailure;.
60-
</para>
60+
</simpara>
6161
</refsect1>
6262

6363
<refsect1 role="examples">

0 commit comments

Comments
 (0)