1 files changed, 59 insertions, 15 deletions
diff --git a/macros/latex/contrib/nicematrix/nicematrix.tex b/macros/latex/contrib/nicematrix/nicematrix.tex
index 77c4e8d9f9..b2da527927 100644
--- a/macros/latex/contrib/nicematrix/nicematrix.tex
+++ b/macros/latex/contrib/nicematrix/nicematrix.tex
@@ -1185,7 +1185,39 @@ command |\hline| and the command |\Hline| provided by \pkg{nicematrix}.
 
 The key |\Hline| takes in an optional argument (between square brackets) which
 is a list of \textsl{key=value} pairs. For the description of those keys, see
-|custom-line| on p.~\pageref{custom-line}.
+|custom-line| on p.~\pageref{custom-line}.\footnote{Technical remark: If the
+  user wants to write a command over the command |\Hline|, it shall be ensured
+  that this new command is expandable in the TeX sens (by using, for instance,
+  |\NewExpandableDocumentCommand| of LaTeX3, |\newcommand| of LaTeX or |\def| of
+  TeX). Example: |\newcommand{\RedLine}{\Hline[color=red]}|}
+
+
+\bigskip
+\colorbox{yellow!50}{\textbf{New 6.23}}\enskip 
+
+As well as the command |\Hline|, the specifier ``\verb+|+'' supports a optional
+argument between square brackets for the characteristics of the rule.
+
+\medskip
+\begin{BVerbatim}[baseline=c,boxwidth=10cm]
+\begin{NiceTabular}{|c~emphase#|[color=blue]@c|}
+\Hline
+a & b \\
+~emphase#\Hline[color=red]@
+c & d \\
+\Hline
+\end{NiceTabular}
+\end{BVerbatim}
+%
+\begin{NiceTabular}{|c|[color=blue]c|}
+\Hline
+a & b \\
+\Hline[color=red]
+c & d \\
+\Hline
+\end{NiceTabular}
+
+
 
 \subsubsection{The keys hlines and vlines}
 
@@ -1637,7 +1669,7 @@ $\left(\begin{NiceArray}{cccc:c}
 \index{Rules@\textbf{Rules in the tabulars}|)}
 
 
-\section{The color of the rows and columns}
+\section{The color of the background of the rows and columns}
 
 \index{Colour!of the cells}
 
@@ -2992,6 +3024,10 @@ x & \Ldots & &  &  & x
 The option |nullify-dots| smashes the instructions |\Ldots| (and the variants)
 horizontally but also vertically.
 
+\medskip
+Caution : the key |nullify-dots| has a name that may be confusing; that key does
+not imply that the dotted rules won't be drawn!
+
 
 
 \subsection{The commands \textbackslash Hdotsfor and \textbackslash Vdotsfor}
@@ -3049,7 +3085,9 @@ Remark: Unlike the command |\hdotsfor| of \pkg{amsmath}, the command
 |\Hdotsfor| may be used even when the package \pkg{colortbl}\footnote{We
 recall that when \pkg{xcolor} is loaded with the option |table|, the
 package \pkg{colortbl} is loaded.} is loaded (but you might have problem if
-you use |\rowcolor| on the same row as |\Hdotsfor|). 
+you use |\rowcolor| on the same row as |\Hdotsfor|). However, when using
+\pkg{nicematrix}, it's recommended to use the coloring tools provided by
+\pkg{nicematrix} instead of \pkg{colortbl}.
 
 \bigskip
 The package \pkg{nicematrix} also provides a command |\Vdotsfor| similar to
@@ -4102,9 +4140,8 @@ same argument in the caption of the tabular.}
 \item It's possible to create a reference to a tabular note created by |\tabularnote|
 (with the usual command |\label| used after the |\tabularnote|).
 
-\item \colorbox{yellow!50}{\textbf{New 6.19}} The command |\tabularnote| has an
-optional argument (between square brackets) to change the symbol of the
-reference of the note.
+\item The command |\tabularnote| has an optional argument (between square
+brackets) to change the symbol of the reference of the note.
 
 \emph{Example}: |\tabularnote[$\star$]{A footnote...}|
 \end{itemize}
@@ -5746,10 +5783,12 @@ may be wrong in some circonstances.
 
 \bigskip
 The package \pkg{nicematrix} is not fully compatible with the package
-\pkg{arydshln} (because this package redefines many internals of \pkg{array}).
-By any means, in the context of \pkg{nicematrix}, it's recommended to draw
-dashed rules with the tools provided by \pkg{nicematrix}, by creating a
-customized line style with |custom-line|: cf.~p.~\pageref{custom-line}.
+\pkg{arydshln} (because this package redefines many internals of \pkg{array})
+and does support the columns~|V| of \pkg{boldline} (because the letter |V| is
+reserved for the columns~|V| of \pkg{varwidth}). By any means, \pkg{nicematrix}
+provides, with the key |custom-line| (cf. part~\ref{custom-line},
+p.~\pageref{custom-line}), tools to draw dashed rules and rules of different
+widths. 
 
 \bigskip
 The columns |d| of \pkg{dcolumn} are not supported (but it's possible to use
@@ -6116,8 +6155,7 @@ not longer dotted (TikZ should be loaded).
 1& & & \Vdots & & & & \Vdots \\
 & \Ddots[line-style=standard] \\
 & & 1 \\
-\Cdots[color=blue,line-style=dashed]&   &  & \blue 0 &
-\Cdots & & & \blue 1 & & & \Cdots & \blue \leftarrow i \\
+\Cdots & & & \blue 0 & \Cdots & & & \blue 1 & & & \Cdots & \blue \leftarrow i \\
 & & & & 1 \\
 & & &\Vdots & & \Ddots[line-style=standard] & & \Vdots \\
 & & & & & & 1 \\
@@ -6141,8 +6179,7 @@ not longer dotted (TikZ should be loaded).
 1& & & \Vdots & & & & \Vdots \\
 & \Ddots[line-style=standard] \\
 & & 1 \\
-\Cdots[color=blue,line-style=dashed]&   &  & \blue 0 &
-\Cdots & & & \blue 1 & & & \Cdots & \blue \leftarrow i \\
+\Cdots & & & \blue 0 & \Cdots & & & \blue 1 & & & \Cdots & \blue \leftarrow i \\
 & & & & 1 \\
 & & &\Vdots & & \Ddots[line-style=standard] & & \Vdots \\
 & & & & & & 1 \\
@@ -6188,7 +6225,7 @@ $\begin{pNiceArray}{ccc|cc}[first-row,last-col,margin]
 
 \interitem
 \label{ex:colon}
-If you want the lable \emph{on the line}, you should use the special token~``|:|'':
+If you want the label \emph{on the line}, you should use the special token~``|:|'':
 
 \begin{Verbatim}
 \NiceMatrixOptions{xdots={horizontal-labels,line-style = <->}}
@@ -6924,6 +6961,13 @@ The successive versions of the file |nicematrix.sty| provided by TeXLive are ava
 \nolinkurl{https:www.tug.org/svn/texlive/trunk/Master/texmf-dist/tex/latex/nicematrix/nicematrix.sty}
 }
 
+\subsection*{Changes between version 6.22 and 6.23}
+
+The specifier ``\verb+|+'' in the preambles of the environments has now an
+optional argument.
+
+Correction of several bugs.
+
 \subsection*{Changes between version 6.21 and 6.22}
 
 Key |opacity| for the command |\Block|.