summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/tablvar
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-05-02 22:49:09 +0000
committerKarl Berry <karl@freefriends.org>2019-05-02 22:49:09 +0000
commitfc9aebc5bf923b3e26bd4157f786523ff49d2cbe (patch)
tree92d3f3ded101be120864231d91589d6c9048eab1 /Master/texmf-dist/source/latex/tablvar
parent292007ab492194a65a171de46d4a29441ccf26ee (diff)
tablvar (22apr19)
git-svn-id: svn://tug.org/texlive/trunk@50949 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/tablvar')
-rw-r--r--Master/texmf-dist/source/latex/tablvar/tablvar.dtx123
-rw-r--r--Master/texmf-dist/source/latex/tablvar/tablvar.ins6
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{* *}