doc 4

git-svn-id: svn://tug.org/texlive/trunk@80 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 563 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/bezos/README b/Master/texmf-dist/doc/latex/bezos/README
new file mode 100644
index 00000000000..6f25f9c819c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bezos/README
@@ -0,0 +1,53 @@
+This directory contains some unrelated packages which I grouped for 
+not to clutter the contrib directory.
+
+The enumitem package has been moved to its own directory.
+
+accents
+~~~~~~~
+Tools for math accents: multiple and newly defined ones.
+
+Manual: accents.tex
+
+tensind
+~~~~~~~
+Tensorial indexes, with fine tuning and optional subtitution
+of letters (a -> \alpha, for instance)
+
+Both accents and tensind takes into account the 
+slight displacement of indexes in some letters (like $f^1_1$).
+
+Manual: tensind.tex
+
+dotlessi
+~~~~~~~~
+Another math tool. It provides dotless i's and j's for
+use in any math font (\mathrm, etc.). A single file---it is
+documented in the sty file itself.
+
+Manual: clear text in dotless.sty
+
+esindex
+~~~~~~~
+A tool to easy typing of Spanish index entries.
+
+Manual: esindex.tex
+
+checkend
+~~~~~~~~
+More useful error messages when there are open environments
+at \end{document}.
+
+Manual: clear text in checkend.sty
+
+_________________________________________________________________
+Javier Bezos                    | TeX y tipografia
+jbezos@wanadoo.es               | http://perso.wanadoo.es/jbezos/
+.................................................................
+CervanTeX   http://www.cervantex.org
+
+2003/08/30
+
+
+
+
diff --git a/Master/texmf-dist/doc/latex/bezos/accents.tex b/Master/texmf-dist/doc/latex/bezos/accents.tex
new file mode 100644
index 00000000000..feaf8e87800
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bezos/accents.tex
@@ -0,0 +1,207 @@
+% +--------------------------------------------------+
+% | Typeset this file to get the documentation.      |
+% +--------------------------------------------------+
+%
+% This file is copyrighted (c) 1998, 1999, 2000 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.
+
+\def\fileversion{1.2}
+\def\docdate{August 07, 2000}
+
+\documentclass{ltxguide}
+\usepackage{accents}
+
+\title{The \textsf{accents} Package\footnote{This 
+package is currently at version 1.2.}}
+
+\author{Javier Bezos\footnote{Please, send your
+comments and suggestions to \texttt{jbezos@wanadoo.es}, or
+to my postal address: Apartado 116.035, E-28080 Madrid, Spain.
+English is not my strong point, so contact me when you
+find mistakes in the manual. Other packages by the same author:
+\textsf{tensind} (tensorial indexes), \textsf{spanish}
+(for babel), \textsf{titlesec} (to redefine sectioning 
+macros), \textsf{dotlessi} (dotless i in any math group).}}
+
+\date{\docdate}
+
+\newenvironment{sample}{\begin{quote}\small\begin{tabbing}%
+  \hskip14pc\=\hskip6pc\\}
+  {\end{tabbing}\end{quote}}
+
+\DeclareMathAccent{\wtilde}{\mathord}{largesymbols}{"65}
+
+\raggedright
+\advance\textheight24pt
+
+\begin{document}
+
+\maketitle
+
+This package provides some miscellaneous tools for mathematical 
+accents, with the following goals in mind:
+\begin{itemize}
+\item Creating faked accents from non-accent symbols, like
+$\accentset{\star}{s}$.
+\item Grouping them, perhaps including actual accents, like 
+$\hat{\accentset{\star}{\hat h}}$. That
+has the side effect that multiple actual accents can be built
+as well.
+\item Putting them below the main symbol instead of above.
+\end{itemize}
+
+That is done so that the faked accents behave in quite similar fashion 
+to actual accents do; i.e., the skew of the letter is taken into 
+account (compare $\accentset{\ast}{d}$ with 
+$\accentset{\ast}{h}$) and the sub and superscripts attached to 
+it aren't misplaced (look carefully at $\accentset{\star}{f}_1^1$).
+
+Release 1.1 included a few new features, some of them following 
+suggestions by Donald Arseneau.  In particular, the |\underaccent| 
+command has been fully reimplemented for the slant to be taken into 
+account and the ``accent'' to be placed below the symbol can be 
+anyone, not only real accents. This release just makes it compatible
+with \textsf{amsmath} 2 with a quick fix.
+
+\begin{decl}
+|\DeclareMathAccent|
+\end{decl}
+
+This \LaTeXe{} command is reimplemented so that newly defined accents 
+will incorporate the features of this package.  The standard accents 
+are automatically redefined, including |\mathring| if you are using 
+one of the latest \LaTeX{} releases.  However, both |\widetilde| and
+|\widehat| remains untouched.  If you are using a non standard 
+math encoding, the accents following the standard encoding names are 
+rightly redefined, but new accents are not converted because 
+\textsf{accents} is not aware of its existence.
+
+See |fntguide.tex| in the \LaTeX{} standard distribution for a discussion on
+ |\DeclareMathAccent|.
+
+\begin{decl}
+|\ring{<symbol>}|
+\end{decl}
+
+The accent in $\ring{x}$, which was available in this package (and
+in fact in many others) before
+the |\mathring| command was added to the \LaTeX{} kernel.
+
+\begin{decl}
+|\accentset{<accent>}{<symbol>}|
+\end{decl}
+
+Builds a faked accent, as for instance
+\begin{sample}
+|\accentset{\star}{d}|    \> $\accentset{\star}{d}$\\
+|\accentset{\diamond}{h}| \> $\accentset{\diamond}{h}$\\
+|\tilde{\accentset{\circ}{\phi}}| \>
+    $\tilde{\accentset{\circ}{\phi}}$
+\end{sample}
+The |<accent>| is always in |\scriptscriptmode|; hence, using
+|\accentset| in scripts won't give the desired  result. Of course,
+if you use some faked accent many times, you can define:
+\begin{verbatim}
+\newcommand\starred[1]{\accentset{\star}{#1}}
+\end{verbatim}
+and |\starred| will become an accent, like |\hat|, |\tilde|, etc.
+
+\begin{decl}
+|\dddot  \ddddot|
+\end{decl}
+
+Two prefabricated faked accents: $\dddot{f}$ and $\ddddot{f}$.
+
+\begin{decl}
+|\underaccent{<accent>}{<symbol>}|
+\end{decl}
+
+This command puts the |<accent>| under the |<symbol>|. Both real
+and faked accents are allowed. For instance,
+\begin{sample}
+|\underaccent{\hat}{x}|      \> $\underaccent{\hat}{x}$\\
+|\underaccent{\bar}{\gamma}| \> $\underaccent{\bar}{\gamma}$\\
+|\underaccent{\triangleright}{q}|  \>
+   $\underaccent{\triangleright}{q}$\\
+|\underaccent{\tilde}{\mathcal{A}}| \>
+    $\underaccent{\tilde}{\mathcal{A}}$
+\end{sample}
+
+Many people likes using the wider version of the tilde accent as 
+printed by the |\widetilde| command, i.e., $\widetilde{A}$ instead of 
+$\tilde{A}$.  I find that aesthetically questionable, but anyway it
+can be used under the symbol as well. Since |\widetilde| remains
+untouched, you should define:
+\begin{verbatim}
+\DeclareMathAccent{\wtilde}{\mathord}{largesymbols}{"65}
+\end{verbatim}
+and write |\underaccent{\wtilde}{V}|, say (giving 
+$\underaccent{\wtilde}{V}$). You may build an accent with
+|\sim|, too. (The value for a wide hat is |"62|)
+
+Sadly, \TeX{} lacks of a mechanism to place underaccents similar to 
+that used in accents.  Letters have a large variety of shapes and 
+finding an automatic adjusting is practically impossible.  Compare for 
+instance the following letters:
+\begingroup
+\def\\{\underaccent{\bar}}%
+$\\V$, $\\Q$, $\\p$, $\\q$, $\\f$,
+$\\\beta$, $\\\gamma$, $\\{\mathcal{F}}$, $\\{\mathcal{A}}$
+\endgroup
+and you wil understand the difficulties.
+
+\begin{decl}
+|\undertilde{<symbols>}|
+\end{decl}
+
+This is the ``under'' version of |\widetilde| and like the latter is intended for constructions
+involving several symbols. For instance:
+\begin{sample}
+|\undertilde{CV}| \> $\undertilde{CV}$
+\end{sample}
+Note that in this case no correction is made in the placement of the tilde.
+
+\begin{decl}
+|nonscript single|
+\end{decl}
+
+These package options are intended mainly for speeding up the 
+typesetting of document.  The algorithm used here is recursive and 
+very slow; although in fast processors that is not felt, in slow 
+system that could be very annoying.
+
+\begin{description}
+\item[single] If you are interested only in |\accentset|.
+ Accents are not reimplemented.
+\item[nonscript] If you intend to use multiple accents in
+ text and display modes only.
+\end{description}
+
+Macros are speeded up dramaticaly with both options; if your system is slow,
+I commend using them in drafts and removing them for the final print.
+
+Finally, some remarks:
+\begin{itemize}
+\item The package does not provides alternative accents for fonts
+  lacking them. If you want an accented  |\mathcal| letter you had to
+  write |\hat{\hat{\mathcal{A}}}| ($\hat{\hat{\mathcal{A}}}$).
+\item |\mathbf{\hat{\hat h}}| gets the bold accent;
+ |\hat{\hat{\mathbf{h}}}| not.
+\item The symbol in |\accentset| must be a single symbol.
+\item If you use \textsf{accents} with \textsf{amsmath} 2, you must
+load \textsf{accents} after. Note that \textsf{amsmath} could redefine
+some accents; in particular, if you experience problems with |\vec|
+and you are using the standard math encodings, define:
+\begin{verbatim}
+\let\vec\relax
+\DeclareMathAccent{\vec}{\mathord}{letters}{"7E}
+\end{verbatim}
+\end{itemize}
+
+\end{document}
+
diff --git a/Master/texmf-dist/doc/latex/bezos/esindex.tex b/Master/texmf-dist/doc/latex/bezos/esindex.tex
new file mode 100644
index 00000000000..acad83e758c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bezos/esindex.tex
@@ -0,0 +1,109 @@
+% 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}
diff --git a/Master/texmf-dist/doc/latex/bezos/tensind.tex b/Master/texmf-dist/doc/latex/bezos/tensind.tex
new file mode 100644
index 00000000000..d81a3577a73
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bezos/tensind.tex
@@ -0,0 +1,194 @@
+% +--------------------------------------------------+
+% | Typeset this file to get the documentation.      |
+% +--------------------------------------------------+
+%
+% This file is copyrighted (c) 1998, 2000 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.
+
+\def\fileversion{1.0}
+\def\docdate{August 7, 2000}
+
+\documentclass{ltxguide}
+\usepackage{tensind}
+
+\title{The \textsf{tensind} Package for
+Tensorial Indexes\footnote{This 
+package is currently at version 1.0.}}
+
+\author{Javier Bezos\footnote{Please, send your
+comments and suggestions to \texttt{jbezos@wanadoo.es}, or
+to my postal address: Apartado 116.035, E-28080 Madrid, Spain.
+English is not my strong point, so contact me when you
+find mistakes in the manual. Other packages by the same author:
+\textsf{accents, titlesec, dotlessi}.}}
+
+\date{\docdate}
+
+\newenvironment{sample}{\begin{quote}\small\begin{tabbing}%
+  \hskip12pc\=\hskip6pc\\}
+  {\end{tabbing}\end{quote}}
+  
+\tensordelimiter{?}
+\tensorformat{lrb}
+
+\raggedright
+
+\begin{document}
+
+\maketitle
+  
+This package provides typographically fine tensorial notation, with the 
+following features:
+\begin{itemize}
+\item Dots filling gaps.
+\item Symbol subtitution to easy typing (if you are using greek letters, for 
+example).
+\item Corrected position of indexes: horizontally, to compensate the small 
+displacement in letters
+like $f$ (look carefully at $f_*^*$) and vertically, to avoid superscripts 
+too raised.
+\item Aditional minute corrections are also allowed.
+\end{itemize}
+
+\section{User Interface}
+
+\begin{decl}
+|\tensordelimiter{<tensor-delim>}|
+\end{decl}
+
+Defines |<tensor-delim>| to be a tensor delimiter. In subsequent examples we will 
+assume
+\begin{verbatim}
+\tensordelimiter{?}
+\end{verbatim}
+and every instance of |?| will actually mean |<tensor-delim>|.
+
+\begin{decl}
+|?[<format>]{<nucleous>}{<special-index>}{<special-index>}...|\\
+|                       <super-or-sub><super-or-sub>...?|
+\end{decl}
+
+Creates a tensor. |<super-or-sub>| is either |_{<index>}{<index>}...| or 
+|^{<index>}{<index>}|.
+|<nucleous>| is the symbol which indexes will be add to. |<special-index>| is a 
+superscript which is neither covariant nor contravariant (dual, 
+prime...). In 
+one-letter |<index>|, |<special-index>| or |<nucleous>|, curly braces can be 
+omitted.
+For example:
+\begin{sample}
+|?R_ij^kl_\alpha^\beta?|     \>        $?R_ij^kl_\alpha^\beta?$\\[2pt]
+|?R^ij_kl^\alpha_\beta?|     \>        $?R^ij_kl^\alpha_\beta?$\\[2pt]
+|?R**_ij^kl_\alpha^\beta?|   \>        $?R**_ij^kl_\alpha^\beta?$\\[2pt] 
+|?R**^ij_kl^\alpha_\beta?|   \>        $?R**^ij_kl^\alpha_\beta?$
+\end{sample}
+
+(\emph{Don't forget the closing |?|!})
+Finally, |<format>| changes the format in a tensor. (See |\tensorformat| 
+below.)
+
+\begin{decl}
+|\tensorformat{<format>}|
+\end{decl}
+
+The following letter may be used in format.
+\begin{itemize}
+\item[\texttt{l}] Gaps to the left of the last index are filled with dots.
+\item[\texttt{r}] Gaps to the right of the first index are filled.
+\item[\texttt{e}] If there is no index (empty), gaps are filled.
+\item[\texttt{b}] Only gaps in subscripts are filled.
+\end{itemize}
+
+Sensible settings are: none (no dots), |l| and |lrb|.
+Further options are:
+\begin{itemize}
+\item[\texttt{c}] Brings index lines closer.
+\item[\texttt{o}] Opens index lines.
+\item[\texttt{s}] Styled. |o| in display style and |c| otherwise.
+\end{itemize}
+These options are mutually exclusive. If none of them is
+used, then indexes behave in a similar way to standard ones.
+This document sets
+\begin{verbatim}
+\tensorformat{lrb}
+\end{verbatim}
+
+\begin{sample}
+|?[]f\prime_ij^kl?|    \>  $?[]f\prime_ij^kl?$\\[2pt]
+|?[e]f^ij?|            \>  $?[e]f^ij?$ \\[2pt] 
+|?[l]f*_ij^kl?|        \>  $?[l]f*_ij^kl?$\\[2pt]
+|?[c]R^ij_kl?|         \>  $?[c]R^ij_kl?$
+\end{sample}
+
+\begin{decl}
+|\indexdot|
+\end{decl}
+
+This macro is the index dot. Defined to |\cdot|. You can
+redefine it with |\renewcommand|.
+
+\begin{decl}
+|\whenindex{<index>}{<new-index>}{<commands>}|
+\end{decl}
+
+Automatically replaces |<index>| (if not enclosed in braces)
+by |<new-index>| and the additional |<commands>| are
+executed. For example, if you like to use greek indexes:
+\begin{verbatim}
+\whenindex{a}{\alpha}{}
+\whenindex{b}{\beta}{}
+\whenindex{g}{\gamma}{}
+\end{verbatim}
+
+\whenindex{a}{\alpha}{}
+\whenindex{b}{\beta}{}
+\whenindex{g}{\gamma}{
+}
+A |\whenindex{'}{\prime}{}| is performed by the package. For instance
+\begin{sample}
+|?R'_ijk^abg?|    \>  $?R'_ijk^abg?$
+\end{sample}
+
+In |<commands>|, two command for space fine-tuning are provided:
+|\sbadjust{<index>}{<comma-space>}| adds |<comma-space>| times
+|\,| before the current subscript index if the last superscript index
+was |<index>|. Similarly, |\spadjust| adds the space before the current
+superscript index if the last subscript index was |<index>|.
+For instance, the normal result of |?[]R^ik_lm?| is $?[]R^ij_kl?$, but
+with
+\begin{verbatim}
+\whenindex{k}{k}{\sbadjust{j}{-1}}
+\end{verbatim}
+\whenindex{k}{k}{\sbadjust{j}{-1}}
+is $?[]R^ij_kl?$.
+These commands will be ignored if dots are used.
+
+Two further command allowed in |\whenindex|
+are: |\omitdot| omits the dot for the current
+index, and |\finishdots| omits as well all subsequent indexes.
+For example
+\begin{verbatim}
+\whenindex{;}{\,;\,}{\finishdots}
+\end{verbatim}
+\whenindex{;}{\,;\,}{\finishdots}
+
+\begin{sample}
+|?[lr]A*_i^kl;i?|  \>   $?[lr]A*_i^kl;i?$
+\end{sample}
+
+\begin{decl}
+|tensor|
+\end{decl}
+
+The environment called by |?...?|. Useful if for some reason you
+don't want an equivalent defined with |\tensordelimiter| . Example:
+\begin{verbatim}
+\begin{tensor}[lr]A*_i^kl;i\end{tensor}
+\end{verbatim}
+
+\end{document}