texlive[63262] Master/texmf-dist: nicematrix (8may22)

commits+karl at tug.org commits+karl at tug.org
Sun May 8 22:24:31 CEST 2022


Revision: 63262
          http://tug.org/svn/texlive?view=revision&revision=63262
Author:   karl
Date:     2022-05-08 22:24:31 +0200 (Sun, 08 May 2022)
Log Message:
-----------
nicematrix (8may22)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
    trunk/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
    trunk/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
    trunk/Master/texmf-dist/source/latex/nicematrix/nicematrix.dtx
    trunk/Master/texmf-dist/tex/latex/nicematrix/nicematrix.sty

Modified: trunk/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex	2022-05-08 20:24:12 UTC (rev 63261)
+++ trunk/Master/texmf-dist/doc/latex/nicematrix/nicematrix-french.tex	2022-05-08 20:24:31 UTC (rev 63262)
@@ -1170,64 +1170,6 @@
 
 
 
-\subsection{Filets en pointillés}
-
-\label{dotted}
-
-Dans les environnements de \pkg{nicematrix}, il est possible d'utiliser la
-commande |\hdottedline| (fournie par \pkg{nicematrix}) qui est l'équivalent pour
-les pointillés de la commande |\hline|.
-
-\medskip
-\begin{BVerbatim}[baseline=c,boxwidth=9.5cm]
-\begin{pNiceMatrix}
-1 & 2 & 3 & 4 & 5 \\
-~emphase#\hdottedline@
-6 & 7 & 8 & 9 & 10 \\
-11 & 12 & 13 & 14 & 15
-\end{pNiceMatrix}
-\end{BVerbatim}
-$\begin{pNiceMatrix}
-1 & 2 & 3 & 4 & 5 \\
-\hdottedline
-6 & 7 & 8 & 9 & 10 \\
-11 & 12 & 13 & 14 & 15
-\end{pNiceMatrix}$
-
-
-\medskip
-Dans les environnements avec un préambule explicite (comme |{NiceTabular}|,
-|{NiceArray}|, etc.), il est possible de dessiner un trait vertical en
-pointillés avec le spécificateur «|:|».
-
-\medskip
-\begin{BVerbatim}[baseline=c,boxwidth=9.5cm]
-\begin{pNiceArray}{cccc~emphase#:@c}
-1 & 2 & 3 & 4 & 5 \\
-6 & 7 & 8 & 9 & 10 \\
-11 & 12 & 13 & 14 & 15
-\end{pNiceArray}
-\end{BVerbatim}
-$\begin{pNiceArray}{cccc:c}
-1 & 2 & 3 & 4 & 5 \\
-6 & 7 & 8 & 9 & 10 \\
-11 & 12 & 13 & 14 & 15
-\end{pNiceArray}$
-
-\medskip
-Il est possible de changer dans \pkg{nicematrix} la lettre utilisée pour
-indiquer dans le préambule un trait vertical en pointillés avec l'option
-|letter-for-dotted-lines| disponible dans |\NiceMatrixOptions|. 
-
-\medskip
-\emph{Remarque} : Quand l'extension \pkg{array} (sur laquelle s'appuie
-\pkg{nicematrix}) est chargée, les traits verticaux et horizontaux que l'on
-insère rendent le tableau plus large ou plus long d'une quantité égale à la
-largeur du trait\footnote{En fait, avec l'extension \pkg{array}, cela est vrai
-  pour |\hline| et «\verb+|+» mais pas pour |\cline| : cf.
-  p.~\pageref{remark-cline}}. Avec \pkg{nicematrix}, les lignes en pointillés
-tracées par |\hdottedline| et «|:|» ont ce même effet.
-
 \subsection{Commandes pour filets personnalisés}
 \label{custom-line}
 
@@ -1272,35 +1214,9 @@
 \end{itemize}
 
 \medskip
