tablvar (22apr19)

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

2 files changed, 73 insertions, 56 deletions

diff --git a/Master/texmf-dist/source/latex/tablvar/tablvar.dtx b/Master/texmf-dist/source/latex/tablvar/tablvar.dtx
index 9db531147bb..ae376f286c2 100644
--- a/Master/texmf-dist/source/latex/tablvar/tablvar.dtx
+++ b/Master/texmf-dist/source/latex/tablvar/tablvar.dtx
@@ -6,6 +6,7 @@
 % Version 0.3 : 07/12/2014 ajouté environnement tablvar*
 % Version 1.0 : 11/11/2018 macro \bblim, modif macros \barre et \ZIh, 
 %    création des fichiers dtx et ins
+% Version 1.1 : 12/04/2019 reprise README.md, \tvloop -> \varloop
 %
 % This file may be distributed and/or modified under the conditions of
 % the LaTeX Project Public License, either version 1.3 of this license
@@ -27,16 +28,18 @@
 %<*package> 
 \NeedsTeXFormat{LaTeX2e}[2005/12/01]
 \ProvidesPackage{tablvar}   
-    [11/11/2018 v1.0 .dtx tablvar file]
+    [22/04/2019 v1.1 .dtx tablvar file]
 %</package>
 %<*driver>
 \documentclass{ltxdoc}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
-\usepackage[frenchb]{babel}
+\usepackage[french]{babel}
 \usepackage{lmodern}
