Skip to content

Commit ad9ad61

Browse files
GirgiasGirgias
committed
luasandbox: fix XML to remove useless wrapping para tags via script
1 parent 935b5c8 commit ad9ad61

21 files changed

+360
-443
lines changed

‎reference/luasandbox/differences.xml‎

Lines changed: 85 additions & 94 deletions
Original file line numberDiff line numberDiff line change
@@ -1,113 +1,104 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 990521c9ca64fe7d83016a613b850177d3a90776 Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
4-
<chapter xml:id="reference.luasandbox.differences" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<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>
66
<para>
77
LuaSandbox fournit un environnement sécurisé qui diffère de certaines manières de Lua 5.1 standard.
88
</para>
99

1010
<simplesect xml:id="reference.luasandbox.differences.unavailable">
1111
<title>Fonctionnalités non disponibles</title>
12-
<para>
13-
<itemizedlist>
14-
<listitem>
15-
<para>
16-
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.
17-
</para>
18-
</listitem>
19-
<listitem>
20-
<para>
21-
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.
22-
</para>
23-
</listitem>
24-
<listitem>
25-
<para>
26-
<literal>load()</literal> et <literal>loadstring()</literal>, pour permettre l'analyse statique du code Lua.
27-
</para>
28-
</listitem>
29-
<listitem>
30-
<para>
31-
<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.
32-
</para>
33-
</listitem>
34-
<listitem>
35-
<para>
36-
La plupart du package <literal>os</literal>, car il permet la manipulation du processus et l'exécution d'autres processus.
37-
</para>
38-
<para>
39-
<itemizedlist>
40-
<listitem>
41-
<para>
42-
<literal>os.clock()</literal>, <literal>os.date()</literal>, <literal>os.difftime()</literal>, et <literal>os.time()</literal> reste disponibles.
43-
</para>
44-
</listitem>
45-
</itemizedlist>
46-
</para>
47-
</listitem>
48-
<listitem>
49-
<para>
50-
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.
51-
</para>
52-
<para>
53-
<itemizedlist>
54-
<listitem>
55-
<para>
56-
<literal>debug.traceback()</literal> reste disponibles.
57-
</para>
58-
</listitem>
59-
</itemizedlist>
60-
</para>
61-
</listitem>
62-
<listitem>
63-
<para>
64-
<literal>string.dump()</literal>, car il peut exposer des données internes.
65-
</para>
66-
</listitem>
67-
<listitem>
68-
<para>
69-
Le package <literal>collectgarbage()</literal>, <literal>gcinfo()</literal>, et <literal>coroutine</literal> n'ont pas été examinés pour la sécurité.
70-
</para>
71-
</listitem>
72-
</itemizedlist>
73-
</para>
12+
<itemizedlist>
13+
<listitem>
14+
<para>
15+
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>
17+
</listitem>
18+
<listitem>
19+
<para>
20+
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>
22+
</listitem>
23+
<listitem>
24+
<para>
25+
<literal>load()</literal> et <literal>loadstring()</literal>, pour permettre l'analyse statique du code Lua.
26+
</para>
27+
</listitem>
28+
<listitem>
29+
<para>
30+
<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>
32+
</listitem>
33+
<listitem>
34+
<para>
35+
La plupart du package <literal>os</literal>, car il permet la manipulation du processus et l'exécution d'autres processus.
36+
</para>
37+
<itemizedlist>
38+
<listitem>
39+
<para>
40+
<literal>os.clock()</literal>, <literal>os.date()</literal>, <literal>os.difftime()</literal>, et <literal>os.time()</literal> reste disponibles.
41+
</para>
42+
</listitem>
43+
</itemizedlist>
44+
</listitem>
45+
<listitem>
46+
<para>
47+
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>
49+
<itemizedlist>
50+
<listitem>
51+
<para>
52+
<literal>debug.traceback()</literal> reste disponibles.
53+
</para>
54+
</listitem>
55+
</itemizedlist>
56+
</listitem>
57+
<listitem>
58+
<para>
59+
<literal>string.dump()</literal>, car il peut exposer des données internes.
60+
</para>
61+
</listitem>
62+
<listitem>
63+
<para>
64+
Le package <literal>collectgarbage()</literal>, <literal>gcinfo()</literal>, et <literal>coroutine</literal> n'ont pas été examinés pour la sécurité.
65+
</para>
66+
</listitem>
67+
</itemizedlist>
7468
</simplesect>
7569

7670
<simplesect xml:id="reference.luasandbox.differences.modified">
7771
<title>Features that have been modified</title>
78-
<para>
79-
<itemizedlist>
80-
<listitem>
81-
<para>
82-
<literal>pcall()</literal> et <literal>xpcall()</literal> ne peuvent pas attraper certaines erreurs, en particulier les erreurs de délai d'attente.
83-
</para>
84-
</listitem>
85-
<listitem>
86-
<para>
87-
<literal>tostring()</literal> n'inclut pas les adresses de pointeur.
88-
</para>
89-
</listitem>
90-
<listitem>
91-
<para>
92-
<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.
93-
</para>
94-
</listitem>
95-
<listitem>
96-
<para>
97-
<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.
98-
</para>
99-
</listitem>
100-
<listitem>
101-
<para>
102-
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>.
103-
</para>
104-
</listitem>
105-
</itemizedlist>
106-
</para>
72+
<itemizedlist>
73+
<listitem>
74+
<para>
75+
<literal>pcall()</literal> et <literal>xpcall()</literal> ne peuvent pas attraper certaines erreurs, en particulier les erreurs de délai d'attente.
76+
</para>
77+
</listitem>
78+
<listitem>
79+
<para>
80+
<literal>tostring()</literal> n'inclut pas les adresses de pointeur.
81+
</para>
82+
</listitem>
83+
<listitem>
84+
<para>
85+
<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>
87+
</listitem>
88+
<listitem>
89+
<para>
90+
<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>
92+
</listitem>
93+
<listitem>
94+
<para>
95+
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>
97+
</listitem>
98+
</itemizedlist>
10799
</simplesect>
108100

109101
</chapter>
110-
111102
<!-- Keep this comment at the end of the file
112103
Local variables:
113104
mode: sgml

‎reference/luasandbox/examples.xml‎

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 990521c9ca64fe7d83016a613b850177d3a90776 Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
4-
<chapter xml:id="luasandbox.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<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 -->
@@ -10,10 +10,9 @@
1010
<para>
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.
1212
</para>
13-
<para>
14-
<example>
15-
<title>Excuter du code Lua</title>
16-
<programlisting role="php" xml:id="luasandbox.examples.uniqueidhere">
13+
<example>
14+
<title>Excuter du code Lua</title>
15+
<programlisting role="php" xml:id="luasandbox.examples.uniqueidhere">
1716
<![CDATA[
1817
<?php
1918
@@ -58,13 +57,11 @@ assert( $message === 'Something is wrong' );
5857
5958
?>
6059
]]>
61-
</programlisting>
62-
</example>
63-
</para>
60+
</programlisting>
61+
</example>
6462
</section>
6563

6664
</chapter>
67-
6865
<!-- Keep this comment at the end of the file
6966
Local variables:
7067
mode: sgml

‎reference/luasandbox/luasandbox/callfunction.xml‎

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
4-
<refentry xml:id="luasandbox.callfunction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.callfunction">
55
<refnamediv>
66
<refname>LuaSandbox::callFunction</refname>
77
<refpurpose>Appelle une fonction dans une variable globale Lua</refpurpose>
@@ -62,10 +62,9 @@
6262

6363
<refsect1 role="examples">
6464
&reftitle.examples;
65-
<para>
66-
<example>
67-
<title>Appel d'une fonction Lua</title>
68-
<programlisting role="php">
65+
<example>
66+
<title>Appel d'une fonction Lua</title>
67+
<programlisting role="php">
6968
<![CDATA[
7069
<?php
7170
@@ -77,13 +76,11 @@ $captures = $sandbox->callFunction( 'string.match', $string, $pattern );
7776
7877
?>
7978
]]>
80-
</programlisting>
81-
</example>
82-
</para>
79+
</programlisting>
80+
</example>
8381
</refsect1>
8482

8583
</refentry>
86-
8784
<!-- Keep this comment at the end of the file
8885
Local variables:
8986
mode: sgml

‎reference/luasandbox/luasandbox/disableprofiler.xml‎

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 990521c9ca64fe7d83016a613b850177d3a90776 Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
4-
<refentry xml:id="luasandbox.disableprofiler" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.disableprofiler">
55
<refnamediv>
66
<refname>LuaSandbox::disableProfiler</refname>
77
<refpurpose>Désactive le profileur</refpurpose>
@@ -11,7 +11,7 @@
1111
&reftitle.description;
1212
<methodsynopsis>
1313
<modifier>public</modifier> <type>void</type><methodname>LuaSandbox::disableProfiler</methodname>
14-
<void />
14+
<void/>
1515
</methodsynopsis>
1616
<para>
1717
Désactive le profileur.
@@ -33,16 +33,13 @@
3333

3434
<refsect1 role="seealso">
3535
&reftitle.seealso;
36-
<para>
37-
<simplelist>
38-
<member><methodname>LuaSandbox::enableProfiler</methodname></member>
39-
<member><methodname>LuaSandbox::getProfilerFunctionReport</methodname></member>
40-
</simplelist>
41-
</para>
36+
<simplelist>
37+
<member><methodname>LuaSandbox::enableProfiler</methodname></member>
38+
<member><methodname>LuaSandbox::getProfilerFunctionReport</methodname></member>
39+
</simplelist>
4240
</refsect1>
4341

4442
</refentry>
45-
4643
<!-- Keep this comment at the end of the file
4744
Local variables:
4845
mode: sgml

‎reference/luasandbox/luasandbox/enableprofiler.xml‎

Lines changed: 6 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: 990521c9ca64fe7d83016a613b850177d3a90776 Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
4-
<refentry xml:id="luasandbox.enableprofiler" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.enableprofiler">
55
<refnamediv>
66
<refname>LuaSandbox::enableProfiler</refname>
77
<refpurpose>Active le profileur</refpurpose>
@@ -48,16 +48,13 @@
4848

4949
<refsect1 role="seealso">
5050
&reftitle.seealso;
51-
<para>
52-
<simplelist>
53-
<member><methodname>LuaSandbox::disableProfiler</methodname></member>
54-
<member><methodname>LuaSandbox::getProfilerFunctionReport</methodname></member>
55-
</simplelist>
56-
</para>
51+
<simplelist>
52+
<member><methodname>LuaSandbox::disableProfiler</methodname></member>
53+
<member><methodname>LuaSandbox::getProfilerFunctionReport</methodname></member>
54+
</simplelist>
5755
</refsect1>
5856

5957
</refentry>
60-
6158
<!-- Keep this comment at the end of the file
6259
Local variables:
6360
mode: sgml

‎reference/luasandbox/luasandbox/getcpuusage.xml‎

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 990521c9ca64fe7d83016a613b850177d3a90776 Maintainer: Fan2Shrek Status: ready -->
2+
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: Fan2Shrek Status: ready -->
33
<!-- Reviewed: yes -->
4-
<refentry xml:id="luasandbox.getcpuusage" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.getcpuusage">
55
<refnamediv>
66
<refname>LuaSandbox::getCPUUsage</refname>
77
<refpurpose>Récupère l'utilisation actuelle du temps CPU de l'environnement Lua</refpurpose>
@@ -11,7 +11,7 @@
1111
&reftitle.description;
1212
<methodsynopsis>
1313
<modifier>public</modifier> <type>float</type><methodname>LuaSandbox::getCPUUsage</methodname>
14-
<void />
14+
<void/>
1515
</methodsynopsis>
1616
<para>
1717
Récupère l'utilisation actuelle du temps CPU de l'environnement Lua.
@@ -44,17 +44,14 @@
4444

4545
<refsect1 role="seealso">
4646
&reftitle.seealso;
47-
<para>
48-
<simplelist>
49-
<member><methodname>LuaSandbox::getMemoryUsage</methodname></member>
50-
<member><methodname>LuaSandbox::getPeakMemoryUsage</methodname></member>
51-
<member><methodname>LuaSandbox::setCPULimit</methodname></member>
52-
</simplelist>
53-
</para>
47+
<simplelist>
48+
<member><methodname>LuaSandbox::getMemoryUsage</methodname></member>
49+
<member><methodname>LuaSandbox::getPeakMemoryUsage</methodname></member>
50+
<member><methodname>LuaSandbox::setCPULimit</methodname></member>
51+
</simplelist>
5452
</refsect1>
5553

5654
</refentry>
57-
5855
<!-- Keep this comment at the end of the file
5956
Local variables:
6057
mode: sgml

0 commit comments

Comments
 (0)