nicematrix (23mar20)

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

3 files changed, 44 insertions, 21 deletions

diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
index 67e958be03a..3b5ff88070a 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 3f3c6dc7d14..2d157cce4f1 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
@@ -236,7 +236,8 @@ entre les premières cases non vides\footnote{La définition précise de ce qui
 entendu, pour |\Ldots| et |\Cdots|, c'est une ligne horizontale ; pour |\Vdots|, c'est une ligne verticale et pour
 |\Ddots| et |\Iddots|, ce sont des lignes diagonales. On peut changer la couleur d'une ligne avec
 l'option~|color|.\footnote{Il est aussi possible de changer la couleur de toutes ces lignes pointillées avec
-  l'option |xdots/color| (\textsl{xdots} pour rappeler que cela s'applique à |\Cdots|, |\Ldots|, |Vdots|, etc.)
+  l'option |xdots/color| (\textsl{xdots} pour rappeler que cela s'applique à |\Cdots|, |\Ldots|, |Vdots|, etc.) :
+  cf. p.~\pageref{customization}).
 }\par\nobreak   
 
 \bigskip
@@ -529,6 +530,8 @@ $\begin{pmatrix}
 
 \subsection{Personnalisation des lignes en pointillés}
 
+
+\label{customization}
 Les lignes pointillées tracées par |\Ldots|, |\Cdots|, |\Vdots|, |\Ddots|, |\Idots| et |\Hdotsfor| (ainsi que par la
 commande |\line| dans le |code-after| 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) :
@@ -1045,11 +1048,10 @@ Les environnements de \pkg{nicematrix} permettent de composer des rangées et de
 \label{exterior}
 
 Si elle est présente, la «première rangée» (extérieure) est numérotée par $0$ (et non $1$). Il en est de même pour
-la «première rangée». Dans le cas général, on doit spécifier le numéro de la dernière rangée et de la dernière
-colonne comme valeurs des options |last-row| et |last-col| (si elles sont présentes).
+la «première rangée». 
 
 \begin{Verbatim}
