summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/mattens
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-03-02 03:03:38 +0000
committerNorbert Preining <norbert@preining.info>2022-03-02 03:03:38 +0000
commit1769d3d8842ef66919943128931e647de9756adb (patch)
tree46df94f2204cba9384cccf5ab6ca8cbbcd49bcad /macros/latex/contrib/mattens
parent3e9a44ea155766214d8657ed79db2206592b6e8e (diff)
CTAN sync 202203020303
Diffstat (limited to 'macros/latex/contrib/mattens')
-rw-r--r--macros/latex/contrib/mattens/README16
-rw-r--r--macros/latex/contrib/mattens/mattens.dtx342
-rw-r--r--macros/latex/contrib/mattens/mattens.ins14
-rw-r--r--macros/latex/contrib/mattens/mattens.pdfbin541450 -> 481295 bytes
-rw-r--r--macros/latex/contrib/mattens/mattens_sample.pdfbin194705 -> 233282 bytes
5 files changed, 125 insertions, 247 deletions
diff --git a/macros/latex/contrib/mattens/README b/macros/latex/contrib/mattens/README
index d1c6a93471..1885ed18e6 100644
--- a/macros/latex/contrib/mattens/README
+++ b/macros/latex/contrib/mattens/README
@@ -2,8 +2,8 @@
for vector/tensor typesetting
Author: Danie Els
- Copyright (c) 2001-2010 Danie Els
- Licence: LaTeX Project Public License
+ Copyright (c) 2001-2022 Danie Els
+ Licence: LaTeX Project Public License 1.3c
DESCRIPTION
===========
@@ -18,11 +18,11 @@ DESCRIPTION
1. Hassenpflug, W.C., "Matrix Tensor Notation Part I.
Rectilinear Orthogonal Coordinates."
- Comput. Math. Appl., vol. 26, no. 3, 1993, pp. 55–-93.
+ Comput. Math. Appl., vol. 26, no. 3, 1993, pp. 55-93.
2. Hassenpflug, W.C., "Matrix Tensor Notation Part II.
Skew and Curved Coordinates."
- Comput. Math. Appl., vol. 29, no. 11, 1995, pp. 1-–103.
+ Comput. Math. Appl., vol. 29, no. 11, 1995, pp. 1-103.
FILES IN DISTRIBUTION
@@ -30,7 +30,7 @@ FILES IN DISTRIBUTION
BASE DISTRIBUTION:
- readme.txt This file.
+ README This file.
mattens.ins Package installation file.
mattens.dtx Package source file.
@@ -68,6 +68,12 @@ FILES IN DISTRIBUTION
TransRot.asy Asympote source file
TransRot.pdf Graphics input file
+
+ EulerGyro.asy Asympote source file
+ EulerGyro.pdf Graphics input file
+
+ Euler-313.asy Asympote source file
+ Euler-313.pdf Graphics input file
BASIC INSTALLATION
diff --git a/macros/latex/contrib/mattens/mattens.dtx b/macros/latex/contrib/mattens/mattens.dtx
index 6833a44460..5a3d47819e 100644
--- a/macros/latex/contrib/mattens/mattens.dtx
+++ b/macros/latex/contrib/mattens/mattens.dtx
@@ -1,7 +1,7 @@
% \iffalse meta-comment
%
% mattens.dtx
-% Copyright (C) 2001--2009 Danie Els
+% Copyright (C) 2001--2022 Danie Els
%
% -------------------------------------------------------------------
% The mattens package
@@ -17,7 +17,7 @@
%
% This work has the LPPL maintenance status 'maintained'.
%
-% This Current Maintainer of this work is Danie Els (dnjels@sun.ac.za)
+% This Current Maintainer of this work is Danie Els (dnjels@gmail.com)
%
% This package consists of the files: mattens.dtx
% mattens.ins
@@ -28,7 +28,7 @@
%
% \iffalse
%<*driver>
-\documentclass[a4paper]{ltxdoc}
+\documentclass[a4paper,notitlepage]{ltxdoc}
\makeatletter
\newcommand{\DeclareSBox}[2]{%
\@ifdefinable{#1}{%
@@ -47,6 +47,8 @@
% the accents and bm packages are loaded
\DeclareSBox{\AccentBox}{$\dot{\overline{f}}^a_b$}
\usepackage{array}
+\usepackage{enumitem}
+ \setlist{itemsep=\smallskipamount, parsep=0pt}
\usepackage{accents}
\newcommand{\dotr}[1]{\accentset{\phantom{r}{\displaystyle.}r}{#1}}
\usepackage{mattens}
@@ -58,11 +60,11 @@
\newcommand*{\MT}{\pkg{mattens}}
\newcommand*{\Hass}{Hassenpflug}
\newcommand*{\myemph}[1]{\emph{#1}}
- \newenvironment{Decl}%
+ \newenvironment{Decl}[1][l]%
{\par\small\addvspace{2.3ex plus 1ex}%
\vskip -\parskip
\noindent\hspace{\leftmargini}%
- \begin{tabular}{|l|}\hline\ignorespaces}%
+ \begin{tabular}{|#1|}\hline\ignorespaces}%
{\\\hline\end{tabular}\nobreak\par\nobreak
\vspace{2.3ex}\vskip -\parskip}
\newenvironment{Indent}[1]{%
@@ -101,7 +103,7 @@
%
% \fi
%
-% \CheckSum{584}
+% \CheckSum{0}
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
@@ -148,6 +150,7 @@
% \changes{1.0}{2001 Dec 9}{Initial version}
% \changes{1.1}{2004 Jan 15}{Doc: Updated}
% \changes{1.3}{2009 Sep 1}{Doc: Updated}
+% \changes{1.3b}{2022 Mar 1}{Doc: Updated}
%
%
% \GetFileInfo{mattens.sty}
@@ -160,44 +163,22 @@
% \date{\filedate}
% \maketitle
%
-% \begin{abstract}
-% \noindent The \MT\ package contains the definitions to typeset vectors and
-% tensors such as $\aS{e}_i$, $\bS[\dot]{x}^r$, $\bSb{E}^s_r$, etc., for the
-% representation of common vectors and tensors such as forces, velocities,
-% moments of inertia, etc. These symbols (and variants thereof) are found on
-% the black boards of engineering schools and in many journals and books,
-% particularly those concerned with dynamics and kinematics.
-%
-% This package adheres to the well defined and documented notation of
-% Hassenpflug.\footnote{^^A
-% Hassenpflug, W.C.,
-% Matrix Tensor Notation Part I. Rectilinear Orthogonal Coordinates.
-% \emph{Comput. Math.\ Applic.,} vol.\ 26, no.\ 3, 1993, pp.\ 55--93.}^^A
-% \textsuperscript{,}^^A
-% \footnote{
-% Hassenpflug, W.C.,
-% Matrix Tensor Notation Part II. Skew and Curved Coordinates.
-% \emph{Comput. Math. Appl.}, vol.\ 29, no.\ 11, 1993, pp. 1--103.}
%
-% \medskip
-% \noindent\slshape{\bfseries Keywords:} vector, matrix, tensor, notation.
-% \end{abstract}
-%
-% \clearpage
-% {\parskip0pt\tableofcontents}
+% \section{Introduction}
%
-% \clearpage
-% \section{Background}
+% \subsection{Background}
%
% A browse through journals and handbooks, in particular those concerned with
% dynamics, reveals an amazing array of private notations for vectors and
% tensors. Every author has his or her own notation, making it very difficult
% to comprehend what is going on in complex multi reference axes environments.
%
-% This package is based on the notation of \Hass\cite{Hass93a,Hass93b}. It was
-% developed and refined by Dr.~\Hass{} over many years of teaching engineering,
-% and as stated by him\cite{Hass93a}:
-%
+% The \MT\ package contains the definitions to typeset vectors and
+% tensors such as $\aS{e}_i$, $\bS[\dot]{x}^r$, $\bSb{E}^s_r$, etc., for the
+% representation of common vectors and tensors such as forces, velocities,
+% moments of inertia, etc. It is based on the well defined notation of
+% \Hass\cite{Hass93a,Hass93b}. It was developed and over many years of
+% teaching engineering:
% \begin{quote}\slshape
% ``It is designed particulary to distinguish between vectors and tensors
% and their representation as vectors and matrices in different coordinate
@@ -210,25 +191,25 @@
% for a good notation for tensor quantities and operations, to which his
% notation conforms. A notation must:
% \begin{itemize}
-% \item be easily written by hand;
-% \item distinguish between vector and scalar quantities;
-% \item distinguish between (second order) tensors and vectors;
-% \item distinguish between physical vectors and their representation
+% \item Be easily written by hand;
+% \item Distinguish between vector and scalar quantities;
+% \item Distinguish between (second order) tensors and vectors;
+% \item Distinguish between physical vectors and their representation
% by vector arrays, and between physical (second order) tensors and
% their representation by matrices;
-% \item distinguish between row and column vectors;
-% \item use the same symbol as name for the same vector or tensor in
+% \item Distinguish between row and column vectors;
+% \item Use the same symbol as name for the same vector or tensor in
% either its physical sense or its representation by a vector array
% or matrix in different coordinate axes;
-% \item distinguish between matrix/vector representation of the same
+% \item Distinguish between matrix/vector representation of the same
% vector/tensor in different coordinate axes;
-% \item be equally valid in orthonormal and skew coordinate axes;
-% \item indicate all intended operations uniquely;
-% \item be equally valid in all dimensions;
-% \item be equally valid for algebraic vector/matrix algebra which has
+% \item Be equally valid in orthonormal and skew coordinate axes;
+% \item Indicate all intended operations uniquely;
+% \item Be equally valid in all dimensions;
+% \item Be equally valid for algebraic vector/matrix algebra which has
% no connection to any metric space;
-% \item be applicable to differentials;
-% \item allow for defaults to avoid repetitive elaborate symbols, i.e.,
+% \item Be applicable to differentials;
+% \item Allow for defaults to avoid repetitive elaborate symbols, i.e.,
% not all the symbols need to be written down explicitly if it is
% clear from the context.
% \item It must be well documented (own addition).
@@ -237,43 +218,42 @@
% \noindent The \MT\ package was developed to typeset the \Hass{} matrix
% tensor symbols in a consistent manner.
%
-% An appeal is made to the engineering and scientific community to adopt this
-% notation, because of its consistency and ease of use.
+% \subsection{Why the \MT\ package?}
+%
+% The \Hass{} notation contains symbols such as, $\aS{e}_i$,
+% $\bS[\dot]{x}^{r}_{\alpha}$, $\bSa[\dot]{E}^s$, etc. These symbols
+% are quite common and variants thereof are found on many
+% blackboards of engineering schools. Based on the reputation of
+% \TeX{} it would seem trivial to typeset them, but to the contrary
+% ...
+% \SetSymbFont{\relax}
+% \begin{sample}
+% |$\bS[\dot]{f}^a_b$| \> $\bS[\dot]{f}^a_b$ ~~~(correct typesetting)\\[.75ex]
+% |$\dot{\overline{f}}^a_b$| \> \AccentBox\\[.75ex]
+% |$\dot{\overline{f}}{}^a_b$| \> $\dot{\overline{f}}{}^a_b$\\[.75ex]
+% |$\dot{\overline{f}^a_b}$| \> $\dot{\overline{f}^a_b}$
+% \end{sample}
+% \SetSymbFont{\bm}
%
% \section{Usage of \MT\ package}
%
% The \MT\ package is loaded in the document preamble with:
-% \begin{quote}
-% \begin{tabbing}
-% \hskip14pc\=\kill
-% \qquad$\vdots$\\
-% \cmd{\usepackage}\oarg{options}|{mattens}| \>|% amsmath loaded internally|\\
-% \qquad$\vdots$\\
-% \cmd{\usepackage}\marg{font packages} \>|%|\\
-% \cmd{\DeclareSymbolFont}... \>|% All the font changes|\\
-% \cmd{\SetSymbolFont}... \>|%|\\
-% \cmd{\DeclareSymbolFontAlphabet}... \>|%|\\
-% \qquad$\vdots$\\
-% \cmd{\usepackage}|{bm} %\boldsymbol redirected to call \bm|\\
-% \qquad$\vdots$
-% \end{tabbing}
-% \end{quote}
+% \begin{sample}
+% \cmd{\usepackage}\oarg{options}|{mattens}|
+% \end{sample}
%
% \noindent When \MT\ is loaded, the \pkg{amsmath} package is loaded
% automatically, because it is needed for the redefined \cmd{\overrightarrow}
% and \cmd{\underrightarrow} commands, as well as the \cmd{\boldsymbol}
% command. It must be loaded before any font packages that redefine some of the
-% \pkg{amsmath} symbols or commands.
-%
-% On the other hand, the preferred method for obtaining bold italic math
-% symbols is the \cmd{\bm} command of the \pkg{bm} package.\footnote{In the
-% \pkg{amsmath} documentation, \AmS{} recommends the \cmd{\bm} command of the
-% \pkg{bm} package instead of the \cmd{\boldsymbol} command for bold italic
-% math symbols. The \cmd{\boldsymbol} puts its contents in a box,
-% \cmd{\mbox\{}\cmd{\boldmath\$}\meta{contents}\texttt{\$\}}, while \cmd{\bm}
-% is a font changing command that uses the appropriate bold math font.} The
-% \pkg{bm} package must be loaded after all the font packages in order for it
-% to recognize the bold math versions. The \pkg{bm} package reroutes the
+% \pkg{amsmath} symbols or commands.
+
+% \AmS{} recommends the \pkg{bm} package instead of the \cmd{\boldsymbol}
+% command for bold italic math symbols\footnote{The \cmd{\boldsymbol} puts
+% its contents in a box,
+% \cmd{\mbox\{}\cmd{\boldmath\$}\meta{contents}\texttt{\$\}},
+% while \cmd{\bm} is a font changing command that uses the appropriate
+% bold math font.}. The \pkg{bm} package reroutes the
% \cmd{\boldsymbol} command to point to \cmd{\bm}. If \cmd{\boldsymbol} is
% called after the \pkg{bm} package is loaded, it is equivalent to \cmd{\bm}.
% If the \pkg{bm} package is not loaded, \MT\ defaults to the \cmd{\boldsymbol}
@@ -284,13 +264,14 @@
% symbols then indicates the fact that it is a vector/tensor and the lines,
% arrows and sub- and superscripts indicate the specific type and reference
% axes.
+% \pagebreak[2]
%
-% The following options are recognized by \MT:
+% \noindent The following options are recognized by \MT:
%
% \begin{description}
% \item[\normalfont\opt{noformat}:] No symbol formatting is performed,
% otherwise symbols are set by default in bold italics with the
-% \cmd{\boldsymbol} or \cmd{\bm} command.
+% \cmd{\boldsymbol} command.
%
% It is important to note that the \Hass{} requirement of easily
% written by hand is not fulfilled if the symbols are formatted
@@ -301,7 +282,6 @@
% depth. The default is no mathstrut.
% \end{description}
%
-% \clearpage
% \section{List of \MT\ commands}
%
% \begin{table}[htbp]
@@ -387,15 +367,19 @@
% \subsection{General syntax}
%
% The general syntax of the \MT\ commands is
-% \begin{Decl}
-% |\|\m|S|\m\,| |\oarg{accent}\marg{Symbol} ~~
-% |\|\m|CS|\m\,| |\oarg{accent}\marg{Symbol}\\[1ex]
-% |\|\m|S|\m\,|*|\oarg{accent}\marg{Symbol}~~~
+% \begin{Decl}[ll]
+% |\|\m|S|\,\oarg{accent}\marg{Symbol} &
+% |\|\m|S|\,|*|\oarg{accent}\marg{Symbol} \\
+% |\S|\m\,\oarg{accent}\marg{Symbol} &
+% |\S|\m\,|*|\oarg{accent}\marg{Symbol} \\[1ex]
+%
+% |\|\m|S|\m\,\oarg{accent}\marg{Symbol} &
+% |\|\m|S|\m\,|*|\oarg{accent}\marg{Symbol}\\[1ex]
+%
+% |\|\m|CS|\m\,\oarg{accent}\marg{Symbol} &
% |\|\m|CS|\m\,|*|\oarg{accent}\marg{Symbol}
% \end{Decl}
-% \noindent with command names $\cmd{\bS}$, $\cmd{\aS}$, $\cmd{\aSa}$,
-% $\cmd{\aSb}$, etc. See table\:\ref{tab:1} for a full list of all the
-% commands. The ``starred'' form is used to set the symbol in normal math.
+% The ``starred'' form is used to set the symbol in normal math.
% This can be used for compound tensors or for pre-declared symbols (see
% \pkg{bm} documentation). An example of the usage is
% \begin{sample}
@@ -404,9 +388,10 @@
% \cmd{\Sb}|{x}| \> \cmd{\Sb*}|{x}| \> $\Sb{x}$ \> $\Sb*{x}$\\[0.75ex]
% \cmd{\aCSa}|{z}|\> \cmd{\aCSa*}|{z}| \> $\aCSa{z}$\> $\aCSa*{z}$
% \end{sample}
-% The optional argument \meta{accent} is intended for \LaTeX{} accent commands
-% such as $\cmd{\dot}$, $\cmd{\ddot}$, etc., or their $\AmS$ equivalents,
-% $\cmd{\Dot}$, $\cmd{\Ddot}$.
+%
+% The optional argument \meta{accent} is intended for \LaTeX{}
+% accent commands % such as $\cmd{\dot}$, $\cmd{\ddot}$, etc., or
+% their $\AmS$ equivalents, $\cmd{\Dot}$, $\cmd{\Ddot}$.
% \begin{sample}
% |\bS[\Ddot]{x}| \> $\bS[\Ddot]{x}$
% \end{sample}
@@ -460,13 +445,23 @@
% \cmd{\SetSymbFont}\marg{font-command}^^A
% \SpecialUsageIndex{\SetSymbFont}
% \end{Decl}
-% \noindent The \pkg{bm} package reroutes the \cmd{\boldsymbol} command to
-% point to \cmd{\bm}. If \cmd{\SetSymbFont}|{\boldsymbol}| is called after the
-% \pkg{bm} package is loaded, it is equivalent to \cmd{\SetSymbFont}|{\bm}|.
-% Bold formatting of individual tensors can also be switched off with the use
-% of the starred forms of the tensor commands.
%
-% If the symbols are interpreted as tensors, then according to the ISO, it can
+% \pagebreak[2]
+% \noindent In general a typical setup to include unicode math
+% \begin{sample}
+% |\usepackage{ifxetex} |\\
+% |\ifxetex |\\
+% | ... Unicode-math and font selection ...|\\
+% | \SetSymbFont{\symbfit} |\\
+% |\else |\\
+% | ... Font selection ... |\\
+% | \usepackage{bm} |\\
+% | \SetSymbFont{\bm} |\\
+% |\fi |
+% \end{sample}
+%
+%
+% \noindent If the symbols are interpreted as tensors, then according to the ISO, it can
% be typeset in a slanted sans serif font (if you are fond of fonts). For the
% Computer Modern fonts with an \texttt{OT1} encoding, you can put in the
% preamble
@@ -520,21 +515,23 @@
% \SpecialUsageIndex{\SetSymbStrut}^^A
% \cmd{\SetSymbStrut}\marg{strut}
% \end{Decl}
+%
+% \pagebreak[2]
% \noindent For example
% \SetSymbStrut{\relax}
% \begin{sample}
% |\SetSymbStrut{\relax}| \\
-% |\bSb{E}|, |\bS{f}|, |\Sb{y}| \>$\bSb{E}$, $\bS{x}$, $\Sb{y}$
+% |\bSb{E}|, |\bS{x}|, |\Sb{y}| \>$\bSb{E}$, $\bS{x}$, $\Sb{y}$
% \end{sample}
% \SetSymbStrut{\mathstrut}
% \begin{sample}
% |\SetSymbStrut{\mathstrut}| \\
-% |\bSb{E}|, |\bS{f}|, |\Sb{y}| \>$\bSb{E}$, $\bS{x}$, $\Sb{y}$
+% |\bSb{E}|, |\bS{x}|, |\Sb{y}| \>$\bSb{E}$, $\bS{x}$, $\Sb{y}$
% \end{sample}
% \SetSymbStrut{\vphantom{E}}
% \begin{sample}
% |\SetSymbStrut{\vphantom{E}}| \\
-% |\bSb{E}|, |\bS{f}|, |\Sb{y}| \>$\bSb{E}$, $\bS{x}$, $\Sb{y}$
+% |\bSb{E}|, |\bS{x}|, |\Sb{y}| \>$\bSb{E}$, $\bS{x}$, $\Sb{y}$
% \end{sample}
% \SetSymbStrut{\relax}
%
@@ -584,19 +581,6 @@
% |$\aSb{{{\color{red}E}}}_i$| \> $\aSb{{{\color{red}E}}}_i$
% \end{sample}
%
-% \item[\normalfont\pkg{slide}, \pkg{foils}:~~] The Euler math fonts
-% are definitely compulsory. The ratio of the sub- and superscript
-% sizes to normal math font sizes is too big inside the \pkg{slide}
-% class. For tensors such as $\bS{x}^j_k$, you may find that the
-% sub- and superscripts overlap. Choose your script characters
-% carefully.
-%
-% \item[\normalfont\pkg{eulervm}:\quad] The \Hass{} ideal of symbols
-% that are easily written by hand is satisfied with the beautiful
-% letters of the Euler fonts. This package is a must for
-% presentation material, but \myemph{please do not use bold Euler
-% symbols}, they just do not look right!
-%
% \item[\normalfont\pkg{accents}:\quad] For the creation of alternative
% accents the \MT\ package is fully compatible with the
% \pkg{accents}\ package. As an example of its usage, the equation
@@ -633,127 +617,7 @@
% \end{description}
% ^^A\clearpage
%
-% \section{Typesetting the \Hass{} notation in \LaTeX}
-% \subsection{Why?}
-%
-% The \Hass{} notation contains symbols such as, $\aS{e}_i$,
-% $\bS[\dot]{x}^{r}_{\alpha}$, $\bSa[\dot]{E}^s$, etc. These symbols
-% are quite common and variants thereof are found on many
-% blackboards of engineering schools. Based on the reputation of
-% \TeX{} it would seem trivial to typeset them, but to the contrary
-% ...
-% \SetSymbFont{\relax}
-% \begin{sample}
-% |\bS[\dot]{f}^a_b| \> $\bS[\dot]{f}^a_b$ ~~~(correct typesetting)\\[.75ex]
-% |$\dot{\overline{f}}^a_b$| \> \AccentBox\\[.75ex]
-% |$\dot{\overline{f}}{}^a_b$| \> $\dot{\overline{f}}{}^a_b$\\[.75ex]
-% |$\dot{\overline{f}^a_b}$| \> $\dot{\overline{f}^a_b}$
-% \end{sample}
-% \SetSymbFont{\bm}
-%
-% When a subscript is inserted for slanted characters, e.g.,
-% $f^a_b$, the subscript is kerned closer to the symbol.
-% This subscript kerning as well as the superscript height is
-% retained for math accents, e.g., $\dot{f}^a_b$. When
-% the \cmd{\overline} or \cmd{\overrightarrow} commands are used together
-% with math accents, the problems begin\footnote{If you are using
-% Equation Editor or MathType inside word processors in the Windows environment,
-% you end up with the same problems and have to fiddle \myemph{every}
-% sub- and superscript individually. A browse through the accompanying
-% sample document, \pkg{mtsample.tex}, will show that this can amount to
-% hundreds of little equations. I challenge anyone to rewrite that
-% document with one of the popular wordprocessors and still be sane
-% afterwards :-)}:
-%
-% \begin{itemize}
-%
-% \item For an \cmd{\overline}, $\overline{f}^a_b$, the superscript moves up to
-% the height of the overline, which is fine for vector notation, but the
-% subscript kerning is lost, because the symbol is set inside a box with
-% italic correction added (App. G of the \TeX{}book). If the subscript is
-% added inside the \cmd{\overline} construct, $\overline{f_b}^a$, the
-% overline is stretched, which is acceptable only when the subscript is
-% part of the symbol itself. The subscript kerning can be corrected by
-% attaching the subscript to the symbol and the superscript to the overline
-% and then overtyping (\cmd{\rlap} or \cmd{\llap}) them while using a
-% phantom symbol (without subscript) for the overline,
-% \begin{sample}
-% |\leavevmode\rlap{$\overline{\phantom{f}}^a$}%|\\
-% | {$f^{}_b$}|
-% \end{sample}
-% which gives \leavevmode\rlap{$\overline{\phantom{f}}^a$}{$f^{}_b$}.
-%
-% The \cmd{\leavevmode} command is nessesary to prevent the symbol being
-% spread over two lines when it is the first token in a new paragraph
-% (\TeX{} in vertical mode).
-%
-% Care must be taken with the sequence in which the two parts overlap when
-% the one is wider than the other,
-% \leavevmode\rlap{$\overline{\phantom{f}}^{abcde}$}{$f^{}_a$},
-% because the superscript will then run into the following text.
-%
-% \item If a math accent is added to the overline, \AccentBox, the superscript
-% goes to the level of the accent (except if the \pkg{accents}\ package is
-% loaded). This can be remedied by controlling the height of the accented
-% overline construction with a \cmd{\vphantom} commands as a strut,
-% \begin{sample}
-% |\leavevmode\rlap%|\\
-% | {$\dot{\overline{\phantom{f}}}{\vphantom{\overline{f}}}^a$}%|\\
-% | {$f^{}_b$}|
-% \end{sample}
-% which gives
-% \rlap{$\dot{\overline{\phantom{f}}}{\vphantom{\overline{f}}}^a$}^^A
-% {$f^{}_b$}.
-%
-% \item For an |\overrightarrow| in vector notation, ($\overrightarrow{i}_a$,
-% ~$\overrightarrow{iiii}_a\,$), the construction of the stretchable arrow
-% results in an arrow wider than most symbols, with the symbol centred
-% below it. The subscript ended up far removed from the symbol. For
-% multiple symbols, the arrow width is equal to the box containing the
-% letters, resulting in better-looking subscripts (but still without the
-% subscript kerning). The previous procedure can be used to correct the
-% subscript kerning, except that additional white space must be inserted
-% before the symbol to centre it beneath the arrow.
-% \begin{sample}
-% |\newlength{\Wspace}\settowidth{\Wspace}{$\overrightarrow{i}$}|\\
-% |\newlength{\SymWdth}\settowidth{\SymWdth}{$i$}|\\
-% |\addtolength{\Wspace}{-\SymWdth} |\\
-% |\leavevmode\rlap{$\dot{\overrightarrow{\phantom{i}}}$}% |\\
-% | {\hspace*{.5\Wspace}$i^{}_b$} |
-% \end{sample}
-% \newlength{\Wspace}\settowidth{\Wspace}{$\overrightarrow{i}$}
-% \newlength{\SymWdth}\settowidth{\SymWdth}{$i$}
-% \addtolength{\Wspace}{-\SymWdth}
-% which gives \rlap{$\dot{\overrightarrow{\phantom{i}}}$}{\hspace*{.5\Wspace}$i^{}_b$}.
-%
-% The commands can be optimized by using saveboxes, \myemph{but} the
-% symbols will not scale correctly when used as sub- or superscripts or in
-% the \cmd{\tfrac} macro. A solution is to nest the commands inside a
-% \cmd{\mathpalette} environment, but be warned, this is very expensive!
-% The commands \cmd{\phantom}, \cmd{\smash}, \cmd{\overrightarrow} (in
-% \pkg{amsmath}) are already inside \cmd{\mathpalette} macros, and \TeX{}
-% calls the arguments of a \cmd{\mathpalette} macro four times before
-% deciding on the dimensions.
-%
-% \item The shape of the arrow tip of the |\overrightarrow| command was
-% probably not designed for this type of application and is much too broad
-% in the final CM font version. This broad arrow shape is incidentally one
-% of last changes by Prof.~Knuth to the CM font symbols. The PostScript
-% version of the CM fonts typesets the arrow much better, but it is highly
-% likely that it is still the old outdated version of the symbol.
-%
-% \item The subscript heights differ for the cases with and without
-% superscripts, $x_b,\; x_b^a$. This is not very satisfactory for a
-% consistent matrix-tensor notation, but it can be remedied by inserting a
-% dummy superscript, |$x^{}_b$|, which then gives $x^{}_b$, $x_b^a$.
-%
-% \end{itemize}
-% The \MT\ package was developed to overcome (some of) the above-mentioned
-% problems and to typeset the \Hass{} matrix tensor symbols in a consistent
-% manner.
-%
-%
-% \subsection{To do's}
+% \section{To do's}
%
% \begin{itemize}
% \item The vertical spacing between the symbols and the lines and
@@ -764,6 +628,14 @@
% \item For the purists: The ends of the |\overrightarrow| are rounded
% (ligature of symbols), while the ends of the |\overline| are
% squared (\TeX{} line drawing).
+% \item The shape of the arrow tip of the |\overrightarrow| command was
+% probably not designed for this type of application and is much too broad
+% in the final CM font version. This broad arrow shape is incidentally one
+% of last changes by Prof.~Knuth to the CM font symbols. The PostScript
+% version of the CM fonts typesets the arrow much better, but it is highly
+% likely that it is still the old outdated version of the symbol.
+% The \pkg{esvect} provides alternative vector symbols that can
+% be used in \cmd{\overrightarrow}.
% \end{itemize}
% \bigskip
%
@@ -799,8 +671,8 @@
%
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{mattens}[2010/03/26
- v1.3a
+\ProvidesPackage{mattens}[2022/03/01
+ v1.3b
Matrix/Tensors (DNJ Els)]
% \end{macrocode}
%
diff --git a/macros/latex/contrib/mattens/mattens.ins b/macros/latex/contrib/mattens/mattens.ins
index a4ad740171..85af205dac 100644
--- a/macros/latex/contrib/mattens/mattens.ins
+++ b/macros/latex/contrib/mattens/mattens.ins
@@ -1,5 +1,5 @@
% mattens.ins
-% Copyright (C) 2001--2010 Danie Els
+% Copyright (C) 2001--2022 Danie Els
%
% -------------------------------------------------------------------
% The mattens package
@@ -11,11 +11,11 @@
% of this license is in
% http://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions of LaTeX
-% version 2005/12/01 or later.
+% version 2008/12/01 or later.
%
% This work has the LPPL maintenance status 'maintained'.
%
-% This Current Maintainer of this work is Danie Els (dnjels@sun.ac.za)
+% This Current Maintainer of this work is Danie Els (dnjels@gmail.com)
%
% This package consists of the files: mattens.dtx
% mattens.ins
@@ -23,13 +23,13 @@
% -------------------------------------------------------------------
\def\batchfile{mattens.ins}
-\def\filedate{2010/03/26}
+\def\filedate{2022/03/01}
\input docstrip.tex
\keepsilent
\declarepreamble\DNJEpreamble
-Copyright (C) 2001--2010 Danie Els
+Copyright (C) 2001--2022 Danie Els
-------------------------------------------------------------------
The mattens package
@@ -41,11 +41,11 @@ 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.3c or later is part of all distributions of LaTeX
-version 2005/12/01 or later.
+version 2008/12/01 or later.
This work has the LPPL maintenance status 'maintained'.
-This Current Maintainer of this work is Danie Els (dnjels@sun.ac.za)
+This Current Maintainer of this work is Danie Els (dnjels@gmail.com)
-------------------------------------------------------------------
\endpreamble
diff --git a/macros/latex/contrib/mattens/mattens.pdf b/macros/latex/contrib/mattens/mattens.pdf
index 5a651a3ac5..806d8e764a 100644
--- a/macros/latex/contrib/mattens/mattens.pdf
+++ b/macros/latex/contrib/mattens/mattens.pdf
Binary files differ
diff --git a/macros/latex/contrib/mattens/mattens_sample.pdf b/macros/latex/contrib/mattens/mattens_sample.pdf
index 321d16aa7c..3fb0eba780 100644
--- a/macros/latex/contrib/mattens/mattens_sample.pdf
+++ b/macros/latex/contrib/mattens/mattens_sample.pdf
Binary files differ