doc 4

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

5 files changed, 422 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/tabvar/00README b/Master/texmf-dist/doc/latex/tabvar/00README
new file mode 100644
index 00000000000..1877ff8c996
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tabvar/00README
@@ -0,0 +1,27 @@
+                            Tabvar package
+
+This LaTeX package is meant to ease the typesetting of tables showing
+variations of functions as they are used in France. 
+The documentation is in French.
+
+Listing of the package:
+-- 00README (this file)
+-- source : tabvar.dtx tabvar.ins tabvar.mp
+-- font: tabvar.afm tabvar.tfm tabvar.pfb  tabvar.map
+-- inputs: tabvar.sty tabvar.cfg tabvar.1 tabvar.2 tabvar.3
+-- doc: tabvar.pdf demo.pdf demo.tex
+
+Installation on tetex/TeXLive based systems:
+First decide where you want to install tabvar: 
+-- either in your personnal TEXMF directory, then you can use the 
+  `install-tabvar.sh' script;
+-- or system wide, then I guess you know what you have to do ;-).
+Reading the script `install-tabvar.sh' can help...
+
+Have a look at the PDF file demo.pdf in the doc directory, to have
+a quick overview of how to use this package.
+Read file tabvar.pdf in the doc directory, for the complete documentation
+of the provided commands.
+
+Daniel Flipo, <Daniel.Flipo@univ-lille1.fr>
+February 6th, 2005.
diff --git a/Master/texmf-dist/doc/latex/tabvar/demo.pdf b/Master/texmf-dist/doc/latex/tabvar/demo.pdf
new file mode 100644
index 00000000000..1cdb4c55581
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tabvar/demo.pdf
diff --git a/Master/texmf-dist/doc/latex/tabvar/demo.tex b/Master/texmf-dist/doc/latex/tabvar/demo.tex
new file mode 100644
index 00000000000..a1bcb77f94a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tabvar/demo.tex
@@ -0,0 +1,346 @@
+%Format: PDF
+
+\documentclass[a4paper,11pt]{article}
+
+\addtolength{\textwidth}{10mm}
+\addtolength{\oddsidemargin}{-5mm}
+\setlength{\parindent}{0mm}
+\setlength{\parskip}{.5\baselineskip}
+
+\usepackage{tabvar}
+%\usepackage[FlechesPS]{tabvar}
+%\usepackage[FlechesMP]{tabvar}
+
+\usepackage[latin1]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage[frenchb]{babel}
+
+\IfFileExists{lmodern.sty}{\usepackage{lmodern}}{}
+
+\begin{document}
+\thispagestyle{empty}
+
+\begin{center}
+  \Large\bfseries Exemples de tableaux de variations avec \texttt{tabvar}
+\end{center}
+
+Un exemple simple : 
+$\displaystyle f(x)=\frac{x^3+2}{2x} \qquad f'(x)=\frac{x^3-1}{x^2}$.
+
+\[\begin{tabvar}{|C|CCCCCCCCC|} \hline
+ x    &-\infty &   &-\sqrt[3]{2} &   & 0       &   & 1  &    &+\infty      
+\\ \hline
+f'(x) &        & - &             & - & \dbarre & - & 0  & +  & 
+\\ \hline
+\niveau{3}{3}f(x)  
+      &+\infty                       &\decroit 
+      &0                             &\decroit
+      &\discont{-\infty}{<}{+\infty} &\decroit
+      &\frac{3}{2}                   &\croit
+      &+\infty
+\\ \hline
+\end{tabvar}\]
+
+Le codage du tableau est le suivant :
+\begin{verbatim}
+\[\begin{tabvar}{|C|CCCCCCCCC|} \hline
+ x    &-\infty &  &-\sqrt[3]{2} &  &0       &  & 1 &  &+\infty      
+\\ \hline
+f'(x) &        &- &             &- &\dbarre &- & 0 &+ & 
+\\ \hline
+\niveau{3}{3}f(x)  
+      &+\infty                       &\decroit 
+      &0                             &\decroit
+      &\discont{-\infty}{<}{+\infty} &\decroit
+      &\frac{3}{2}                   &\croit
+      &+\infty
+\\ \hline
+\end{tabvar}\]
+\end{verbatim}
+
+L'argument optionnel de \verb|\discont| n'a pas été utilisé, on obtiendrait
+une meilleure présentation en lui donnant la valeur~1, ce qui écarterait
+d'un interligne les valeurs $+\infty$ et~$-\infty$, mettant ainsi
+les trois valeurs~$+\infty$ sur la même ligne.
+
+D'autre part, $f(x)$ est placé au niveau~3 par la commande \verb|\niveau|.
+Si on souhaitait que $f(x)$ soit placé plus bas, au niveau~2 par exemple,
+il faudrait coder :\\
+\verb|\niveau{2}{3}f(x)} &\niveau{3}{3}+\infty}|
+
+Voici le résultat obtenu avec ces deux modifications :
+\[\begin{tabvar}{|C|CCCCCCCCC|} \hline
+ x    &-\infty &  &-\sqrt[3]{2} &  &0       &  & 1 &  &+\infty      
+\\ \hline
+f'(x) &        &- &             &- &\dbarre &- & 0 &+ & 
+\\ \hline
+\niveau{2}{3}f(x)  
+      &\niveau{3}{3}+\infty             &\decroit 
+      &0                                &\decroit
+      &\discont[1]{-\infty}{<}{+\infty} &\decroit
+      &\frac{3}{2}                      &\croit
+      &+\infty
+\\ \hline
+\end{tabvar}\]
+
+Une présentation plus traditionnelle du tableau de variations serait la
+suivante (on renonce à l'utilisation de \verb|\discont| et on remplace
+la colonne \texttt{C} par trois colonnes \texttt{LCR}, la colonnne
+centrale contenant une double barre).
+
+\[\begin{tabvar}{|C|CCCCLCRCCCC|} \hline
+ x    &-\infty &  &-\sqrt[3]{2} &  & &0       & &  & 1 &  &+\infty      
+\\ \hline
+f'(x) &        &- &             &- & &\dbarre & &- & 0 &+ & 
+\\ \hline
+\niveau{2}{3}f(x)  
+      &\niveau{3}{3}+\infty                    &\decroit 
+      &0                                       &\decroit
+      &-\infty  &\dbarre &\niveau{3}{3}+\infty &\decroit
+      &\frac{3}{2}                             &\croit
+      &+\infty
+\\ \hline
+\end{tabvar}\]
+
+Le codage est le suivant :
+\begin{verbatim}
+\[\begin{tabvar}{|C|CCCCRCLCCCC|} \hline
+ x    &-\infty &  &-\sqrt[3]{2} &  & &0       & &  & 1 &  &+\infty      
+\\ \hline
+f'(x) &        &- &             &- & &\dbarre & &- & 0 &+ & 
+\\ \hline
+\niveau{2}{3}f(x)  
+      &\niveau{3}{3}+\infty                    &\decroit 
+      &0                                       &\decroit
+      &-\infty  &\dbarre &\niveau{3}{3}+\infty &\decroit
+      &\frac{3}{2}                             &\croit
+      &+\infty
+\\ \hline
+\end{tabvar}\]
+\end{verbatim}
+
+Noter la présence de la seconde commande \verb|\niveau| pour
+positionner le terme \verb|+\infty| au niveau~3 après la discontinuité.
+
+\newpage
+Un exemple de courbe paramétrée :
+$\displaystyle x(t)= t + \frac{1}{t}\qquad y(t) = t + \frac{1}{2t^2}$.
+
+\[
+\begin{tabvar}{|C|CCRCCCCCC|} \hline
+ t    &-\infty &   &-1  &   & 0       &   & 1  &   &+\infty      
+\\ \hline
+x'(t) &        &+  & 0  & - & \dbarre & - & 0  & + & 
+\\ \hline
+\niveau{1}{3}
+x(t) &-\infty                                &\croit 
+           &-2                               &\decroit 
+           &\discont[1]{-\infty}{<}{+\infty} &\decroit 
+           &2                                &\croit
+           &+\infty
+\\ \hline
+\niveau{1}{3}
+y(t) &-\infty            &\croit 
+           &-\frac{1}{2} &\croit
+           &+\infty      &\decroit
+           &\frac{3}{2}  &\croit
+           &+\infty
+\\ \hline
+y'(t) &        &+  &2   & + & \dbarre & - & 0  &+   &             
+\\ \hline
+\end{tabvar}
+\]
+
+Le codage est le suivant :
+\begin{verbatim}
+\[\begin{tabvar}{|C|CCRCCCCCC|} \hline
+ t    &-\infty &   &-1  &   & 0       &   & 1  &   &+\infty      
+\\ \hline
+x'(t) &        &+  & 0  & - & \dbarre & - & 0  & + & 
+\\ \hline
+\niveau{1}{3}
+x(t) &-\infty                                &\croit 
+           &-2                               &\decroit 
+           &\discont[1]{-\infty}{<}{+\infty} &\decroit 
+           &2                                &\croit
+           &+\infty
+\\ \hline
+\niveau{1}{3}
+y(t) &-\infty            &\croit 
+           &-\frac{1}{2} &\croit
+           &+\infty      &\decroit
+           &\frac{3}{2}  &\croit
+           &+\infty
+\\ \hline
+y'(t) &        &+  &2   & + & \dbarre & - & 0  &+   &             
+\\ \hline
+\end{tabvar}\]
+\end{verbatim}
+
+\newpage
+Le même tableau de variations en présentation \og traditionnelle \fg :
+
+\[\begin{tabvar}{|C|CCRCRCLCCCC|} \hline
+ t    &-\infty &  &-1  &   & &0       &  &   & 1 &   &+\infty      
+\\ \hline
+x'(t) &        &+ & 0  & - & &\dbarre &  & - & 0 & + & 
+\\ \hline
+\niveau{1}{3}
+x(t) &-\infty                                       &\croit 
+           &-2                                      &\decroit 
+           &-\infty  &\dbarre &\niveau{3}{3}+\infty &\decroit 
+           &2                                       &\croit
+           &+\infty
+\\ \hline
+\niveau{1}{3}
+y(t) &-\infty                         &\croit 
+           &-\frac{1}{2}              &\croit
+           &+\infty &\dbarre &+\infty &\decroit
+           &\frac{3}{2}               &\croit
+           &+\infty
+\\ \hline
+y'(t) &        &+  &2   & + & & \dbarre & & - & 0  &+   &             
+\\ \hline
+\end{tabvar}\]
+
+Le codage est le suivant :
+
+\begin{verbatim}
+\[\begin{tabvar}{|C|CCRCRCLCCCC|} \hline
+ t    &-\infty &   &-1  &   & & 0       &  &   & 1  &    &+\infty      
+\\ \hline
+x'(t) &        &+  & 0  & - & & \dbarre &  & - & 0  & +  & 
+\\ \hline
+\niveau{1}{3}
+x(t) &-\infty                                       &\croit 
+           &-2                                      &\decroit 
+           &-\infty  &\dbarre &\niveau{3}{3}+\infty &\decroit 
+           &2                                       &\croit
+           &+\infty
+\\ \hline
+\niveau{1}{3}
+y(t) &-\infty                         &\croit 
+           &-\frac{1}{2}              &\croit
+           &+\infty &\dbarre &+\infty &\decroit
+           &\frac{3}{2}               &\croit
+           &+\infty
+\\ \hline
+y'(t) &        &+  &2   & + & & \dbarre & & - & 0  &+   &             
+\\ \hline
+\end{tabvar}\]
+\end{verbatim}
+
+\newpage
+Le même tableau encore, mais cette fois on utilise les flèches
+dessinées en MetaPost :
+\begingroup
+\renewcommand{\FlecheC}{\FlecheCm}
+\renewcommand{\FlecheD}{\FlecheDm}
+\renewcommand{\FlecheH}{\FlecheHm}
+
+\[\begin{tabvar}{|C|CCRCRCLCCCC|} \hline
+ t    &-\infty &  &-1  &   & &0       &  &   & 1 &   &+\infty      
+\\ \hline
+x'(t) &        &+ & 0  & - & &\dbarre &  & - & 0 & + & 
+\\ \hline
+\niveau{1}{3}
+x(t) &-\infty                                       &\croit 
+           &-2                                      &\decroit 
+           &-\infty  &\dbarre &\niveau{3}{3}+\infty &\decroit 
+           &2                                       &\croit
+           &+\infty
+\\ \hline
+\niveau{1}{3}
+y(t) &-\infty                         &\croit 
+           &-\frac{1}{2}              &\croit
+           &+\infty &\dbarre &+\infty &\decroit
+           &\frac{3}{2}               &\croit
+           &+\infty
+\\ \hline
+y'(t) &        &+  &2   & + & & \dbarre & & - & 0  &+   &             
+\\ \hline
+\end{tabvar}\]
+\endgroup
+
+Le choix entre les flèches MetaPost et celles de Michel \textsc{Bovani} se
+fait normalement soit à l'aide des options 
+%\texttt{FlechesMP} ou\texttt{FlechesPS} 
+de \texttt{tabvar} (\verb|\usepackage[FlechesMP]{tabvar}|)
+soit dans le préambule ou dans le fichier \texttt{tabvar.cfg}, à l'aide du
+drapeau \verb|\FlechesMP| : \verb|\FlechesMPtrue| pour les 
+flèches MetaPost (par défaut les flèches 
+\og bovaniennes \fg{} sont utilisées).
+
+Un exemple de fonction non définie partout :
+$\displaystyle f(x) = \sqrt{\frac{x-1}{x+1}}$. 
+
+\[\begin{tabvar}{|C|CCRNLCC|} \hline
+ x    &-\infty &       &-1       &\hspace*{15mm} & 1              &    &+\infty
+\\ \hline
+ f'(x) &       & +     &         &               &+\infty         & +  &
+\\ \hline
+\niveau{1}{2}
+f(x)  &1     &\croit &+\infty   &               
+          &\niveau{1}{2}0 &\croit & 1
+\\ \hline
+\end{tabvar}\]
+
+Le codage est le suivant
+\begin{verbatim}
+\[\begin{tabvar}{|C|CCRNLCC|} \hline
+ x     &-\infty &  &-1 &\hspace*{15mm} & 1      &  &+\infty
+\\ \hline
+ f'(x) &        &+ &   &               &+\infty &+ &
+\\ \hline
+\niveau{1}{2}
+f(x)  &1     &\croit &+\infty   &               
+          &\niveau{1}{2}0 &\croit & 1
+\\ \hline
+\end{tabvar}\]
+\end{verbatim}
+
+La largeur de la colonne grisée est fixée à~15mm par le \verb|\hspace*{15mm}|
+placé dans une ligne quelconque du tableau. Certains visualiseurs
+(Xdvi par exemple) n'affichent pas correctement les couleurs ;
+en cas de doute, vérifier sur une sortie PostScript ou PDF. 
+
+Noter l'emploi d'une seconde commande \verb|\niveau{1}{2}| pour positionner
+la valeur de~$f$ au point~1 (sans celle-ci, cette valeur serait placée
+au niveau de la valeur précédente, ici~$+\infty$. 
+
+Si on prolongeait la définition de $f$ en posant $f(x)=0$ sur $[-1,1]$
+on aurait le tableau suivant :
+
+\[\begin{tabvar}{|C|CCRCCCCC|} \hline
+ x     &-\infty &       &        &-1      &   & 1      &  &+\infty
+\\ \hline
+ f'(x) &        &+      &        &\dbarre & 0 &+\infty &+ &
+\\ \hline
+\niveau{1}{2}
+f(x)  &1        &\croit &+\infty &\niveau{1}{2}0 
+                                   &\constante &0 &\croit & 1
+\\ \hline
+\end{tabvar}\]
+
+Le codage est le suivant :
+
+\begin{verbatim}
+\[\begin{tabvar}{|C|CCRCCCCC|} \hline
+ x     &-\infty &       &        &-1      &   & 1      &  &+\infty
+\\ \hline
+ f'(x) &        &+      &        &\dbarre & 0 &+\infty &+ &
+\\ \hline
+\niveau{1}{2}
+f(x)  &1        &\croit &+\infty &\niveau{1}{2}0 
+                                   &\constante &0 &\croit & 1
+\\ \hline
+\end{tabvar}\]
+\end{verbatim}
+
+\end{document}
+
+%%% Local Variables: 
+%%% mode: latex
+%%% TeX-master: t
+%%% coding: latin-1
+%%% End: 
diff --git a/Master/texmf-dist/doc/latex/tabvar/install-tabvar.sh b/Master/texmf-dist/doc/latex/tabvar/install-tabvar.sh
new file mode 100755
index 00000000000..699a1b538de
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tabvar/install-tabvar.sh
@@ -0,0 +1,49 @@
+#!/bin/sh
+#
+################################
+# Utilisation: install-tabvar.sh
+# Ce script installe l'extension `tabvar' dans votre répertoire TEXMF
+# personnel (créé au besoin) sur les systèmes Unix à base tetex/TeXLive.
+################################
+# Configuration: 
+INSTDIR=`kpsewhich --expand-var='$HOMETEXMF'`
+################################
+# Répertoires d'installation
+DOCDIR=${INSTDIR}/doc/latex/tabvar
+SOURCEDIR=${INSTDIR}/source/latex/tabvar
+INPUTDIR=${INSTDIR}/tex/latex/tabvar
+AFMDIR=${INSTDIR}/fonts/afm/public/tabvar
+TFMDIR=${INSTDIR}/fonts/tfm/public/tabvar
+PFBDIR=${INSTDIR}/fonts/tupe1/public/tabvar
+# L'emplacement du fichier tabvar.map dépend des distributions... Tester 
+# s'il existe un répertoire `fonts/map' dans le répertoire TEXMF principal.
+TEXMFCNFMAIN=`kpsewhich --expand-var='$TEXMFMAIN'`
+map=`grep 'TEXFONTMAPS' ${TEXMFCNFMAIN}/web2c/texmf.cnf | grep 'fonts/map//$'`
+if [ "x$map" == "x" ]; then
+   MAPDIR=${INSTDIR}/dvips/tabvar
+else
+   MAPDIR=${INSTDIR}/fonts/map/dvips/tabvar
+fi
+################################
+# Créer les répertoires nécessaires :
+${TEXMFCNFMAIN}/web2c/mktexdir ${DOCDIR} ${SOURCEDIR} ${INPUTDIR} ${AFMDIR} ${TFMDIR} ${PFBDIR} ${MAPDIR}
+# Ventiler les fichiers dans l'arborescence ainsi créée :
+cp 00README install-tabvar.sh doc/* ${DOCDIR}
+cp source/* ${SOURCEDIR}
+cp inputs/* ${INPUTDIR}
+cp font/tabvar.afm ${AFMDIR}
+cp font/tabvar.tfm ${TFMDIR}
+cp font/tabvar.pfb ${PFBDIR}
+cp font/tabvar.map ${MAPDIR}
+################################
+# Mettre à jour les fichiers .map à l'aide du script updmap.
+# S'il n'y a pas de fichier updmap.cfg dans l'arborescence perso,
+# rechercher le fichier updmap actif et l'y recopier.
+if [ ! -f $INSTDIR/web2c/updmap.cfg ]; then
+   UPDMAPCFG=`kpsewhich --format='web2c files' updmap.cfg`
+   ${TEXMFCNFMAIN}/web2c/mktexdir $INSTDIR/web2c/
+   cp ${UPDMAPCFG} $INSTDIR/web2c/
+fi
+# Ajouter la ligne concernant tabvar dans updmap.cfg et regénérer
+# les fichiers .map pour dvips, pdftex, etc.
+updmap --enable Map=tabvar.map
diff --git a/Master/texmf-dist/doc/latex/tabvar/tabvar.pdf b/Master/texmf-dist/doc/latex/tabvar/tabvar.pdf
new file mode 100644
index 00000000000..98654ba9f50
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tabvar/tabvar.pdf