ajustes em reference/xls/* conforme revisões em inglês (#422)

reference/xsl/book.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: felipe,fernandowobeto -->
 
 <book xml:id="book.xsl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<?phpdoc extension-membership="bundledexternal" ?>
  <title>XSL</title>
 
  <!-- {{{ preface -->

reference/xsl/configure.xml

@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: felipe Status: ready -->
+<!-- EN-Revision: f9c4a68ef4f89e51e6d9b905ad3ddb6492386dd3 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: felipe,fernandowobeto -->
 <section xml:id="xsl.installation" xmlns="http://docbook.org/ns/docbook">
  &reftitle.install;
   <para>
-   PHP 5 inclue a extensão XSL por padrão e pode ser habilitada
+   PHP inclue a extensão XSL por padrão e pode ser habilitada
    adicionando o argumento <option role="configure">--with-xsl[=DIR]</option>
-   na linha de configuração. <literal>DIR</literal> é o diretório da instalação
+   na linha de configuração <literal>DIR</literal> sendo o diretório da instalação
    da libxslt.
   </para>
 </section>

reference/xsl/constants.xml

@@ -1,80 +1,159 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: felipe Status: ready -->
+<!-- EN-Revision: f9c4a68ef4f89e51e6d9b905ad3ddb6492386dd3 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: felipe,fernandowobeto -->
 <appendix xml:id="xsl.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
  <variablelist>
-  <varlistentry>
+  <varlistentry xml:id="constant.xsl-clone-auto">
    <term>
     <constant>XSL_CLONE_AUTO</constant>
-    (<type>integer</type>)
+    (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry>
+  <varlistentry xml:id="constant.xsl-clone-never">
    <term>
     <constant>XSL_CLONE_NEVER</constant>
-    (<type>integer</type>)
+    (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry>
+  <varlistentry xml:id="constant.xsl-clone-always">
    <term>
     <constant>XSL_CLONE_ALWAYS</constant>
-    (<type>integer</type>)
+    (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry>
+  <varlistentry xml:id="constant.libxslt-version">
    <term>
     <constant>LIBXSLT_VERSION</constant>
-    (<type>integer</type>)
+    (<type>int</type>)
    </term>
    <listitem>
     <simpara>
-     Versão da  libxslt como 10117. Disponível no PHP 5.1.2.
+     Versão da  libxslt como 10117.
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry>
+  <varlistentry xml:id="constant.libxslt-dotted-version">
    <term>
     <constant>LIBXSLT_DOTTED_VERSION</constant>
     (<type>string</type>)
    </term>
    <listitem>
     <simpara>
-     Versão da libxslt como 1.1.17. Disponível no PHP 5.1.2.
+     Versão da libxslt como 1.1.17.
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry>
+  <varlistentry xml:id="constant.libexslt-version">
    <term>
     <constant>LIBEXSLT_VERSION</constant>
-    (<type>integer</type>)
+    (<type>int</type>)
    </term>
    <listitem>
     <simpara>
-     Versão da libexslt como 813. Disponível no PHP 5.1.2.
+     Versão da libexslt como 813.
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry>
+  <varlistentry xml:id="constant.libexslt-dotted-version">
    <term>
     <constant>LIBEXSLT_DOTTED_VERSION</constant>
     (<type>string</type>)
    </term>
    <listitem>
     <simpara>
-     Versão da libexslt com 1.1.17. Disponível no PHP 5.1.2.
+     Versão da libexslt com 1.1.17.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.xsl-secpref-none">
+   <term>
+    <constant>XSL_SECPREF_NONE</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>Desativa todas as restrições de segurança.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.xsl-secpref-read-file">
+   <term>
+    <constant>XSL_SECPREF_READ_FILE</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Não permite a leitura de arquivos.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.xsl-secpref-write-file">
+   <term>
+    <constant>XSL_SECPREF_WRITE_FILE</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Não permite gravação de arquivos.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.xsl-secpref-create-directory">
+   <term>
+    <constant>XSL_SECPREF_CREATE_DIRECTORY</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Não permite a criação de diretórios.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.xsl-secpref-read-network">
+   <term>
+    <constant>XSL_SECPREF_READ_NETWORK</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Não permite a leitura de arquivos de rede.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.xsl-secpref-write-network">
+   <term>
+    <constant>XSL_SECPREF_WRITE_NETWORK</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Não permite a gravação de arquivos de rede.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.xsl-secpref-default">
+   <term>
+    <constant>XSL_SECPREF_DEFAULT</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Proíbe todo acesso de gravação, ou seja, uma máscara de bits de
+     <constant>XSL_SECPREF_WRITE_NETWORK</constant> |
+     <constant>XSL_SECPREF_CREATE_DIRECTORY</constant> |
+     <constant>XSL_SECPREF_WRITE_FILE</constant>.
     </simpara>
    </listitem>
   </varlistentry>

reference/xsl/examples.xml

@@ -1,9 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 10b60deaa2e4353299a66e99eae0f06d53ddb661 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: felipe,fernandowobeto -->
 
 <chapter xml:id="xsl.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
  <section xml:id="xsl.examples-collection">
+  <title>Exemplos de collection.xml e collection.xsl files</title>
   <para>
    Muitos exemplos nesta referência requerem um arquivo XML e XSL.
    Nós iremos usar <filename>collection.xml</filename> e
@@ -51,6 +52,93 @@
    </example>
   </para>
  </section>
+
+ <section xml:id="xsl.examples-errors">
+  <title>Tratamento de erros com funções de tratamento de erros libxml</title>
+  <para>
+   libxml oferece uma série de funções para tratamento de erros, que podem ser
+   empregadas para capturar e lidar com erros no processamento XSLT.
+  </para>
+  <para>
+   <example>
+    <title>fruits.xml</title>
+    <para>Um arquivo XML válido.</para>
+    <programlisting role="xml">
+<![CDATA[
+<fruits>
+ <fruit>Apple</fruit>
+ <fruit>Banana</fruit>
+ <fruit>Cherry</fruit>
+</fruits>
+]]>
+    </programlisting>
+   </example>
+   <example>
+    <title>fruits.xsl</title>
+    <para>Contém uma expressão de seleção inválida.</para>
+    <programlisting role="xml">
+<![CDATA[
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+ <xsl:output method="html" encoding="utf-8" indent="no"/>
+ <xsl:template match="fruits">
+  <ul>
+   <xsl:apply-templates/>
+  </ul>
+ </xsl:template>
+ <xsl:template match="fruit">
+  <li><xsl:value-of select="THIS IS A DELIBERATE ERROR!"/></li>
+ </xsl:template>
+</xsl:stylesheet>
+]]>
+    </programlisting>
+   </example>
+   <example xml:id="xsl.examples-errors.capture">
+    <title>Erros de agrupamento e impressão</title>
+    <para>
+     O exemplo abaixo captura e exibe erros de libxml gerados ao chamar
+     <methodname>XSLTProcessor::importStyleSheet</methodname> com uma 
+     folha de estilo contendo um erro.
+    </para>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+$xmldoc = new DOMDocument();
+$xsldoc = new DOMDocument();
+$xsl = new XSLTProcessor();
+
+$xmldoc->loadXML('fruits.xml');
+$xsldoc->loadXML('fruits.xsl');
+
+libxml_use_internal_errors(true);
+$result = $xsl->importStyleSheet($xsldoc);
+if (!$result) {
+    foreach (libxml_get_errors() as $error) {
+        echo "Libxml error: {$error->message}\n";
+    }
+}
+libxml_use_internal_errors(false);
+
+if ($result) {
+    echo $xsl->transformToXML($xmldoc);
+}
+
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+Libxml error: Invalid expression
+
+Libxml error: compilation error: file fruits.xsl line 9 element value-of
+Libxml error: xsl:value-of : could not compile select expression 'THIS IS A DELIBERATE ERROR!'
+]]>
+    </screen>
+   </example>
+  </para>
+ </section>
+
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:

reference/xsl/setup.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 383b579aef7ccf8e553603db99fd3c4a89bddabe Maintainer: fernandowobeto Status: ready --><!-- CREDITS: felipe,fernandowobeto -->
 
 <chapter xml:id="xsl.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
@@ -7,6 +7,7 @@
  <!-- {{{ Requirements -->
  <section xml:id="xsl.requirements">
   &reftitle.required;
+  &libxml.required;
   <para>
    Esta extensão usa <productname>libxslt</productname> que pode ser
    encontrada em <link xlink:href="&url.libxslt;">&url.libxslt;</link>. Versão