From b4fc5f639874db951177ec539299d20908adb654 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 9 Jan 2006 00:44:40 +0000 Subject: doc 4 git-svn-id: svn://tug.org/texlive/trunk@80 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/bezos/README | 53 +++++++ Master/texmf-dist/doc/latex/bezos/accents.tex | 207 ++++++++++++++++++++++++++ Master/texmf-dist/doc/latex/bezos/esindex.tex | 109 ++++++++++++++ Master/texmf-dist/doc/latex/bezos/tensind.tex | 194 ++++++++++++++++++++++++ 4 files changed, 563 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/bezos/README create mode 100644 Master/texmf-dist/doc/latex/bezos/accents.tex create mode 100644 Master/texmf-dist/doc/latex/bezos/esindex.tex create mode 100644 Master/texmf-dist/doc/latex/bezos/tensind.tex (limited to 'Master/texmf-dist/doc/latex/bezos') 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{}| +\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{}{}| +\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 || 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{}{}| +\end{decl} + +This command puts the || under the ||. 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{}| +\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 <>, +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{}| +\end{decl} + +Defines || to be a tensor delimiter. In subsequent examples we will +assume +\begin{verbatim} +\tensordelimiter{?} +\end{verbatim} +and every instance of |?| will actually mean ||. + +\begin{decl} +|?[]{}{}{}...|\\ +| ...?| +\end{decl} + +Creates a tensor. || is either |_{}{}...| or +|^{}{}|. +|| is the symbol which indexes will be add to. || is a +superscript which is neither covariant nor contravariant (dual, +prime...). In +one-letter ||, || or ||, 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, || changes the format in a tensor. (See |\tensorformat| +below.) + +\begin{decl} +|\tensorformat{}| +\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{}{}{}| +\end{decl} + +Automatically replaces || (if not enclosed in braces) +by || and the additional || 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 ||, two command for space fine-tuning are provided: +|\sbadjust{}{}| adds || times +|\,| before the current subscript index if the last superscript index +was ||. Similarly, |\spadjust| adds the space before the current +superscript index if the last subscript index was ||. +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} -- cgit v1.2.3