Skip to content

Commit 740f259

Browse files
GirgiasGirgias
committed
ffi : fix XML by converting para to simpara tags via script
1 parent c73456d commit 740f259

41 files changed

Lines changed: 376 additions & 363 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎reference/ffi/book.xml‎

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,43 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: leonardolara Status: ready --><!-- CREDITS: athos-ribeiro -->
3-
4-
<book xml:id="book.ffi" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<!-- CREDITS: athos-ribeiro -->
4+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.ffi">
55
<?phpdoc extension-membership="bundled" ?>
66
<title>Interface de função externa</title>
77
<titleabbrev>FFI</titleabbrev>
88

99
<preface xml:id="intro.ffi">
1010
&reftitle.intro;
11-
<para>
11+
<simpara>
1212
Esta extensão permite o carregamento de bibliotecas compartilhadas (<filename>.DLL</filename> ou
1313
<filename>.so</filename>), a chamada de funções escritas em C e o acesso à estruturas de dados de C
1414
em PHP puro, sem a necessidade de maiores conhecimentos da API de extensões do Zend, e
1515
sem a necessidade de aprender uma terceira linguagem "intermediária".
1616
A API pública é implementada como uma única classe <classname>FFI</classname> com
1717
diversos métodos estáticos (alguns deles podem ser chamados dinamicamente) e
1818
métodos de objetos sobrecarregados, que realizam a interação com os dados em C.
19-
</para>
19+
</simpara>
2020
<caution>
21-
<para>
21+
<simpara>
2222
A FFI é perigosa, visto que permite a interface com o sistema em um nível muito baixo.
2323
A extensão FFI deve ser usada apenas por desenvolvedores que possuam experiência com C
2424
e com as APIs de C utilizadas. Para minimizar o risco, a utilização da API da FFI pode ser restringida
2525
com a opção <link linkend="ini.ffi.enable">ffi.enable</link> do &php.ini;.
26-
</para>
26+
</simpara>
2727
</caution>
2828
<note>
29-
<para>
29+
<simpara>
3030
A extensão FFI não torna a API de extensão clássica do PHP obsoleta; ela é apenas
3131
fornecida para interface ad-hoc com funções e estruturas de dados em C.
32-
</para>
32+
</simpara>
3333
</note>
3434
<tip>
35-
<para>
35+
<simpara>
3636
Atualmente, acessar estruturas de dados com a FFI é significativamente mais lento (aproximadamente 2 vezes)
3737
do que acessar arrays e objetos nativos de PHP. Portanto, não faz sentido utilizar
3838
a extensão FFI para ganhos de desempenho; entretanto, pode fazer sentido utilizá-la para reduzir o
3939
consumo de memória.
40-
</para>
40+
</simpara>
4141
</tip>
4242
</preface>
4343

@@ -49,7 +49,6 @@
4949
&reference.ffi.ffi.exception;
5050
&reference.ffi.ffi.parserexception;
5151
</book>
52-
5352
<!-- Keep this comment at the end of the file
5453
Local variables:
5554
mode: sgml

‎reference/ffi/configure.xml‎

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,20 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: cffb5f52894aa8a29109e3802e2257c56b51bcb6 Maintainer: leonardolara Status: ready --><!-- CREDITS: AdaiasMagdiel -->
3-
4-
<section xml:id="ffi.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<!-- CREDITS: AdaiasMagdiel -->
4+
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ffi.installation">
55
&reftitle.install;
66

7-
<para>
7+
<simpara>
88
Para habilitar a extensão FFI, o PHP precisa ser configurado com
99
<option role="configure">--with-ffi</option>.
10-
</para>
10+
</simpara>
1111

12-
<para>
12+
<simpara>
1313
Usuários do Windows precisam incluir <filename>php_ffi.dll</filename> no &php.ini;
1414
para habilitar a extensão FFI.
15-
</para>
15+
</simpara>
1616

1717
</section>
18-
19-
2018
<!-- Keep this comment at the end of the file
2119
Local variables:
2220
mode: sgml

‎reference/ffi/ctype/getalignment.xml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9e0804888ae46a50f28d98514a8d5e70a34e069c Maintainer: leonardolara Status: ready -->
2-
<refentry xml:id="ffi-ctype.getalignment" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ffi-ctype.getalignment">
34
<refnamediv>
45
<refname>FFI\CType::getAlignment</refname>
56
<refpurpose>Descrição</refpurpose>
@@ -11,9 +12,9 @@
1112
<modifier>public</modifier> <type>int</type><methodname>FFI\CType::getAlignment</methodname>
1213
<void/>
1314
</methodsynopsis>
14-
<para>
15+
<simpara>
1516

16-
</para>
17+
</simpara>
1718

1819
&warn.undocumented.func;
1920

@@ -26,9 +27,9 @@
2627

2728
<refsect1 role="returnvalues">
2829
&reftitle.returnvalues;
29-
<para>
30+
<simpara>
3031

31-
</para>
32+
</simpara>
3233
</refsect1>
3334

3435

‎reference/ffi/ctype/getarrayelementtype.xml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9e0804888ae46a50f28d98514a8d5e70a34e069c Maintainer: leonardolara Status: ready -->
2-
<refentry xml:id="ffi-ctype.getarrayelementtype" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ffi-ctype.getarrayelementtype">
34
<refnamediv>
45
<refname>FFI\CType::getArrayElementType</refname>
56
<refpurpose>Descrição</refpurpose>
@@ -11,9 +12,9 @@
1112
<modifier>public</modifier> <type>FFI\CType</type><methodname>FFI\CType::getArrayElementType</methodname>
1213
<void/>
1314
</methodsynopsis>
14-
<para>
15+
<simpara>
1516

16-
</para>
17+
</simpara>
1718

1819
&warn.undocumented.func;
1920

@@ -26,9 +27,9 @@
2627

2728
<refsect1 role="returnvalues">
2829
&reftitle.returnvalues;
29-
<para>
30+
<simpara>
3031

31-
</para>
32+
</simpara>
3233
</refsect1>
3334

3435

‎reference/ffi/ctype/getarraylength.xml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9e0804888ae46a50f28d98514a8d5e70a34e069c Maintainer: leonardolara Status: ready -->
2-
<refentry xml:id="ffi-ctype.getarraylength" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ffi-ctype.getarraylength">
34
<refnamediv>
45
<refname>FFI\CType::getArrayLength</refname>
56
<refpurpose>Descrição</refpurpose>
@@ -11,9 +12,9 @@
1112
<modifier>public</modifier> <type>int</type><methodname>FFI\CType::getArrayLength</methodname>
1213
<void/>
1314
</methodsynopsis>
14-
<para>
15+
<simpara>
1516

16-
</para>
17+
</simpara>
1718

1819
&warn.undocumented.func;
1920

@@ -26,9 +27,9 @@
2627

2728
<refsect1 role="returnvalues">
2829
&reftitle.returnvalues;
29-
<para>
30+
<simpara>
3031

31-
</para>
32+
</simpara>
3233
</refsect1>
3334

3435

‎reference/ffi/ctype/getattributes.xml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9e0804888ae46a50f28d98514a8d5e70a34e069c Maintainer: leonardolara Status: ready -->
2-
<refentry xml:id="ffi-ctype.getattributes" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ffi-ctype.getattributes">
34
<refnamediv>
45
<refname>FFI\CType::getAttributes</refname>
56
<refpurpose>Descrição</refpurpose>
@@ -11,9 +12,9 @@
1112
<modifier>public</modifier> <type>int</type><methodname>FFI\CType::getAttributes</methodname>
1213
<void/>
1314
</methodsynopsis>
14-
<para>
15+
<simpara>
1516

16-
</para>
17+
</simpara>
1718

1819
&warn.undocumented.func;
1920

@@ -26,9 +27,9 @@
2627

2728
<refsect1 role="returnvalues">
2829
&reftitle.returnvalues;
29-
<para>
30+
<simpara>
3031

31-
</para>
32+
</simpara>
3233
</refsect1>
3334

3435

‎reference/ffi/ctype/getenumkind.xml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9e0804888ae46a50f28d98514a8d5e70a34e069c Maintainer: leonardolara Status: ready -->
2-
<refentry xml:id="ffi-ctype.getenumkind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ffi-ctype.getenumkind">
34
<refnamediv>
45
<refname>FFI\CType::getEnumKind</refname>
56
<refpurpose>Descrição</refpurpose>
@@ -11,9 +12,9 @@
1112
<modifier>public</modifier> <type>int</type><methodname>FFI\CType::getEnumKind</methodname>
1213
<void/>
1314
</methodsynopsis>
14-
<para>
15+
<simpara>
1516

16-
</para>
17+
</simpara>
1718

1819
&warn.undocumented.func;
1920

@@ -26,9 +27,9 @@
2627

