%%
%% This is file `paresse-en.tex',
%% generated with the docstrip utility.
%%
%% The original source files were:
%%
%% paresse.dtx  (with options: `doc,en')
%% 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[frenchb,english]{babel}
\usepackage[colorlinks=true,
            linkcolor=blue,
            urlcolor=blue,
            citecolor=blue]{hyperref}
\makeatletter
\newcommand\DescribeOption[1]{\@bsphack \marginpar{\raggedleft
    \textsc{#1}}\index{#1 (option)}\@esphack}
\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{The package \MODULE{paresse}\thanks{This document corresponds
    to the file \MODULE{\filename}~\fileversion, dated \filedate.}
  \mbox{}\thanks{English translation by the author. Any comment
    about the translation is welcome.}}
\author{Le \TeX nicien de surface\\
\url{le.texnicien.de.surface@wanadoo.fr}}
\maketitle{}

\begin{abstract}
  This package implements an example from T.~\textsc{Lachand-Robert}
  in~\cite{tlachand}. It provides a means of typing isolated greek
  letters with the character ^^a7 activated and redefined. Instead of
  |\(\alpha\)| one types |^^a7a| to obtain \(\alpha\).

  The code is not commented in English any more. Sorry. See the French
  documentation for French commented code in \texttt{paresse.pdf}.
\end{abstract}
\begin{otherlanguage}{french}
  \begin{abstract}
    La documentation fran^^e7aise pour l'utilisateur de l'extension
    \MODULE{paresse} est d^^e9sormais disponible sous le nom de
    \texttt{paresse-fr.pdf}.

    Le fichier \texttt{paresse.pdf} contient le code comment^^e9 en
    fran^^e7ais.
  \end{abstract}
\end{otherlanguage}

\tableofcontents{}

\newpage

\section{Introduction}

This package provides only a `quick and low-cost' access to greek
letters which one can obtain with a macro such as \cs{alpha} or
\cs{Omega}. It provides also an environment and a macro which make
possible the use of ^^a7 to type in those letters. Because of an
\cs{ensuremath} we are not bound to explicitly enter ---i.e. by typing
|$ $| or |\( \)| or else |\[ \]| or anything whatsoever with the same
effect--- mathematics mode to obtain a greek letter.

The idea of the method is from T.~\textsc{Lachand-Robert} and
described in~\cite{tlachand}. I have just add the \cs{ensuremath} which
is so agreeable to write macros.

There is \emph{no} macros for the lowercase omicron nor for the
uppercase alpha, beta\dots{} that one can obtain with the latin roman
letters with the same look. I have not had the courage nor the
strength to build a solution which would provide a means of obtaining
an upright uppercase alpha in a math formula enbedded in an italic
boldfaced text.

Even if the meaning of the French `paresse' is just `lazyness' I would
like to enphasize that the name of this package comes from the fact
that the sign ^^a7 can be used to point at a paragraph and looks like an
S. So there is no connection between the name and the not unfrequent
sin of the same (French) name\dots{} or maybe\dots{}

\section{Why a 3rd Version?}

With a mail dated march, 3, 2003, Claudio \textsc{Beccari} kindly
informed me that there was an encoding of the greek alphabet with latin
letters some 15~years before I commited this extension. This encoding
was devised by Sylvio \textsc{Levi} who, at the time, was designing
the first greek font for \TeX, using the correspondance between greek
and us keyboard. Claudio wrote to me, and I can't but agree with him,
that if one is used to \textsc{Levi}'s encoding, one would rather keep
one's habit in order to use \MODULE{paresse}.

I, then, decided to provide a new couple of mutually exclusive
options: the first one is \Option{legacy} with which one obtain the
original encoding of this extension and which is active by default,
the other one is \Option{Levi} which provides Sylvio \textsc{Levi}'s
encoding.

I take advantage of this update to make some cosmetic changes: from
now on all inner \emph{secret} macros have a name which begins with
\cs{GA@}; the |.dtx| file is reorganised to facilitate the translation
of the documentation.

\section{Usage}

One loads the package with |\usepackage{paresse}| \textbf{after} the
package |inputenc|. The sign ^^a7 must be recognised as a letter by
\TeX. On can use for instance |inputenc| with option |latin1| for such
a purpose.

By default the package is loaded with option |wild| and so the macros
such as |^^a7a| are immediately available. If one prefers one can choose
the option \Option{tame} by writing |\usepackage[tame]{paresse}|. One
must then use the command \cs{ActiveLaParesse} or the environment
|ParesseActive| to use the `^^a7-macros'.

When `paresse' is active, one has just to type |^^a7a| in to obtain
\(\alpha\). One has access, by the same means, to all the other greek
letters to which a macro is devoted such as \cs{alpha}, see the
tables~\ref{codageorig} and~\ref{codagelevi}. One obtains
\(\alpha^{\beta}\) with |\(^^a7a^{^^a7b}\)| when ^^a7 is active. One will note
that, if the package |amsmath| is loaded, the curly braces are
\emph{not} compulsory and that one obtains the same result with just
|\(^^a7a^^^a7b\)|.

\subsection{Options}

\begin{itemize}
\item \Option{tame}\DescribeOption{tame / wild} is the contrary of
  \Option{wild} which is the option by default. When \Option{tame}
  reigns, one \textbf{must} use an environment |ParesseActive| or a
  command \cs{ActiveLaParesse} in order to use the ^^a7-macros.

\item \Option{Levi}\NOUVO\DescribeOption{legacy / Levi} is the
  contrary of \Option{legacy} which is the default. With
  \Option{legacy} one uses the original encoding of
  \MODULE{paresse.sty} as it is given by the
  table~\ref{codageorig}. If the option \Option{Levi} is enforced, one
  uses the Sylvio \textsc{Levi} encoding, see the
  table~\ref{codagelevi}.

\item \Option{ttau}\DescribeOption{ttau / ttheta} is the contrary of
  \Option{ttheta} which is selected by default. When \Option{ttheta}
  is active |^^a7t| gives \(\theta\) in the contrary |^^a7t| gives
  \(\tau\). In all cases, \(\theta\) is given by |^^a7v| and \(\tau\) by
  |^^a7y|. \NOUVO That option is ineffective when one has chosen
  \Option{Levi}.

\textbf{Remark:} \NOUVO when one has chosen the option
\Option{legacy}, \(\Theta\) is `regularly' obtained with |^^a7V| and
\emph{also} with |^^a7T| whatever is the chosen option. In the case of
the option \Option{Levi}, |^^a7V| doesn't correspond to any greek letter.

\item \Option{epsilon}\DescribeOption{epsilon / varepsilon} is the
  contrary of \Option{varepsilon} which is selected by default. With
  \Option{epsilon}, |^^a7e| gives \(\epsilon\) otherwide |^^a7e| gives
  \(\varepsilon\).

\item The following `couples' behave as \Option{epsilon},
  \Option{varepsilon}: \Option{theta} and \Option{vartheta};
  \Option{pi} and \Option{varpi}; \Option{rho} and \Option{varrho};
  \Option{sigma} and \Option{varsigma}; \Option{phi} and
  \Option{varphi}.
\end{itemize}

The default options are \Option{varepsilon}, \Option{theta},
\Option{pi}, \Option{rho}, \Option{sigma}, \Option{varphi},
\Option{wild} and \Option{legacy}\NOUVO. That ensures that this 3rd
version behaves, by default, as the preceding one.

\subsection{Commands and Environment}

\DescribeMacro{\makeparesseletter}
This command gives the letter-catcode to the `character' ^^a7. After that
one can use ^^a7 in the name of a macro, for instance. It corresponds to
the well-known |\makeatletter|.

\DescribeMacro{\makeparesseother}
This macro gives the catcode \emph{other} to the character ^^a7. It is
the `contrary' of the preceding one. It corresponds to |\makeatother|.

\DescribeMacro{\ActiveLaParesse}
This macro makes ^^a7 active and thus enable one to access the macros the
name of which begins with ^^a7 such as |^^a7a|. A list of these macros and
theirs meanings is given in the tables~\ref{codageorig}
and~\ref{codagelevi}.

\DescribeEnv{ParesseActive}
In this environment ^^a7 is active and one can use the ^^a7-macros. One
could use this environment if one want to use the ^^a7-macros when the
package \texttt{paresse.sty} is loaded whith the option \texttt{tame}.

\subsection{Tables of the Macros}

\subsubsection{\MODULE{paresse.sty}'s Original Encoding}

This is the active encoding when one choses the option \Option{legacy}
which is the default.

\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{Remarks : } all the latin letters used in the name of the
^^a7-macros, but for {\ActiveLaParesse ^^a7v, ^^a7y and ^^a7q}, are loaded with
reminiscences, I hope \texttt{:-)} and the greek uppercases are
obtained with the (latin) corresponding uppercases.

\subsubsection{Sylvio \textsc{Levi}'s Encoding}

One make this encoding active with the 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}

Sylvio \textsc{Levi}'s encoding gives a direct acces to \cs{varsigma}
(\(\varsigma\)) with |^^a7c| and is different from the original encoding
just for the letters {\ActiveLaParesse ^^a7v, ^^a7y, ^^a7c et ^^a7q}. Here is a
summary of theses differences:

\begin{center}
\newcommand\CT[1]{\multicolumn{1}{c|}{\texttt{#1}}}
\begin{ParesseActive}
\begin{tabular}{|l|*{7}{c|}}\hline
greek letters
& ^^a7v & ^^a7y & ^^a7c & ^^a7q & ^^a7V & ^^a7Q & \(\varsigma\)\\\hline
original encoding
&\CT{\^^a7v/\^^a7t}&\CT{\^^a7y/\^^a7t}&\CT{\^^a7c}
&\CT{\^^a7q}&\CT{\^^a7V/\^^a7T}&\CT{\^^a7Q}& --- \\\hline
S. \textsc{Levi}'s encoding
&\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-en.tex'.
