Skip to content

Commit ac5b7ee

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

33 files changed

Lines changed: 325 additions & 350 deletions

‎reference/luasandbox/book.xml‎

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,45 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: leonardolara Status: ready -->
3-
4-
<book xml:id="book.luasandbox" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: leonardolara Status: ready -->
3+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.luasandbox">
54
<?phpdoc extension-membership="pecl" ?>
65
<title>LuaSandbox</title>
76
<titleabbrev>LuaSandbox</titleabbrev>
87

98
<preface xml:id="intro.luasandbox">
109
&reftitle.intro;
11-
<para>
10+
<simpara>
1211
LuaSandbox é uma extensão para PHP 7 e PHP 8 para permitir a execução
1312
segura de código Lua 5.1 não confiável de dentro do PHP.
14-
</para>
13+
</simpara>
1514
<para>
1615
Diferenças em comparação com a extensão <link linkend="book.lua">Lua</link>:
1716
<itemizedlist>
1817
<listitem>
19-
<para>
18+
<simpara>
2019
O LuaSandbox tem suporte para limites de tempo e memória.
21-
</para>
20+
</simpara>
2221
</listitem>
2322
<listitem>
24-
<para>
23+
<simpara>
2524
LuaSandbox fornece um ambiente seguro padrão para executar código não confiável.
2625
As funções do Lua Stock foram revisadas para segurança, e várias foram corrigidas
2726
de acordo.
28-
</para>
27+
</simpara>
2928
</listitem>
3029
<listitem>
31-
<para>
30+
<simpara>
3231
LuaSandbox tem uma interface PHP que é mais complexa, precisa e poderosa,
3332
mas é menos conveniente para desenvolvedores.
34-
</para>
33+
</simpara>
3534
</listitem>
3635
<listitem>
37-
<para>
36+
<simpara>
3837
LuaSandbox suporta apenas Lua 5.1. É difícil mudar isso, porque
3938
LuaSandbox usa bibliotecas padrão Lua bastante modificadas, e
4039
devido à falta de compatibilidade com versões anteriores entre as principais versões Lua.
4140
LuaSandbox visa maximizar a compatibilidade com versões anteriores com scripts
4241
fornecidos pelo usuário.
43-
</para>
42+
</simpara>
4443
</listitem>
4544
</itemizedlist>
4645
</para>
@@ -63,7 +62,6 @@
6362
&reference.luasandbox.luasandboxtimeouterror;
6463

6564
</book>
66-
6765
<!-- Keep this comment at the end of the file
6866
Local variables:
6967
mode: sgml

‎reference/luasandbox/configure.xml‎

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

7-
<para>
6+
<simpara>
87
&pecl.info;
98
<link xlink:href="&url.pecl.package;luasandbox">&url.pecl.package;luasandbox</link>
10-
</para>
9+
</simpara>
1110

1211
</section>
13-
14-
1512
<!-- Keep this comment at the end of the file
1613
Local variables:
1714
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: leonardolara Status: ready -->
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: leonardolara Status: ready -->
33
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="reference.luasandbox.differences">
44
<title>Diferenças do Lua Padrão</title>
55

6-
<para>
6+
<simpara>
77
O LuaSandbox fornece um ambiente isolado (caixa de areia) que difere em alguns aspectos do Lua 5.1 padrão.
8-
</para>
8+
</simpara>
99

