%%
%% This is file `paresse-fr.tex',
%% generated with the docstrip utility.
%%
%% The original source files were:
%%
%% paresse.dtx  (with options: `doc,fr')
%% This is a generated file.
%% 
%% Copyright (C) 2003-2010 Y. Henel, le TeXnicien de surface
%% <le.texnicien.de.surface@wanadoo.fr>
%% 
%% This file may be distributed and/or modified under the conditions of
%% the LaTeX Project Public License, either version 1.2 of this license
%% or (at your option) any later version.  The latest version of this
%% license is in:
%% 
%%    http://www.latex-project.org/lppl.txt
%% 
%% and version 1.2 or later is part of all distributions of LaTeX version
%% 1999/12/01 or later.
\def\fileversion{v3}
\def\filedate{2010/03/21}
\documentclass[a4paper]{ltxdoc}
\usepackage[latin1]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[tame]{paresse}
\usepackage{xspace,url,array,ifthen}
\IfFileExists{lmodern.sty}{\usepackage{lmodern}}{}
\usepackage[english,frenchb]{babel}
\usepackage[colorlinks=true,
            linkcolor=blue,
            urlcolor=blue,
            citecolor=blue]{hyperref}
\makeatletter
\newcommand\DescribeOption[1]{\@bsphack \marginpar{\raggedleft
    \textsc{#1}}\index{#1 (option)}\@esphack}
\GlossaryPrologue{%
  \section*{{Changements}}
  \markboth{{Changements}}{{Changements}}}
\IndexPrologue{%
  \section*{Index}\markboth{Index}{Index}%
  Les nombres en italique renvoient ^^e0 la page o^^f9 l'entr^^e9e est d^^e9crite;
  les nombres soulign^^e9s renvoient ^^e0 la ligne de code de la d^^e9finition;
  les nombres en caract^^e8res romains renvoient ^^e0 la ligne de code o^^f9
  l'entr^^e9e est utilis^^e9e.}
\def\generalname{G^^e9n^^e9ral}
\def\SpecialMainEnvIndex#1{%
  \@bsphack\special@index{%
    #1\actualchar
    {\string\ttfamily\space#1}
    (environnement)%
    \encapchar main}%
  \special@index{environnements:\levelchar#1\actualchar{%
      \string\ttfamily\space#1}\encapchar
    main}\@esphack}
\makeatother
\newcommand{\TO}{\textemdash\ \ignorespaces}
\newcommand{\TF}{\unskip\ \textemdash\xspace}
\newcommand{\CAD}{c.-^^e0-d.\xspace}
\newcommand\BOP{\discretionary{}{}{}}
\newcommand\Option[1]{\textsc{#1}}
\newcommand\MODULE[1]{\textsf{#1}}
\newcommand\NOUVO{%
  \marginpar{\hspace*{\stretch{1}}%
    \textbf{N (v3)}\hspace*{.5em}}\xspace}

\begin{document}
\GetFileInfo{paresse.sty} % marche p^^f4! :(

\title{Le module \MODULE{paresse}\thanks{Ce document correspond au
    fichier \MODULE{\filename}~\fileversion, du \filedate.}}
\author{Le \TeX nicien de surface\\
\url{le.texnicien.de.surface@wanadoo.fr}}
\maketitle{}

\begin{abstract}
  Ce module, reprenant un exemple de T.~\textsc{Lachand-Robert}
  dans~\cite{tlachand}, fournit un moyen de taper des lettres grecques
  isol^^e9es ^^e0 l'aide du caract^^e8re actif et red^^e9fini. Au lieu de
  |\(\alpha\)| ou tape |^^a7a| pour obtenir \(\alpha\).

  \textbf{Important} : Il doit ^^eatre charg^^e9 \textbf{apr^^e8s}
  \MODULE{inputenc} si ce dernier est utilis^^e9. De plus, il faut que le
  signe ^^a7 soit une lettre pour \TeX.

  Le fichier \texttt{paresse.pdf} contient le code comment^^e9 en
  fran^^e7ais.
\end{abstract}
\begin{otherlanguage}{english}
  \begin{abstract}
    This is the French documentation for the final user of the package
    \MODULE{paresse}. The English documentation for the final user is
    available in the file \texttt{paresse-en.pdf}.

    The code is not commented in English any more. Sorry. See the
    French documentation for French commented code in
    \texttt{paresse.pdf}.
  \end{abstract}
\end{otherlanguage}

\tableofcontents{}

\newpage

\section{Introduction}

Cette extension ne fournit qu'un acc^^e8s \og rapide et ^^e9conomique \fg
aux lettres grecques qui s'obtiennent ^^e0 l'aide d'une macro comme
\cs{alpha} ou \cs{Omega}. Elle fournit un environnement et une commande
qui permettent d'utiliser ^^a7 pour taper ces lettres. Un \cs{ensuremath}
nous dispense de nous placer explicitement \TO c'est-^^e0-dire en
tapant |$ $| ou bien |\( \)| ou encore |\[ \]| ou tout autre chose
ayant le m^^eame effet\TF en mode math^^e9matique pour obtenir une lettre
grecque.

L'id^^e9e de la m^^e9thode est due ^^e0 T.~\textsc{Lachand-Robert} et est
expos^^e9e dans~\cite{tlachand}. Je n'ai fait qu'ajouter le
\cs{ensuremath} bien agr^^e9able pour l'^^e9criture de macros.

Bien entendu, on \textbf{ne} dispose \textbf{pas} de macros pour la
minuscule omicron ni pour les majuscules alpha, beta\dots{} qui
s'obtiennent ^^e0 l'aide des latines romaines de m^^eame
apparence\footnote{Je ne ferai aucune remarque sur les probl^^e8mes de
  codage que cela pose.}. Je ne me suis pas senti le courage ni la
force de fournir une solution qui permettent d'obtenir dans une
formule baignant dans un texte en italique gras un alpha majuscule
droit, romain, \&c.

Pour finir cette introduction, glosons le nom de cette
extension. |paresse| vient de ce que le signe ^^a7 indique un  \og
paragraphe \fg  en ayant une forme lointainement apparent^^e9e au
S et n'a donc aucun lien avec le \emph{d^^e9faut} si fr^^e9quent,
encore que, ^^e0 bien y r^^e9fl^^e9chir\dots

\section{Pourquoi une 3\ieme version?}

C'est par un courriel du 3~mars 2003 que Claudio \textsc{Beccari} me
signalait tr^^e8s aimablement qu'il existait un codage de l'alphabet
grec en lettres latines pr^^e8s de 15~ans avant que je ne commette
cette extension. Ce codage ^^e9tait d^^fb ^^e0 Sylvio \textsc{Levi} qui
l'avait mis au point, alors qu'il dessinait les premi^^e8res fontes
grecques pour \TeX, en s'appuyant sur la correspondance entre les
claviers am^^e9ricain et grec.  Il me faisait remarquer ^^e0 juste titre
que si quelqu'un avait pris l'habitude du codage de Sylvio
\textsc{Levi}, il pr^^e9f^^e9rerait conserver ses habitudes pour
\MODULE{paresse}.

J'ai donc d^^e9cid^^e9 de fournir un nouveau couple d'options exclusives
l'une de l'autre que j'ai nomm^^e9es, pour l'une, \Option{legacy} ---
pour \og h^^e9ritage\fg --- qui assure le codage originel de cette
extension et qui est active par d^^e9faut et, pour l'autre, \Option{Levi}
qui assure le codage de Sylvio \textsc{Levi}.

J'en profite pour faire quelques changements cosm^^e9tiques:
d^^e9sormais toutes les macros internes \emph{secr^^e8tes} ont un nom qui
commence par \cs{GA@};
le fichier |.dtx| est r^^e9organis^^e9 pour faciliter la tache de
traduction de la documentation.

\section{Utilisation}

On charge cette extension avec |\usepackage{paresse}| \textbf{apr^^e8s}
l'extension |inputenc|. Il faut que la \og caract^^e8re \fg ^^a7 soit
reconnu par \TeX\ comme une lettre. On pourra, par exemple, utiliser
l'option |latin1| de |inputenc| pour obtenir cela.

Par d^^e9faut, l'extension est charg^^e9e avec l'option |wild| ce qui
signifie que les macros de la forme |^^a7a| sont disponibles. Si l'on
pr^^e9f^^e8re, on peut passer ^^e0 |paresse| l'option \Option{tame} avec
|\usepackage[tame]{paresse}|. Il faut alors utiliser la commande
\cs{ActiveLaParesse} ou l'environnement |ParesseActive| pour utiliser
les macros en ^^a7.

Lorsque la \og paresse est active \fg, il suffit de taper |^^a7a| pour
obtenir \(\alpha\). On a de m^^eame acc^^e8s ^^e0 toutes les lettres grecques
auxquelles sont consacr^^e9es une macro comme \cs{alpha},
voyez~\ref{codageorig} et~\ref{codagelevi}. On obtient, de m^^eame,
\(\alpha^{\beta}\) avec |\(^^a7a^{^^a7b}\)| lorsque ^^a7 est active. On notera
que, si l'extension |amsmath| est utilis^^e9e, les accolades sont
optionelles et qu'on obtient un r^^e9sultat identique avec |\(^^a7a^^^a7b\)|.

\subsection{Les options}

\begin{itemize}
\item \Option{tame}\DescribeOption{tame / wild} s'oppose ^^e0
  \Option{wild} qui est l'option par d^^e9faut. Lorsque \Option{tame}
  r^^e8gne, il \textbf{faut} un environnement |ParesseActive| ou une
  commande \cs{ActiveLaParesse} pour utiliser les macros ^^e0 ^^a7.

\item \Option{Levi}\NOUVO\DescribeOption{legacy / Levi} s'oppose ^^e0
  \Option{legacy} qui est l'option par d^^e9faut. Avec l'option
  \Option{legacy} on utilise le codage \og originel\fg de
  \MODULE{paresse.sty} tel que le donne la
  table~\ref{codageorig}. Sinon, le codage est celui d^^e9fini par Sylvio
  \textsc{Levi}, cf. la table~\ref{codagelevi}.

\item \Option{ttau}\DescribeOption{ttau / ttheta} s'oppose ^^e0
  \Option{ttheta} qui est l'option par d^^e9faut. Lorsque \Option{ttheta}
  est active |^^a7t| donne \(\theta\) dans le cas contraire |^^a7t| donne
  \(\tau\). En tous cas, \(\theta\) est accessible par |^^a7v| et
  \(\tau\) par |^^a7y|. \NOUVO Cette option est inop^^e9rante si l'option
  \Option{Levi} a ^^e9t^^e9 choisie.

  \textbf{Remarque :} \NOUVO quand l'option \Option{legacy} a ^^e9t^^e9 choisie,
  \(\Theta\) est obtenu par |^^a7V| de mani^^e8re \og r^^e9guli^^e8re \fg et
  \emph{^^e9galement} par |^^a7T| quelle que soit l'option choisie. Dans
  le cas de l'option \Option{Levi}, |^^a7V| ne correspond ^^e0 aucune lettre
  grecque.

\item \Option{epsilon}\DescribeOption{epsilon / varepsilon} s'oppose ^^e0
  \Option{varepsilon} qui est l'option par d^^e9faut. Avec
  \Option{epsilon}, |^^a7e| donne \(\epsilon\) sinon |^^a7e| donne
  \(\varepsilon\).

\item Se comportent comme le couple \Option{epsilon},
  \Option{varepsilon} les couples suivants \Option{theta} et
  \Option{vartheta} ; \Option{pi} et \Option{varpi} ; \Option{rho} et
  \Option{varrho} ; \Option{sigma} et \Option{varsigma} \og |^^a7s| donne
  \(\varsigma\)\fg; \Option{phi} et \Option{varphi}.
\end{itemize}

Par d^^e9faut on a \Option{varepsilon}, \Option{theta}, \Option{pi},
\Option{rho}, \Option{sigma}, \Option{varphi}, \Option{wild} et
\Option{legacy}\NOUVO. Cela assure que cette version~3, se comporte,
par d^^e9faut, comme la pr^^e9c^^e9dente.

\subsection{Commandes et environnement}

\DescribeMacro{\makeparesseletter}
Cette macro donne au \og caract^^e8re \fg ^^a7 le catcode d'une
lettre. Apr^^e8s cela, on peut se servir de ^^a7 dans un nom de macro, par
exemple. C'est le pendant de \cs{makeatletter}.

\DescribeMacro{\makeparesseother}
Cette macro donne au caract^^e8re ^^a7 le catcode \emph{other}. C'est le \og
contraire \fg de la pr^^e9c^^e9dente. Cela ^^e9quivaut au \cs{makeatother}.

\DescribeMacro{\ActiveLaParesse}
Cette macro active le caract^^e8re ^^a7 et permet ainsi d'acc^^e9der aux
macros dont le nom commence par ^^a7 comme |^^a7a|. Pour une liste de ces
macros et leurs significations, voyez les tableaux~\ref{codageorig}
et~\ref{codagelevi}.

\DescribeEnv{ParesseActive}
Dans cet environnement le caract^^e8re ^^a7 est actif ce qui permet
d'utiliser les macros en ^^a7.  On utilisera cet environnement si l'on
veut utiliser les macros quand on a charg^^e9 l'extension
\MODULE{paresse} avec l'option \texttt{tame}.

\subsection{Tableaux des macros}

\subsubsection{Codage originel de \MODULE{paresse.sty}}

C'est le codage actif lorsque l'on a choisit l'option \Option{legacy} qui
est l'option par d^^e9faut.

\begin{center}\Large
\begin{ParesseActive} \label{codageorig}
\begin{tabular}{*4{||>{\ttfamily \^^a7}c|c}||}\hline
a & ^^a7a & b & ^^a7b & g & ^^a7g & d & ^^a7d\\ \hline
e & ^^a7e & z & ^^a7z & h & ^^a7h & v & ^^a7v\\ \hline
i & ^^a7i & k & ^^a7k & l & ^^a7l & m & ^^a7m\\ \hline
n & ^^a7n & x & ^^a7x & p & ^^a7p & r & ^^a7r\\ \hline
s & ^^a7s & y & ^^a7y & u & ^^a7u & f & ^^a7f\\ \hline
c & ^^a7c & q & ^^a7q & w & ^^a7w &\multicolumn{1}{c|}{}&\\ \hline\hline
G & ^^a7G & D & ^^a7D & V & ^^a7V & L & ^^a7L\\ \hline
X & ^^a7X & P & ^^a7P & S & ^^a7S & U & ^^a7U\\ \hline
F & ^^a7F & Q & ^^a7Q & W & ^^a7W &\multicolumn{1}{c|}{}&\\ \hline
\end{tabular}
\end{ParesseActive}
\end{center}

\paragraph{Remarques : } ^^e0 l'exception de {\ActiveLaParesse ^^a7v, ^^a7y
et ^^a7q} les lettres utilis^^e9es dans les noms des macros sont charg^^e9es
de vertu mn^^e9motechniques \texttt{:-)} et les majuscules grecques
s'obtiennent ^^e0 l'aide de la majuscule correspondante.

\subsubsection{Codage de Sylvio \textsc{Levi}}

On active ce codage avec l'option \Option{Levi}.

\begin{center}\Large\NOUVO
\begin{ParesseActive} \label{codagelevi}
\begin{tabular}{*4{||>{\ttfamily \^^a7}c|c}||}\hline
a & ^^a7a & b & ^^a7b & g & ^^a7g & d & ^^a7d\\ \hline
e & ^^a7e & z & ^^a7z & h & ^^a7h & j & ^^a7v\\ \hline
i & ^^a7i & k & ^^a7k & l & ^^a7l & m & ^^a7m\\ \hline
n & ^^a7n & x & ^^a7x & p & ^^a7p & r & ^^a7r\\ \hline
s & ^^a7s & t & ^^a7y & u & ^^a7u & f & ^^a7f\\ \hline
q & ^^a7c & y & ^^a7q & w & ^^a7w & c & \(\varsigma\)\\ \hline\hline
G & ^^a7G & D & ^^a7D & J & ^^a7V & L & ^^a7L\\ \hline
X & ^^a7X & P & ^^a7P & S & ^^a7S & U & ^^a7U\\ \hline
F & ^^a7F & Y & ^^a7Q & W & ^^a7W &\multicolumn{1}{c|}{}&\\ \hline
\end{tabular}
\end{ParesseActive}
\end{center}

Le codage de Sylvio \textsc{Levi} donne acc^^e8s directement ^^e0 \cs{varsigma}
(\(\varsigma\)) avec |^^a7c| et ne diff^^e8re du codage originel que pour
les lettres {\ActiveLaParesse ^^a7v, ^^a7y, ^^a7c et ^^a7q}. Voici un r^^e9sum^^e9 de
ces diff^^e9rences:

\begin{center}
\newcommand\CT[1]{\multicolumn{1}{c|}{\texttt{#1}}}
\begin{ParesseActive}
\begin{tabular}{|l|*{7}{c|}}\hline
lettres grecques
& ^^a7v & ^^a7y & ^^a7c & ^^a7q & ^^a7V & ^^a7Q & \(\varsigma\)\\\hline
codage originel
&\CT{\^^a7v/\^^a7t}&\CT{\^^a7y/\^^a7t}&\CT{\^^a7c}
&\CT{\^^a7q}&\CT{\^^a7V/\^^a7T}&\CT{\^^a7Q}& --- \\\hline
codage de S. \textsc{Levi}
&\CT{\^^a7j}&\CT{\^^a7t}&\CT{\^^a7q}&\CT{\^^a7y}
&\CT{\^^a7J}&\CT{\^^a7Y} & \CT{\^^a7c}\\\hline
\end{tabular}
\end{ParesseActive}
\end{center}

\begin{thebibliography}{99}
\addcontentsline{toc}{section}{Bibliographie}
\bibitem{tlachand} T.~\textsc{Lachand-Robert}.
\emph{La ma^^eetrise de \TeX{} et \LaTeX{}}.
Masson, Paris, Milan, Barcelone, \oldstylenums{1995}.\\
\textsc{isbn} : \texttt{2-225-84832-7}.
\end{thebibliography}

\end{document}
\endinput
%%
%% End of file `paresse-fr.tex'.