-\item \emph{Deuxième possibilité}\par\nobreak
-
-On peut utiliser la clé |dotted| qui impose un style de pointillés qui utilise
-le système de pointillés de la commande |\hdottedline| (et de la lettre
-\verb|:|) décrit à la partie précédente (cf. p.~\pageref{dotted}). La clé
-|color| est en fait aussi utilisable dans ce cas-là.
-
-\medskip
-\item \colorbox{yellow!50}{\textbf{Nouveau 6.6}}\enskip \emph{Troisième
-  possibilité}
-
-On peut utiliser la clé |tikz| (si Tikz est chargé, \pkg{nicematrix} ne
-chargeant par défaut que \textsc{pgf}). Dans ce cas-là, le filet est tracé
-directement avec Tikz en utilisant comme paramètres la valeur de la clé |tikz|
-qui doit être une liste de couples \textsl{clé=valeur} applicables à un chemin
-Tikz.
-
-Par défaut aucune réservation de place n'est faite par défaut pour le filet qui
-sera tracé avec Tikz. On peut demander une réservation (horizontale pour un
-filet vertical et verticale pour un filet horizontal) avec la clé |width| qui
-est donc en quelque sorte la largeur du filet qui sera tracé (cette largeur
-n'est pas déduite des caractéristiques fournies par la clé |tikz|).
-\end{itemize}
-
-
-\medskip
 Ce système permet en particulier de définir des commandes pour tracer des filets
-avec une couleur spécifique (et ces filets respecteront les blocs comme les
-autres filets de \pkg{nicematrix}).
+avec une couleur spécifique (et ces filets respecteront les blocs et les coinn
+comme les autres filets de \pkg{nicematrix}).
 
 \medskip
 \begin{Verbatim}
@@ -1331,31 +1247,40 @@
 \end{center}
 
 
+\item \colorbox{yellow!50}{\textbf{Nouveau 6.6}}\enskip \emph{Deuxième
+  possibilité}
+
+On peut utiliser la clé |tikz| (si Tikz est chargé, \pkg{nicematrix} ne
+chargeant par défaut que \textsc{pgf}). Dans ce cas-là, le filet est tracé
+directement avec Tikz en utilisant comme paramètres la valeur de la clé |tikz|
+qui doit être une liste de couples \textsl{clé=valeur} applicables à un chemin
+Tikz.
+
+Par défaut aucune réservation de place n'est faite par défaut pour le filet qui
+sera tracé avec Tikz. On peut demander une réservation (horizontale pour un
+filet vertical et verticale pour un filet horizontal) avec la clé |width| qui
+est donc en quelque sorte la largeur du filet qui sera tracé (cette largeur
+n'est pas déduite des caractéristiques fournies par la clé |tikz|).
+
 \bigskip
-Voici un exemple avec la clé |tikz|.
+Voici ce que l'on obtient avec la clé |dotted| de Tikz.
 
 \begin{Verbatim}
-\documentclass{article}
-\usepackage{nicematrix,tikz}
-\usetikzlibrary{decorations.pathmorphing}
-
 \NiceMatrixOptions
   {
     custom-line = 
      {
        letter = I , 
-       ~emphase#tikz = { decorate, decoration = { coil, aspect = 0 } }}@ ,
-       ~emphase#width = 2 mm@ 
+       ~emphase#tikz = dotted @ ,
+       ~emphase#width = \pgflinewidth@ 
      }
   }
 
-\begin{document}
 \begin{NiceTabular}{cIcIc}
 un & deux & trois \\
 quatre & cinq & six \\
 sept & huit & neuf
 \end{NiceTabular}
-\end{document}
 \end{Verbatim}
 
 \begin{center}
@@ -1364,8 +1289,8 @@
     custom-line = 
      {
        letter = I , 
-       tikz = { decorate, decoration = { coil, aspect = 0 } } ,
-       width = 2 mm 
+       tikz = dotted ,
+       width = \pgflinewidth
      }
   }
 \begin{NiceTabular}{cIcIc}
@@ -1375,8 +1300,82 @@
 \end{NiceTabular}
 \end{center}
 
+\medskip
+\item \emph{Troisième possibilité} : la clé |dotted|\par\nobreak
+\label{dotted}
 
+Comme on le voit dans l'exemple précédent, les pointillés tracés par la clé
+|dotted| de Tikz ne sont pas ronds. C'est pourquoi l'extension \pkg{nicematrix}
+propose dans la clé |custom-line| une clé |dotted| qui va tracer des pointillés
+ronds. La valeur de la clé |width| est, dans ce cas-là, déjà réglée sur le
+diamètre des points. Ces pointillés ronds sont aussi utilisés par
+\pkg{nicematrix} pour des lignes en pointillées continues créées entre deux
+composantes de la matrice par |\Cdots|, |\Vdots|, etc (voir p.~\pageref{Cdots}).
 
+\medskip
+L'extension \pkg{nicematrix} prédéfinit en fait la commande |\hdottedline| et la
+lettre «|:|» pour ces filets en pointillés.\footnote{Néanmoins, l'utilisateur peut écraser ces définitions de |\hdottedline| et de
+«|:|» avec |custom-line| s'il le souhaite (par exemple pour les remplacer par des
+lignes en tiretés).}
+
+\smallskip
+\begin{BVerbatim}
+% ~textsl#présent dans nicematrix.sty@
+\NiceMatrixOptions
+  { 
+    custom-line = 
+      { 
+        letter = : , 
+        command = hdottedline , 
+        dotted 
+      }
+  } 
+\end{BVerbatim}
+
+\bigskip
+Dans les environnements de \pkg{nicematrix}, il est donc possible d'utiliser la
+commande |\hdottedline| pour tracer des filets horizontaux en pointillés.
+
+\medskip
+\begin{BVerbatim}[baseline=c,boxwidth=9.5cm]
+\begin{pNiceMatrix}
+1 & 2 & 3 & 4 & 5 \\
+~emphase#\hdottedline@
+6 & 7 & 8 & 9 & 10 \\
+11 & 12 & 13 & 14 & 15
+\end{pNiceMatrix}
+\end{BVerbatim}
+$\begin{pNiceMatrix}
+1 & 2 & 3 & 4 & 5 \\
+\hdottedline
+6 & 7 & 8 & 9 & 10 \\
+11 & 12 & 13 & 14 & 15
+\end{pNiceMatrix}$
+
+
+\medskip
+Dans les environnements avec un préambule explicite (comme |{NiceTabular}|,
+|{NiceArray}|, etc.), il est possible de dessiner un trait vertical en
+pointillés avec le spécificateur «|:|».
+
+\medskip
+\begin{BVerbatim}[baseline=c,boxwidth=9.5cm]
+\begin{pNiceArray}{cccc~emphase#:@c}
+1 & 2 & 3 & 4 & 5 \\
+6 & 7 & 8 & 9 & 10 \\
+11 & 12 & 13 & 14 & 15
+\end{pNiceArray}
+\end{BVerbatim}
+$\begin{pNiceArray}{cccc:c}
+1 & 2 & 3 & 4 & 5 \\
+6 & 7 & 8 & 9 & 10 \\
+11 & 12 & 13 & 14 & 15
+\end{pNiceArray}$
+\end{itemize}
+
+
+
+
 \section{Les couleurs des rangées et des colonnes}
 
 \subsection{Utilisation de colortbl}
@@ -2117,9 +2116,7 @@
 
 \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)
