nicematrix (3sep20)

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

3 files changed, 68 insertions, 43 deletions

diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
index bddd1a53c0e..1b03c3ddec3 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 7ea4ab69f85..ede56a3b74a 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
@@ -123,7 +123,7 @@ classique |latex|-|dvips|-|ps2pdf| (ou Adobe Distiller).
 \bigskip
 Cette extension nécessite et charge les extensions \pkg{l3keys2e}, \pkg{xparse}, \pkg{array}, \pkg{amsmath} et
 \pkg{pgfcore} ainsi que le module \pkg{shapes} de \textsc{pgf} (l'extension \pkg{tikz}, qui est une surcouche de
-\textsc{pgf} n'est \emph{pas} chargée). L'utilisateur final n'a qu'à charger l'extension \pkg{nicematrix} avec
+\textsc{pgf}, n'est \emph{pas} chargée). L'utilisateur final n'a qu'à charger l'extension \pkg{nicematrix} avec
 l'instruction habituelle : |\usepackage{nicematrix}|.
 
 
@@ -368,7 +368,7 @@ u_n & 1 & 2 & 4 & 8 & 16 & 32 \\
 
 
 \bigskip
-\colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip On peut aussi utiliser la clé
+\colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip On peut aussi utiliser la clé
 |baseline| pour aligner une matrice sur un filet horizontal (tracé par
 |\hline|). On doit pour cela donner la valeur |line-|\textsl{i} où \textsl{i}
 est le numéro de la rangée qui suit ce filet horizontal.
@@ -476,6 +476,9 @@ Rang & 1A & 1B & 1C & 2A & 2B & 2C \\
 \end{NiceTabular}
 \end{center}
 
+\interitem
+\colorbox{yellow!50}{\textbf{Nouveau 5.3}}\enskip La commande |\Block| accepte
+les options |l|, |c| et |r| pour le placement horizontal.
 
 \interitem
 On peut aussi utiliser la commande |\Block| dans des matrices mathématiques.
@@ -561,7 +564,7 @@ Marie & Pauline \\ \hline
 
 
 \bigskip
-\colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip En revanche, les filets
+\colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip En revanche, les filets
 verticaux ne sont pas tracés à l'intérieur des blocs.
 
 
@@ -807,7 +810,7 @@ Comme on le voit, un «coin vide» est constitué de la réunion de tous les
 rectangles vides partant de la case située exactement dans le coin.
 
 \bigskip
-\colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip On peut passer en argument de
+\colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip On peut passer en argument de
 |\hvlines-except-corners| une liste de coins à prendre en considération. Les
 coins étant désignés par |NW|, |SW|, |NE| et |SE| (\emph{north west},
 \emph{south west}, \emph{north east} et \emph{south east}).
@@ -1132,8 +1135,8 @@ Estelle & 15
 \end{scope}
 
 \bigskip
-\colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip Il existe une option |respect-blocks|
-pour la commande |\rowcolor|. Avec cette option, les ``rangées'' colorées
+\colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip Il existe une option |respect-blocks|
+pour la commande |\rowcolors|. Avec cette option, les ``rangées'' colorées
 alternativement peuvent s'étendre sur plusieurs rangées réelles du tableau pour
 englober les blocs.
 
@@ -1141,30 +1144,32 @@ englober les blocs.
 \begin{scope}
 \hfuzz=10cm
 \begin{BVerbatim}[baseline=c,boxwidth=9cm]
-\begin{NiceTabular}{cr}[hvlines,code-before =
+\begin{NiceTabular}{lr}[hvlines,code-before =
 ~emphase#\rowcolors{1}{blue!10}{}[respect-blocks]@]
-\Block{2-1}{Pierre} & 12 \\
-                    & 13 \\
+\Block[l]{2-1}{Pierre} & 12 \\
+                       & 13 \\
 Jacques & 8 \\
-\Block{3-1}{Stéphanie} & 18 \\
-                       & 17 \\
-                       & 15 \\
+\hphantom{Stéphanie}
+\Block[l]{3-1}{Stéphanie} & 18 \\
+                          & 17 \\
+                          & 15 \\
 Amélie & 20 \\
 Henri & 14 \\
-\Block{2-1}{Estelle} & 15 \\
-                     & 19
+\Block[l]{2-1}{Estelle} & 15 \\
+                        & 19
 \end{NiceTabular}
 \end{BVerbatim}
-\begin{NiceTabular}{cr}[hvlines,code-before = \rowcolors{1}{blue!10}{}[respect-blocks],baseline=c]
-\Block{2-1}{Pierre} & 12 \\
+\begin{NiceTabular}{lr}[hvlines,code-before = \rowcolors{1}{blue!10}{}[respect-blocks],baseline=c]
+\Block[l]{2-1}{Pierre} & 12 \\
                     & 13 \\
 Jacques & 8 \\
-\Block{3-1}{Stéphanie} & 18 \\
+\hphantom{Stéphanie}
+\Block[l]{3-1}{Stéphanie} & 18 \\
                        & 17 \\
                        & 15 \\
 Amélie & 20 \\
 Henri & 14 \\
-\Block{2-1}{Estelle} & 15 \\
+\Block[l]{2-1}{Estelle} & 15 \\
                      & 19
 \end{NiceTabular}
 \end{scope}
@@ -1210,7 +1215,7 @@ On remarquera que ces commandes sont compatibles avec les commandes de
 \begin{NiceTabular}{lSSSS}%
 [code-before = \rowcolor{red!15}{1-2} \rowcolors{3}{blue!15}{}]
 ~emphase#\toprule@
-\Block{2-1}{Produit} \\
+\Block{2-1}{Produit} &
 \Block{1-3}{dimensions (cm)} & & & 
 \Block{2-1}{\rotate Prix} \\
 ~emphase#\cmidrule(rl){2-4}@
@@ -1259,14 +1264,15 @@ On a alors accès aux trois commandes suivantes :
 \item |\rowcolor| à utiliser dans une case et qui colorie le reste de la rangée
 ;
 \item |\columncolor| à utiliser dans le préambule de la même manière que la
-commande éponyme de \pkg{colortbl}\footnote{Contrairement à la commande
+commande éponyme de \pkg{colortbl} (néanmoins, contrairement à la commande
 |\columncolor| de \pkg{colortbl}, celle-ci peut apparaître à l'intérieur d'une
-autre commande, elle-même utilisée dans le préambule.}.
+autre commande, elle-même utilisée dans le préambule).
 \end{itemize}
 
 \medskip
 \begin{Verbatim}
-\begin{NiceTabular}[colortbl-like]{*{2}{>{~emphase#\columncolor{blue!15}@}c}c} 
+\NewDocumentCommand { \Blue } { } { ~emphase#\columncolor{blue!15}@ }
+\begin{NiceTabular}[colortbl-like]{>{\Blue}c>{\Blue}cc} 
 \toprule
 ~emphase#\rowcolor{red!15}@
 Nom & Prénom & Année de naissance \\
@@ -1281,7 +1287,8 @@ Dupont & Chantal & 15 janvier 1998 \\
 
 
 \begin{center}
-\begin{NiceTabular}[colortbl-like]{*{2}{>{\columncolor{blue!15}}c}c} 
+\NewDocumentCommand { \Blue } { } { \columncolor{blue!15} }
+\begin{NiceTabular}[colortbl-like]{>{\Blue}c>{\Blue}cc} 
 \toprule
 \rowcolor{red!15}
 Nom & Prénom & Année de naissance \\
@@ -1301,8 +1308,8 @@ Chacune de ces instructions |\cellcolor|, |\rowcolor| ou |\columncolor|
 (utilisée hors du |code-before|) produit une instruction |fill| (codée |f|) dans
 le \textsc{pdf} final. En cas de juxtaposition de rectangles de même couleur,
 une fine ligne blanche peut donc apparaître dans certains lecteurs de
-\textsc{pdf}\footnote{Par exemple SumatraPDF v3.1.2, qui utilise MuPDF de Artifex
-  Software, dont le moteur de rendu \textsc{pdf} est appelé Fitz.} (entre les
+\textsc{pdf}\footnote{Par exemple SumatraPDF, qui utilise MuPDF de Artifex
+  Software, ou PDF.js utilisé par Firefox.} (entre les
 deux premières colonnes dans l'exemple ci-dessus). Pour éviter cela, il convient
 d'utiliser les outils proposés dans le |code-before|. C'est ce que l'on fait
 dans le codage qui suit. 
@@ -1923,14 +1930,15 @@ C[a_n^{(p)},a_1] & \Cdots & C[a_n^{(p)},a_n] & & C[a_n^{(p)},a_1^{(p)}] & \Cdots
 
 \subsection{Comment créer les lignes en pointillés de manière transparente}
 
-L'extension \pkg{nicematrix} fournit une option appelée |transparent| qui permet
-d'utiliser du code existant de manière transparente dans les environnements de
-l'\pkg{amsmath} : |{matrix}|, |{pmatrix}|, etc. En fait, cette option est un
-alias pour la conjonction de deux options : |renew-dots| et
+Si on a un document déjà tapé qui contient un grand nombre de matrices avec des
+points de suspension, on peut souhaiter utiliser les lignes pointillées de
+\pkg{nicematrix} sans avoir à modifier chaque matrice. Pour cela,
+\pkg{nicematrix} propose deux options |renew-dots| et
 |renew-matrix|.\footnote{Comme toutes les autres options, les options
-  |renew-dots|, |renew-matrix| et |transparent| peuvent être fixées avec la
-  commande |\NiceMatrixOptions|, mais elles peuvent aussi être passées en option
-  du |\usepackage| (ce sont les trois seules).}
+  |renew-dots|, |renew-matrix| peuvent être fixées avec la commande
+  |\NiceMatrixOptions|, mais elles peuvent aussi être passées en option du
+  |\usepackage|. Remarquons que la clé |transparent| est un alias, considéré
+  comme obsolète, pour la conjonction des clés |renew-dots| et |renew-matrix|.}
 
 \smallskip
 
@@ -1951,14 +1959,14 @@ Avec cette option, l'environnement |{matrix}| est redéfini et se comporte comme
 \end{itemize}
 
 \bigskip 
-Par conséquent, avec l'option |transparent|, un code classique donne directement
+Par conséquent, avec les options |renew-dots| et |renew-matrix|, un code classique donne directement
 le résultat fourni par \pkg{nicematrix}.\par\nobreak
 
 \bigskip
 \begin{scope}
-\NiceMatrixOptions{transparent}
+\NiceMatrixOptions{renew-dots,renew-matrix}
 \begin{BVerbatim}[baseline=c,boxwidth=10cm]
-~emphase#\NiceMatrixOptions{transparent}@
+~emphase#\NiceMatrixOptions{renew-dots,renew-matrix}@
 \begin{pmatrix}
 1      & \cdots & \cdots & 1      \\
 0      & \ddots &        & \vdots \\
@@ -2404,7 +2412,7 @@ séparés par des virgules quand on utilise plusieurs commandes |\tabularnote|
 successivement. Le marqueur |#1| est censé correspondre à un nom de compteur
 LaTeX. 
 
-Valeur initiale : |\emph{\alph{#1}}|
+Valeur initiale : |\textit{\alph{#1}}|
 
 Une autre valeur possible pourrait être tout simplement |\arabic{#1}|
 
@@ -2490,12 +2498,13 @@ Pour un exemple de personnalisation des notes de tableau, voir p.~\pageref{ex:no
 \subsection{Utilisation de \{NiceTabular\} avec threeparttable}
 
 
-Si vous souhaitez utiliser l'environnement |{NiceTabular}| dans un environnement
-|{threeparttable}| de l'extension éponyme, vous devez patcher l'environnement
-|{threeparttable}| avec le code suivant.
+Si vous souhaitez utiliser l'environnement |{NiceTabular}| ou |{NiceTAbular*}|
+dans un environnement |{threeparttable}| de l'extension éponyme, vous devez
+patcher |{threeparttable}| avec le code suivant.
 \begin{Verbatim}[commandchars=\~\#\!]
 \makeatletter
-\AtBeginEnvironment{threeparttable}{\TPT@hookin{NiceTabular}}
+\AtBeginEnvironment{threeparttable}
+  {\TPT@hookin{NiceTabular}\TPT@hookin{NiceTabular*}}
 \makeatother
 \end{Verbatim}
 
@@ -3204,7 +3213,7 @@ L'extension \pkg{nicematrix} fournit deux variables internes mais publiques\foot
   publique alors que toute variable dont le nom débute par |\g__nicematrix| ou
   par |\l__nicematrix| est privée.} :
 \begin{itemize}
-\item \colorbox{yellow!50}{\textbf{Nouveau 5.2}}\enskip |\g_nicematrix_code_before_tl| ;
+\item \colorbox{yellow!30}{\textbf{Nouveau 5.2}}\enskip |\g_nicematrix_code_before_tl| ;
 \item |\g_nicematrix_code_after_tl|.
 \end{itemize}
 
@@ -3421,10 +3430,14 @@ a+b    & \Ddots  &     & \Vdots \\
 a+b    & \Cdots  & a+b & 1
 \end{pNiceMatrix}$
 
-
-
 \end{scope}
 
+\bigskip
+\colorbox{yellow!50}{\textbf{Nouveau 5.3}}\enskip On peut choisir l'instruction
+  |\Ddots| qui sera tracée en premier (et qui servira pour tracer les suivantes
+  quand la parallélisation est activée) avec la clé |draw-first| :
+  |\Ddots[draw-first]|. 
+
 \subsection{Les cases «vides»}
 
 \label{empty-cells}
@@ -4268,12 +4281,24 @@ L_i & a_{i1} & \Cdots & a_{ik} & \Cdots & a_{in} \\
  \draw [color = gray] (A-3-3) to [bend left] (B-3-3) ; 
 \end{tikzpicture}
 
+
+\newpage
+
 \section*{Autre documentation}
 
 Le document |nicematrix.pdf| (fourni avec l'extension \pkg{nicematrix}) contient
 une traduction anglaise de la documentation ici présente, ainsi que le code
 source commenté et un historique des versions.
 
+\bigskip
+Les versions successives du fichier |nicematrix.sty| fournies par
+TeXLive sont disponibles sur le serveur \textsc{svn} de TeXLive :
+
+{
+\small
+\url{https:www.tug.org/svn/texlive/trunk/Master/texmf-dist/tex/latex/nicematrix/nicematrix.sty}
+}
+
 \end{document}
 
 % Local Variables:
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
index ebefac27a86..9743eb335d7 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf