- Indexterms should not be embedded directly into a question or answer

  element but into a deeper paragraph, optimally right after the
  referenced word without spaces even [1] but somehow the schema allows
  badly nested indexterms.  Correct such entires in the whole documentation
  set.
- Add constraints to check for invalid indexterm entries.

See also: http://www.sagehill.net/docbookxsl/GenerateIndex.html#Indexterms [1]

1 files changed, 5 insertions, 16 deletions

diff --git a/es_ES.ISO8859-1/books/handbook/mail/chapter.xml b/es_ES.ISO8859-1/books/handbook/mail/chapter.xml
index 50590ba2e0..c55b1defb8 100755
--- a/es_ES.ISO8859-1/books/handbook/mail/chapter.xml
+++ b/es_ES.ISO8859-1/books/handbook/mail/chapter.xml
@@ -970,9 +970,8 @@ purgestat	/usr/local/supermailer/bin/purgestat-compat</programlisting>
           caso <hostid role="fqdn">mumble.bar.edu</hostid> en lugar de
           referirse a ella simplemente como <hostid>mumble</hostid>.</para>
 
-	<indexterm><primary>BIND</primary></indexterm>
 	<para>Tradicionalmente, la referencia incompleta era posible
-          utilizando <quote>resolvers</quote> de BSD BIND.
+          utilizando <quote>resolvers</quote> de BSD BIND<indexterm><primary>BIND</primary></indexterm>.
 	  No obstante la versión de <application>BIND</application>
           que en la actualidad se ofrece con FreeBSD ya no permite por defecto
           el uso de dichas abreviaturas salvo para aquellas máquinas
@@ -1009,10 +1008,6 @@ purgestat	/usr/local/supermailer/bin/purgestat-compat</programlisting>
 
       <qandaentry>
 	<question>
-	  <indexterm>
-	    <primary>MX record</primary>
-	  </indexterm>
-
 	<para><application>sendmail</application> dice <errorname>mail
 	  loops back to myself</errorname> (el correo vuelve a mis manos)</para>
 	</question>
@@ -1031,7 +1026,7 @@ purgestat	/usr/local/supermailer/bin/purgestat-compat</programlisting>
 Usted ha especificado que el correo para el dominio (por ejemplo,
 para el dominio dominio.net) sea reenviado a una máquina determinada
 (en este caso relay.dominio.net), para lo que se utiliza un registro
-de DNS de tipo MX, pero la máquina que actúa de relay no se
+de DNS de tipo MX<indexterm><primary>MX record</primary></indexterm>, pero la máquina que actúa de relay no se
 reconoce a sí misma como perteneciente al dominio dominio.net.
 Se debe añadir dominio.net al fichero /etc/mail/local-host-names,
 que recibe el nombre de /etc/sendmail.cw en versiones de sendmail previas
@@ -1052,7 +1047,6 @@ al fichero <filename>/etc/mail/sendmail.cf</filename>
 
       <qandaentry>
         <question>
-	  <indexterm><primary>PPP</primary></indexterm>
 	<para>?Cómo puedo ejecutar un servidor de correo
           utilizando una máquina que se conecta a internet
               mediante modem analógico (dial-up) ?</para>
@@ -1061,16 +1055,11 @@ al fichero <filename>/etc/mail/sendmail.cf</filename>
 	<answer>
 	<para>Se quiere conectar una máquina FreeBSD dentro de una LAN a
 	  Internet.  La máquina FreeBSD será una pasarela de
-          correo para dicha LAN.  La conexión mediante PPP no es
+          correo para dicha LAN.  La conexión mediante PPP<indexterm><primary>PPP</primary></indexterm> no es
 	  dedicada.</para>
 
-	<indexterm><primary>UUCP</primary></indexterm>
-	<indexterm>
-	  <primary>MX record</primary>
-	</indexterm>
-
 	<para>Existen al menos dos formas distintas de hacerlo.  Una de ellas
-          consiste en utilizar UUCP.</para>
+          consiste en utilizar UUCP<indexterm><primary>UUCP</primary></indexterm>.</para>
 
 	<para>Otra forma consiste en hacerse con un servidor de internet a
           tiempo completo para proporcionar servicios de agente de transporte
@@ -1101,7 +1090,7 @@ al fichero <filename>/etc/mail/sendmail.cf</filename>
           La aplicación <application>sendmail</application>
           automáticamente entregará el correo al servidor
           especificado como agente de transporte de correo secundario
-          (segundo registro MX), es decir, entregará el correo a
+          (segundo registro MX)<indexterm><primary>MX record</primary></indexterm>, es decir, entregará el correo a
           nuestro proveedor de servicios de internet (<hostid
           role="domainname">ejemplo.net</hostid>).  El sitio MX secundario
           tratará de conectarse con nuestra máquina de una forma