%%
%% This is file `paresse-en.tex',
%% generated with the docstrip utility.
%%
%% The original source files were:
%%
%% paresse.dtx  (with options: `en-doc')
%% This is a generated file.
%% 
%% Copyright (C) 2003-2008 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.
\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}
\newcommand\MODULE[1]{\textsf{#1}}
\begin{document}
\GetFileInfo{paresse.sty}
\title{The package \MODULE{paresse}\thanks{This document corresponds
    to the file \MODULE{paresse.sty}~\fileversion, dated \filedate,
    50th anniversary edition.}
  \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{otherlanguage}{french}
  \begin{abstract}
    Ce module, reprenant un exemple de T.~\textsc{Lachand-Robert}
    dans~\cite{tlachand}, fournit un moyen de taper des lettres
    grecques isolées à l'aide du caractère actif et redéfini. Au lieu
    de |\(\alpha\)| ou tape |§a| pour obtenir \(\alpha\).

    \textbf{Important} : Il doit être chargé \textbf{après}
    \MODULE{inputenc} si ce dernier est utilisé. De plus, il faut que
    le signe § soit une lettre pour \TeX.

    La \textbf{documentation française} de cette extension est
    \texttt{paresse-fr.pdf}. Elle contient le code commenté.
\end{abstract}

\end{otherlanguage}
\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 § activated and redefined. Instead of
  |\(\alpha\)| one types |§a| to obtain \(\alpha\).

  \textbf{Important}: You have to load it \textbf{after} the
  \MODULE{inputenc} package if the latter is used. Moreover the sign §
  must be a letter for \TeX.

  The code is not commented in English any more, see the French
  documentation for French commented code. Sorry.
\end{abstract}

\tableofcontents{}

\newpage

\section{Introduction}

This is the English version of the documentation of the
\MODULE{paresse} package.

This package provides only a `quick and low-cost' access to greek
letters which one can obtain with a macro such as |\alpha| or
|\Omega|. It provides also an environment and a macro which make
possible the use of § to type in those letters. Because of an
|\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 |\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 § 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{Usage}

One loads the package with |\usepackage{paresse}| \textbf{after} the
package |inputenc|. The sign § 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 |§a| are immediately available. If one prefers one can choose
the option |tame| by writing |\usepackage[tame]{paresse}|. One must
then use the command |\ActiveLaParesse| or the environment
|ParesseActive| to use the `§-macros'.

When `paresse' is active, one has just to type |§a| 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 |\alpha|, see the table
page~\pageref{tableau}. One obtains \(\alpha^{\beta}\) with
|\(§a^{§b}\)| when § 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 |\(§a^§b\)|.

\subsection{Options}

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

\item |ttau| is the contrary of |ttheta| which is selected by
  default. When |ttheta| is active |§t| gives \(\theta\) in the
  contrary |§t| gives \(\tau\). In all cases, \(\theta\) is given by
  |§v| and \(\tau\) by |§y|.

  \textbf{Remark:} \(\Theta\) is `regularly' obtained with |§V| and
  \emph{also} with |§T| whatever is the chosen option.

\item |epsilon| is the contrary of |varepsilon| which is selected by
  default. With |epsilon|, |§e| gives \(\epsilon\) otherwide |§e|
  gives \(\varepsilon\).

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

The default options are |varepsilon|, |theta|, |pi|, |rho|, |sigma|,
|varphi| and |wild|.

\subsection{Commands and environment}
\DescribeMacro{\makeparesseletter}
This command gives the letter-catcode to the `character' §. After that
one can use § 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 §. It is
the `contrary' of the preceding one. It corresponds to |\makeatother|.

\DescribeMacro{\ActiveLaParesse}
This macro makes § active and thus enable one to access the macros the
name of which begins with § such as |§a|. A list of these macros and
theirs meanings is given in the table~\pageref{tableau}.

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

\subsection{Table of the §-macros}

\begin{center}\Large
\begin{ParesseActive} \label{tableau}
\begin{tabular}{*4{||>{\ttfamily \§}c| c}||}\hline
a & §a & b & §b & g & §g & d & §d\\ \hline
e & §e & z & §z & h & §h & v & §v\\ \hline
i & §i & k & §k & l & §l & m & §m\\ \hline
n & §n & x & §x & p & §p & r & §r\\ \hline
s & §s & y & §y & u & §u & f & §f\\ \hline
c & §c & q & §q & w & §w &\multicolumn{1}{ c|}{} &  \\ \hline\hline
G & §G & D & §D & V & §V & L & §L\\ \hline
X & §X & P & §P & S & §S & U & §U\\ \hline
F & §F & Q & §Q & W & §W &\multicolumn{1}{ c|}{} &  \\ \hline
\end{tabular}
\end{ParesseActive}
\end{center}

\paragraph{Remarks : } all the latin letters used in the name of the
§-macros, but for {\ActiveLaParesse §v, §y and §q}, are loaded with
reminiscences, I hope \texttt{:-)} and the greek uppercases are
obtained with the (latin) corresponding uppercases.

\begin{thebibliography}{99}
\addcontentsline{toc}{section}{Bibliography}
\selectlanguage{french}
\bibitem{tlachand} T.~\textsc{Lachand-Robert}.
\emph{La maîtrise 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'.
