Skip to content

Commit b9e3dbf

Browse files
GirgiasGirgias
committed
readline: fix XML by converting para to simpara tags via script
1 parent 0db72d6 commit b9e3dbf

17 files changed

+127
-133
lines changed

‎reference/readline/book.xml‎

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<!-- EN-Revision: 51779f7c42f39934403805a42b83cef7126a5fc1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandoc,felipe,fernandowobeto,leonardolara -->
3-
4-
<book xml:id="book.readline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 53208f9bd0a035a4e1409ba700106540474c9ef1 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandoc,felipe,fernandowobeto,leonardolara -->
4+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.readline">
55
<?phpdoc extension-membership="bundledexternal" ?>
66
<title>Readline GNU</title>
77
<titleabbrev>Readline</titleabbrev>
88

99
<!-- {{{ preface -->
1010
<preface xml:id="intro.readline">
1111
&reftitle.intro;
12-
<para>
12+
<simpara>
1313
As funções readline implementam uma interface para
1414
a biblioteca Readline GNU. Estas são funções que fornecem
1515
linhas de comando editáveis. Um exeplo é a maneira que o Bash permite
@@ -18,15 +18,15 @@
1818
biblioteca, ela será de pouco uso para escrever aplicações Web,
1919
mas pode ser util ao escrever scripts usados a partir de uma
2020
<link linkend="features.commandline">linha de comando</link>.
21-
</para>
22-
<para>
21+
</simpara>
22+
<simpara>
2323
A partir do PHP 7.1.0 esta extensão é suportada no Windows.
24-
</para>
24+
</simpara>
2525
<caution>
26-
<para>
26+
<simpara>
2727
A extensão readline não é segura para threads! Portanto, o uso dela com qualquer
2828
SAPI verdadeiramente segura para threads (como mod_winnt do Apache) é fortemente desencorajado.
29-
</para>
29+
</simpara>
3030
</caution>
3131
</preface>
3232
<!-- }}} -->
@@ -36,7 +36,6 @@
3636
&reference.readline.reference;
3737

3838
</book>
39-
4039
<!-- Keep this comment at the end of the file
4140
Local variables:
4241
mode: sgml
@@ -57,4 +56,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
5756
vim: et tw=78 syn=sgml
5857
vi: ts=1 sw=1
5958
-->
60-

‎reference/readline/configure.xml‎

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<!-- EN-Revision: 51779f7c42f39934403805a42b83cef7126a5fc1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandoc,fernandowobeto,leonardolara -->
3-
<section xml:id="readline.installation" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 53208f9bd0a035a4e1409ba700106540474c9ef1 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandoc,fernandowobeto,leonardolara -->
4+
<section xmlns="http://docbook.org/ns/docbook" xml:id="readline.installation">
45
&reftitle.install;
5-
<para>
6+
<simpara>
67
Para usar estas funções, as versões CGI ou CLI do PHP devem ser compiladas
78
com suporte a readline. É necessário configurar o PHP com a opção
89
<option role="configure">--with-readline[=DIR]</option>.
910
Se a intenção for usar a biblioteca substituta libedit, o PHP deve ser configurado com
1011
<option role="configure">--with-libedit[=DIR]</option>.
11-
</para>
12-
<para>
12+
</simpara>
13+
<simpara>
1314
No Windows, esta extensão está disponível por padrão a partir do PHP 7.1.0.
14-
</para>
15+
</simpara>
1516
</section>
16-
1717
<!-- Keep this comment at the end of the file
1818
Local variables:
1919
mode: sgml
@@ -34,4 +34,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
3434
vim: et tw=78 syn=sgml
3535
vi: ts=1 sw=1
3636
-->
37-

‎reference/readline/functions/readline-add-history.xml‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: fernandowobeto Status: ready -->
2+
<!-- EN-Revision: 53208f9bd0a035a4e1409ba700106540474c9ef1 Maintainer: fernandowobeto Status: ready -->
33
<!-- CREDITS: fernandoc,fernandowobeto -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-add-history">
55
<refnamediv>
@@ -13,9 +13,9 @@
1313
<type>true</type><methodname>readline_add_history</methodname>
1414
<methodparam><type>string</type><parameter>prompt</parameter></methodparam>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
Esta função adiciona uma linha ao histórico da linha de comando.
18-
</para>
18+
</simpara>
1919
</refsect1>
2020

