tabvar (10mar11)

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

1 files changed, 112 insertions, 68 deletions

diff --git a/Master/texmf-dist/source/latex/tabvar/tabvar.dtx b/Master/texmf-dist/source/latex/tabvar/tabvar.dtx
index 6bf971c3c70..920424b22fa 100644
--- a/Master/texmf-dist/source/latex/tabvar/tabvar.dtx
+++ b/Master/texmf-dist/source/latex/tabvar/tabvar.dtx
@@ -1,9 +1,9 @@
-% \CheckSum{501}
+% \CheckSum{556}
 %
 % \iffalse meta-comment
 % Files `tabvar.dtx', `tabvar.ins' and `tabvar.mp'
 %
-% Copyright (C) Daniel Flipo 2003-2010 <daniel.flipo at free.fr>
+% Copyright (C) Daniel Flipo 2003-2011 <daniel.flipo at free.fr>
 %
 % All the files included in the `tabvar' distribution, including
 % the font, may be distributed and/or modified under the conditions
@@ -25,7 +25,7 @@
 %
 %<*sty>
 %%
-%% Copyright (C) Daniel Flipo 2003-2010 <daniel.flipo at free.fr>
+%% Copyright (C) Daniel Flipo 2003-2011 <daniel.flipo at free.fr>
 %%
 \NeedsTeXFormat{LaTeX2e}[1997/06/01]
 \ProvidesFile{tabvar.sty}
@@ -34,7 +34,7 @@
 \ProvidesFile{tabvar.dtx}
 %</dtx>
 %<*!cfg>
-             [2010/08/22 v1.4 (Daniel Flipo)]
+             [2011/03/10 v1.5 (Daniel Flipo)]
 %</!cfg>
 %
 %<*driver>
@@ -73,20 +73,31 @@
 %    Elle s'appuie sur les extensions \file{array}, \file{colortbl},
 %    et \file{varwidth}. Les fl\`eches sont prises dans une fonte
 %    (type\,1) sp\'ecialement cr\'e\'ee par Michel~\bsc{Bovani}.
+%    Depuis la version~1.5, quatre variantes de fl\`eches sont
+%    propos\'ees.
 %    Un grand merci \`a Michel pour cette contribution et pour
 %    ses remarques qui m'ont \'et\'e tr\`es utiles pour
 %    am\'eliorer les versions pr\'eliminaires.
 %
-%    Une autre possibilit\'e est de faire appel, pour les fl\`eches,
+%    Une autre possibilit\'e (conserv\'ee uniquement pour pr\'eserver
+%    la compatibilit\'e avec les premi\`eres versions de \file{tabvar})
+%    consiste \`a faire appel, pour le dessin des fl\`eches, 
 %    \`a MetaPost : le fichier \file{tabvar.mp} permet de cr\'eer les
 %    trois fl\`eches \file{tabvar.1}, \file{tabvar.2}, \file{tabvar.3}.
 %    Ceci est une solution de repli pour ceux qui auraient du mal
-%    \`a installer la fonte \file{tabvar.pfb}.
+%    \`a installer la fonte \file{tabvar.pfb}, \`a n'employer qu'en
+%    dernier recours.
+%
+%    Lorsqu'on travaille avec XeLaTeX ou LuaLaTeX il convient de
+%    placer l'appel \`a |\usepackage{tabvar}| \emph{avant}
+%    |\usepackage{fontspec}|.
 %
 %  \subsection{Installation}
 %
-%    Assurez-vous que l'extension \file{varwidth.sty} est pr\'esente
-%    sur votre syst\`eme, sinon r\'ecup\'erez-les sur CTAN :
+%    L'extension \file{tabvar} fait partie des distributions TeXLive,
+%    MacTeX, ProTeXt, MikTeX, etc. Si elle n'est pas install\'ee chez
+%    vous, assurez-vous d'abord que l'extension \file{varwidth.sty} est
+%    pr\'esente sur votre syst\`eme, sinon r\'ecup\'erez-la sur CTAN :
 %    cherchez par exemple la cha\^{\i}ne |varwidth|
 %    sur \url{http://www.tex.ac.uk/CTANfind.html}
 %
@@ -114,14 +125,13 @@
 %    L'environnement |tabvar| est une variante de l'environnement
 %    |array|, adapt\'ee \`a la saisie de tableaux de variations.
 %
-%    Trois nouveaux types de colonnes, |C|, |L| et |R| sont
-%    utilis\'es \`a la place des types classiques (|c|, |l| et |r|) ;
-%    ils permettent de disposer du mat\'eriel sur plusieurs niveaux
-%    dans un m\^eme ligne du tableau (ce sont des colonnes de type
-%    |\parbox|).
+%    Trois nouveaux types de colonnes, |C|, |L| et |R| remplacent
+%    les types classiques (|c|, |l| et |r|) ; ils permettent de
+%    disposer du mat\'eriel sur plusieurs niveaux dans un m\^eme ligne
+%    du tableau (ce sont des colonnes de type |\parbox|).
 %
 %    Un quatri\`eme type de colonne, not\'e |N| sert pour les plages
-%    o\`u la fonction est non d\'efinie. La colonne est enti\`erement
+%    o\`u la fonction n'est pas d\'efinie. La colonne est enti\`erement
 %    gris\'ee par d\'efaut, mais il est possible de choisir une autre
 %    couleur (voir le fichier de configuration \file{tabvar.cfg}).
 %
@@ -142,6 +152,7 @@
 %        deux arguments : le niveau (hauteur) o\`u doit \^etre
 %        positionn\'ee la premi\`ere valeur de la fonction et le
 %        nombre total de niveaux qui seront utilis\'es dans la ligne.
+%        Le niveau le plus bas est num\'erot\'e 1.
 %
 %      \item |\dbarre| trace un double trait vertical dont la hauteur
 %        est celle de la ligne du tableau ; elle indique les
@@ -174,6 +185,12 @@
 %    \'et\'e pr\'ef\'er\'ee \`a des pointill\'es qui posent des
 %    probl\`emes de raccordement d'une ligne \`a l'autre du tableau.
 %
+%    Depuis la version 1.5, quatre variantes sont propos\'ees pour le
+%    dessin des fl\`eches PostScript type\,1, elles sont accessibles
+%    par les commandes |\FlechesPS1| (fl\`eches \og\`a moustaches\fg{}
+%    obtenues par d\'efaut), |\FlechesPS2| (assorties \`a la police
+%    Fourier), |\FlechesPS3| et |\FlechesPS4|.
+%
 %    Le fichier \file{demo.pdf} (joint) propose plusieurs exemples,
 %    accompagn\'es de leur code source, illustrant les utilisations
 %    possibles de l'environnement |tabvar|.
@@ -181,7 +198,7 @@
 %    Plusieurs commandes ou param\`etres permettent de personnaliser
 %    l'aspect du tableau (augmentation de la largeur ou de la hauteur
 %    des cellules, etc.), voir le fichier \file{tabvar.cfg}.
-
+%
 % \StopEventually{\PrintChanges}
 %
 % \iffalse
@@ -205,7 +222,8 @@
 %    install\'ee, on pourra d\'eclarer |\FlechesMPtrue| dans le
 %    fichier \file{tabvar.cfg} ou dans le pr\'eambule, ou encore
 %    utiliser l'option |FlechesMP| pour que les fl\`eches
-%    MetaPost utilis\'ees \`a la place.
+%    MetaPost utilis\'ees \`a la place. Cette solution est \`a
+%    proscrire lorsqu'on travaille avec XeLaTeX ou LuaLaTeX.
 %
 %    \begin{macrocode}
 \newif\ifFlechesMP \FlechesMPfalse
@@ -225,10 +243,10 @@
 \RequirePackage{ifthen}
 %    \end{macrocode}
 %
-%  \subsection{Dessin des fl\`eches en MetaPost}
+%  \subsection{Dessin des fl\`eches}
 %
 %    Le fichier \file{tabvar.mp} (joint) contient le dessin des
-%    trois fl\`eches.
+%    trois fl\`eches en MetaPost.
 %
 %    La commande |mpost -tex=latex tabvar| produit trois fichiers
 %    \file{tabvar.1}\dots{} \file{tabvar.3} qui contiennent les
@@ -244,20 +262,27 @@
 \fi
 %    \end{macrocode}
 %
-%    Les commandes |\FlecheCm|, |\FlecheDm| et |\FlecheHm| tracent
-%    les trois types de fl\`eches MetaPost.
-%
-%    \begin{macrocode}
-\newsavebox{\arup}
-\newsavebox{\ardown}
-\newsavebox{\arhor}
-%    \end{macrocode}
+%\changes{tabvar-1.5}{2011/03/04}{La d\'efinition des fl\`eches en
+%  MetaPost est d\'eplac\'ee (AtBeginDocument) pour \'eviter un
+%  message d'erreur avec XeLaTeX. Bug signal\'e par Thierry Wybrecht.}
 %
 %\changes{tabvar-1.2}{2008/10/23}{\cs{@ptsize} peut prendre des
 %  valeurs n\'egatives (classes koma-script avec tailles inf\'erieures
 %  \`a 10pt).  Utiliser \cs{f@size} \`a la place (patch propos\'e par
 %  Ulrike Fisher, merci Ulrike).}
 %
+%    La mise \`a l'\'echelle des fl\`eches MetaPost se fait \`a partir
+%    de la valeur de |\f@size| qui contient normalement la taille en
+%    points de la police de base (10 en 10pt). Si la classe utilis\'ee
+%    ne d\'efinit pas |\f@size|, on donne la valeur 10 \`a |\f@size|,
+%    la valeur par d\'efaut de |\TVarrowscale| est alors 1.0
+%    (\'echelle 1), l'utilisateur peut toujours red\'efinir lui-m\^eme
+%    |\TVarrowscale| selon ses besoins.
+%    \begin{macrocode}
+\providecommand{\f@size}{10}
+\newcommand{\TVarrowscale}{\strip@pt\dimexpr\f@size pt/10\relax}
+%    \end{macrocode}
+%
 %\changes{tabvar-1.4}{2010/08/22}{Ajout d'une commande
 %    \cs{TVarrowscolstretch} permettant d'augmenter la largeur des
 %    colonnes contenant les fl\`eches.}
@@ -274,63 +299,74 @@
 %    \end{macrocode}
 %  \end{macro}
 %
-%    La mise \`a l'\'echelle des fl\`eches MetaPost se fait \`a partir
-%    de la valeur de |\f@size| qui contient normalement la taille en
-%    points de la police de base (10 en 10pt). Si la classe utilis\'ee
-%    ne d\'efinit pas |\f@size|, on donne la valeur 10 \`a |\f@size|,
-%    la valeur par d\'efaut de |\TVarrowscale| est alors 1.0
-%    (\'echelle 1), l'utilisateur peut toujours red\'efinir lui-mme
-%    |\TVarrowscale| selon ses besoins.
-%    \begin{macrocode}
-\providecommand{\f@size}{10}
-\newcommand{\TVarrowscale}{\strip@pt\dimexpr\f@size pt/10\relax}
-\sbox{\arup}{\includegraphics[scale=\TVarrowscale]{tabvar.1}}
-\sbox{\ardown}{\includegraphics[scale=\TVarrowscale]{tabvar.2}}
-\sbox{\arhor}{\includegraphics[scale=\TVarrowscale]{tabvar.3}}
-\newcommand{\FlecheCm}{%
-        \TV@arrowcol@stretch{\raisebox{.5ex}{\usebox{\arup}}}}
-\newcommand{\FlecheDm}{%
-        \TV@arrowcol@stretch{\raisebox{.5ex}{\usebox{\ardown}}}}
-\newcommand{\FlecheHm}{%
-        \TV@arrowcol@stretch{\raisebox{.5ex}{\usebox{\arhor}}}}
-%    \end{macrocode}
+%\changes{tabvar-1.5}{2011/03/10}{Trois nouvelles formes de fl\`eches
+%  d\'essin\'ees par Michel Bovani.
+%  Ajout de la commande \cs{FlechesPS} pour y acc\'eder.} 
 %
-%  \subsection{Fl\`eches comme caract\`eres d'une fonte type\,1}
+%  La commande |\FlechesPS| suivie d'un chiffre compris entre 1 et 4
+%  permet d'acc\'eder \`a quatre variantes pour les fl\`eches
+%  PostScript.
 %
-%    Les fl\`eches utilis\'ees par d\'efaut sont prises dans
-%    la fonte type\,1 \og tvsymbols \fg{} de Michel Bovani.
+%  \begin{macro}{\FlechesPS}
+%    \begin{macrocode}
+\newcommand*{\enearrow}{\enearrowi}
+\newcommand*{\esearrow}{\esearrowi}
+\newcommand*{\eastarrow}{\eastarrowi}
+\newcommand*{\FlechesPS}[1]{%
+  \renewcommand*{\enearrow}{%
+    \csname enearrow\romannumeral#1\endcsname}%
+  \renewcommand*{\esearrow}{%
+    \csname esearrow\romannumeral#1\endcsname}%
+  \renewcommand*{\eastarrow}{%
+    \csname eastarrow\romannumeral#1\endcsname}%
+}
+%    \end{macrocode}
+%  \end{macro}
 %
 %  \begin{macro}{\FlecheC}
 %  \begin{macro}{\FlecheD}
 %  \begin{macro}{\FlecheH}
 %    Le trac\'e des trois types de fl\`eches est fait par les
-%    commandes |\FlecheC|, |\FlecheD| et |\FlecheH|.  Il pourrait
-%    sembler plus naturel de d\'efinir des commandes |\FlecheCp|,
-%    |\FlecheDp| et |\FlecheHp| faisant appel \`a la fonte \og
-%    tvsymbols \fg{} et de choisir au |\begin{document}| entre la
-%    variante MetaPost et la variante type\,1 ; mais cette solution
-%    consommerait syst\'ematiquement une fonte math\'ematique parmi
-%    les 16 disponibles. Ici, la fonte \og tvsymbols \fg{} n'est pas
-%    d\'eclar\'ee si on travaille avec les variantes MetaPost.
-%
+%    commandes |\FlecheC|, |\FlecheD| et |\FlecheH|. Le choix de la
+%    variante (MetaPost ou type\,1) est fait au |\begin{document}|,
+%    ce qui \'economise une fonte math\'ematique parmi les 16
+%    disponibles lorsqu'on choisit la variante MetaPost.
 %    \begin{macrocode}
 \AtBeginDocument{%
   \ifFlechesMP
-    \newcommand{\FlecheC}{\FlecheCm}%
-    \newcommand{\FlecheD}{\FlecheDm}%
-    \newcommand{\FlecheH}{\FlecheHm}%
+    \newsavebox{\arup}%
+    \newsavebox{\ardown}%
+    \newsavebox{\arhor}%
+    \sbox{\arup}{\includegraphics[scale=\TVarrowscale]{tabvar.1}}%
+    \sbox{\ardown}{\includegraphics[scale=\TVarrowscale]{tabvar.2}}%
+    \sbox{\arhor}{\includegraphics[scale=\TVarrowscale]{tabvar.3}}%
+    \newcommand*{\FlecheC}{%
+        \TV@arrowcol@stretch{\raisebox{.5ex}{\usebox{\arup}}}}%
+    \newcommand*{\FlecheD}{%
+        \TV@arrowcol@stretch{\raisebox{.5ex}{\usebox{\ardown}}}}%
+    \newcommand*{\FlecheH}{%
+        \TV@arrowcol@stretch{\raisebox{.5ex}{\usebox{\arhor}}}}%
   \else
     \DeclareFontFamily{U}{tv}{}%
     \DeclareFontShape{U}{tv}{m}{n}{<->tabvar}{}%
     \DeclareSymbolFont{tvsymbols}{U}{tv}{m}{n}%
-    \DeclareMathSymbol{\enearrow}{\mathrel}{tvsymbols}{"25}%
-    \DeclareMathSymbol{\esearrow}{\mathrel}{tvsymbols}{"26}%
-    \DeclareMathSymbol{\eastarrow}{\mathrel}{tvsymbols}{"21}%
-    \newcommand{\FlecheC}{%
+    \DeclareMathSymbol{\eastarrowi}{\mathrel}{tvsymbols}{"21}%
+    \DeclareMathSymbol{\enearrowi}{\mathrel}{tvsymbols}{"25}%
+    \DeclareMathSymbol{\esearrowi}{\mathrel}{tvsymbols}{"26}%
+    \DeclareMathSymbol{\eastarrowii}{\mathrel}{tvsymbols}{"31}%
+    \DeclareMathSymbol{\enearrowii}{\mathrel}{tvsymbols}{"35}%
+    \DeclareMathSymbol{\esearrowii}{\mathrel}{tvsymbols}{"36}%
+    \DeclareMathSymbol{\eastarrowiii}{\mathrel}{tvsymbols}{"3B}%
+    \DeclareMathSymbol{\enearrowiii}{\mathrel}{tvsymbols}{"3F}%
+    \DeclareMathSymbol{\esearrowiii}{\mathrel}{tvsymbols}{"40}%
+    \DeclareMathSymbol{\eastarrowiv}{\mathrel}{tvsymbols}{"46}%
+    \DeclareMathSymbol{\enearrowiv}{\mathrel}{tvsymbols}{"4A}%
+    \DeclareMathSymbol{\esearrowiv}{\mathrel}{tvsymbols}{"4B}%
+    \newcommand*{\FlecheC}{%
             \TV@arrowcol@stretch{\ensuremath{\enearrow}}}%
-    \newcommand{\FlecheD}{%
+    \newcommand*{\FlecheD}{%
             \TV@arrowcol@stretch{\ensuremath{\esearrow}}}%
-    \newcommand{\FlecheH}{%
+    \newcommand*{\FlecheH}{%
             \TV@arrowcol@stretch{\ensuremath{\eastarrow}}}%
   \fi}
 %    \end{macrocode}
@@ -685,10 +721,18 @@
 %% Fichier de configuration de l'extension `tabvar.sty'.
 %%
 %% D\'ecommenter la ligne suivante pour que les variantes MetaPost
-%% des fl\`eches soient utilis\'ees \`a la place de la fonte tabvar.pfb.
+%% des fl\`eches soient utilis\'ees \`a la place de la fonte tabvar.pfb
+%% (d\'econseill\'e en g\'en\'eral et *jamais* sous LuaLaTeX ou XeLaTeX).
 %%
 %%\FlechesMPtrue
 %%
+%% Choix d'une des 4 variantes pour les fl\`eches PostScript
+%%
+%%\FlechesPS1   % (d\'efaut)
+%%\FlechesPS2   % assorties \`a la police Fourier
+%%\FlechesPS3
+%%\FlechesPS4
+%%
 %% Ce param\`etre permet d'augmenter la largeur des colonnes contenant
 %% des fl\`eches (essayer 1.3, 1.5, etc.), sa valeur par d\'efaut est 1 :
 %%