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