2121
<refsect1 role="parameters">
@@ -24,19 +24,19 @@
2424
<varlistentry>
2525
<term><parameter>prompt</parameter></term>
2626
<listitem>
27-
<para>
27+
<simpara>
2828
A linha a ser adicionada ao histórico.
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.true.always;
39-
</para>
39+
</simpara>
4040
</refsect1>
4141
</refentry>
4242
<!-- Keep this comment at the end of the file

‎reference/readline/functions/readline-callback-handler-install.xml‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 53208f9bd0a035a4e1409ba700106540474c9ef1 Maintainer: leonardolara Status: ready -->
33
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-callback-handler-install">
44
<refnamediv>
55
<refname>readline_callback_handler_install</refname>
@@ -13,18 +13,18 @@
1313
<methodparam><type>string</type><parameter>prompt</parameter></methodparam>
1414
<methodparam><type>callable</type><parameter>callback</parameter></methodparam>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
Configura uma interface de chamada de retorno readline, mostra o
1818
<parameter>prompt</parameter> e retorna imediatamente.
1919
Chamar esta função duas vezes sem remover a interface de
2020
chamada anterior irá automaticamente e convenientemente sobrescrever a
2121
interface antiga.
22-
</para>
23-
<para>
22+
</simpara>
23+
<simpara>
2424
O recurso de chamada de retorno é útil quando combinada com
2525
<function>stream_select</function> já que permite as it allows intercalação de E/S e
2626
de entrada de usuário, diferentemente da função <function>readline</function>.
27-
</para>
27+
</simpara>
2828
</refsect1>
2929

3030
<refsect1 role="parameters">
@@ -33,28 +33,28 @@
3333
<varlistentry>
3434
<term><parameter>prompt</parameter></term>
3535
<listitem>
36-
<para>
36+
<simpara>
3737
A mensagem do prompt.
38-
</para>
38+
</simpara>
3939
</listitem>
4040
</varlistentry>
4141
<varlistentry>
4242
<term><parameter>callback</parameter></term>
4343
<listitem>
44-
<para>
44+
<simpara>
4545
A função definida em <parameter>callback</parameter> leva um parâmetro; a entrada
4646
do usuário retornada.
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
&return.true.always;
57-
</para>
57+
</simpara>
5858
</refsect1>
5959

6060
<refsect1 role="examples">

‎reference/readline/functions/readline-callback-handler-remove.xml‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 53208f9bd0a035a4e1409ba700106540474c9ef1 Maintainer: leonardolara Status: ready -->
33
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-callback-handler-remove">
44
<refnamediv>
55
<refname>readline_callback_handler_remove</refname>
@@ -12,10 +12,10 @@
1212
<type>bool</type><methodname>readline_callback_handler_remove</methodname>
1313
<void/>
1414
</methodsynopsis>
15-
<para>
15+
<simpara>
1616
Remove um manipulador de chamada de retorno previamente instalado e restaura a
1717
configuração do terminal.
18-
</para>
18+
</simpara>
1919
</refsect1>
2020

2121
<refsect1 role="parameters">
@@ -25,18 +25,18 @@
2525

2626
<refsect1 role="returnvalues">
2727
&reftitle.returnvalues;
28-
<para>
28+
<simpara>
2929
Retorna &true; se o manipulador de chamada de retorno previamente instalado for removido, ou
3030
&false; se ele não puder ser encontrado.
31-
</para>
31+
</simpara>
3232
</refsect1>
3333

3434
<refsect1 role="examples">
3535
&reftitle.examples;
36-
<para>
36+
<simpara>
3737
Consulte <function>readline_callback_handler_install</function> para um exemplo
3838
de como usar a interface de chamada de retorno de readline.
39-
</para>
39+
</simpara>
4040
</refsect1>
4141

4242
<refsect1 role="seealso">

