- Avoid comments in CDATA sections so that these documents can easily be

  converted to DocBook 5.0.  This results in an ugly markup at some parts
  but this can be corrected after the conversion is done.  Anyway, these
  sections need serious rewriting.
- Fix a double application element

2 files changed, 24 insertions, 35 deletions

diff --git a/pt_BR.ISO8859-1/books/fdp-primer/sgml-markup/chapter.xml b/pt_BR.ISO8859-1/books/fdp-primer/sgml-markup/chapter.xml
index b623738add..be204394ab 100644
--- a/pt_BR.ISO8859-1/books/fdp-primer/sgml-markup/chapter.xml
+++ b/pt_BR.ISO8859-1/books/fdp-primer/sgml-markup/chapter.xml
@@ -177,21 +177,21 @@
 
 	  <para>Uso:</para>
 
-	  <programlisting><![CDATA[<h1>Primeira seção</h1>
+	  <programlisting>&lt;h1&gt;Primeira seção&lt;/h1&gt;
 
-<!-- a introdução do documento entra aqui -->
+&lt;!&hyphen;- a introdução do documento entra aqui -&hyphen;&gt;
 
-<h2>Este é o cabeçalho da primeira seção</h2>
+&lt;h2&gt;Este é o cabeçalho da primeira seção&lt;/h2&gt;
 
-<!-- O conteúdo da primeira seção entra aqui -->
+&lt;!&hyphen;- O conteúdo da primeira seção entra aqui -&hyphen;&gt;
 
-<h3>Este é o cabeçalho da primeira subseção</h3>
+&lt;h3&gt;Este é o cabeçalho da primeira subseção&lt;/h3&gt;
 
-<!-- O conteúdo da primeira subseção entra aqui -->
+&lt;!&hyphen;- O conteúdo da primeira subseção entra aqui -&hyphen;&gt;
 
-<h2>Este é o heading para a segunda seção</h2>
+&lt;h2&gt;Este é o heading para a segunda seção&lt;/h2&gt;
 
-<!-- O conteúdo da segunda seção entra aqui -->]]></programlisting>	    
+&lt;!&hyphen;- O conteúdo da segunda seção entra aqui -&hyphen;&gt;</programlisting>	    
 	</example>
 	
 	<para>Geralmente, uma página HTML deveria ter um 
@@ -211,13 +211,13 @@
 
 	  <para>Uso:</para>
 
-	  <programlisting><![CDATA[<h1>Primeira seção</h1>
+	  <programlisting>&lt;h1&gt;Primeira seção&lt;/h1&gt;
 
-<!-- Introdução do documento -->
+&lt;!&hyphen;- Introdução do documento -&hyphen;&gt;
 
-<h3>Subseção</h3>
+&lt;h3&gt;Subseção&lt;/h3&gt;
 
-<!-- Isto é ruim, não foi usado <h2> -->]]></programlisting>
+&lt;!&hyphen;- Isto é ruim, não foi usado <h2> -&hyphen;&gt;</programlisting>
 	</example>
       </sect3>
 
@@ -509,8 +509,6 @@ células pequenas à direita.</p>
   </tr>
 
   <tr>
-    <!-- Como a célula grande à esquerda funde-se com esta linha,
-         o primeiro <td> ocorrerá à a sua direita. -->
     <td>Célula do meio a direita</td>
   </tr>
 
diff --git a/pt_BR.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml b/pt_BR.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml
index 8d056ae206..fe4d59da50 100644
--- a/pt_BR.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml
+++ b/pt_BR.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml
@@ -1008,16 +1008,16 @@ onsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen>
 
       <programlisting>&lt;!-- Teste de comentário --></programlisting>
 
-      <programlisting><![CDATA[
-<!-- Este é o interior do comentário -->
+      <programlisting>
+&lt;!&hyphen;- Este é o interior do comentário -&hyphen;&gt;
 
-<!-- Este é outro comentário    -->
+&lt;!&hyphen;- Este é outro comentário    -&hyphen;&gt;
 
-<!-- Esta é uma forma 
-     de fazer comentários de várias linhas -->
+&lt;!&hyphen;- Esta é uma forma 
+     de fazer comentários de várias linhas -&hyphen;&gt;
 
-<!-- Esta é outra forma  --
-  -- de fazer comentários de várias linhas -->]]></programlisting>
+&lt;!&hyphen;- Esta é outra forma  -&hyphen;
+  &hyphen;- de fazer comentários de várias linhas -&hyphen;&gt;</programlisting>
     </example>
 
     <para>Se você já utilizou HTML antes, você pode ter 
@@ -1037,12 +1037,12 @@ onsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen>
     <example>
       <title>Comentários SGML errados</title>
 
-      <programlisting><![CDATA[
-<!-- Este é o comentário --
+      <programlisting>
+&lt;!&hyphen;- Este é o comentário -&hyphen;
 
      Isto está fora do comentário!
 
-  -- de volta para dentro do comentário -->]]></programlisting>
+  &hyphen;- de volta para dentro do comentário -&hyphen;&gt;</programlisting>
 
       <para>O interpretador SGML irá tratar isto como ele 
 	é realmente;</para>
@@ -1052,12 +1052,12 @@ onsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen>
       <para>Isto não é um SGML válido, e pode 
 	dar mensagens de erro confusas.</para>
 
-      <programlisting><![CDATA[<!--------------- Isto é uma idéia muito ruim --------------->]]></programlisting>
+      <programlisting>&lt;!&hyphen;&hyphen;&hyphen;&hyphen;&hyphen; Isto é uma idéia muito ruim &hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&gt;</programlisting>
 
       <para>E como o exemplo sugere, <emphasis>não escreva
 	</emphasis> comentários como esse.</para>
 
-      <programlisting><![CDATA[<!--===================================================-->]]></programlisting>
+      <programlisting>&lt;!&hyphen;-===================================================-&hyphen;&gt;</programlisting>
 
       <para>Esta é uma abordagem (ligeiramente) melhor, mas 
 	ele ainda é potencialmente confuso para as pessoas 
@@ -1209,8 +1209,6 @@ onsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen>
 <!ENTITY % param.some "some">
 <!ENTITY % param.text "text">
 <!ENTITY % param.new  "%param.some more %param.text">
-
-<!-- %param.new agora contém "some more text" -->
 ]>]]></programlisting>
       </example>
 	
@@ -1236,8 +1234,6 @@ onsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen>
     <title>Um exemplo de arquivo HTML</title>
   </head>
 
-  <!-- Você pode ter alguns comentários aqui também -->
-	  
   <body>	    
     <p>Este é um parágrafo contendo algum texto.</p>
 
@@ -1344,11 +1340,9 @@ onsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen>
 <!ENTITY chapter.1 SYSTEM "chapter1.xml">
 <!ENTITY chapter.2 SYSTEM "chapter2.xml">
 <!ENTITY chapter.3 SYSTEM "chapter3.xml">
-<!-- e assim por diante -->
 ]>
 
 <html>
-  <!-- Utilize as entidades para carregar os capítulos -->
 
   &chapter.1;
   &chapter.2;
@@ -1414,10 +1408,7 @@ onsgmls:example.xml:6:8:E: end tag for "HEAD" which is not finished</screen>
 	  entidades gerais como antes;</para>
 	
 	<programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
-<!-- Define uma entidade de parâmetro para carregar as entidades gerais de capitulo -->
 <!ENTITY % chapters SYSTEM "chapters.ent">
-
-<!-- Agora utilize a entidade de parâmetro para carregar neste arquivo -->
 %chapters;
 ]>