summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/paresse/paresse-en.tex
blob: 15d1368008dc5ae7783f59a1b5f8ed61e43f66ec (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
%%
%% 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'.