nicematrix (24nov21)

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

4 files changed, 143 insertions, 41 deletions

diff --git a/Master/texmf-dist/doc/latex/nicematrix/README.md b/Master/texmf-dist/doc/latex/nicematrix/README.md
index d55ad613522..5822e17e0e7 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/README.md
+++ b/Master/texmf-dist/doc/latex/nicematrix/README.md
@@ -20,7 +20,7 @@ The package `nicematrix` is present in the distributions MiKTeX, TeXLive and Mac
 For a manual installation:
 
 * put the files `nicematrix.ins` and `nicematrix.dtx` in the same directory; 
-* run `latex nicematrix.ins`.
+* run `latex nicematrix.ins` in that directory.
 
 The file `nicematrix.sty` will be generated.
 
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
index e95df7bfc33..ff9d46251ce 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
index 86c4f74da86..3690d378801 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
@@ -10,7 +10,7 @@
 \usepackage{nicematrix}
 
 \usepackage{tikz}
-\usetikzlibrary{fit,patterns}
+\usetikzlibrary{fit,patterns,arrows.meta}
 
 \usepackage{enumitem}
 \usepackage{siunitx}
@@ -543,7 +543,8 @@ options la valeur de cette clé |tikz| (qui doit donc être une liste de clés T
 applicables à un chemin de Tikz). Pour des exemple d'utilisation de cette clé
 |tikz|, voir p.~\pageref{tikz-key-examples} ;
 \item \colorbox{yellow!50}{\textbf{Nouveau 6.3}}\enskip la clé |name| donne un
-nom au nœud Tikz rectangulaire correspondant au bloc.
+nom au nœud Tikz rectangulaire correspondant au bloc ; on peut utiliser ce nom
+avec Tikz dans le |\CodeAfter| (cf p.~\pageref{code-after}).
 \end{itemize}
 
 
@@ -590,9 +591,9 @@ Les blocs mono-colonne ont un comportement spécial.
 \item La largeur naturelle du contenu de ces blocs est prise en compte pour la
 largeur de la colonne courante.
 
-\colorbox{yellow!50}{\textbf{Nouveau 6.0}}\enskip Dans les colonnes à largeur
-fixée (colonnes |w{...}{...}|, |p{...}|, |b{...}|, |m{...}| et |X|), le contenu
-du bloc est mis en forme comme un paragraphe de cette largeur.
+Dans les colonnes à largeur fixée (colonnes |w{...}{...}|, |p{...}|, |b{...}|,
+|m{...}| et |X|), le contenu du bloc est mis en forme comme un paragraphe de
+cette largeur.
 
 \item La spécification d'alignement horizontal donnée par le type de
 colonne (|c|, |r| ou |l|) est prise en compte pour le bloc (mais le bloc peut
@@ -1045,7 +1046,8 @@ Pour chacun de ces coins, on appellera \emph{coin vide} (ou tout simplement
 rectangle entièrement constitué de cases vides partant de ce coin.\footnote{Pour
   être complet, on doit préciser que toute case située dans un bloc (même si
   elle est vide) n'est pas prise en compte pour la détermination des coins. Ce
-  comportement est naturel.}
+  comportement est naturel. La définition précise de ce qui est considéré comme
+  une «case vide» est donnée plus loin (cf. p.~\pageref{empty-cells}).}
 
 \smallskip
 On peut néanmoins imposer à une case sans contenu d'être considérée
@@ -1602,12 +1604,11 @@ Henri                  & 14 \\
 
 
 \medskip
-\item \colorbox{yellow!50}{\textbf{Nouveau 6.0}}\enskip L'extension
-\pkg{nicematrix} propose aussi une commande |\rowlistcolors|. Cette commande
-généralise la commande |\rowcolors|: au lieu de prendre deux arguments
-successifs pour les couleurs, elle prend un seul argument qui est une liste de
-couleurs séparées par des virgules. Dans cette liste, le symbole |=| représente
-une couleur identique à la précédente.
+\item L'extension \pkg{nicematrix} propose aussi une commande |\rowlistcolors|.
+Cette commande généralise la commande |\rowcolors|: au lieu de prendre deux
+arguments successifs pour les couleurs, elle prend un seul argument qui est une
+liste de couleurs séparées par des virgules. Dans cette liste, le symbole |=|
+représente une couleur identique à la précédente.
 
 \smallskip
 \begin{BVerbatim}[boxwidth=10cm,baseline=c]
@@ -1979,13 +1980,15 @@ $\begin{array}{c}
 
 \subsection{Les colonnes V de varwidth}
 
+\label{varwidth}
+
 \colorbox{yellow!50}{\textbf{Nouveau 6.3}}
 
 \smallskip
 Rappelons d'abord le fonctionnement d'un environnement |{varwidth}| de
 l'extension éponyme \pkg{varwidth}. Un tel environnement est similaire à
 l'environnement classique |{minipage}| mais la largeur indiquée (en argument)
-n'est que la largeur \emph{maximale} de la boîte créée. Dans la cas général, la
+n'est que la largeur \emph{maximale} de la boîte créée. Dans le cas général, la
 largeur d'une boîte |{varwidth}| est la largeur naturelle de son contenu.
 
 \smallskip
@@ -2035,18 +2038,37 @@ réglages supplémentaires).
 Lorsque l'extension \pkg{varwidth} est chargée, ces colonnes |V| de
 \pkg{varwidth} sont prises en charge par \pkg{nicematrix}. Dans le cadre de
 \pkg{nicematrix}, l'un des intérêts des colonnes de type |V| par rapport aux