-\usepackage{tablvar}[11/11/2018]
-\newcommand{\dfrac}{\displaystyle\frac}
+\usepackage{tablvar}
+\usepackage[Symbol]{upgreek}
+\renewcommand\pi{\uppi}
+\newcommand*\dfrac[2]{{\displaystyle\frac{#1}{#2}}}
 \DisableCrossrefs         
 %\CodelineIndex
 %\RecordChanges
@@ -56,7 +59,7 @@
 %</driver>
 % \fi
 %
-% \CheckSum{2847}
+% \CheckSum{2897}
 %
 % \CharacterTable
 %  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -96,7 +99,7 @@
 % \title{L'extension \textsf{tablvar}\thanks{Ce document
 %     correspond à \textsf{tablvar}~\fileversion, dernière modification le \filedate.}}
 % \author{Antoine Missier \\ \texttt{prenom.nom@ac-toulouse.fr}}
-% \date{11 novembre 2018}
+% \date{22 avril 2019}
 % \maketitle
 % \tableofcontents
 %
@@ -104,19 +107,23 @@
 %
 % Cette extension permet de construire des tableaux de variation (et de signes)
 % de manière simple et intuitive.
-% Bien que plusieurs autres extensions soient déjà dédiées à cette tâche, 
+% Bien que plusieurs autres extensions soient déjà dédiées à cette tâche
+% \footnote{Mentionnons \textsf{tabvar} de Daniel Flipo et 
+% \textsf{variations} de Christian Obrecht ou, plus complexes, 
+% \textsf{tablor} de Guillaume Connan et \textsf{tkz-tab} de Alain Matthes.}, 
 % nous avons voulu produire des tableaux de manière automatisée, 
 % y compris pour des tableaux complexes,  
 % mais avec de nombreuses possibilités de réglages et d'ajustements personnels
 % et une haute qualité graphique, en particulier pour le dessin des flèches,
-% en exploitant les fonctionnalités des extensions graphiques pstricks 
-% (plus exactement pst-node) ou tikz pour 
+% en exploitant les fonctionnalités des extensions graphiques \textsf{pstricks} 
+% (plus exactement \textsf{pst-node}) ou \textsf{tikz} pour 
 % définir un \emph{graphe} de \emph{nœuds} reliés par des flèches,
 % venant se \og superposer \fg{} au tableau lui-même.
 %
 % Le parti pris ici est d'utiliser la même syntaxe que les environnements 
 % |array| (ou |tabular|) en laissant à \LaTeX\ le soin de faire 
-% la composition du tableau et à l'extension graphique (pstricks ou tikz) celui
+% la composition du tableau et à l'extension graphique
+% (\textsf{pstricks} ou \textsf{tikz}) celui
 % de réaliser le dessin des flèches, automatisé et sans intervention de l'utilisateur.
 % On a simplement besoin de préciser, à l'intérieur d'une commande |\variations|,
 % ce qui est en haut et ce qui est en bas.
@@ -143,7 +150,7 @@
 % \DescribeMacro{\haut} \DescribeMacro{\bas} \DescribeMacro{\mil}
 % de positionnement naïves |\haut|, |\bas| et |\mil| (milieu).
 %
-%\[
+%\[ 
 %\begin{tablvar}{4}
 %    \hline
 %    x & -5 && -1 && 2 && 3 && 5 \\
@@ -171,7 +178,7 @@
 % \end{verbatim}
 %
 % \vspace{-3ex}
-%% \DescribeEnv{tablvar}
+% \DescribeEnv{tablvar}
 % L'argument obligatoire de l'environnement |tablvar| correspond au nombre 
 % d'intervalles du tableau c'est-à-dire aussi au nombre de flèches (ici 4).
 % Les délimiteurs |&| correspondent aux changements de colonnes 
@@ -194,13 +201,14 @@
 %    \hline
 %    x & -5 && +\infty \\
 %    \hline
-%    \variations{\mil{f(x)} & \haut{2} && \bas{-1}}
+%    \variations{\mil{f(x)} & \haut{2} && 
+%        \bas{-1} }
 %    \hline
 %\end{tablvar}
 %\]
 % \end{verbatim}
 % \end{minipage}
-% \begin{minipage}[t]{5cm}
+% \begin{minipage}[t]{4.7cm}
 %\[
 %\begin{tablvar}[4em]{1}
 %    \hline
@@ -251,7 +259,7 @@
 % \end{verbatim}
 % \end{minipage}
 % \begin{minipage}[t]{5.2cm}
-%\[
+%\[ 
 %\begin{tablvar}{2}
 %    \hline
 %    x & 0 & & \frac12 & & 1 \\
@@ -300,7 +308,7 @@
 %
 % \DescribeMacro{\fleche}
 % On peut modifier l'aspect des flèches en redéfinissant la macro |\fleche|
-% grâce aux nombreuses options offertes par pstricks ou tikz. 
+% grâce aux nombreuses options offertes par \textsf{pstricks} ou \textsf{tikz}. 
 % Cette redéfinition sera locale si on la place dans l'environnement math du tableau.
 % Ci-dessous des flèches plus fines, plus proches des nœuds et dont la pointe est
 % plus effilée (codé ici pour pstricks uniquement).
@@ -387,7 +395,8 @@
 % \subsection{Doubles barres et discontinuités}
 %
 % Une double barre s'obtient avec la commande |\bb|. \DescribeMacro{\bb}
-% Pour ne pas tracer de flèche entre deux nœuds, on place la
+% Pour ne pas tracer de flèche entre deux nœuds (en particulier pour éviter
+% de traverser une double barre), on place la
 % commande |\discont| entre les deux. \DescribeMacro{\discont}
 %\[
 %\begin{tablvar}{2}
@@ -402,8 +411,10 @@
 %    \hline
 %\end{tablvar}
 %\]
-% La commande |\dfrac| provient de l'extension amsmath (ou sinon on l'obtient
-% avec |\newcommand{\dfrac}{\displaystyle\frac}|).
+% La commande |\dfrac| provient de l'extension \textsf{amsmath} ou peut être redéfinie
+% par |\newcommand*\dfrac[2]{{\displaystyle\frac{#1}{#2}}}|.
+%
+% \smallskip
 % \begin{verbatim}
 %\begin{tablvar}{2}
 %    \hline
@@ -418,7 +429,7 @@
 %\end{tablvar}
 % \end{verbatim}
 %
-% \vspace{-2ex}
+% \vspace{-1ex}
 % La syntaxe ci-dessus pose problème lorsque les limites à gauche et à droite 
 % d'une valeur interdite se trouvent sur des lignes différentes,
 % ou que leur contenu n'a pas la même largeur, 
@@ -687,7 +698,8 @@
 % \DescribeMacro{\tablvarstretch}
 % À cause des 4 lignes de variations, la hauteur de lignes du tableau 
 % a été réduite en modifiant le facteur
-% |\tablvarstretch| (fixé à 1.2 par défaut), modification locale car placée à l'intérieur de l'environnement math.\\
+% |\tablvarstretch| (fixé à 1.2 par défaut), modification locale 
+% car placée à l'intérieur de l'environnement math.\\
 % \DescribeMacro{\vdecal}
 % Enfin  la légende $\exp x$ a été placée en ligne 2 mais 
 % décalée vers le bas, pour qu'elle se trouve centrée verticalement
@@ -738,7 +750,7 @@
 % particulières, voir l'exemple ci-dessous avec la fonction définie par
 %\[ 
 %f(x)=\left\{
-%\begin{array}{cl}
+%\begin{array}{@{}cl}
 %    \frac{\sin x}{x} &\mbox{si } x \neq 0 \\[1ex]
 %    0 &\mbox{si } x= 0
 %\end{array}
@@ -809,7 +821,7 @@
 % \DescribeMacro{\noeud} \DescribeMacro{\vrconnect}
 % Par contre, pour traiter ici les valeurs remarquables avec des pointillés, 
 % la commande |\vr| ne permet pas connecter les valeurs sur $x$ avec celles du sinus dans
-% le 2ème tableau, mais on peut le faire \og à la main\fg{} 
+% le 2\ieme\ tableau, mais on peut le faire \og à la main\fg{} 
 % en appelant les macros |\noeud| et |\vrconnect|.
 %\[
 %\begin{tablvar}{4}
@@ -879,7 +891,7 @@
 % Pour cela on les place dans une |\zbox|.
 % La commande \cmd{\zbox}\oarg{pos}\marg{contenu} 
 % affiche son contenu mais considère la largeur comme nulle.
-% Le 1er paramètre (optionnel) est le positionnement dans la boite : 
+% Le 1\ier\ paramètre (optionnel) est le positionnement dans la boite : 
 % |c| (par défaut), |l| (left) ou |r| (right).
 % Ici |zbox| est aussi nécessaire pour annuler la largeur des
 % boites contenant les $+\infty$ sinon la double barre ne serait
@@ -1113,6 +1125,7 @@
 %    \hline
 %\end{tablvar}
 %\]
+% \smallskip
 % \begin{verbatim}
 %\begin{tablvar}{4}
 %    \hline
@@ -1223,7 +1236,7 @@
 %    \end{macrocode}
 
 % \subsection{Les paramètres généraux}
-
+%
 % Dans cette section sont présentés tous les paramètres
 % que l'on peut redéfinir pour modifier l'aspect des tableaux,
 % mais qui n'ont en principe pas besoin d'être touchés.
@@ -1295,13 +1308,13 @@
 %    \end{macrocode}
 % \end{macro}
 
-% \subsection{Les commandes graphiques pstricks/tikz}
-
+% \subsection{Les commandes graphiques \textsf{pstricks/tikz}}
+%
 % Nous présentons ici les commandes graphiques permettant le dessin 
 % des flèches,
 % les pointillés des valeurs remarquables, les hachures des zones interdites.
 % Celles-ci sont définies différemment s'il s'agit de l'option |tikz| ou |pstricks|
-% (plus précisément liées à l'extension pst-node).
+% (plus précisément liées à l'extension \textsf{pst-node}).
 %
 % \begin{macro}{\fleche}
 % La commande \cmd{\fleche}\marg{noeud1}\marg{noeud2} possède deux paramètres
@@ -1342,12 +1355,12 @@
 % \begin{macro}{\noeud}
 % \cmd{\noeud}\oarg{pos}\marg{noeud}\marg{valeur}
 % définit les nœuds des flèches et valeurs remarquables ; 
-% le 1er paramètre optionnel correspond à l'option |t| (top), 
+% le 1\ier\ paramètre optionnel correspond à l'option |t| (top), 
 % |b| (bottom) ou |c| (centered, par défaut) permettant d'ajuster
 % la manière dont la flèche arrive sur le nœud (sans effet pour |tikz|) ;
-% le 2ème paramètre est le nom du nœud (qui est donné automatiquement 
+% le 2\ieme\ paramètre est le nom du nœud (qui est donné automatiquement 
 % par les commandes de positionnement) ;
-% le 3ème paramètre est la valeur affichée dans le tableau.
+% le 3\ieme\ paramètre est la valeur affichée dans le tableau.
 %    \begin{macrocode}
 \newcommand*{\noeud}[3][c]{
     \ifthenelse{\boolean{tikz}}{
@@ -1381,7 +1394,7 @@
 % \end{macro}
 
 % \subsection{Longueurs et compteurs internes}
-
+%
 %   \begin{macrocode}
 \newcounter{ligne} % numéro de ligne
 \newcounter{noeud} % numéro du nœud
@@ -1414,8 +1427,8 @@
 
 % \bigskip
 % \subsection{Les environnements \texttt{tablvar} et \texttt{tablvar*}}
-
-% Grâce à l'extension |array| nous pouvons définir un nouveau type de colonnes 
+%
+% Grâce à l'extension \textsf{array} nous pouvons définir un nouveau type de colonnes 
 % pour les intervalles : |i|.
 %    \begin{macrocode}
 \newcolumntype{i}[1]{>{\centering\arraybackslash $}p{#1}<{$}}
@@ -1423,12 +1436,15 @@
 %    \end{macrocode}
 
 % \begin{macro}{\tablvarinit}
+% \changes{v1.1}{13/04/2019}{ajouté \bslash extrarowheight}
 % Cette commande d'initialisation des compteurs est appelée
 % au début de chaque environnement |tablvar| ou |tablvar*|.
+% Les redéfinitions de |\extrarowheight| et |\arraystretch| seront locales 
+% dans l'environnement |tablvar|.
 %    \begin{macrocode}
 \newcommand{\tablvarinit}{
+    \setlength{\extrarowheight}{0pt} % paramètre de l'extension array
     \renewcommand{\arraystretch}{\tablvarstretch} 
-    % la redéfinition de \arraystretch sera locale dans tablvar
     \setcounter{ligne}{0}
     \setcounter{numvr}{0}
 }
@@ -1455,9 +1471,9 @@
 
 % \begin{environment}{tablvar}
 % L'environnement |tablvar| : |\begin{tablvar}|\oarg{width}\marg{nbintervals}.
-% Le 1er paramètre (optionnel) permet de régler la largeur des colonnes 
+% Le 1\ier\ paramètre (optionnel) permet de régler la largeur des colonnes 
 % intervalles (définie par |\intervalwidth|
-% par défaut), le 2ème paramètre (obligatoire) est le nombre d'intervalles.
+% par défaut), le 2\ieme\ paramètre (obligatoire) est le nombre d'intervalles.
 % Cet environnement n'est rien d'autre qu'un |array| dans lequel on a réglé
 % les options de colonages.
 % Les colonnes de valeurs sont de type |c| et les colonnes d'intervalles de type |i|.
@@ -1504,23 +1520,24 @@
 % \end{environment}
 
 % \subsection{La commande \texttt{\textbackslash variations}}
-
+%
 % C'est ici qu'est la magie !
 % 
-% \begin{macro}{\tvloop}
-% La commande \cmd{\tvloop}\marg{iter}\marg{code} répète \meta{code} (\meta{iter}$- 1$) fois
+% \begin{macro}{\varloop}
+% \changes{v1.1}{12/04/2019}{tvloop -> varloop}
+% La commande \cmd{\varloop}\marg{iter}\marg{code} répète \meta{code} (\meta{iter}$- 1$) fois
 % (car la dernière ligne de variations doit subir un traitement particulier).
-% C'est une variante de |\multido| (du package |multido|) car
+% Nous avons créé une variante de |\multido| (du package \textsf{multido}) car
 % |\multido|, |\Multido| ou |\whiledo| plantent sur |\\| ou |\@arraycr|
 % et la commande |\variations| a besoin d'utiliser une boucle dans un tableau.
-% |\tvloop| n'est autre qu'un |\ifthenelse| récursif.
+% |\varloop| n'est autre qu'un |\ifthenelse| récursif.
 %    \begin{macrocode}
 \newcounter{loop@counter}    
-\newcommand{\tvloop}[2]{%
+\newcommand{\varloop}[2]{%
     \setcounter{loop@counter}{#1}
     \addtocounter{loop@counter}{-1}% on boucle 1 fois de moins que #1
     \ifthenelse{\value{loop@counter}=0}{}{%
-        #2 \tvloop{\value{loop@counter}}{#2}%
+        #2 \varloop{\value{loop@counter}}{#2}%
     }
 }
 %    \end{macrocode}
@@ -1534,7 +1551,7 @@
 % Le principe est que l'on parcourt 3 fois (par défaut) le contenu de |\variations| ;
 % à chaque itération, le compteur |ligne| est incrémenté, 
 % le compteur |noeud| est remis à 0 puis incrémenté à chaque commande |\pos|,
-% mais le contenu de |\pos| n'est affiché et le nœud n'est créé 
+% mais le contenu de |\pos| n'est affiché et le nœud n'est effectivement créé 
 % que si la valeur du compteur |ligne| correspond à l'argument de ligne de |\pos|.\\
 % Les flèches et pointillés sont dessinés à la fin, quand tous les nœuds sont créés,
 % mais il faut les tracer avant le |\\| final, sinon la compilation plante !?
@@ -1546,7 +1563,7 @@
     \multido{\I=1+1}{\themaxdiscont}{\setcounter{discont\I}{0}}
     \setcounter{ZIvarlignes}{#1} % nécessaire pour \ZIh
     % boucle : on exécute le code #2 un nb de fois égal à (#1)-1
-    \tvloop{#1}{%
+    \varloop{#1}{%
         \setcounter{noeud}{0}\setcounter{numvr}{0}\setcounter{ZI}{0}
         % à chaque boucle on réinitialise certains compteurs
         \stepcounter{ligne} % le numéro de ligne est incrémenté
@@ -1575,7 +1592,7 @@
 % \end{macro}
 
 % \subsection{Les commandes de positionnement}
-
+%
 % \begin{macro}{\pos}
 % \cmd{\pos}\oarg{opt}\marg{ligne}\marg{valeur} 
 % sert à positionner les valeurs dans la partie variations.
@@ -1583,7 +1600,7 @@
 % (numéroté avec le compteur |noeud| et défini en appelant la commande |\noeud|).
 % Les lignes de variations sont numérotées \emph{du haut vers le bas} 
 % (et les lignes de signes portent toutes le numéro 0).
-% Le 1er argument optionnel, |c| (centered, par défaut), |t| (top) ou |b| (bottom),
+% Le 1\ier\ argument optionnel, |c| (centered, par défaut), |t| (top) ou |b| (bottom),
 % est utilisé pour le positionnement des flèches.\\
 % \DescribeMacro{\pos*}
 % Dans la version étoilée, \cmd{\pos*}\marg{ligne}\marg{valeur}, la différence 
@@ -1631,14 +1648,14 @@
 % mais considère que l'espace occupé est nul pour le calcul des largeurs de colonne.
 % Sa syntaxe est :
 % |\zbox|\oarg{pos}\marg{contenu} où \meta{opt} = |c| (par défaut), |l| (left) ou |r| (right).
-%
 %    \begin{macrocode}
 \newcommand*{\zbox}[2][c]{\makebox[0pt][#1]{$#2$}}
 %    \end{macrocode}
 % \end{macro}
 
 % \begin{macro}{\vdecal}
-% Décalage vertical : \cmd{\vdecal}\marg{decal}\marg{contenu}, le 1er paramètre est le décalage 
+% Décalage vertical : \cmd{\vdecal}\marg{decal}\marg{contenu}, 
+% le 1\ier\ paramètre est le décalage 
 % (positif = vers le haut ou négatif = vers le bas), le second est le contenu à placer.
 %    \begin{macrocode}
 \newcommand*{\vdecal}[2]{\smash{\raisebox{#1}{$#2$}}}
@@ -1648,10 +1665,10 @@
 % \end{macro}
 
 % \subsection{Barres, discontinuités et valeurs remarquables}
-
+%
 % \begin{macro}{\bb}
 % La macro |\bb|, qui produit une double barre,
-% provient de l'extension |variations| de Christian Obrecht
+% provient de l'extension \textsf{variations} de Christian Obrecht
 % |\def\bb{\vrule\kern1pt\vrule}|.
 % Nous avons ajouté 1~pt d'espace avant et après, afin d'éviter le contact
 % entre la double barre et les limites à gauche ou à droite.
@@ -1743,7 +1760,7 @@
 % \end{macro}
 
 % \subsection{Zones interdites}
-
+%
 % \begin{macro}{\ZIc}
 % Commande sans argument qui produit une zone interdite colorée.
 % À placer dans les intervalles voulus. La densité de gris ou la couleur 
diff --git a/Master/texmf-dist/source/latex/tablvar/tablvar.ins b/Master/texmf-dist/source/latex/tablvar/tablvar.ins
index 5ed9d653153..bba566c9ca6 100644
--- a/Master/texmf-dist/source/latex/tablvar/tablvar.ins
+++ b/Master/texmf-dist/source/latex/tablvar/tablvar.ins
@@ -43,10 +43,10 @@ and version 1.3 or later is part of all distributions of LaTeX version
 \Msg{* To finish the installation you have to move the following *}
 \Msg{* file into a directory searched by TeX:                    *}
 \Msg{*                                                           *}
-\Msg{*     tablvar.sty                                          *}
+\Msg{*     tablvar.sty                                           *}
 \Msg{*                                                           *}
-\Msg{* To produce the documentation run the file tablvar.dtx    *}
-\Msg{* through LaTeX.                                            *}
+\Msg{* To produce the documentation run the file tablvar.dtx     *}
+\Msg{* through LaTeX + dvips + ps2pdf.                           *}
 \Msg{*                                                           *}
 \Msg{* Happy TeXing!                                             *}
 \Msg{*                                                           *}