-$\begin{pNiceMatrix}[~emphase#first-row,last-row=5,first-col,last-col=5@,nullify-dots]
+$\begin{pNiceMatrix}[~emphase#first-row,last-row,first-col,last-col@,nullify-dots]
        & C_1    & \Cdots &        & C_4    &        \\
 L_1    & a_{11} & a_{12} & a_{13} & a_{14} & L_1    \\
 \Vdots & a_{21} & a_{22} & a_{23} & a_{24} & \Vdots \\
@@ -1059,7 +1061,7 @@ L_4    & a_{41} & a_{42} & a_{43} & a_{44} & L_4    \\
 \end{pNiceMatrix}$
 \end{Verbatim}
 %
-\[\begin{pNiceMatrix}[first-row,last-row=5,first-col,last-col=5,nullify-dots]
+\[\begin{pNiceMatrix}[first-row,last-row,first-col,last-col,nullify-dots]
        & C_1    & \Cdots &        & C_4    &        \\
 L_1    & a_{11} & a_{12} & a_{13} & a_{14} & L_1    \\
 \Vdots & a_{21} & a_{22} & a_{23} & a_{24} & \Vdots \\
@@ -1077,14 +1079,26 @@ variantes), on ne doit pas mettre dans ce préambule de spécification de colonn
 dernière colonne : ce sera automatiquement (et nécessairement) une colonne |R| pour la première colonne et une
 colonne |L| pour la dernière.
 
-\item Si on utilise un environnement avec préambule explicite et une dernière colonne, on doit utiliser l'option
-|last-col| \emph{sans} valeur. En effet le numéro de la dernière colonne est, dans ce cas, déduit du préambule (qui
-contient nécessairement implicitement l'information du nombre de colonnes non extérieures).
+\item On peut se demander comment \pkg{nicematrix} détermine le nombre de rangées et de colonnes nécessaires à la
+composition de la «dernière rangée» et de la «dernière colonne».
+
+\begin{itemize}
+\item Dans le cas d'un environnement avec préambule, comme |{NiceArray}| ou |{pNiceArray}|, le nombre de colonnes
+se déduit évidemment du préambule.
+
+\item Dans le cas où l'option |light-syntax| (cf. p. \pageref{light-syntax}) est utilisée, \pkg{nicematrix} profite
+du fait que cette option nécessite de toutes manières le chargement complet du contenu de l'environnement (d'où
+l'impossibilité de mettre du verbatim dans ce cas-là) avant composition du tableau. L'analyse du contenu de
+l'environnement donne le nombre de rangées (mais pas le nombre de colonnes).
+
+\item Dans les autres cas, \pkg{nicematrix} détermine le nombre de rangées et de colonnes à la première compilation
+et l'écrit dans le fichier |.aux| pour pouvoir l'utiliser à la compilation suivante.
+
+\textsl{Néanmoins, il est possible de donner le numéro de la dernière rangée et le numéro de la dernière colonne en
+arguments des options |last-row| et |last-col| pour ce qui permettra d'accélérer le processus complet de
+compilation.} C'est ce que nous ferons dans la suite.
+\end{itemize}
 
-\item Pour une dernière rangée, l'option |last-row| peut en fait être utilisée sans préciser de valeur. Dans ce
-cas, \pkg{nicematrix} détermine, lors de la première compilation, le nombre de rangées rencontrées dans le tableau
-et l'écrit dans le fichier |.aux| pour la prochaine compilation. Dans l'exemple qui suit, l'option |last-row| sera
-utilisée sans valeur explicite.
 \end{itemize}
 
 
@@ -1099,7 +1113,7 @@ insérées au début de chaque case de la rangée ou de la colonne considérée.
                    ~emphase#code-for-first-col@ = \color{blue},
                    ~emphase#code-for-last-row@ = \color{green},
                    ~emphase#code-for-last-col@ = \color{magenta}}
-$\begin{pNiceArray}{CC|CC}[first-row,last-row,first-col,last-col,nullify-dots]
+$\begin{pNiceArray}{CC|CC}[first-row,last-row=6,first-col,last-col,nullify-dots]
        & C_1    & \Cdots &        & C_4    &        \\
 L_1    & a_{11} & a_{12} & a_{13} & a_{14} & L_1    \\
 \Vdots & a_{21} & a_{22} & a_{23} & a_{24} & \Vdots \\
@@ -1116,7 +1130,7 @@ L_4    & a_{41} & a_{42} & a_{43} & a_{44} & L_4    \\
                    code-for-last-row = \color{green},
                    code-for-last-col = \color{magenta}}
 \begin{displaymath}
-\begin{pNiceArray}{CC|CC}[first-row,last-row,first-col,last-col,nullify-dots]
+\begin{pNiceArray}{CC|CC}[first-row,last-row=5,first-col,last-col,nullify-dots]
        & C_1    & \multicolumn1C{\Cdots} &        & C_4    &        \\
 L_1    & a_{11} & a_{12} & a_{13} & a_{14} & L_1    \\
 \Vdots & a_{21} & a_{22} & a_{23} & a_{24} & \Vdots \\
@@ -1751,11 +1765,13 @@ $\begin{pNiceMatrix}[vlines]
 
 \subsection{L'option light-syntax}
 
-L'option |light-syntax|\footnote{Cette option est inspirée de 
-l'extension \pkg{spalign} de Joseph Rabinoff.} permet d'alléger la saisie des matrices, ainsi que leur lisibilité dans le source TeX.
-Lorsque cette option est activée, on doit utiliser le point-virgule comme marqueur de fin de rangée et séparer les
-colonnes par des espaces. On remarquera toutefois que, comme souvent dans le monde TeX, les espaces après les
-séquences de contrôle ne sont pas comptées et que les éléments entre accolades sont considérés comme un tout.
+\label{light-syntax}
+
+L'option |light-syntax|\footnote{Cette option est inspirée de l'extension \pkg{spalign} de Joseph Rabinoff.} permet
+d'alléger la saisie des matrices, ainsi que leur lisibilité dans le source TeX. Lorsque cette option est activée,
+on doit utiliser le point-virgule comme marqueur de fin de rangée et séparer les colonnes par des espaces ou des
+tabulations. On remarquera toutefois que, comme souvent dans le monde TeX, les espaces après les séquences de
+contrôle ne sont pas comptées et que les éléments entre accolades sont considérés comme un tout.
 
 
 \medskip
@@ -1779,6 +1795,13 @@ b \cos a+\cos b  { 2 \cos b }
 On peut changer le caractère utilisé pour indiquer les fins de rangées avec l'option |end-of-row|. Comme dit
 précédemment, la valeur initiale de ce paramètre est un point-virgule.
 
+\medskip
+Lorsque l'option |light-syntax| est utilisée, il n'est pas possible de mettre d'éléments en verbatim (avec par
+exemple la commande |\verb|) dans les cases du tableau.\footnote{La raison en est que lorsque l'option
+  |light-syntax| est utilisée, le contenu complet de l'environnement est chargé comme un argument de commande TeX.
+  L'environnement ne se comporte plus comme un «vrai» environnement de LaTeX qui se contente d'insérer des
+  commandes avant et après.}
+
 \subsection{Utilisation du type de colonne S de siunitx}
 
 Si l'extension \pkg{siunitx} est chargée (avant ou après \pkg{nicematrix}), il est possible d'utiliser les colonnes
@@ -1831,14 +1854,14 @@ Le trait fort correspondant ne s'étendra pas dans les rangées extérieures :
 \newcolumntype{?}{!{\OnlyMainNiceMatrix{\vrule width 1 pt}}}
 
 \begin{BVerbatim}[baseline = c, boxwidth = 10.5cm]
-$\begin{pNiceArray}{CC?CC}[first-row,last-row]
+$\begin{pNiceArray}{CC?CC}[first-row,last-row=3]
 C_1 & C_2 & C_3 & C_4 \\
 a & b & c & d \\
 e & f & g & h \\
 C_1 & C_2 & C_3 & C_4
 \end{pNiceArray}$
 \end{BVerbatim}
-$\begin{pNiceArray}{CC?CC}[first-row,last-row]
+$\begin{pNiceArray}{CC?CC}[first-row,last-row=3]
 C_1 & C_2 & C_3 & C_4 \\
 a & b & c & d \\
 e & f & g & h \\
diff --git a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
index fe0d364d95b..8cddffc1b2a 100644
--- a/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
+++ b/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf