%% %% 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 %% %% %% 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'.