‎reference/readline/functions/readline-callback-read-char.xml‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 53208f9bd0a035a4e1409ba700106540474c9ef1 Maintainer: leonardolara Status: ready -->
33
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-callback-read-char">
44
<refnamediv>
55
<refname>readline_callback_read_char</refname>
@@ -12,12 +12,12 @@
1212
<type>void</type><methodname>readline_callback_read_char</methodname>
1313
<void/>
1414
</methodsynopsis>
15-
<para>
15+
<simpara>
1616
Lê um caractere de entrada do usuário. Quando uma linha é recebida, esta função
1717
informa a interface de chamada de retorno de readline, instalada usando
1818
<function>readline_callback_handler_install</function>, que uma linha
1919
está pronta para entrada.
20-
</para>
20+
</simpara>
2121
</refsect1>
2222

2323
<refsect1 role="parameters">
@@ -27,17 +27,17 @@
2727

2828
<refsect1 role="returnvalues">
2929
&reftitle.returnvalues;
30-
<para>
30+
<simpara>
3131
&return.void;
32-
</para>
32+
</simpara>
3333
</refsect1>
3434

3535
<refsect1 role="examples">
3636
&reftitle.examples;
37-
<para>
37+
<simpara>
3838
Consulte <function>readline_callback_handler_install</function> para um exemplo
3939
de como usar a interface de chamada de retorno de readline.
40-
</para>
40+
</simpara>
4141
</refsect1>
4242

4343
<refsect1 role="seealso">

‎reference/readline/functions/readline-clear-history.xml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<!-- EN-Revision: 2ab6e3ff1677d26786a443fa370719bfb4eba9cb Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandoc,fernandowobeto -->
3-
<refentry xml:id="function.readline-clear-history" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 53208f9bd0a035a4e1409ba700106540474c9ef1 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandoc,fernandowobeto -->
4+
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-clear-history">
45
<refnamediv>
56
<refname>readline_clear_history</refname>
67
<refpurpose>Limpa o histórico</refpurpose>
@@ -12,9 +13,9 @@
1213
<type>true</type><methodname>readline_clear_history</methodname>
1314
<void/>
1415
</methodsynopsis>
15-
<para>
16+
<simpara>
1617
Esta função limpa todo o histórico da linha de comando.
17-
</para>
18+
</simpara>
1819
</refsect1>
1920

2021
<refsect1 role="parameters">
@@ -24,9 +25,9 @@
2425

2526
<refsect1 role="returnvalues">
2627
&reftitle.returnvalues;
27-
<para>
28+
<simpara>
2829
&return.true.always;
29-
</para>
30+
</simpara>
3031
</refsect1>
3132
</refentry>
3233
<!-- Keep this comment at the end of the file

‎reference/readline/functions/readline-completion-function.xml‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
2-
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 53208f9bd0a035a4e1409ba700106540474c9ef1 Maintainer: leonardolara Status: ready -->
33
<!-- CREDITS: fernandoc,fernandowobeto,leonardolara -->
44
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-completion-function">
55
<refnamediv>
@@ -13,10 +13,10 @@
1313
<type>bool</type><methodname>readline_completion_function</methodname>
1414
<methodparam><type>callable</type><parameter>callback</parameter></methodparam>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
Esta função registra uma função de completamento. Este é o mesmo tipo de
1818
funcionamento ao pressionar a tecla de tabulação enquanto estiver usando o Bash.
19-
</para>
19+
</simpara>
2020
</refsect1>
2121

2222
<refsect1 role="parameters">
@@ -25,20 +25,20 @@
2525
<varlistentry>
2626
<term><parameter>callback</parameter></term>
2727
<listitem>
28-
<para>
28+
<simpara>
2929
Deve-se usar o nome de uma função existente que aceite uma
3030
linha de comando parcial e retorne um array de combinações possíveis.
31-
</para>
31+
</simpara>
3232
</listitem>
3333
</varlistentry>
3434
</variablelist>
3535
</refsect1>
3636

3737
<refsect1 role="returnvalues">
3838
&reftitle.returnvalues;
39-
<para>
39+
<simpara>
4040
&return.success;
41-
</para>
41+
</simpara>
4242
</refsect1>
4343
</refentry>
4444
<!-- Keep this comment at the end of the file

0 commit comments

Comments
 (0)