Skip to content

Commit 6a6e396

Browse files
GirgiasGirgias
committed
mcrypt: fix XML to remove useless wrapping para tags via script
1 parent 613ea40 commit 6a6e396

33 files changed

Lines changed: 833 additions & 988 deletions

‎reference/mcrypt/functions/mcrypt-create-iv.xml‎

Lines changed: 47 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: leonardolara Status: ready -->
3-
<refentry xml:id="function.mcrypt-create-iv" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mcrypt-create-iv">
44
<refnamediv>
55
<refname>mcrypt_create_iv</refname>
66
<refpurpose>Cria um vetor de inicialização (IV) a partir de uma fonte aleatória</refpurpose>
@@ -35,42 +35,40 @@
3535

3636
<refsect1 role="parameters">
3737
&reftitle.parameters;
38-
<para>
39-
<variablelist>
40-
<varlistentry>
41-
<term><parameter>size</parameter></term>
42-
<listitem>
43-
<para>
44-
O tamanho do IV.
45-
</para>
46-
</listitem>
47-
</varlistentry>
48-
<varlistentry>
49-
<term><parameter>source</parameter></term>
50-
<listitem>
51-
<para>
52-
A fonte do IV. A fonte pode ser
53-
<constant>MCRYPT_RAND</constant> (gerador de números aleatórios do sistema),
54-
<constant>MCRYPT_DEV_RANDOM</constant> (leitura de dados de
55-
<filename>/dev/random</filename>) e
56-
<constant>MCRYPT_DEV_URANDOM</constant> (leitura de dados de
57-
<filename>/dev/urandom</filename>). Antes da versão 5.3.0,
58-
<constant>MCRYPT_RAND</constant> era o único suportado no Windows.
59-
</para>
60-
<para>
61-
Observe que o valor padrão deste parâmetro era
62-
<constant>MCRYPT_DEV_RANDOM</constant> antes do PHP 5.6.0.
63-
</para>
64-
<note>
65-
<simpara>
66-
Observe que <constant>MCRYPT_DEV_RANDOM</constant> pode bloquear até que mais
67-
entropia esteja disponível.
68-
</simpara>
69-
</note>
70-
</listitem>
71-
</varlistentry>
72-
</variablelist>
73-
</para>
38+
<variablelist>
39+
<varlistentry>
40+
<term><parameter>size</parameter></term>
41+
<listitem>
42+
<para>
43+
O tamanho do IV.
44+
</para>
45+
</listitem>
46+
</varlistentry>
47+
<varlistentry>
48+
<term><parameter>source</parameter></term>
49+
<listitem>
50+
<para>
51+
A fonte do IV. A fonte pode ser
52+
<constant>MCRYPT_RAND</constant> (gerador de números aleatórios do sistema),
53+
<constant>MCRYPT_DEV_RANDOM</constant> (leitura de dados de
54+
<filename>/dev/random</filename>) e
55+
<constant>MCRYPT_DEV_URANDOM</constant> (leitura de dados de
56+
<filename>/dev/urandom</filename>). Antes da versão 5.3.0,
57+
<constant>MCRYPT_RAND</constant> era o único suportado no Windows.
58+
</para>
59+
<para>
60+
Observe que o valor padrão deste parâmetro era
61+
<constant>MCRYPT_DEV_RANDOM</constant> antes do PHP 5.6.0.
62+
</para>
63+
<note>
64+
<simpara>
65+
Observe que <constant>MCRYPT_DEV_RANDOM</constant> pode bloquear até que mais
66+
entropia esteja disponível.
67+
</simpara>
68+
</note>
69+
</listitem>
70+
</varlistentry>
71+
</variablelist>
7472
</refsect1>
7573

7674
<refsect1 role="returnvalues">
@@ -82,34 +80,29 @@
8280

8381
<refsect1 role="examples">
8482
&reftitle.examples;
85-
<para>
86-
<example>
87-
<title>Exemplo de <function>mcrypt_create_iv</function></title>
88-
<programlisting role="php">
83+
<example>
84+
<title>Exemplo de <function>mcrypt_create_iv</function></title>
85+
<programlisting role="php">
8986
<![CDATA[
9087
<?php
9188
$size = mcrypt_get_iv_size(MCRYPT_CAST_256, MCRYPT_MODE_CFB);
9289
$iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
9390
?>
9491
]]>
95-
</programlisting>
96-
</example>
97-
</para>
92+
</programlisting>
93+
</example>
9894
</refsect1>
9995

