% +--------------------------------------------------+
% | Typeset this file to get the documentation. |
% +--------------------------------------------------+
%
%% Copyright (C) 1998, 1999, 2000, 2006 Javier Bezos
%% All Rights Reserved
%% http://www.tex-tipografia.com
%%
%% This work may be distributed and/or modified under the conditions
%% of the LaTeX Project Public License, either version 1.3 of this
%% license or (at your option) any later version. The latest version
%% of this license is in
%% http://www.latex-project.org/lppl.txt
%% and version 1.3 or later is part of all distributions of LaTeX
%% version 2003/12/01 or later.
%%
%% This work has the LPPL maintenance status "maintained".
%%
%% This Current Maintainer of this work is Javier Bezos.
%%
%% This work consists of the files accents.tex and accents.sty.
\def\fileversion{1.3}
\def\docdate{May 12, 2006}
\documentclass{ltxguide}
\usepackage{accents}
\title{The \textsf{accents} Package\footnote{This
package is currently at version \fileversion.}}
\author{Javier Bezos\footnote{For bug reports, comments and
suggestions go to
\texttt{http://www.tex-tipografia.com}.
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}