@@ -3211,8 +3208,6 @@
 \subsection{Les commandes \textbackslash OverBrace et \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}
@@ -3392,6 +3387,12 @@
 \pkg{nicematrix}), la clé |notes/bottomrule| permet de faire tracer un
 |\bottomrule| de \pkg{booktabs} \emph{après} les notes.
 
+\item \colorbox{yellow!50}{\textbf{Nouveau 6.8}}\enskip Lorsque plusieurs
+commandes |\tabularnote| sont utilisées avec le même argument, une seule note
+est insérée en fin de tableau (mais tous les labels sont marqués). Il est
+possible de désactiver cette fonctionnalité avec la clé
+|notes/detect-duplicates|
+
 \item Il est possible de référencer une note de tableau (avec la commande
 |\label| placée après le |\tabularnote|).
 \end{itemize}
@@ -3406,8 +3407,7 @@
 \setlength{\belowcaptionskip}{1ex}
 \centering
 \caption{Utilisation de \texttt{\textbackslash
-    tabularnote}~emphase#\tabularnote{On peut!
-     ~emphase# mettre une note dans le titre.}!}
+    tabularnote}~emphase#\tabularnote{On peut mettre une note dans le titre.}!}
 \label{t:tabularnote}
 \begin{NiceTabular}{@{}llc@{}}%
   [~emphase#notes/bottomrule!, tabularnote = Un peu de texte avant les notes.]
@@ -3417,9 +3417,9 @@
 Barrère & Bertrand &  86\\
 Nightingale~emphase#\tabularnote{Souvent considérée comme la première!
   ~emphase#infirmière.}\tabularnote{Surnommée «la Dame à la Lampe».}!
-& Florence & 90 \\
+& Florence~emphase#\tabularnote{Cette note est commune à deux appels de notes.}! & 90 \\
 Schœlcher & Victor & 89~emphase#\tabularnote{L'appel de note déborde à droite.}!\\
-Touchet & Marie & 89 \\
+Touchet & Marie~emphase#\tabularnote{Cette note est commune à deux appels de notes.}! & 89 \\
 Wallis & John & 87 \\
 \bottomrule
 \end{NiceTabular}
@@ -3441,9 +3441,9 @@
 Barrère & Bertrand &  86\\
 Nightingale\tabularnote{Souvent considérée comme la première
   infirmière.}\tabularnote{Surnommée «la Dame à la Lampe».}
-& Florence & 90 \\
+& Florence\tabularnote{Cette note est commune à deux appels de notes.} & 90 \\
 Schœlcher & Victor & 89\tabularnote{L'appel de note déborde à droite.}\\
-Touchet & Marie & 89 \\
+Touchet & Marie\tabularnote{Cette note est commune à deux appels de notes.} & 89 \\
 Wallis & John & 87 \\
 \bottomrule
 \end{NiceTabular}
@@ -3603,13 +3603,10 @@
 On peut aussi mettre dans cette clé |\raggedright| ou |\RaggedRight| (cette
 dernière est une commande de \pkg{ragged2e}).
 
-\item \colorbox{yellow!50}{\textbf{Nouveau 6.8}}\enskip À partir de la version
-6.8, les doublons dans les notes de tableau sont détectés par défaut: lorsque
-plusieurs commandes |\tabularnote| sont utilisées avec le même argument, une
-seule note est insérée en fin de tableau (mais tous les labels sont marqués). Il
-est possible de désactiver cette fonctionnalité avec la clé
-|notes/detect-duplicates| (sa valeur initiale est |true|).
+\item La clé |notes/detect-duplicates| active la détection des
+commandes |\tabularnote| avec le même argument.
 
+Valeur initiale : |true|
 \end{itemize}
 
 
@@ -4085,10 +4082,9 @@
 \end{pNiceMatrix}\]
 
 
-\colorbox{yellow!50}{\textbf{Nouveau 6.3}}\enskip Les nœuds de la dernière
-colonne (hors éventuelle «colonne extérieure» spécifiée par |last-col|) peuvent
-aussi être désignés par $i$-|last|. De même, les nœuds de la dernière ligne
-peuvent être désignés par |last|-$j$.
+Les nœuds de la dernière colonne (hors éventuelle «colonne extérieure» spécifiée
+par |last-col|) peuvent aussi être désignés par $i$-|last|. De même, les nœuds
+de la dernière ligne peuvent être désignés par |last|-$j$.
 
 \medskip
 \subsubsection{Les colonnes V de varwidth}

Modified: trunk/Master/texmf-dist/doc/latex/nicematrix/nicematrix.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/source/latex/nicematrix/nicematrix.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/nicematrix/nicematrix.dtx	2022-05-08 20:24:12 UTC (rev 63261)
+++ trunk/Master/texmf-dist/source/latex/nicematrix/nicematrix.dtx	2022-05-08 20:24:31 UTC (rev 63262)
@@ -15,8 +15,8 @@
 %
 % \fi
 % \iffalse
-\def\myfileversion{6.8}
-\def\myfiledate{2022/03/11}
+\def\myfileversion{6.8a}
+\def\myfiledate{2022/05/08}
 %
 %
 %<*batchfile>
@@ -101,6 +101,8 @@
 \makeatother
 
 
+
+
 \begin{document}
 \DocInput{nicematrix.dtx}
 \end{document}
@@ -1181,60 +1183,8 @@
 % It's possible to use the command |\diagbox| in a |\Block|.
 %
 %
-% \subsection{Dotted rules}
-%
-% \label{dotted}
-%
-% In the environments of the package \pkg{nicematrix}, it's possible to use
-% the command |\hdottedline| (provided by \pkg{nicematrix}) which is a
-% counterpart of the classical command |\hline|.
-%
-% \medskip
-% \begin{BVerbatim}[baseline=c,boxwidth=9.5cm]
-% \begin{pNiceMatrix}
-% 1 & 2 & 3 & 4 & 5 \\
-% ~emphase#\hdottedline@
-% 6 & 7 & 8 & 9 & 10 \\
-% 11 & 12 & 13 & 14 & 15 
-% \end{pNiceMatrix}
-% \end{BVerbatim}
-% $\begin{pNiceMatrix}
-% 1 & 2 & 3 & 4 & 5 \\
-% \hdottedline
-% 6 & 7 & 8 & 9 & 10 \\
-% 11 & 12 & 13 & 14 & 15 
-% \end{pNiceMatrix}$
-%
-%
-% \bigskip
-% In the environments with an explicit preamble (like |{NiceTabular}|,
-% |{NiceArray}|, etc.), it's possible to draw a vertical dotted line with the
-% specifier ``|:|''.
 % 
-% \medskip
-% \begin{BVerbatim}[baseline=c,boxwidth=9.5cm]
-% \left(\begin{NiceArray}{cccc~emphase#:@c}
-% 1 & 2 & 3 & 4 & 5 \\
-% 6 & 7 & 8 & 9 & 10 \\
-% 11 & 12 & 13 & 14 & 15 
-% \end{NiceArray}\right)
-% \end{BVerbatim}
-% $\left(\begin{NiceArray}{cccc:c}
-% 1 & 2 & 3 & 4 & 5 \\
-% 6 & 7 & 8 & 9 & 10 \\
-% 11 & 12 & 13 & 14 & 15 
-% \end{NiceArray}\right)$
 %
-% 
-% \bigskip
-% \emph{Remark}: In the package \pkg{array} (on which the package
-% \pkg{nicematrix} relies), horizontal and vertical rules make the array larger
-% or wider by a quantity equal to the width of the rule\footnote{In fact, with
-% \pkg{array}, this is true only for |\hline| and ``"|"'' but not for |\cline|:
-% cf p.~\pageref{remark-cline}}. In \pkg{nicematrix}, the dotted lines drawn by
-% |\hdottedline| and ``|:|'' do likewise.
-%
-%
 % \subsection{Commands for customized rules}
 % \label{custom-line}
 % 
@@ -1274,36 +1224,12 @@
 % \item the key |sep-color| sets the color between two successive rules (should be
 % used only in conjonction with |multiplicity|).
 % \end{itemize}
-% 
-% \bigskip
-% \item \emph{Second possibility}\par\nobreak
-% 
-% The key |dotted| forces a style with dotted rules such as those created by
-% |\hdottedline| or the letter ``|:|'' in the preamble (cf.
-% p.~\pageref{dotted}). The key |color| may be used also in that case.
 %
-% \bigskip
-% \item \colorbox{yellow!50}{\textbf{New 6.6}}\enskip \emph{Third
-% possibility}\par\nobreak 
-% 
-% It's possible to use the key |tikz| (if Tikz is loaded). In that case, the
-% rule is drawn directly with Tikz by using as parameters the value of the key
-% |tikz| which must be a list of \textsl{key=value} pairs which may be applied
-% to a Tikz path.
-% 
-% By default, no space is reserved for the rule that will be drawn with Tikz. It
-% possible to specify a reservation (horizontal for a vertical rule and vertical
-% for an horizontal one) with the key |width|. That value of that key, is, in
-% some ways, the width of the rule that will be drawn (\pkg{nicematrix} does not
-% compute that width from the characteristics of the rule specified in |tikz|).
-% \end{itemize}
-% 
-% \bigskip
+% \medskip
 % That system may be used, in particular, for the definition of commands and
 % letters to draw rules with a specific color (and those rules will respect the
-% blocks as do all rules of \pkg{nicematrix}).
-%
-%
+% blocks and corners as do all the rules of \pkg{nicematrix}). 
+% 
 % \medskip
 % \begin{Verbatim}
 % \begin{NiceTabular}{lcIcIc}~emphase#[custom-line = {letter=I, color=blue}]@
@@ -1318,7 +1244,24 @@
 % \end{NiceTabular}
 % \end{Verbatim}
 %
+% 
+% \bigskip
+% \item \colorbox{yellow!50}{\textbf{New 6.6}}\enskip \emph{Second
+% possibility}\par\nobreak 
+% 
+% It's possible to use the key |tikz| (if Tikz is loaded). In that case, the
+% rule is drawn directly with Tikz by using as parameters the value of the key
+% |tikz| which must be a list of \textsl{key=value} pairs which may be applied
+% to a Tikz path.
+% 
+% By default, no space is reserved for the rule that will be drawn with Tikz. It
+% is possible to specify a reservation (horizontal for a vertical rule and
+% vertical for an horizontal one) with the key |width|. That value of that key,
+% is, in some ways, the width of the rule that will be drawn (\pkg{nicematrix}
+% does not compute that width from the characteristics of the rule specified in
+% |tikz|).
 %
+%
 % \begin{center}
 % \begin{NiceTabular}{lcIcIc}[custom-line = {letter=I, color=blue}]
 % \hline
@@ -1333,40 +1276,33 @@
 % \end{center}
 %
 % \bigskip
-% Here is an example of the key |tikz|.
+% Here is an example with the key |dotted| of Tikz.
 %
-% \begin{Verbatim}
-% \documentclass{article}
-% \usepackage{nicematrix,tikz}
-% \usetikzlibrary{decorations.pathmorphing}
-%
+% \begin{BVerbatim}[boxwidth=9cm,baseline=c]
 % \NiceMatrixOptions
 %   {
 %     custom-line = 
 %      {
 %        letter = I , 
-%        ~emphase#tikz = { decorate, decoration = { coil, aspect = 0 } }}@ ,
-%        ~emphase#width = 2 mm@ 
+%        ~emphase#tikz = dotted@ ,
+%        ~emphase#width = \pgflinewidth@ 
 %      }
 %   }
 %
-% \begin{document}
 % \begin{NiceTabular}{cIcIc}
 % one & two & three \\
 % four & five & six \\
 % seven & eight & nine
 % \end{NiceTabular}
-% \end{document}
-% \end{Verbatim}
-%
-% \begin{center}
+% \end{BVerbatim}
+% \begin{scope}
 % \NiceMatrixOptions
 %   {
 %     custom-line = 
 %      {
 %        letter = I , 
-%        tikz = { decorate, decoration = { coil, aspect = 0 } } ,
-%        width = 2 mm 
+%        tikz = dotted ,
+%        width = \pgflinewidth
 %      }
 %   }
 % \begin{NiceTabular}{cIcIc}
@@ -1374,9 +1310,81 @@
 % four & five & six \\
 % seven & eight & nine
 % \end{NiceTabular}
-% \end{center}
+% \end{scope}
 %
+% \bigskip
+% \item \emph{Third possibility} : the key |dotted|
+% \label{dotted}
 %
+% As one can see, the dots of a dotted line of Tikz have the shape of a square,
+% and not a circle. That's why the extension \pkg{nicematrix} provides in the
+% key |custom-line| a key |dotted| which will draw rounded dots. The value of
+% the key |width| is, in this case, preset to the diameter of the dots. Those
+% dotted rules are also used by \pkg{nicematrix} to draw continuous dotted rules
+% between cells of the matrix with |\Cdots|, |\Vdots|, etc. (cf. p.~\pageref{Cdots}).
+%
+% In fact, \pkg{nicematrix} defines by default the command |\hdottedline| and the
+% letter ``|:|'' for those dotted rules.\footnote{However, it's possible to
+% overwrite those definitions with a |custom-line| (in order, for example, to
+% switch to dashed lines).}
+%
+%\smallskip
+%\begin{BVerbatim}
+% 
+% \NiceMatrixOptions % ~textsl#présent dans nicematrix.sty@
+%   { 
+%     custom-line = 
+%       { 
+%         letter = : , 
+%         command = hdottedline , 
+%         ~emphase#dotted@ 
+%       }
+%   } 
+% \end{BVerbatim}
+%
+% Thus, it's possible to use the command |\hdottedline| to draw a horizontal
+% dotted rule.
+%
+% \medskip
+% \begin{BVerbatim}[baseline=c,boxwidth=9.5cm]
+% \begin{pNiceMatrix}
+% 1 & 2 & 3 & 4 & 5 \\
+% ~emphase#\hdottedline@
+% 6 & 7 & 8 & 9 & 10 \\
+% 11 & 12 & 13 & 14 & 15 
+% \end{pNiceMatrix}
+% \end{BVerbatim}
+% $\begin{pNiceMatrix}
+% 1 & 2 & 3 & 4 & 5 \\
+% \hdottedline
+% 6 & 7 & 8 & 9 & 10 \\
+% 11 & 12 & 13 & 14 & 15 
+% \end{pNiceMatrix}$
+%
+%
+% \bigskip
+% In the environments with an explicit preamble (like |{NiceTabular}|,
+% |{NiceArray}|, etc.), it's possible to draw a vertical dotted line with the
+% specifier ``|:|''.
+% 
+% \medskip
+% \begin{BVerbatim}[baseline=c,boxwidth=9.5cm]
+% \left(\begin{NiceArray}{cccc~emphase#:@c}
+% 1 & 2 & 3 & 4 & 5 \\
+% 6 & 7 & 8 & 9 & 10 \\
+% 11 & 12 & 13 & 14 & 15 
+% \end{NiceArray}\right)
+% \end{BVerbatim}
+% $\left(\begin{NiceArray}{cccc:c}
+% 1 & 2 & 3 & 4 & 5 \\
+% 6 & 7 & 8 & 9 & 10 \\
+% 11 & 12 & 13 & 14 & 15 
+% \end{NiceArray}\right)$
+% 
+% \end{itemize}
+% 
+% 
+%
 %\section{The color of the rows and columns}
 %
 % \subsection{Use of colortbl}
@@ -2092,9 +2100,6 @@
 %
 % \label{varwidth}
 % 
-% \colorbox{yellow!50}{\textbf{New 6.3}}
-%
-% \smallskip
 % Let's recall first the behaviour of the environment |{varwidth}| of the
 % eponymous package \pkg{varwidth}. That environment is similar to the classical
 % environment |{minipage}| but the width provided in the argument is only the
@@ -3168,8 +3173,6 @@
 % \subsection{The commands \textbackslash OverBrace and \textbackslash
 % UnderBrace in the \textbackslash CodeAfter}
 %
-% \colorbox{yellow!50}{\textbf{New 6.4}}
-%
 % The commands |\OverBrace| and |\UnderBrace| provide a way to put
 % horizontal braces on a part of the array. These commands take in three
 % arguments:
@@ -3347,6 +3350,12 @@
 % the environment of \pkg{nicematrix}. Thus, it's possible to use it on the
 % title inserted by |\caption| in an environment |{table}| of LaTeX.
 %
+% \colorbox{yellow!50}{\textbf{New 6.8}}\enskip If several commands
+% |\tabularnote| are used in a tabular with the same argument, only one note is
+% inserted at the end of the tabular (but all the labels are composed, of
+% course). It's possible to control that feature with the key
+% |notes/detect-duplicates|.
+%
 % \item It's possible to create a reference to a tabular note created by |\tabularnote|
 % (with the usual command |\label| used after the |\tabularnote|).
 % \end{itemize}
@@ -3370,11 +3379,11 @@
 % Last name & First name & Length of life \\
 % \midrule
 % Churchill & Wiston &  91\\
-% Nightingale~emphase#\tabularnote{Considered as the first nurse of!
-% ~emphase#history.}\tabularnote{Nicknamed ``the Lady with the Lamp''.}!
-% & Florence & 90 \\
+% Nightingale~emphase#\tabularnote{Considered as the first nurse of history}!
+% ~emphase#\tabularnote{Nicknamed ``the Lady with the Lamp''.}!
+% & Florence~emphase#\tabularnote{This note is shared by two references.}! & 90 \\
 % Schoelcher & Victor & 89~emphase#\tabularnote{The label of the note is overlapping.}!\\
-% Touchet & Marie & 89 \\
+% Touchet & Marie~emphase#\tabularnote{This note is shared by two references.}! & 89 \\
 % Wallis & John & 87 \\
 % \bottomrule
 % \end{NiceTabular}
@@ -3397,9 +3406,9 @@
 % Churchill & Wiston &  91\\
 % Nightingale\tabularnote{Considered as the first nurse of
 % history.}\tabularnote{Nicknamed ``the Lady with the Lamp''.} 
-% & Florence & 90 \\
+% & Florence\tabularnote{This note is shared by two references.} & 90 \\
 % Schoelcher & Victor & 89\tabularnote{The label of the note is overlapping.}\\
-% Touchet & Marie & 89 \\
+% Touchet & Marie\tabularnote{This note is shared by two references.} & 89 \\
 % Wallis & John & 87 \\
 % \bottomrule
 % \end{NiceTabular}
@@ -3549,12 +3558,10 @@
 % It's also possible to add |\raggedright| or |\RaggedRight| in that key (|\RaggedRight|
 % is a command of \pkg{ragged2e}).
 %
-% \item \colorbox{yellow!50}{\textbf{New 6.8}}\enskip Since the version 6.8, the
-% duplicates in the notes of a tabular are detected by default: if several
-% commands |\tabularnote| are used in a tabular with the same argument, only one
-% note is inserted at the end of the tabular (but all the labels are composed,
-% of course). It's possible to de-activate that feature with the key
-% |notes/detect-duplicates| (whose initial value is |true|).
+% \item The key |notes/detect-duplicates| activates the detection of the commands
+% |\tabularnotes| with the same argument.
+% 
+% Initial value : |true|
 % \end{itemize}
 %
 %
@@ -11061,12 +11068,16 @@
 % by LaTeX for incorrect nested environments).
 %    \begin{macrocode}
   { 
-    \peek_meaning_ignore_spaces:NTF \end \@@_analyze_end:Nn 
+    \peek_remove_spaces:n
+      {
+        \peek_meaning:NTF \end 
+          \@@_analyze_end:Nn 
 %    \end{macrocode}
 % Here is the call to |\array| (we have a dedicated macro |\@@_array:| because
 % of compatibility with the classes \cls{revtex4-1} and \cls{revtex4-2}).
 %    \begin{macrocode}
-      { \exp_args:NV \@@_array: \g_@@_preamble_tl }
+          { \exp_args:NV \@@_array: \g_@@_preamble_tl }
+      }
   }
   { 
     \@@_create_col_nodes:
@@ -13926,6 +13937,7 @@
 %    \begin{macrocode}
 \NewDocumentCommand \@@_RowStyle:n { O { } m }
   { 
+    \tl_clear:N \l_tmpa_tl
     \keys_set:nn { NiceMatrix / RowStyle } { #1 }
 %    \end{macrocode}
 % If the key |rowcolor| has been used.
@@ -15321,9 +15333,12 @@
 %    \begin{macrocode}
 \cs_set:Npn \@@_Hline_i:n #1
   { 
-    \peek_meaning_ignore_spaces:NTF \Hline
-      { \@@_Hline_ii:nn { #1 + 1 } } 
-      { \@@_Hline_iii:n { #1 } }
+    \peek_remove_spaces:n
+       {
+        \peek_meaning:NTF \Hline
+          { \@@_Hline_ii:nn { #1 + 1 } } 
+          { \@@_Hline_iii:n { #1 } }
+       }
   }
 %    \end{macrocode}
 %

Modified: trunk/Master/texmf-dist/tex/latex/nicematrix/nicematrix.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/nicematrix/nicematrix.sty	2022-05-08 20:24:12 UTC (rev 63261)
+++ trunk/Master/texmf-dist/tex/latex/nicematrix/nicematrix.sty	2022-05-08 20:24:31 UTC (rev 63262)
@@ -18,8 +18,8 @@
 %% and version 1.3 or later is part of all distributions of
 %% LaTeX version 2005/12/01 or later.
 %% 
-\def\myfileversion{6.8}
-\def\myfiledate{2022/03/11}
+\def\myfileversion{6.8a}
+\def\myfiledate{2022/05/08}
 \RequirePackage{pgfcore}
 \usepgfmodule{shapes}
 \RequirePackage{l3keys2e}
@@ -2614,8 +2614,12 @@
   }
 \NewDocumentEnvironment { __nicematrix-normal-syntax } { }
   {
-    \peek_meaning_ignore_spaces:NTF \end \__nicematrix_analyze_end:Nn
-      { \exp_args:NV \__nicematrix_array: \g__nicematrix_preamble_tl }
+    \peek_remove_spaces:n
+      {
+        \peek_meaning:NTF \end
+          \__nicematrix_analyze_end:Nn
+          { \exp_args:NV \__nicematrix_array: \g__nicematrix_preamble_tl }
+      }
   }
   {
     \__nicematrix_create_col_nodes:
@@ -4378,6 +4382,7 @@
   }
 \NewDocumentCommand \__nicematrix_RowStyle:n { O { } m }
   {
+    \tl_clear:N \l_tmpa_tl
     \keys_set:nn { NiceMatrix / RowStyle } { #1 }
     \tl_if_empty:NF \l__nicematrix_tmpc_tl
       {
@@ -5203,9 +5208,12 @@
 \cs_set:Npn \__nicematrix_Hline: { \noalign { \ifnum 0 = `} \fi \__nicematrix_Hline_i:n { 1 } }
 \cs_set:Npn \__nicematrix_Hline_i:n #1
   {
-    \peek_meaning_ignore_spaces:NTF \Hline
-      { \__nicematrix_Hline_ii:nn { #1 + 1 } }
-      { \__nicematrix_Hline_iii:n { #1 } }
+    \peek_remove_spaces:n
+       {
+        \peek_meaning:NTF \Hline
+          { \__nicematrix_Hline_ii:nn { #1 + 1 } }
+          { \__nicematrix_Hline_iii:n { #1 } }
+       }
   }
 \cs_set:Npn \__nicematrix_Hline_ii:nn #1 #2 { \__nicematrix_Hline_i:n { #1 } }
 \cs_set:Npn \__nicematrix_Hline_iii:n #1



More information about the tex-live-commits mailing list.