1010
<simplesect xml:id="reference.luasandbox.differences.unavailable">
1111
<title>Recursos que não estão disponíveis</title>
1212
<itemizedlist>
1313
<listitem>
14-
<para>
14+
<simpara>
1515
<literal>dofile()</literal>, <literal>loadfile()</literal> e o pacote <literal>io</literal>, pois eles permitem acesso direto ao sistema de arquivos. Se necessário, o acesso ao sistema de arquivos deve ser feito por meio de funções de retorno PHP.
16-
</para>
16+
</simpara>
1717
</listitem>
1818
<listitem>
19-
<para>
19+
<simpara>
2020
O pacote <literal>package</literal>, incluindo <literal>require()</literal> e <literal>module()</literal>, pois depende muito do acesso direto ao sistema de arquivos. Uma reescrita Lua pura, como a usada na extensão MediaWiki Scribunto, pode ser usada em vez disso.
21-
</para>
21+
</simpara>
2222
</listitem>
2323
<listitem>
24-
<para>
24+
<simpara>
2525
<literal>load()</literal> e <literal>loadstring()</literal>, para permitir análise estática do código Lua.
26-
</para>
26+
</simpara>
2727
</listitem>
2828
<listitem>
29-
<para>
29+
<simpara>
3030
<literal>print()</literal>, já que ele envia para a saída padrão. Se necessário, a saída deve ser feita via funções de retorno PHP.
31-
</para>
31+
</simpara>
3232
</listitem>
3333
<listitem>
34-
<para>
34+
<simpara>
3535
A maior parte do pacote <literal>os</literal>, pois permite a manipulação do processo e a execução de outros processos.
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> e <literal>os.time()</literal> permanecem disponíveis.
41-
</para>
41+
</simpara>
4242
</listitem>
4343
</itemizedlist>
4444
</listitem>
4545
<listitem>
46-
<para>
46+
<simpara>
4747
A maior parte do pacote <literal>debug</literal>, pois permite a manipulação do estado Lua e metadados de maneiras que podem quebrar o isolamento.
48-
</para>
48+
</simpara>
4949
<itemizedlist>
5050
<listitem>
51-
<para>
51+
<simpara>
5252
<literal>debug.traceback()</literal> permanece disponível.
53-
</para>
53+
</simpara>
5454
</listitem>
5555
</itemizedlist>
5656
</listitem>
5757
<listitem>
58-
<para>
58+
<simpara>
5959
<literal>string.dump()</literal>, pois pode expor dados internos.
60-
</para>
60+
</simpara>
6161
</listitem>
6262
<listitem>
63-
<para>
63+
<simpara>
6464
<literal>collectgarbage()</literal>, <literal>gcinfo()</literal> e o pacote <literal>coroutine</literal> não foram revisados ​​quanto à segurança.
65-
</para>
65+
</simpara>
6666
</listitem>
6767
</itemizedlist>
6868
</simplesect>
@@ -71,29 +71,29 @@
7171
<title>Recursos que foram modificados</title>
7272
<itemizedlist>
7373
<listitem>
74-
<para>
74+
<simpara>
7575
<literal>pcall()</literal> e <literal>xpcall()</literal> não conseguem capturar certos erros, particularmente erros de tempo limite.
76-
</para>
76+
</simpara>
7777
</listitem>
7878
<listitem>
79-
<para>
79+
<simpara>
8080
<literal>tostring()</literal> não inclui endereços de ponteiros.
81-
</para>
81+
</simpara>
8282
</listitem>
8383
<listitem>
84-
<para>
84+
<simpara>
8585
<literal>string.match()</literal> foi corrigido para limitar a profundidade da recursão e verificar periodicamente se há um tempo limite.
86-
</para>
86+
</simpara>
8787
</listitem>
8888
<listitem>
89-
<para>
89+
<simpara>
9090
<literal>math.random()</literal> e <literal>math.randomseed()</literal> foram substituídos por versões que não compartilham estado com <literal>rand()</literal> do PHP.
91-
</para>
91+
</simpara>
9292
</listitem>
9393
<listitem>
94-
<para>
94+
<simpara>
9595
Os metamétodos <literal>__pairs</literal> e <literal>__ipairs</literal> do Lua 5.2 são suportados por <literal>pairs()</literal> e <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: leonardolara Status: ready -->
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: leonardolara Status: ready -->
33
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.examples">
44
&reftitle.examples;
55

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>Uso básico para LuaSandbox</title>
10-
<para>
10+
<simpara>
1111
Depois de compilado o PHP com suporte ao LuaSandbox, pode-se começar a usar o LuaSandbox para executar com segurança o código Lua fornecido pelo usuário.
12-
</para>
12+
</simpara>
1313
<example>
1414
<title>Executando um código Lua</title>
1515
<programlisting role="php" xml:id="luasandbox.examples.uniqueidhere">

‎reference/luasandbox/luasandbox.xml‎

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: leonardolara Status: ready -->
3-
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">
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: leonardolara Status: ready -->
3+
<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">
54

65
<title>A classe LuaSandbox</title>
76
<titleabbrev>LuaSandbox</titleabbrev>
@@ -11,10 +10,10 @@
1110
<!-- {{{ LuaSandbox intro -->
1211
<section xml:id="luasandbox.intro">
1312
&reftitle.intro;
14-
<para>
13+
<simpara>
1514
A classe LuaSandbox cria um ambiente Lua e permite a execução de
1615
código Lua.
17-
</para>
16+
</simpara>
1817
</section>
1918
<!-- }}} -->
2019

@@ -53,7 +52,7 @@
5352
</fieldsynopsis>
5453

5554
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
56-
<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')])"/>
5756
</classsynopsis>
5857
<!-- }}} -->
5958

@@ -67,27 +66,27 @@
6766
<varlistentry xml:id="luasandbox.constants.samples">
6867
<term><constant>LuaSandbox::SAMPLES</constant></term>
6968
<listitem>
70-
<para>
69+
<simpara>
7170
Usado com <methodname>LuaSandbox::getProfilerFunctionReport</methodname> para retornar cronometragem em amostras.
72-
</para>
71+
</simpara>
7372
</listitem>
7473
</varlistentry>
7574

7675
<varlistentry xml:id="luasandbox.constants.seconds">
7776
<term><constant>LuaSandbox::SECONDS</constant></term>
7877
<listitem>
79-
<para>
78+
<simpara>
8079
Usado com <methodname>LuaSandbox::getProfilerFunctionReport</methodname> para retornar cronometragem em segundos.
81-
</para>
80+
</simpara>
8281
</listitem>
8382
</varlistentry>
8483

8584
<varlistentry xml:id="luasandbox.constants.percent">
8685
<term><constant>LuaSandbox::PERCENT</constant></term>
8786
<listitem>
88-
<para>
87+
<simpara>
8988
Usado com <methodname>LuaSandbox::getProfilerFunctionReport</methodname> para retornar cronometragem em porcentagens do total.
90-
</para>
89+
</simpara>
9190
</listitem>
9291
</varlistentry>
9392

@@ -101,7 +100,6 @@
101100
&reference.luasandbox.entities.luasandbox;
102101

103102
</reference>
104-
105103
<!-- Keep this comment at the end of the file
106104
Local variables:
107105
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: leonardolara Status: ready -->
2+
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: leonardolara Status: ready -->
33
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.callfunction">
44
<refnamediv>
55
<refname>LuaSandbox::callFunction</refname>
@@ -13,21 +13,21 @@
1313
<methodparam><type>string</type><parameter>name</parameter></methodparam>
1414
<methodparam rep="repeat"><type>mixed</type><parameter>args</parameter></methodparam>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
Chama uma função em uma variável global Lua.
18-
</para>
19-
<para>
18+
</simpara>
19+
<simpara>
2020
Se o nome contiver caracteres ".", a função será localizada por meio de
2121
acessos recursivos à tabela, como se o nome fosse uma expressão Lua.
22-
</para>
23-
<para>
22+
</simpara>
23+
<simpara>
2424
Se a variável não existir ou não for uma função, false será
2525
retornado e um aviso será emitido.
26-
</para>
27-
<para>
26+
</simpara>
27+
<simpara>
2828
Para mais informações sobre como chamar funções Lua e os valores de retorno,
2929
veja <methodname>LuaSandboxFunction::call</methodname>.
30-
</para>
30+
</simpara>
3131
</refsect1>
3232

3333
<refsect1 role="parameters">
@@ -36,27 +36,27 @@
3636
<varlistentry>
3737
<term><parameter>name</parameter></term>
3838
<listitem>
39-
<para>
39+
<simpara>
4040
Nome da variável Lua.
41-
</para>
41+
</simpara>
4242
</listitem>
4343
</varlistentry>
4444
<varlistentry>
4545
<term><parameter>args</parameter></term>
4646
<listitem>
47-
<para>
47+
<simpara>
4848
Argumentos para a função.
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
Retorna um <type>array</type> de valores retornados pela função Lua, que pode estar vazio, &return.falseforfailure;.
59-
</para>
59+
</simpara>
6060
</refsect1>
6161

6262
<refsect1 role="examples">

0 commit comments

Comments
 (0)