2728
<refsect1 role="returnvalues">
2829
&reftitle.returnvalues;
29-
<para>
30+
<simpara>
3031

31-
</para>
32+
</simpara>
3233
</refsect1>
3334

3435

‎reference/ffi/ctype/getfuncabi.xml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9e0804888ae46a50f28d98514a8d5e70a34e069c Maintainer: leonardolara Status: ready -->
2-
<refentry xml:id="ffi-ctype.getfuncabi" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ffi-ctype.getfuncabi">
34
<refnamediv>
45
<refname>FFI\CType::getFuncABI</refname>
56
<refpurpose>Descrição</refpurpose>
@@ -11,9 +12,9 @@
1112
<modifier>public</modifier> <type>int</type><methodname>FFI\CType::getFuncABI</methodname>
1213
<void/>
1314
</methodsynopsis>
14-
<para>
15+
<simpara>
1516

16-
</para>
17+
</simpara>
1718

1819
&warn.undocumented.func;
1920

@@ -26,9 +27,9 @@
2627

2728
<refsect1 role="returnvalues">
2829
&reftitle.returnvalues;
29-
<para>
30+
<simpara>
3031

31-
</para>
32+
</simpara>
3233
</refsect1>
3334

3435

‎reference/ffi/ctype/getfuncparametercount.xml‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 55e1ffbb74003fdd5d956afcc134669b2d493986 Maintainer: leonardolara Status: ready -->
2-
<refentry xml:id="ffi-ctype.getfuncparametercount" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ffi-ctype.getfuncparametercount">
34
<refnamediv>
45
<refname>FFI\CType::getFuncParameterCount</refname>
56
<refpurpose>Obtém a contagem de parâmetros de um tipo de função</refpurpose>
@@ -11,9 +12,9 @@
1112
<modifier>public</modifier> <type>int</type><methodname>FFI\CType::getFuncParameterCount</methodname>
1213
<void/>
1314
</methodsynopsis>
14-
<para>
15+
<simpara>
1516

16-
</para>
17+
</simpara>
1718

1819
</refsect1>
1920

@@ -24,11 +25,11 @@
2425

2526
<refsect1 role="returnvalues">
2627
&reftitle.returnvalues;
27-
<para>
28+
<simpara>
2829
Retorna o número de parâmetros para o tipo de função subjacente.
2930
Se o tipo não for uma função, uma exceção
3031
<exceptionname>FFI\Exception</exceptionname> é lançada.
31-
</para>
32+
</simpara>
3233
</refsect1>
3334

3435

‎reference/ffi/ctype/getfuncparametertype.xml‎

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 184bc21699133fda630f0327fcd7d636a14d45fb Maintainer: leonardolara Status: ready -->
2-
<refentry xml:id="ffi-ctype.getfuncparametertype" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: e14fdcab82e89bfb4ee221b1de9f4764c93abcf5 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ffi-ctype.getfuncparametertype">
34
<refnamediv>
45
<refname>FFI\CType::getFuncParameterType</refname>
56
<refpurpose>Obtém o tipo de um parâmetro de função</refpurpose>
@@ -11,9 +12,9 @@
1112
<modifier>public</modifier> <type>FFI\CType</type><methodname>FFI\CType::getFuncParameterType</methodname>
1213
<methodparam><type>int</type><parameter>index</parameter></methodparam>
1314
</methodsynopsis>
14-
<para>
15+
<simpara>
1516
Retorna o tipo de um parâmetro para o tipo da função subjacente.
16-
</para>
17+
</simpara>
1718

1819
</refsect1>
1920

@@ -23,22 +24,22 @@
2324
<varlistentry>
2425
<term><parameter>index</parameter></term>
2526
<listitem>
26-
<para>
27+
<simpara>
2728
Índice do parâmetro da função, baseado em zero.
28-
</para>
29+
</simpara>
2930
</listitem>
3031
</varlistentry>
3132
</variablelist>
3233
</refsect1>
3334

3435
<refsect1 role="returnvalues">
3536
&reftitle.returnvalues;
36-
<para>
37+
<simpara>
3738
Retorna o tipo de um parâmetro para o tipo da função subjacente.
3839
Se o tipo subjacente não for uma função, ou se o ínice informado estiver fora
3940
do intervalo de parâmetros da função, uma
4041
<exceptionname>FFI\Exception</exceptionname> será lançada.
41-
</para>
42+
</simpara>
4243
</refsect1>
4344

4445

0 commit comments

Comments
 (0)