piton (8oct22)

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

4 files changed, 29 insertions, 10 deletions

diff --git a/Master/texmf-dist/doc/lualatex/piton/README.md b/Master/texmf-dist/doc/lualatex/piton/README.md
index c9ad487bcc2..3dd557ecaa5 100644
--- a/Master/texmf-dist/doc/lualatex/piton/README.md
+++ b/Master/texmf-dist/doc/lualatex/piton/README.md
@@ -15,6 +15,7 @@ The LaTeX package `piton` provides a command `\piton` and an environment `{Piton
 
 ## Installation
 
+The package `piton` is present in the distributions MiKTeX, TeXLive and MacTeX.
 
 For a manual installation:
 
@@ -23,4 +24,7 @@ For a manual installation:
 
 The file `piton.sty` will be generated.
 
-The file `piton.sty` is *not* the only file necessary to use the extension `piton`. The file `piton.lua` is also required. You have to put both in the same directory as your document or (best) in a `texmf` tree.  
+The file `nicematrix.sty` is the only file necessary to use the extension `nicematrix`. 
+You have to put it in the same directory as your document or (best) in a `texmf` tree. 
+
+
diff --git a/Master/texmf-dist/doc/lualatex/piton/piton-french.pdf b/Master/texmf-dist/doc/lualatex/piton/piton-french.pdf
index 5356daa6789..fe034629eeb 100644
--- a/Master/texmf-dist/doc/lualatex/piton/piton-french.pdf
+++ b/Master/texmf-dist/doc/lualatex/piton/piton-french.pdf
diff --git a/Master/texmf-dist/doc/lualatex/piton/piton-french.tex b/Master/texmf-dist/doc/lualatex/piton/piton-french.tex
index 3e70890e234..1b9854cb154 100644
--- a/Master/texmf-dist/doc/lualatex/piton/piton-french.tex
+++ b/Master/texmf-dist/doc/lualatex/piton/piton-french.tex
@@ -111,12 +111,11 @@ def arctan(x,n=10):
 \end{Piton}
 
 
+\bigskip
 
-\section{Installation}
-
-L'extension \pkg{piton} est composée de deux fichiers : |piton.sty| et |piton.lua| (le fichier LaTeX |piton.sty|
-chargé par |\usepackage| va à son tour charger le fichier |piton.lua|). Les deux fichiers doivent être présents
-dans un répertoire où LaTeX pourra les trouver. Le mieux est de les installer dans une arborescence |texmf|.
+L'extension LaTeX \pkg{piton} est entièrement contenue dans le fichier |piton.sty|. Ce
+fichier peut être placé dans le répertoire courant ou dans une arborescence |texmf|. Le mieux reste néanmoins
+d'installer \pkg{piton} avec une distribution TeX comme MiKTeX, TeX~Live ou MacTeX.
 
 
 \section{Utilisation de l'extension}
@@ -148,7 +147,8 @@ caractères |##| eux-mêmes ne seront pas imprimés et les espaces qui les suive
 
 \subsection{La commande \textbackslash PitonOptions}
 
-La commande |\PitonOptions| propose cinq clés : |gobble|, |auto-gobble|, |env-gobble|, |line-numbers| et |all-line-numbers|.
+La commande |\PitonOptions| prend en argument une liste de couples \textsl{clé=valeur}. La portée des réglages
+effectués par cette commande est le groupe TeX courant. 
 
 \begin{itemize}
 \item La clé |gobble| peut comme valeur un entier positif $n$ : les $n$ premiers caractères de chaque ligne sont
@@ -158,13 +158,28 @@ alors retirés (avant formatage du code) dans les environnements |{Piton}|.
 d'espaces successifs débutant chaque ligne (non vide) de l'environnment |{Piton}| et applique |gobble| avec cette
 valeur de~$n$.
 
-* Quand la clé |env-gobble| est activée, \pkg{piton} applique la clé |gobble| avec une valeur de $n$ égale au
+\item Quand la clé |env-gobble| est activée, \pkg{piton} applique la clé |gobble| avec une valeur de $n$ égale au
 nombre d'espaces sur la ligne précédant le |\end{Piton}| (si cette ligne ne comporte que des espaces).
 
 \item Avec la clé |line-numbers|, les lignes \emph{non vides} sont numérotées dans les environnements \verb|{Piton}|
 et dans les listings produits par la commande |\PitonInputFile|.
 
 \item Avec la clé |all-line-numbers|, \emph{toutes} les lignes sont numérotées, y compris les lignes vides.
+
+\item \colorbox{yellow!50}{\textbf{Nouveau 0.7}}\enskip Avec la clé |resume|, le compteur de lignes n'est pas remis à 
+zéro comme il l'est normalement au début d'un environnement |{Piton}| ou bien au début d'un listing produit par 
+|\PitonInputFile|.
+
+\item \colorbox{yellow!50}{\textbf{Nouveau 0.7}}\enskip La clé |splittable| autorise un saut de page 
+dans les environnements |{Piton}| et les listings produits par |\PitonInputFile|.
+
+\item \colorbox{yellow!50}{\textbf{Nouveau 0.7}}\enskip La clé |background-color| fixe la couleur de fond des
+environnements |{Piton}| et des listings produits par |\PitonInputFile| (ce fond a une largeur égale à la valeur
+courante de |\linewidth|). Même avec une couleur de fond, les sauts de page sont possibles, à partir du moment où
+la clé |splittable| est utilisée.\footnote{Un environnement |{Piton}| est sécable même dans un environnement de
+  \pkg{tcolorbox}, à patir du moment où la clé |breakable| de \pkg{tcolorbox} est utilisée. On précise cela parce
+  que, en revanche, un environnement de \pkg{tcolorbox} inclus dans un autre environnement de \pkg{tcolorbox} n'est
+  pas sécable, même quand les deux utilisent la clé |breakable|.}
 \end{itemize}
 
 \bigskip
@@ -172,7 +187,7 @@ et dans les listings produits par la commande |\PitonInputFile|.
 \begingroup
 \fvset{commandchars=\~\&\@,formatcom=\small\color{gray}}
 \begin{Verbatim}
-~emphase&\PitonOptions{line-numbers,auto-gobble}@
+~emphase&\PitonOptions{line-numbers,auto-gobble,background-color = gray!15}@
 \begin{Piton}
     from math import pi
 
@@ -194,7 +209,7 @@ et dans les listings produits par la commande |\PitonInputFile|.
 \endgroup
 
 \begingroup
-\PitonOptions{line-numbers,auto-gobble}
+\PitonOptions{line-numbers,auto-gobble,background-color = gray!15}
 \begin{Piton}
     from math import pi
 
diff --git a/Master/texmf-dist/doc/lualatex/piton/piton.pdf b/Master/texmf-dist/doc/lualatex/piton/piton.pdf
index 924373fc93d..13e8b7f7296 100644
--- a/Master/texmf-dist/doc/lualatex/piton/piton.pdf
+++ b/Master/texmf-dist/doc/lualatex/piton/piton.pdf