mattens (1mar22) (branch)

git-svn-id: svn://tug.org/texlive/branches/branch2021.final@62327 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 114 insertions, 242 deletions

diff --git a/Master/texmf-dist/source/latex/mattens/mattens.dtx b/Master/texmf-dist/source/latex/mattens/mattens.dtx
index 6833a44460e..5a3d47819ef 100644
--- a/Master/texmf-dist/source/latex/mattens/mattens.dtx
+++ b/Master/texmf-dist/source/latex/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/Master/texmf-dist/source/latex/mattens/mattens.ins b/Master/texmf-dist/source/latex/mattens/mattens.ins
index a4ad740171d..85af205dac8 100644
--- a/Master/texmf-dist/source/latex/mattens/mattens.ins
+++ b/Master/texmf-dist/source/latex/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