diff options
author | Karl Berry <karl@freefriends.org> | 2020-10-08 21:20:56 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-10-08 21:20:56 +0000 |
commit | 99ea21fd2f0b9b4de585316431bf979e59ac35c4 (patch) | |
tree | e14e699b0c106b54902d6e8b5a45440e00e2b9e6 /Master/texmf-dist/doc/latex | |
parent | ecb979519f18e9a0c7d6b3a496e5af891d662d63 (diff) |
paresse (8oct20)
git-svn-id: svn://tug.org/texlive/trunk@56598 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/LISEZMOI.md | 31 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/MANIFEST.md | 72 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/README.md | 34 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-en.pdf | bin | 477661 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-eng.pdf | bin | 0 -> 560865 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-eng.tex | 407 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-ex-en.pdf | bin | 93880 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-ex-fr.pdf | bin | 93596 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-fr.pdf | bin | 503633 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-fra.pdf | bin | 0 -> 595118 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse-fra.tex | 421 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/paresse/paresse.pdf | bin | 489776 -> 422473 bytes |
12 files changed, 965 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/paresse/LISEZMOI.md b/Master/texmf-dist/doc/latex/paresse/LISEZMOI.md new file mode 100644 index 00000000000..c2aca516490 --- /dev/null +++ b/Master/texmf-dist/doc/latex/paresse/LISEZMOI.md @@ -0,0 +1,31 @@ +<!-- Time-stamp: <2020-10-06 14:12:28 administrateur> --> +<!-- Création : 2020-10-06T14:12:21+0200 --> + +# paresse + +Auteur: Yvon Henel, alias _Le TeXnicien de surface_ +([contact](le.texnicien.de.surface@yvon-henel.fr)) + +## LICENCE + +Le contenu de cette archive est placé sous la « LaTeX Project Public License ». +Voir http://www.ctan.org/license/lppl1.3c +pour la licence. + +© 2020 Yvon Henel (Le TeXnicien de surface) + +## Description de l’extension + +Cette extension est faite pour taper « facilement » les lettres +grecques avec un minimum d'effort ;) Elle ne concerne que les +lettres grecques qui ont un nom de macro comme `\alpha` ou `\Omega`. + +## Historique + +* Version 5.0 — 2020-10-06 + * abandon de l'extension <kbd>skeyval</kbd> ; + * gestion des clés avec <kbd>l3keys</kbd> ; + * deux *sous-extensions* <kbd>paresse-old</kbd> and <kbd>paresse-utf8</kbd>; + * passage partiel à <kbd>expl3</kbd>. + +* Version 4.1 — 2013-02-16 diff --git a/Master/texmf-dist/doc/latex/paresse/MANIFEST.md b/Master/texmf-dist/doc/latex/paresse/MANIFEST.md new file mode 100644 index 00000000000..080a0a96b89 --- /dev/null +++ b/Master/texmf-dist/doc/latex/paresse/MANIFEST.md @@ -0,0 +1,72 @@ +# Manifest for paresse + +This file is a listing of all files considered to be part of this package. +It is automatically generated with `texlua build.lua manifest`. + + +## Repository manifest + +The following groups list the files included in the development repository of the package. +Files listed with a ‘†’ marker are included in the TDS but not CTAN files, and files listed +with ‘‡’ are included in both. + +### Source files + +These are source files for a number of purposes, including the `unpack` process which +generates the installation files of the package. Additional files included here will also +be installed for processing such as testing. + +* paresse.dtx +* paresse.ins + +### Typeset documentation source files + +These files are typeset using LaTeX to produce the PDF documentation for the package. + +* paresse.dtx + +### Documentation files + +These files form part of the documentation but are not typeset. Generally they will be +additional input files for the typeset documentation files listed above. + +* LISEZMOI.md +* MANIFEST.md +* README.md +* paresse-fra.pdf +* paresse-eng.pdf + +### Text files + +Plain text files included as documentation or metadata. + +* LISEZMOI.md +* MANIFEST.md +* README.md + +### Derived files + +The files created by ‘unpacking’ the package sources. This typically includes +`.sty` and `.cls` files created from DocStrip `.dtx` files. + +* paresse-old.sty +* paresse-utf8.sty +* paresse.sty + +### Typeset documents + +The output files (PDF, essentially) from typesetting the various source, demo, +etc., package files. + +* paresse.pdf + + +## TDS manifest + +The following groups list the files included in the TeX Directory Structure used to install +the package into a TeX distribution. + + +## CTAN manifest + +The following group lists the files included in the CTAN package. diff --git a/Master/texmf-dist/doc/latex/paresse/README.md b/Master/texmf-dist/doc/latex/paresse/README.md new file mode 100644 index 00000000000..90b918cf8ea --- /dev/null +++ b/Master/texmf-dist/doc/latex/paresse/README.md @@ -0,0 +1,34 @@ +<!-- Time-stamp: <2020-10-06 14:12:38 administrateur> --> +<!-- Création : 2020-10-06T14:12:21+0200 --> + +# paresse + +Author: Yvon Henel, aka Le TeXnicien de surface +([contact](le.texnicien.de.surface@yvon-henel.fr)) + +## LICENCE + +This material is subject to the LaTeX Project Public License. +See http://www.ctan.org/license/lppl1.3c +for the details of that license. + +© 2020 Yvon Henel (Le TeXnicien de surface) + +## Description of the Package + +This package provides a means of typing “easily” greek letters +with the least possible effort ;) It takes care only of the +letters which have a macro name as `\alpha` or `\Omega`. + + +## History + +* Version 5.0 — 2020-10-06 + * doesn't use package <kbd>skeyval</kbd> anymore; + * use <kbd>l3keys</kbd> for managing keys; + * two *sub-packages* <kbd>paresse-old</kbd> and <kbd>paresse-utf8</kbd>; + * partial usage of <kbd>expl3</kbd>. + +* Version 4.1 — 2013-02-16 + + diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-en.pdf b/Master/texmf-dist/doc/latex/paresse/paresse-en.pdf Binary files differdeleted file mode 100644 index 707e4cf90b9..00000000000 --- a/Master/texmf-dist/doc/latex/paresse/paresse-en.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-eng.pdf b/Master/texmf-dist/doc/latex/paresse/paresse-eng.pdf Binary files differnew file mode 100644 index 00000000000..db9bc651689 --- /dev/null +++ b/Master/texmf-dist/doc/latex/paresse/paresse-eng.pdf diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-eng.tex b/Master/texmf-dist/doc/latex/paresse/paresse-eng.tex new file mode 100644 index 00000000000..94f326acf58 --- /dev/null +++ b/Master/texmf-dist/doc/latex/paresse/paresse-eng.tex @@ -0,0 +1,407 @@ +%% +%% This is file `paresse-eng.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% paresse.dtx (with options: `doc,ENG') +%% +%% Do not distribute this file without also distributing the +%% source files specified above. +%% +%% Do not distribute a modified version of this file. +%% +%% File: paresse.dtx +%% Copyright (C) 2020 Yvon Henel aka Le TeXnicien de surface +%% +%% It may be distributed and/or modified under the conditions of the +%% LaTeX Project Public License (LPPL), either version 1.3c of this +%% license or (at your option) any later version. The latest version +%% of this license is in the file +%% +%% http://www.latex-project.org/lppl.txt +%% +\RequirePackage{expl3}[2020/09/24] +\GetIdInfo$Id: paresse.dtx 5.0 2020-10-06 TdS $ + {} +\documentclass[full, english]{l3doc} +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\usepackage[french,main=english]{babel} +\usepackage{xparse} +\usepackage{xspace} + +\usepackage[tame]{paresse}[2020-10-06] + +\newcommand*\PS{\texttt{\S}\xspace} +\newcommand*\PSVerb[1]{\texttt{\S #1}} +\newcommand\BOP{\discretionary{}{}{}} +\newcommand\Option[1]{\textsc{#1}} +\newcommand{\TO}{\textemdash\ \ignorespaces} +\newcommand{\TF}{\unskip\ \textemdash\xspace} + +\begin{document} +\title{\pkg{paresse} user guide\thanks{This file describes + version~\ExplFileVersion, last revised~\ExplFileDate. \emph{Adieu to + skeyval} edition.}} +\author{Yvon Henel\thanks{E-mail: + \href{mailto:le.texnicien.de.surface@yvon-henel.fr} + {le.texnicien.de.surface@yvon-henel.fr}}} +\maketitle +\noindent\hrulefill + +\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 \PS activated and redefined. Instead of |\(\alpha\)| one + types \PSVerb{a} to obtain \(\alpha\). + + \textbf{Important}: You have to load it \textbf{after} the \pkg{inputenc} + package if the latter is used. Moreover the sign \PS must be a letter for + \TeX. + + Since version~4, one can use this package even with utf8-encoded source for + \hologo{LaTeX}, \hologo{LuaLaTeX}, or \hologo{XeLaTeX}. +\end{abstract} + +\noindent\hrulefill + + \begin{otherlanguage}{french} +\begin{abstract} +La documentation française pour l'utilisateur de l'extension +\pkg{paresse} est disponible sous le nom de \texttt{paresse-fra}. +\end{abstract} +\end{otherlanguage} + +\noindent\hrulefill +\vspace{\baselineskip} + +\tableofcontents{} + + +\section{Introduction} +\label{sec: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 § +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 § 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{} + +\subsection{Why a 5th Version?} + +I was happily using \pkg{paresse} almost every day until when, some days ago, +all hell broke loose! I was insulted just by loading \pkg{paresse}. To put it in +a nutshell: the culprit is an improvement of the \LaTeXe{} kernel which wreaks +havoc in the highly unconventional code of \pkg{skeyval}. As it seems very +improbable that that package will be corrected any time soon, I've decided to +rewrite some parts of \pkg{paresse} with expl3. + +So that is why I touch the more than seven-year-old code of this package. + +With this 5th version come two \emph{sub}-packages: \pkg{paresse-old} and +\pkg{paresse-utf8} which are directly loadable. They have the same options and +commands as \pkg{paresse} itself. In fact \pkg{paresse} loads one of them +according to the situation. + +One will use \pkg{paresse-utf8} if and only if the source is utf-8 encoded and +compiled with \texttt{latex} i.~e. with the \TeX-engine and the \LaTeX{} +format. In all other case, on will use \pkg{paresse-old}. + +The documentation of \pkg{paresse} covers the use of the three packages. + +\subsection{Why a 4th Version?} + +I don't remember exactly on what occasion \TO age, disk crash and computer +mishap aiding\TF and even less when \TO more than a year ago, I'm +afraid\footnote{I wrote this section in 2013 when the 4th version was + published.}\TF Christian \textsc{Tellechea} wrote me that he would be +glad to use \pkg{paresse} in his utf-8 encoded sources with \hologo{LaTeX} +\TO not with \hologo{XeLaTeX} nor \hologo{LuaLaTeX}. + +We exchanged emails, Christian sent me working material. He even made +me the gift of two versions, the second better for the identification +of the encoding passed, as an option, to \pkg{inputenc}. However I +procrastinated. My personal life and my job may have interfered with +the development of this package. + +At last, here is the thing. + +The newest feature should escape the user of \hologo{LuaLaTeX} +or \hologo{XeLaTeX} and even of \hologo{LaTeX} loading \pkg{inputenc} +with an option such as \texttt{latin1} or \texttt{latin9}. However, +henceforth, one can use this package with \hologo{LaTeX} loading +\pkg{inputenc} with option \texttt{utf8}. + +I take advantage of this new version to add a \PS-macro: +\PSVerb{Z} which produces \S, symbol already available with +|\S|, so I don't dare to present it as a real ``shortcut''. + +\subsection{Why a 3rd Version?} + +With a mail 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 \pkg{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\footnote{Macros \emph{à la mode} + \LaTeXe{}. As of version~5.0, partially \emph{translated} in expl3, when + dealing with expl3 commands and variables I use the prefix + \texttt{paresse}.} 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}|. +When one uses \hologo{LaTeX} with an 8-bit encoded source +(e.g. \texttt{latin9}), one must load \pkg{paresse} \textbf{after} the +package \pkg{inputenc} whith the correct option. + +In all cases the sign § must be recognised as a letter by \TeX. + + +One will obtain the same behaviour, but for the exception pointed out in +paragraph \textbf{restriction} on page~\pageref{restriction}, with +\pkg{inputenc} and option \texttt{utf8}. + +There is no such restriction when one compiles with \hologo{LuaLaTeX} +or \hologo{XeLaTeX} a source encoded in utf-8. + +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 \Option{tame} by writing |\usepackage[tame]|\BOP|{paresse}|. One +must then use the command \cs{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 \cs{alpha}, see the +tables~\ref{codageorig} and~\ref{codagelevi}. One obtains +\(\alpha^{\beta}\) with |\(§a^{§b}\)| when § is active. + +\paragraph{Restriction} +One will note that the curly braces are \emph{not} compulsory and that +one obtains the same result with just |\(§a^§b\)| \textbf{unless} one +uses a utf-8 encoded source with \hologo{LaTeX}.\label{restriction} + +\section{The Package Options} +\label{sec:keys} + + + +\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 §-macros. + +\item \Option{Levi} \DescribeOption{legacy / Levi} is the + contrary of \Option{legacy} which is the default. With + \Option{legacy} one uses the original encoding of + \pkg{paresse} 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 |§t| gives \(\theta\) in the contrary |§t| gives + \(\tau\). In all cases, \(\theta\) is given by |§v| and \(\tau\) by + |§y|. That option is ineffective when one has chosen + \Option{Levi}. + +\textbf{Remark:} when one has chosen the option +\Option{legacy}, \(\Theta\) is `regularly' obtained with |§V| and +\emph{also} with |§T| whatever is the chosen option. In the case of +the option \Option{Levi}, |§V| 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}, |§e| gives \(\epsilon\) otherwise |§e| 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}. 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' §. 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|. + +This macro is inactivated when one uses a utf-8 encoding with +\hologo{LaTeX}. In such a case it wouldn't have a clear meaning. When +used it issues a warning in the |.log| file. + +\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 tables~\ref{codageorig} +and~\ref{codagelevi}. + +\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} is loaded whith the option \texttt{tame}. + +\newpage{} + +\subsection{Tables of the Macros} + +\subsubsection{\pkg{paresse}'s Original Encoding} + +This is the active encoding when one choses the options \Option{legacy} and +\Option{ttheta} which are the default. + +This version~5.0 adds \(\varsigma\) obtained with \PSVerb{j}. + +\begin{center}\Large +\begin{ParesseActive} \label{codageorig} +\begin{tabular}{*4{||>{\ttfamily \S}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 & Z & §Z\\ \hline +\end{tabular} +\end{ParesseActive} +\end{center} + +\vspace{2\baselineskip} + +\begin{center}\Large +\begin{ParesseActive} \label{codageorig} +\begin{tabular}{*7{||>{\ttfamily \S}c|c}||}\hline +a&§a&b&§b&c&§c&d&§d&e&§e&f&§f\\ \hline +g&§g&h&§h&i&§i&j&§j&k&§k&l&§l\\ \hline +m&§m&n&§n&o& &p&§p&q&§q&r&§r\\ \hline +s&§s&t&§t&u&§u&v&§v&w&§w&x&§x\\ \hline +y&§y&z&§z&A& &B& &C& &D&§D\\ \hline +E& &F&§F&G&§G&H& &I& &J& \\ \hline +K& &L&§L&M& &N& &O& &P&§P\\ \hline +Q&§Q&R& &S&§S&T&§T&U&§U&V&§V\\ \hline +W&§W&X&§X&Y& &Z&§Z&\multicolumn{4}{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. + +\pagebreak[4] + +\subsubsection{Sylvio \textsc{Levi}'s Encoding} + +One make this encoding active with the option \Option{Levi}. + +\begin{center}\Large +\begin{ParesseActive} \label{codagelevi} +\begin{tabular}{*4{||>{\ttfamily \S}c|c}||}\hline +a & §a & b & §b & g & §g & d & §d\\ \hline +e & §e & z & §z & h & §h & j & §v\\ \hline +i & §i & k & §k & l & §l & m & §m\\ \hline +n & §n & x & §x & p & §p & r & §r\\ \hline +s & §s & t & §y & u & §u & f & §f\\ \hline +q & §c & y & §q & w & §w & c & \(\varsigma\)\\ \hline\hline +G & §G & D & §D & J & §V & L & §L\\ \hline +X & §X & P & §P & S & §S & U & §U\\ \hline +F & §F & Y & §Q & W & §W & Z & §Z\\ \hline +\end{tabular} +\end{ParesseActive} +\end{center} + +Sylvio \textsc{Levi}'s encoding gives a direct acces to \cs{varsigma} +(\(\varsigma\)) with |§c| and is different from the original encoding +just for the letters {\ActiveLaParesse §v, §y, §c et §q}. 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 +& §v & §y & §c & §q & §V & §Q & \(\varsigma\)\\\hline +original encoding +&\CT{\S{}v/\S{}t}&\CT{\S{}y/\S{}t}&\CT{\S{}c} +&\CT{\S{}q}&\CT{\S{}V/\S{}T}&\CT{\S{}Q}& \CT{\S{}j} \\\hline +S. \textsc{Levi}'s encoding +&\CT{\S{}j}&\CT{\S{}t}&\CT{\S{}q}&\CT{\S{}y} +&\CT{\S{}J}&\CT{\S{}Y} & \CT{\S{}c}\\\hline +\end{tabular} +\end{ParesseActive} +\end{center} + +\vspace{\stretch{2}} + +\begin{thebibliography}{99} +\addcontentsline{toc}{section}{Bibliographie} +\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} + +\vspace{\stretch{2}} + +\noindent\hspace*{0.2\textwidth}\hrulefill\hspace*{0.2\textwidth} +\begin{center} + \textsl{Le TeXnicien de Surface scripsit.} +\end{center} +\noindent\hspace*{0.2\textwidth}\hrulefill\hspace*{0.2\textwidth} + +\vspace*{\stretch{2}} + +\end{document} +\endinput +%% +%% End of file `paresse-eng.tex'. diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-ex-en.pdf b/Master/texmf-dist/doc/latex/paresse/paresse-ex-en.pdf Binary files differdeleted file mode 100644 index 01364d627ed..00000000000 --- a/Master/texmf-dist/doc/latex/paresse/paresse-ex-en.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-ex-fr.pdf b/Master/texmf-dist/doc/latex/paresse/paresse-ex-fr.pdf Binary files differdeleted file mode 100644 index e0af60738eb..00000000000 --- a/Master/texmf-dist/doc/latex/paresse/paresse-ex-fr.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-fr.pdf b/Master/texmf-dist/doc/latex/paresse/paresse-fr.pdf Binary files differdeleted file mode 100644 index b2444884bd7..00000000000 --- a/Master/texmf-dist/doc/latex/paresse/paresse-fr.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-fra.pdf b/Master/texmf-dist/doc/latex/paresse/paresse-fra.pdf Binary files differnew file mode 100644 index 00000000000..b43c4ce8eba --- /dev/null +++ b/Master/texmf-dist/doc/latex/paresse/paresse-fra.pdf diff --git a/Master/texmf-dist/doc/latex/paresse/paresse-fra.tex b/Master/texmf-dist/doc/latex/paresse/paresse-fra.tex new file mode 100644 index 00000000000..cb9cbea48ef --- /dev/null +++ b/Master/texmf-dist/doc/latex/paresse/paresse-fra.tex @@ -0,0 +1,421 @@ +%% +%% This is file `paresse-fra.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% paresse.dtx (with options: `doc,FRA') +%% +%% Do not distribute this file without also distributing the +%% source files specified above. +%% +%% Do not distribute a modified version of this file. +%% +%% File: paresse.dtx +%% Copyright (C) 2020 Yvon Henel aka Le TeXnicien de surface +%% +%% It may be distributed and/or modified under the conditions of the +%% LaTeX Project Public License (LPPL), either version 1.3c of this +%% license or (at your option) any later version. The latest version +%% of this license is in the file +%% +%% http://www.latex-project.org/lppl.txt +%% +\RequirePackage{expl3}[2020/09/24] +\GetIdInfo$Id: paresse.dtx 5.0 2020-10-06 TdS $ + {} +\documentclass[full, french]{l3doc} +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\usepackage[english,main=french]{babel} +\usepackage{xparse} +\usepackage{xspace} + +\usepackage[tame]{paresse}[2020-10-06] + +\newcommand*\PS{\texttt{\S}\xspace} +\newcommand*\PSVerb[1]{\texttt{\S #1}} +\newcommand\BOP{\discretionary{}{}{}} +\newcommand\Option[1]{\textsc{#1}} +\newcommand{\TO}{\textemdash\ \ignorespaces} +\newcommand{\TF}{\unskip\ \textemdash\xspace} + +\begin{document} +\title{Guide de l'utilisateur de \pkg{paresse}\thanks{Ce fichier décrit la + version~\ExplFileVersion, dernière révision~\ExplFileDate. Édition + \emph{Adieu à skeyval}.}} +\author{Yvon Henel\thanks{E-mail: + \href{mailto:le.texnicien.de.surface@yvon-henel.fr} + {le.texnicien.de.surface@yvon-henel.fr}}} +\maketitle +\noindent\hrulefill + +\begin{abstract} + Cette extension, 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 \PS actif et redéfini. Au lieu de |\(\alpha\)| ou tape + \PSVerb{a} pour obtenir \(\alpha\). + + \textbf{Important} : Il doit être chargé \textbf{après} \pkg{inputenc} si ce + dernier est utilisé. De plus, il faut que le signe \PS soit une lettre pour + \TeX. + + Depuis la version~4, on peut utiliser cette extension même dans un source + codé en utf-8 avec \hologo{LaTeX}, \hologo{LuaLaTeX} ou \hologo{XeLaTeX}. +\end{abstract} + +\noindent\hrulefill + + \begin{otherlanguage}{english} +\begin{abstract} +The English documentation for the final user of the package +\pkg{paresse} is available in the file \texttt{paresse-eng}. +\end{abstract} +\end{otherlanguage} + +\noindent\hrulefill +\vspace{\baselineskip} + +\tableofcontents{} + +\section{Introduction} +\label{sec:introduction} + +Cette extension ne fournit qu'un accès \og rapide et économique \fg aux lettres +grecques qui s'obtiennent à l'aide d'une macro comme \cs{alpha} ou +\cs{Omega}. Elle fournit un environnement et une commande qui permettent +d'utiliser § pour taper ces lettres. Un \cs{ensuremath} nous dispense de nous +placer explicitement \TO c'est-à-dire en tapant |$ $| ou bien |\( \)| ou encore +|\[ \]| ou tout autre chose ayant le même effet\TF en mode mathématique pour +obtenir une lettre grecque. + + +L'idée de la méthode est due à T.~\textsc{Lachand-Robert} et est +exposée dans~\cite{tlachand}. Je n'ai fait qu'ajouter le +\cs{ensuremath} bien agréable pour l'écriture de macros. + +Bien entendu, on \textbf{ne} dispose \textbf{pas} de macros pour la +minuscule omicron ni pour les majuscules alpha, beta\dots{} qui +s'obtiennent à l'aide des latines romaines de même +apparence\footnote{Je ne ferai aucune remarque sur les problèmes de + codage que cela pose.}. Je ne me suis pas senti le courage ni la +force de fournir une solution qui permettent d'obtenir dans une +formule baignant dans un texte en italique gras un alpha majuscule +droit, romain, \&c. + +Pour finir cette introduction, glosons le nom de cette +extension. |paresse| vient de ce que le signe § indique un \og +paragraphe \fg en ayant une forme lointainement apparentée au +S et n'a donc aucun lien avec le \emph{défaut} si fréquent, +encore que, à bien y réfléchir\dots + +\subsection{Pourquoi une 5\ieme version?} + +\emph{Sur mon brin de laurier, je dormais comme un loir} en utilisant +\pkg{paresse} presque quotidiennement quand il y a quelques jours, patatras! +Plus rien ne va, je me fais insulter rien qu'à charger l'extension. Je passe sur +les détails: la faute en revient à une modification du noyau qui vient perturber +le code acrobatique de \pkg{skeyval}. Comme la mise à jour de la dite extension +semble extrèmement improbable, j'ai décidé de réparer \pkg{paresse} en recourant +aux commandes de expl3. + +Ce n'est donc que pour remettre en marche ce dont je me sers souvent que je +viens soulever le capot de cette extension vieille de plus de 7~ans. + +Avec cette 5\ieme version, apparaissent deux \emph{sous}-extensions: +\pkg{paresse-old} et \pkg{paresse-utf8} que l'on peut charger directement et qui +offrent les mêmes options et les mêmes commandes. De fait, \pkg{paresse} charge +l'une ou l'autre suivant la situation. + +On utilisera \pkg{paresse-utf8} uniquement si le source est codé en utf-8 et que +l'on compile avec \texttt{latex} c.-à-d. avec le moteur \TeX{} et le format +\LaTeX{}. Dans tous les autres cas de figure on utilisera \pkg{paresse-old}. + +La documentation de \pkg{paresse} couvre donc l'utilisation des trois +extensions. + +\subsection{Pourquoi une 4\ieme version?} + +Je ne sais plus bien à quelle occasion \TO l'age et les pannes de machine +avec \og crachage\fg de disque aidant\TF et encore moins quand \TO si ce +n'est que cela remonte à plus d'un an maintenant\footnote{J'ai écrit cette + section à l'occasion de la sortie de la 4\ieme version, en 2013.}\TF +Christian \textsc{Tellechea} me faisait part de son désir d'utiliser +\pkg{paresse} avec des sources codées en utf-8 sous \hologo{LaTeX} \TO et +non \hologo{XeLaTeX} ou \hologo{LuaLaTeX}. + +Une discussion s'engagea, Christian me fit parvenir du matériel en +ordre de marche. Il me fit même cadeau de deux versions, la deuxième +améliorant la reconnaissance du codage déclaré avec +\pkg{inputenc}. Toutefois, je procrastinais. Il se peut que ma vie +personnelle et mon travail aient interféré avec le développement de +cette extension. + +Enfin, voici la chose. + +Le plus nouveau devrait échapper à l'utilisateur de \hologo{LuaLaTeX} +ou \hologo{XeLaTeX} et même de \hologo{LaTeX} chargeant \pkg{inputenc} +avec une option comme \texttt{latin1} ou \texttt{latin9}. Cependant, +désormais, on peut utiliser cette extension avec \hologo{LaTeX} en +chargeant \pkg{inputenc} avec l'option \texttt{utf8}. + +J'ai profité de cette nouvelle version pour ajouter une macro en \PS: +\PSVerb{Z} qui produit \S, symbole déjà accessible par |\S|, ce qui +fait que je n'ose pas vraiment parler de \og raccourci\fg. + +\subsection{Pourquoi une 3\ieme version?} + +C'est par courriel que Claudio \textsc{Beccari} m'a signalé très +aimablement qu'il existait un codage de l'alphabet grec en lettres +latines près de 15~ans avant que je ne commette cette extension. Ce +codage était dû à Sylvio \textsc{Levi} qui l'avait mis au point, alors +qu'il dessinait les premières fontes grecques pour \TeX, en s'appuyant +sur la correspondance entre les claviers américain et grec. Il me +faisait remarquer à juste titre que si quelqu'un avait pris l'habitude +du codage de Sylvio \textsc{Levi}, il préférerait conserver ses +habitudes pour \pkg{paresse}. + +J'ai donc décidé de fournir un nouveau couple d'options exclusives +l'une de l'autre que j'ai nommées, pour l'une, \Option{legacy} --- +pour \og héritage\fg --- qui assure le codage originel de cette +extension et qui est active par défaut et, pour l'autre, \Option{Levi} +qui assure le codage de Sylvio \textsc{Levi}. + +J'en profite pour faire quelques changements cosmétiques: +désormais toutes les macros internes \emph{secrètes}\footnote{À la mode + \LaTeXe{}, pour la version~5.0 j'utilise en partie expl3 et, dans ce cas, + le préfixe \texttt{paresse}.} ont un nom qui +commence par \cs{GA@}; +le fichier |.dtx| est réorganisé pour faciliter la tache de +traduction de la documentation. + +\section{Utilisation} + +On charge cette extension avec |\usepackage{paresse}|. Quand on utilise +\hologo{LaTeX} avec un codage 8-bits (comme \texttt{latin9} par exemple), +on la charge \textbf{après} l'extension \pkg{inputenc} avec l'option +idoine. Avec un \hologo{LaTeX} moderne \TO post 2019\TF et un source codé +en utf-8, on n'a pas besoin de charger explicitement \pkg{inputenc}. Dans +ce cas, \pkg{paresse} suppose que le source est codé en utf-8. + +Dans tous les cas il faut que le \og caractère \fg § soit reconnu par \TeX\ +comme une lettre. + + +On obtiendra le même comportement, à l'exception \TO signalée dans le +paragraphe intitulé \textbf{restriction} page~\pageref{restriction}\TF +près, avec \pkg{inputenc} et l'option \texttt{utf8}. + +Il n'y a pas ce genre de restriction quand on travaille avec +\hologo{LuaLaTeX} ou \hologo{XeLaTeX} sur un source codé en utf-8. + +Par défaut, l'extension est chargée avec l'option |wild| ce qui +signifie que les macros de la forme |§a| sont disponibles. Si l'on +préfère, on peut passer à \pkg{paresse} l'option \Option{tame} avec +|\usepackage[tame]|\BOP|{paresse}|. Il faut alors utiliser la commande +\cs{ActiveLaParesse} ou l'environnement |ParesseActive| pour utiliser +les macros en~§. + +Lorsque la \og paresse est active \fg, il suffit de taper |§a| pour +obtenir \(\alpha\). On a de même accès à toutes les lettres grecques +auxquelles sont consacrées une macro comme \cs{alpha}, +voyez~\ref{codageorig} et~\ref{codagelevi}. On obtient, de même, +\(\alpha^{\beta}\) avec |\(§a^{§b}\)| lorsque § est active. + +\paragraph{Restriction} +On notera que les accolades sont optionelles et qu'on obtient un +résultat identique avec |\(§a^§b\)|, \textbf{à moins que} l'on utilise +un source codé en utf-8 avec \hologo{LaTeX}.\label{restriction} + + +\section{Les options de l'extension} +\label{sec:clefs} + + +\begin{itemize} +\item \Option{tame} \DescribeOption{tame / wild} s'oppose à + \Option{wild} qui est l'option par défaut. Lorsque \Option{tame} + règne, il \textbf{faut} un environnement |ParesseActive| ou une + commande \cs{ActiveLaParesse} pour utiliser les macros à §. + +\item \Option{Levi} \DescribeOption{legacy / Levi} s'oppose à + \Option{legacy} qui est l'option par défaut. Avec l'option + \Option{legacy} on utilise le codage \og originel\fg de + \pkg{paresse} tel que le donne la + table~\ref{codageorig}. Sinon, le codage est celui défini par Sylvio + \textsc{Levi}, cf. la table~\ref{codagelevi}. + +\item \Option{ttau} \DescribeOption{ttau / ttheta} s'oppose à + \Option{ttheta} qui est l'option par défaut. Lorsque \Option{ttheta} + est active |§t| donne \(\theta\) dans le cas contraire |§t| donne + \(\tau\). En tous cas, \(\theta\) est accessible par |§v| et + \(\tau\) par |§y|. Cette option est inopérante si l'option + \Option{Levi} a été choisie. + + \textbf{Remarque :} quand l'option \Option{legacy} a été choisie, + \(\Theta\) est obtenu par |§V| de manière \og régulière \fg et + \emph{également} par |§T| quelle que soit l'option choisie. Dans + le cas de l'option \Option{Levi}, |§V| ne correspond à aucune lettre + grecque. + +\item \Option{epsilon} \DescribeOption{epsilon / varepsilon} s'oppose à + \Option{varepsilon} qui est l'option par défaut. Avec + \Option{epsilon}, |§e| donne \(\epsilon\) sinon |§e| donne + \(\varepsilon\). + +\item Se comportent comme le couple \Option{epsilon}, + \Option{varepsilon} les couples suivants \Option{theta} et + \Option{vartheta} ; \Option{pi} et \Option{varpi} ; \Option{rho} et + \Option{varrho} ; \Option{sigma} et \Option{varsigma} \og |§s| donne + \(\varsigma\)\fg; \Option{phi} et \Option{varphi}. +\end{itemize} + +Par défaut on a \Option{varepsilon}, \Option{theta}, \Option{pi}, +\Option{rho}, \Option{sigma}, \Option{varphi}, \Option{wild} et +\Option{legacy}. Cela assure que cette version~3, se comporte, +par défaut, comme la précédente. + +\subsection{Commandes et environnement} + +\DescribeMacro{\makeparesseletter} +Cette macro donne au \og caractère \fg § le catcode d'une +lettre. Après cela, on peut se servir de § dans un nom de macro, par +exemple. C'est le pendant de \cs{makeatletter}. + +\DescribeMacro{\makeparesseother} +Cette macro donne au caractère § le catcode \emph{other}. C'est le \og +contraire \fg de la précédente. Cela équivaut au \cs{makeatother}. + +Cette macro est inactive avec un codage utf-8 sous +\hologo{LaTeX}. Elle n'aurait d'ailleurs pas vraiment de sens. Son +utilisation produit un avertissement dans le fichier |.log|. + +\DescribeMacro{\ActiveLaParesse} +Cette macro active le caractère § et permet ainsi d'accéder aux +macros dont le nom commence par § comme |§a|. Pour une liste de ces +macros et leurs significations, voyez les tableaux~\ref{codageorig} +et~\ref{codagelevi}. + +\DescribeEnv{ParesseActive} +Dans cet environnement le caractère § est actif ce qui permet +d'utiliser les macros en §. On utilisera cet environnement si l'on +veut utiliser les macros quand on a chargé l'extension +\pkg{paresse} avec l'option \texttt{tame}. + +\newpage{} + +\subsection{Tableaux des macros} + +\subsubsection{Codage originel de \pkg{paresse}} + +C'est le codage actif lorsque l'on a choisit les options \Option{legacy} et +\Option{ttheta} qui sont des options par défaut. + +Cette version~5.0 ajoute \(\varsigma\) obtenu avec \PSVerb{j}. + +\begin{center}\Large +\begin{ParesseActive} \label{codageorig} +\begin{tabular}{*4{||>{\ttfamily \S}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 & Z & §Z\\ \hline +\end{tabular} +\end{ParesseActive} +\end{center} + +\vspace{2\baselineskip} + +\begin{center}\Large +\begin{ParesseActive} \label{codageorig} +\begin{tabular}{*7{||>{\ttfamily \S}c|c}||}\hline +a&§a&b&§b&c&§c&d&§d&e&§e&f&§f\\ \hline +g&§g&h&§h&i&§i&j&§j&k&§k&l&§l\\ \hline +m&§m&n&§n&o& &p&§p&q&§q&r&§r\\ \hline +s&§s&t&§t&u&§u&v&§v&w&§w&x&§x\\ \hline +y&§y&z&§z&A& &B& &C& &D&§D\\ \hline +E& &F&§F&G&§G&H& &I& &J& \\ \hline +K& &L&§L&M& &N& &O& &P&§P\\ \hline +Q&§Q&R& &S&§S&T&§T&U&§U&V&§V\\ \hline +W&§W&X&§X&Y& &Z&§Z&\multicolumn{4}{c||}{}\\ \hline +\end{tabular} +\end{ParesseActive} +\end{center} + +\paragraph{Remarques : } à l'exception de {\ActiveLaParesse §v, §y, §q et §j} +les lettres utilisées dans les noms des macros sont chargées de vertu +mnémotechniques \texttt{:-)} et les capitales grecques, quand elles différent +des capitales latines, s'obtiennent à l'aide de la majuscule correspondante. + +\pagebreak[4] + +\subsubsection{Codage de Sylvio \textsc{Levi}} + +On active ce codage avec l'option \Option{Levi}. + +\begin{center}\Large +\begin{ParesseActive} \label{codagelevi} +\begin{tabular}{*4{||>{\ttfamily \S}c|c}||}\hline +a & §a & b & §b & g & §g & d & §d\\ \hline +e & §e & z & §z & h & §h & j & §v\\ \hline +i & §i & k & §k & l & §l & m & §m\\ \hline +n & §n & x & §x & p & §p & r & §r\\ \hline +s & §s & t & §y & u & §u & f & §f\\ \hline +q & §c & y & §q & w & §w & c & \(\varsigma\)\\ \hline\hline +G & §G & D & §D & J & §V & L & §L\\ \hline +X & §X & P & §P & S & §S & U & §U\\ \hline +F & §F & Y & §Q & W & §W & Z & §Z\\ \hline +\end{tabular} +\end{ParesseActive} +\end{center} + +Le codage de Sylvio \textsc{Levi} donne accès directement à \cs{varsigma} +(\(\varsigma\)) avec |§c| et ne diffère du codage originel que pour +les lettres {\ActiveLaParesse §v, §y, §c et §q}. Voici un résumé de +ces différences: + +\begin{center} +\newcommand\CT[1]{\multicolumn{1}{c|}{\texttt{#1}}} +\begin{ParesseActive} +\begin{tabular}{|l|*{7}{c|}}\hline +lettres grecques +& §v & §y & §c & §q & §V & §Q & \(\varsigma\)\\\hline +codage originel +&\CT{\S{}v/\S{}t}&\CT{\S{}y/\S{}t}&\CT{\S{}c} +&\CT{\S{}q}&\CT{\S{}V/\S{}T}&\CT{\S{}Q}& \CT{\S{}j} \\\hline +codage de S. \textsc{Levi} +&\CT{\S{}j}&\CT{\S{}t}&\CT{\S{}q}&\CT{\S{}y} +&\CT{\S{}J}&\CT{\S{}Y} & \CT{\S{}c}\\\hline +\end{tabular} +\end{ParesseActive} +\end{center} + +\vspace{\stretch{2}} + +\begin{thebibliography}{99} +\addcontentsline{toc}{section}{Bibliographie} +\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} + +\vspace{\stretch{2}} + +\noindent\hspace*{0.2\textwidth}\hrulefill\hspace*{0.2\textwidth} +\begin{center} + \textsl{Le TeXnicien de Surface scripsit.} +\end{center} +\noindent\hspace*{0.2\textwidth}\hrulefill\hspace*{0.2\textwidth} + +\vspace*{\stretch{2}} + +\end{document} +\endinput +%% +%% End of file `paresse-fra.tex'. diff --git a/Master/texmf-dist/doc/latex/paresse/paresse.pdf b/Master/texmf-dist/doc/latex/paresse/paresse.pdf Binary files differindex fd9863db904..8ef2eb3e553 100644 --- a/Master/texmf-dist/doc/latex/paresse/paresse.pdf +++ b/Master/texmf-dist/doc/latex/paresse/paresse.pdf |