% This file is copyrighted (c) 1998-2004 by Javier Bezos.
% All Rights Reserved.
% 
% This program can be redistributed and/or modified under the terms
% of the LaTeX Project Public License Distributed from CTAN
% archives in directory macros/latex/base/lppl.txt; either
% version 1 of the License, or any later version.

\documentclass{article}
\usepackage[spanish,activeacute]{babel}
\usepackage[cp1252]{inputenc}

\title{Paquete \textsf{esindex}\footnote{Este
     archivo est\'a actualmente en la versi\'on 1.1
     con fecha 15/07/19.
     Esta copia del manual se compuso el~\today.}}

 \author{Javier Bezos\footnote{Por favor, env\'{\i}en
   comentarios y sugerencias a \texttt{jbezos@wanadoo.es}
   o a mi direcci\'on postal:  Apartado 116.035, E-28080 Madrid,
   Spain.}}
   
\raggedright
\parskip=1ex

\date{19/07/2004}

\begin{document}
	
\maketitle

This package defines a single command \verb|\esindex| which
easies writing Spanish index entries:
\begin{verbatim}
\esindex{cañón}
\end{verbatim}
is equivalent to
\begin{verbatim}
\index{can^^ffon@cañón}
\end{verbatim}
Since it is an especifically Spanish tool, the documentation
is in Spanish.

\vspace*{1pc}

Este paquete ha sido dise'nado para facilitar la escritura
de 'indices correctamente alfabetizados en castellano. Su 'unica orden es
\verb|\esindex| que convierte a una forma adecuada su argumento.
As'i por ejemplo,
\begin{verbatim}
\esindex{cañón}
\end{verbatim}
equivale a
\begin{verbatim}
\index{can^^ffon@cañón}
\end{verbatim}
No es necesario usar \textsf{babel} salvo, l'ogicamente, si los acentos
est'an escritos en forma de abreviaciones (\verb|'a|, \verb|'e|, etc.)
en lugar de con los caracteres reales.  En este 'ultimo caso, el paquete
utiliza ciertas 'ordenes internas de \textsf{babel} por lo que no
puedo garantizar su funcionamiento correcto con versiones distintas a
las 3.6 a 3.8.  En caso de que \textsf{esindex} sea incompatible con
futuras versiones de \textsf{babel} intentar'e adaptarlo en el menor
tiempo posible.

Salvo el car'acter \verb|actual| (normalmente \verb|@|) se pueden usar
todos los caracteres especiales de \textit{MakeIndex}.  Se pueden usar
convenciones diferentes a las normales, pero en este caso hacen falta
ajustes adicionales en caso de que los modificados sean \verb|actual|,
\verb|encap|, \verb|level| o \verb|quote|.  En ese caso basta con
indicar los caracteres que hay que usar como opciones de paquete.  Por
ejemplo, si para \verb|quote| decidimos usar \verb|$| en nuestro
archivo \verb|.ist| particular, tendr'iamos que llamar al paquete del
siguiente modo:
\begin{verbatim}
\usepackage[quote=$]{esindex}
\end{verbatim}

Es importante observar que, a diferencia de la opci'on para alem'an de
\textit{MakeIndex}, el uso de \verb|"| en abreviaciones como \verb|"u|
es completamente leg'itimo, ya que el paquete reconoce tal
combinaci'on y la trata aparte.  Lo mismo vale para \verb|'| o
\verb|~| en caso de que se usaran como car'acter especial.  Es decir
\begin{verbatim}
\esindex{{"!`}Cig"ue'nas{"!}|textbf}
\end{verbatim}
equivale a
\begin{verbatim}
\index{{"!`}Ciguen^^ffas{"!}@{"!`}Cig"ue'nas{"!}|textbf}
\end{verbatim}

Sin embargo, el uso del car'acter \verb|quote|
ante \verb|encap| o \verb|level| no
se detecta a menos que el grupo est'e encerrado entre llaves.
Por ejemplo, en lugar de \verb/\esindex{Pleca: "|}/ debe escribirse
\verb/\esindex{Pleca: {"|}}/. (En realidad en este caso podr'ia
haberse usado \verb|\index|. Es tan s'olo un ejemplo.)

Aunque el hecho de que \verb|@| no se pueda usar en \verb|\esindex|
hace que todav'ia algunas entradas se tengan que hacer <<a mano>>,
la mayor parte del trabajo se ve considerablemente simplificado.

Finalmente, hay que se'nalar que con este paquete no se crea en el 
'indice una entrada propia para la palabras que empiezan por e'ne,
sino que tan s'olo se a'naden al final de la ene. En el rar'isimo
caso de que hubiera palabras que empiezan por e'ne habria que
modificar el archivo \verb|.ind| a mano.

\end{document}