10096
<refsect1 role="seealso">
10197
&reftitle.seealso;
102-
<para>
103-
<simplelist>
104-
<member><link xlink:href="&url.mcrypt.iv;">&url.mcrypt.iv;</link></member>
105-
<member><link xlink:href="&url.mcrypt.bcm;">&url.mcrypt.bcm;</link></member>
106-
<member>Capítulo 9.3 de &book.applied.cryptography;</member>
107-
<member><function>random_bytes</function></member>
108-
</simplelist>
109-
</para>
98+
<simplelist>
99+
<member><link xlink:href="&url.mcrypt.iv;">&url.mcrypt.iv;</link></member>
100+
<member><link xlink:href="&url.mcrypt.bcm;">&url.mcrypt.bcm;</link></member>
101+
<member>Capítulo 9.3 de &book.applied.cryptography;</member>
102+
<member><function>random_bytes</function></member>
103+
</simplelist>
110104
</refsect1>
111105
</refentry>
112-
113106
<!-- Keep this comment at the end of the file
114107
Local variables:
115108
mode: sgml

‎reference/mcrypt/functions/mcrypt-decrypt.xml‎

Lines changed: 44 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 5fabd07880ab15b0ad2cf7eb055c7c2b36d7120f Maintainer: leonardolara Status: ready -->
3-
<refentry xml:id="function.mcrypt-decrypt" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-decrypt">
44
<refnamediv>
55
<refname>mcrypt_decrypt</refname>
66
<refpurpose>Descriptografa texto criptografado com parâmetros fornecidos</refpurpose>
@@ -24,47 +24,45 @@
2424
</refsect1>
2525
<refsect1 role="parameters">
2626
&reftitle.parameters;
27-
<para>
28-
<variablelist>
29-
<varlistentry>
30-
<term><parameter>cipher</parameter></term>
31-
<listitem>
32-
&mcrypt.parameter.cipher;
33-
</listitem>
34-
</varlistentry>
35-
<varlistentry>
36-
<term><parameter>key</parameter></term>
37-
<listitem>
38-
<para>
39-
A chave com a qual os dados foram criptografados. Se o tamanho da chave fornecida não for
40-
suportado pela cifra, a função emitirá um aviso e retornará &false;
41-
</para>
42-
</listitem>
43-
</varlistentry>
44-
<varlistentry>
45-
<term><parameter>data</parameter></term>
46-
<listitem>
47-
<para>
48-
Os dados que serão descriptografados com <parameter>cipher</parameter>
49-
e <parameter>mode</parameter> fornecidos. Se o tamanho dos dados não for n * tamanho_do_bloco,
50-
os dados serão preenchidos com '<literal>\0</literal>'.
51-
</para>
52-
</listitem>
53-
</varlistentry>
54-
<varlistentry>
55-
<term><parameter>mode</parameter></term>
56-
<listitem>
57-
&mcrypt.parameter.mode;
58-
</listitem>
59-
</varlistentry>
60-
<varlistentry>
61-
<term><parameter>iv</parameter></term>
62-
<listitem>
63-
&mcrypt.parameter.iv.strict;
64-
</listitem>
65-
</varlistentry>
66-
</variablelist>
67-
</para>
27+
<variablelist>
28+
<varlistentry>
29+
<term><parameter>cipher</parameter></term>
30+
<listitem>
31+
&mcrypt.parameter.cipher;
32+
</listitem>
33+
</varlistentry>
34+
<varlistentry>
35+
<term><parameter>key</parameter></term>
36+
<listitem>
37+
<para>
38+
A chave com a qual os dados foram criptografados. Se o tamanho da chave fornecida não for
39+
suportado pela cifra, a função emitirá um aviso e retornará &false;
40+
</para>
41+
</listitem>
42+
</varlistentry>
43+
<varlistentry>
44+
<term><parameter>data</parameter></term>
45+
<listitem>
46+
<para>
47+
Os dados que serão descriptografados com <parameter>cipher</parameter>
48+
e <parameter>mode</parameter> fornecidos. Se o tamanho dos dados não for n * tamanho_do_bloco,
49+
os dados serão preenchidos com '<literal>\0</literal>'.
50+
</para>
51+
</listitem>
52+
</varlistentry>
53+
<varlistentry>
54+
<term><parameter>mode</parameter></term>
55+
<listitem>
56+
&mcrypt.parameter.mode;
57+
</listitem>
58+
</varlistentry>
59+
<varlistentry>
60+
<term><parameter>iv</parameter></term>
61+
<listitem>
62+
&mcrypt.parameter.iv.strict;
63+
</listitem>
64+
</varlistentry>
65+
</variablelist>
6866
</refsect1>
6967

7068
<refsect1 role="returnvalues">
@@ -76,14 +74,11 @@
7674

7775
<refsect1 role="seealso">
7876
&reftitle.seealso;
79-
<para>
80-
<simplelist>
81-
<member><function>mcrypt_encrypt</function></member>
82-
</simplelist>
83-
</para>
77+
<simplelist>
78+
<member><function>mcrypt_encrypt</function></member>
79+
</simplelist>
8480
</refsect1>
8581
</refentry>
86-
8782
<!-- Keep this comment at the end of the file
8883
Local variables:
8984
mode: sgml

‎reference/mcrypt/functions/mcrypt-enc-get-algorithms-name.xml‎

Lines changed: 20 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: d7d7191c7dcd0384209ade638d6ecdd2ce203016 Maintainer: leonardolara Status: ready -->
3-
<refentry xml:id="function.mcrypt-enc-get-algorithms-name" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-algorithms-name">
44
<refnamediv>
55
<refname>mcrypt_enc_get_algorithms_name</refname>
66
<refpurpose>Retorna o nome do algoritmo aberto</refpurpose>
@@ -23,18 +23,16 @@
2323

2424
<refsect1 role="parameters">
2525
&reftitle.parameters;
26-
<para>
27-
<variablelist>
28-
<varlistentry>
29-
<term><parameter>td</parameter></term>
30-
<listitem>
31-
<para>
32-
O descritor de criptografia.
33-
</para>
34-
</listitem>
35-
</varlistentry>
36-
</variablelist>
37-
</para>
26+
<variablelist>
27+
<varlistentry>
28+
<term><parameter>td</parameter></term>
29+
<listitem>
30+
<para>
31+
O descritor de criptografia.
32+
</para>
33+
</listitem>
34+
</varlistentry>
35+
</variablelist>
3836
</refsect1>
3937

4038
<refsect1 role="returnvalues">
@@ -46,10 +44,9 @@
4644

4745
<refsect1 role="examples">
4846
&reftitle.examples;
49-
<para>
50-
<example>
51-
<title>Exemplo de <function>mcrypt_enc_get_algorithms_name</function></title>
52-
<programlisting role="php">
47+
<example>
48+
<title>Exemplo de <function>mcrypt_enc_get_algorithms_name</function></title>
49+
<programlisting role="php">
5350
<![CDATA[
5451
<?php
5552
$td = mcrypt_module_open(MCRYPT_CAST_256, '', MCRYPT_MODE_CFB, '');
@@ -59,19 +56,17 @@ $td = mcrypt_module_open('cast-256', '', MCRYPT_MODE_CFB, '');
5956
echo mcrypt_enc_get_algorithms_name($td). "\n";
6057
?>
6158
]]>
62-
</programlisting>
63-
&example.outputs;
64-
<screen>
59+
</programlisting>
60+
&example.outputs;
61+
<screen>
6562
<![CDATA[
6663
CAST-256
6764
CAST-256
6865
]]>
69-
</screen>
70-
</example>
71-
</para>
66+
</screen>
67+
</example>
7268
</refsect1>
7369
</refentry>
74-
7570
<!-- Keep this comment at the end of the file
7671
Local variables:
7772
mode: sgml

‎reference/mcrypt/functions/mcrypt-enc-get-block-size.xml‎

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: d7d7191c7dcd0384209ade638d6ecdd2ce203016 Maintainer: leonardolara Status: ready -->
3-
<refentry xml:id="function.mcrypt-enc-get-block-size" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-block-size">
44
<refnamediv>
55
<refname>mcrypt_enc_get_block_size</refname>
66
<refpurpose>Retorna o tamanho do bloco do algoritmo aberto</refpurpose>
@@ -20,18 +20,16 @@
2020
</refsect1>
2121
<refsect1 role="parameters">
2222
&reftitle.parameters;
23-
<para>
24-
<variablelist>
25-
<varlistentry>
26-
<term><parameter>td</parameter></term>
27-
<listitem>
28-
<para>
29-
O descritor de criptografia.
30-
</para>
31-
</listitem>
32-
</varlistentry>
33-
</variablelist>
34-
</para>
23+
<variablelist>
24+
<varlistentry>
25+
<term><parameter>td</parameter></term>
26+
<listitem>
27+
<para>
28+
O descritor de criptografia.
29+
</para>
30+
</listitem>
31+
</varlistentry>
32+
</variablelist>
3533
</refsect1>
3634
<refsect1 role="returnvalues">
3735
&reftitle.returnvalues;
@@ -40,7 +38,6 @@
4038
</para>
4139
</refsect1>
4240
</refentry>
43-
4441
<!-- Keep this comment at the end of the file
4542
Local variables:
4643
mode: sgml

0 commit comments

Comments
 (0)