-colonnes de type |p|, |m| ou |b| est que, pour les cellules d'une telle colonne,
-le nœud PGF/Tikz créé pour le contenu d'une telle cellule a une largeur ajusté
-au contenu de la cellule en question : cf. p.~\pageref{node-V}.
+colonnes de type |p|, |m| ou |b| est que, pour les cases d'une telle colonne,
+le nœud PGF/Tikz créé pour le contenu d'une telle case a une largeur ajusté
+au contenu de la cellule en question : cf. p.~\pageref{node-V}. Si le contenu
+est vide, la cellule sera considérée comme vide par \pkg{nicematrix} pour le
+tracé des lignes pointillés et la détermination des «coins vides» (ce n'est pas
+le cas avec une case d'une colonne |p|, |m| ou |b|).
+
+\medskip
+\begin{Verbatim}
+\begin{NiceTabular}[corners=NW,hvlines]{~emphase#V{3cm}V{3cm}V{3cm}@}
+& un très très très très long texte & un très très très très long texte \\
+un très très très très long texte \\
+un très très très très long texte 
+\end{NiceTabular}
+\end{Verbatim}
+
+\medskip
+\begin{center}
+\begin{NiceTabular}[corners=NW,hvlines]{V{3cm}V{3cm}V{3cm}}
+& un très très très très long texte & un très très très très long texte \\
+un très très très très long texte \\
+un très très très très long texte 
+\end{NiceTabular}
+\end{center}
 
 
 \subsection{Les colonnes X}
 
-\label{colonne-X}
 
-\colorbox{yellow!50}{\textbf{Nouveau 6.0}}
+\label{colonne-X}
 
-\smallskip
 L'environnement |{NiceTabular}| propose aussi des colonnes |X| similaires à
 celles proposées par l'environnement |{tabularx}| de l'extension éponyme.
 
@@ -2058,7 +2080,7 @@ Pour se rapprocher davantage de l'environnement |{tabularx}|, \pkg{nicematrix}
 propose aussi un environnement |{NiceTabularX}| qui prend en premier argument
 (obligatoire) la largeur voulue pour le tableau.\footnote{Si \pkg{tabularx} est
   chargé, on doit obligatoirement utiliser |{NiceTabularX}| pour utiliser les
-  colonnes |X| (ceci est dû à un problème de conflit de définition des
+  colonnes |X| (cela est dû à un problème de conflit de définition des
   spécificateurs de colonne |X|).}
 
 
@@ -2069,7 +2091,7 @@ accepte entre crochets un argument optionnel qui est une liste de clés.
 entier positif comme argument du spécificateur |X|. Par exemple, une colonne
 |X[2]| aura une largeur double de celle d'une colonne |X| (qui a un poids de
 1).\footnote{Les valeurs négatives pour les poids, comme proposées par
-  \pkg{tabu} (maintenant obsolète), ne sont pas prises en charge par
+  \pkg{tabu} (maintenant obsolète), ne sont \emph{pas} prises en charge par
   \pkg{nicematrix}. Si une telle valeur est utilisée, une erreur sera levée.}
 \item On peut spécifier l'alignement horizontal avec une des lettres |l|, |c| et
 |r| (qui insèrent respectivement |\raggedright|, |\centering| et |\raggedleft|
@@ -2626,9 +2648,9 @@ $\begin{bNiceMatrix}
 
 \label{customization}
 Les lignes pointillées tracées par |\Ldots|, |\Cdots|, |\Vdots|, |\Ddots|,
-|\Iddots| et |\Hdotsfor| (ainsi que par la commande |\line| dans le |\CodeAfter|
-décrite p.~\pageref{line-in-code-after}) peuvent être paramétrées par trois
-options (que l'on met entre crochets après la commande) :
+|\Iddots|, |\Hdotsfor| et |\Vdotsfor| (ainsi que par la commande |\line| dans le
+|\CodeAfter| décrite p.~\pageref{line-in-code-after}) peuvent être paramétrées
+par trois options (que l'on met entre crochets après la commande) :
 %
 \begin{itemize}
 \item |color| ;
@@ -2774,8 +2796,9 @@ PGF/Tikz créés par \pkg{nicematrix} dans le |\CodeAfter|. Ces nœuds sont déc
 à partir de la page \pageref{PGF-nodes}.
 
 \medskip
-Par ailleurs, deux commandes spéciales sont disponibles dans le |\CodeAfter| :
-|\line| et |\SubMatrix|. On va maintenant détailler ces deux commandes.
+Par ailleurs, plusieurs commandes spéciales sont disponibles dans le |\CodeAfter| :
+|\line|, |\SubMatrix|, |\OverBrace| et |\UnderBrace|. On va maintenant détailler
+ces commandes. 
 
 
 \subsection{La commande \textbackslash line dans le \textbackslash CodeAfter}
@@ -3045,6 +3068,78 @@ a_{31} & a_{32}                                     & a_{33}
 
 
 
+\subsection{Les commandes \textbackslash OverBrace et le \textbackslash
+  UnderBrace dans le \textbackslash CodeAfter}
+
+\colorbox{yellow!50}{\textbf{Nouveau 6.4}}
+
+Les commandes |\OverBrace| and |\UnderBrace| permettent de placer des accolades
+horizontales sur une partie du tableau. Ces commandes prennent trois arguments :
+\begin{itemize}
+\item le premier argument est le coin supérieur gauche du rectangle de cellules
+impliquées dans l'accolade avec la syntaxe habituelle $i$|-|$j$ où $i$ est le
+numéro de rangée et $hj$ le numéro de colonne ;
+
+\item le deuxième argument est le coin inférieur droit avec la même syntaxe ;
+
+\item le troisième argument est le «label» de l'accolade qui sera placé par
+\pkg{nicematrix} (avec \textsc{pgf}) au-dessus de l'accolade (pour la commande
+|\OverBrace|) ou au-dessous (pour |\UnderBrace|).
+\end{itemize}
+
+\bigskip
+\begin{BVerbatim}[baseline=c,boxwidth=9cm]
+\begin{pNiceMatrix}
+1  & 2  & 3  & 4  & 5  & 6  \\
+11 & 12 & 13 & 14 & 15 & 16 \\
+\CodeAfter
+  ~emphase#\OverBrace{1-1}{2-3}{A}@
+  ~emphase#\OverBrace{1-4}{2-6}{B}@
+\end{pNiceMatrix}
+\end{BVerbatim}
+$\begin{pNiceMatrix}
+1  & 2  & 3  & 4  & 5  & 6  \\
+11 & 12 & 13 & 14 & 15 & 16 \\
+\CodeAfter
+  \OverBrace{1-1}{2-3}{A}
+  \OverBrace{1-4}{2-6}{B}
+\end{pNiceMatrix}$
+
+\bigskip
+Les commandes |\OverBrace| et |\UnderBrace| acceptent en fait un premier
+argument optionnel (entre crochets) pour une liste de couples clé-valeur. Les
+clés disponibles sont les suivantes :
+\begin{itemize}
+\item |left-shorten| et |right-shorten| qui ne prennent pas de valeur ; quand
+|left-shorten| est utilisée, l'abscisse de l'extrémité de gauche de l'accolade
+est calculée à partir du contenu du sous-tableau concerné alors que, sinon,
+c'est la position du filet vertical éventuel qui est utilisée (de même pour
+|right-shorten|) ;
+
+\item |shorten|, qui est la conjonction des clés |left-shorten| et |right-shorten| ;
+
+\item |yshift|, qui déplace verticalement l'accolade (et son label).
+\end{itemize}
+
+\bigskip
+\begin{BVerbatim}[baseline=c,boxwidth=9cm]
+\begin{pNiceMatrix}
+1  & 2  & 3  & 4  & 5  & 6  \\
+11 & 12 & 13 & 14 & 15 & 16 \\
+\CodeAfter
+  \OverBrace~emphase#[shorten,yshift=3pt]@{1-1}{2-3}{A}
+  \OverBrace~emphase#[shorten,yshift=3pt]@{1-4}{2-6}{B}
+\end{pNiceMatrix}
+\end{BVerbatim}
+$\begin{pNiceMatrix}
+1  & 2  & 3  & 4  & 5  & 6  \\
+11 & 12 & 13 & 14 & 15 & 16 \\
+\CodeAfter
+  \OverBrace[shorten,yshift=3pt]{1-1}{2-3}{A}
+  \OverBrace[shorten,yshift=3pt]{1-4}{2-6}{B}
+\end{pNiceMatrix}$
+
+
 \section{Les notes dans les tableaux}
 
 \label{s:notes}
@@ -3843,23 +3938,24 @@ intéressant de préciser que, pour une cellule située dans une colonne de type
 |V|, le nœud PGF/Tikz créé par \pkg{nicematrix} pour le contenu de cette cellule
 a une largeur ajustée au contenu de cette cellule. Cela est en contraste avec le
 cas des colonnes de type |p|, |m| ou |b| dans lesquelles les nœuds ont toujours
-une largeur égale à la largeur de la colonne.
+une largeur égale à la largeur de la colonne. Dans l'exemple suivant, la
+commande |\lipsum| est fournie par l'extension éponyme.
 
 \begin{Verbatim}
-\begin{NiceTabular}{V{8cm}}
+\begin{NiceTabular}{V{10cm}}
 \bfseries \large 
 Titre \\
-\lipsum[1] 
+\lipsum[1][1-4]
 \CodeAfter 
   \tikz \draw [rounded corners] (1-1) -| (last-|2) -- (last-|1) |- (1-1) ; 
 \end{NiceTabular}
 \end{Verbatim}
 
 \begin{center}
-\begin{NiceTabular}{V{8cm}}
+\begin{NiceTabular}{V{10cm}}
 \bfseries \large 
 Titre \\
-\lipsum[1] 
+\lipsum[1][1-4]
 \CodeAfter 
   \tikz \draw [rounded corners] (1-1) -| (last-|2) -- (last-|1) |- (1-1) ; 
 \end{NiceTabular}
@@ -4463,10 +4559,11 @@ clé |draw-first| : |\Ddots[draw-first]|\rlap{.}
 
 \label{empty-cells}
 Une instruction comme |\Ldots|, |\Cdots|, etc. essaye de déterminer la première
-case vide de part et d'autre de la case considérée. Néanmoins, une case «vide»
-n'est pas nécessairement sans contenu dans le codage TeX (c'est-à-dire sans
-aucun token entre les deux esperluettes~|&|). Les règles précises sont les
-suivantes :
+case vide de part et d'autre de la case considérée. Quand la clé |corners|
+(cf.~p.~\pageref{corners}) est utilisée, les coins qui sont déterminés sont
+composés de cases vides. Néanmoins, une case «vide» n'est pas nécessairement
+sans contenu dans le codage TeX (c'est-à-dire sans aucun token entre les deux
+esperluettes~|&|). Les règles précises sont les suivantes :
 
 \begin{itemize}
 \item Une case implicite est vide. Par exemple, dans la matrice suivante
@@ -4496,8 +4593,11 @@ fixer la largeur des colonnes sans interférer avec le tracé des lignes en
 pointillés par \pkg{nicematrix}.
 
 \medskip
-\item Une case d'une colonne de type |p|, |m| ou |t| est toujours non vide.
-\emph{Attention} : Ne pas se fier à ce point car il est susceptible de changer.
+\item Une case d'une colonne de type |p|, |m| ou |t| est toujours non vide
+(\emph{attention} : ne pas se fier à ce point car il est susceptible de
+changer). En revanche, une case d'une colonne de type |V| de \pkg{varwidth} (cf.
+p.~\pageref{varwidth}) est vide quand son contenu TeX est de largeur nulle.
+
 
 \end{itemize}
 
@@ -4576,7 +4676,7 @@ La clé |tikz| de la commande |\Block| n'est disponible que lorsque Tikz est
 chargé.\footnote{Par défaut, \pkg{nicematrix} ne charge que \textsc{pgf}, qui
   est une sous-couche de Tikz.}
 
-Pour l'exemple suivant, la bibliothèque \tikz{patterns} de Tikz doit aussi être chargée.
+Pour l'exemple suivant, la bibliothèque \pkg{patterns} de Tikz doit aussi être chargée.
 
 \begin{Verbatim}
 \usetikzlibrary{patterns}
@@ -4831,11 +4931,13 @@ pointillées.
 
 
 \interitem
-On peut même tracer des lignes continues.
+On peut même tracer des lignes continues.\footnote{Dans ce document, la
+  bibliothèque \pkg{arrows.meta} de Tikz a été chargée, ce qui a une incidence
+  sur la forme des pointes de flèches.}
 
 \begin{Verbatim}
 \NiceMatrixOptions
-  {nullify-dots,code-for-first-col = \color{blue},code-for-first-col=\color{blue}}
+  {nullify-dots,code-for-first-col = \color{blue},code-for-first-row=\color{blue}}
 $\begin{pNiceMatrix}[first-row,first-col]
        &   & \Ldots[line-style={solid,<->},shorten=0pt]^{n \text{ colonnes}} \\
        & 1 & 1 & 1 & \Ldots & 1 \\
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
index 392d7278979..d6c12ea75e0 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf