summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-09-02 00:04:23 +0000
committerKarl Berry <karl@freefriends.org>2016-09-02 00:04:23 +0000
commit470aa345999d2c666bfc3fac175ffe03dd7ac528 (patch)
tree13ed3193959d4803f14a5e4086bcea05a066bc46 /Master/texmf-dist/doc
parent033a26ed0e42d930f1e3c20a70f7b820235e0257 (diff)
listofitems (1sep16)
git-svn-id: svn://tug.org/texlive/trunk@41971 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/generic/listofitems/README6
-rw-r--r--Master/texmf-dist/doc/generic/listofitems/listofitems-en.pdfbin443430 -> 368032 bytes
-rw-r--r--Master/texmf-dist/doc/generic/listofitems/listofitems-en.tex34
-rw-r--r--Master/texmf-dist/doc/generic/listofitems/listofitems-fr.pdfbin407222 -> 331528 bytes
-rw-r--r--Master/texmf-dist/doc/generic/listofitems/listofitems-fr.tex16
5 files changed, 28 insertions, 28 deletions
diff --git a/Master/texmf-dist/doc/generic/listofitems/README b/Master/texmf-dist/doc/generic/listofitems/README
index 2f274eceb04..b8e7890fd82 100644
--- a/Master/texmf-dist/doc/generic/listofitems/README
+++ b/Master/texmf-dist/doc/generic/listofitems/README
@@ -4,9 +4,9 @@ ___________________________________
listofitems
package
- v1.0
+ v1.1
- 20/08/2016
+ 01/09/2016
___________________________________
Authors : Christian Tellechea, Steven B. Segletes
@@ -27,4 +27,4 @@ dont le s\'eparateur a \'et\'e choisi par l'utilisateur et d'acc\'eder
This package allows one to capture all the items of a list, for which
the parsing character has been selected by the user, and to access any
-of these items with a simple syntax. \ No newline at end of file
+of these items with a simple syntax.
diff --git a/Master/texmf-dist/doc/generic/listofitems/listofitems-en.pdf b/Master/texmf-dist/doc/generic/listofitems/listofitems-en.pdf
index 9fb4af47a80..7e9bd771b39 100644
--- a/Master/texmf-dist/doc/generic/listofitems/listofitems-en.pdf
+++ b/Master/texmf-dist/doc/generic/listofitems/listofitems-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/listofitems/listofitems-en.tex b/Master/texmf-dist/doc/generic/listofitems/listofitems-en.tex
index 0b2d7c5b5b0..765cd29b9a0 100644
--- a/Master/texmf-dist/doc/generic/listofitems/listofitems-en.tex
+++ b/Master/texmf-dist/doc/generic/listofitems/listofitems-en.tex
@@ -4,9 +4,9 @@
\usepackage[utf8]{inputenc}
\usepackage{listofitems,babel,xspace}
\usepackage[bottom]{footmisc}
-\usepackage{libertine}\usepackage[libertine]{newtxmath}
+\usepackage{libertine}\usepackage[italic]{mathastext}
\usepackage[scaled=0.8]{luximono}
-\usepackage[margin=2.84cm]{geometry}
+\usepackage[margin=3cm]{geometry}
\usepackage{fancybox}
\usepackage{xcolor}
\def\listofitems{\textsf{\loiname}\xspace}
@@ -89,12 +89,12 @@
\makeatother
% FOR AMERICAN-ENGLISH VERSION
\usepackage{setspace}
-\setstretch{1.02}
+\setstretch{1.01}
\usepackage{enumitem}
\newcommand\no[1]{number #1}
\let\bsc\textsc
\def\americanloidate{\expandafter\americanloidatei\loidate/}
-\def\americanloidatei#1/#2/#3/{#3 \ifcase #2 \or January\or February\or March\or April\or May\or
+\def\americanloidatei#1/#2/#3/{\number#3\relax\space\ifcase #2 \or January\or February\or March\or April\or May\or
June\or July\or August\or September\or October\or November\or December\fi{} #1}
%\newcommand\flag[1]{\textcolor{red}{#1}}% DIAGNOSTIC FLAG FOR FURTHER TRANSLATION
%\newcommand\cflag[1]{\textcolor{blue}{#1}}% DIAGNOSTIC FLAG FOR FURTHER TRANSLATION
@@ -136,13 +136,10 @@ A component may, in turn, be a list with a parsing delimiter different from
\def\listofitems{\textsf\loiname\xspace}
\section{Preface}
-
-\begin{sloppypar}
This package loads no external packages, must be used with the
- \eTeX{} engine, and must be called in (pdf)(Xe)(lua)\LaTeX{} with
+ \eTeX{} engine, and must be called in (pdf)\hskip0pt(Xe)\hskip0pt(lua)\LaTeX{} with
the invocation
\code|\usepackage{listofitems}|
-\end{sloppypar}
and under (pdf)(Xe)(Lua)\TeX {} by way of
\code|\input listofitems.tex|
@@ -172,12 +169,10 @@ To set ``\verb-/-'' as the \verb|<parse-character>| for a simple list,
for example ``\verb|.|'', and write ``\verb+\setsepchar[.]{/}+''.
\medbreak
-\begin{sloppypar}
It is not possible to select \verb-|- as the \verb|<delimiter>| because it would
conflict with the logical \textbf{OR}, denoted ``\verb-||-'' (see below).
However, one can work around this limitation, at one's own peril, writing
``\verb-\setsepchar{{|}}-''.
-\end{sloppypar}
\paragraph{Read a list}
To read the list of items, the \verb|\readlist<macro-list>{<list>}| should be called.
@@ -222,6 +217,13 @@ Otherwise, a compilation error occurs.
If the index is empty, \verb|\foo[]| produces the complete \verb|<list>|.
+The macro \verb|\foosep| is created. It is used with the syntax
+ \verb|\foosep[<index>]| and allows access to the parse-character that follows the
+ item of rank \verb|<index>|.
+The last parse-character (the one following the last item) is implicitly
+ defined by \listofitems.
+If the \verb|<index>| is empty, \verb|\foosep[]| is empty.
+
\paragraph{Select several possible parsing characters}
To specify several possible separators, use the \textbf{OR} operator,
denoted ``\verb-||-''.
@@ -230,10 +232,10 @@ One can use this feature, for example, to isolate the terms in an
\exemple/\setsepchar{+||-}
\readlist\term{17-8+4-11}
-1) \term[1]\par
-2) \term[2]\par
-3) \term[3]\par
-4) \term[4]/
+1) \term[1] (parse character = \termsep[1])\par
+2) \term[2] (parse character = \termsep[2])\par
+3) \term[3] (parse character = \termsep[3])\par
+4) \term[4] (parse character = \termsep[4])/
\paragraph{Number of items}
If we write \verb|\readlist<macro-list>{<list>}|, then the macro \verb|<macro-list>len|
@@ -277,7 +279,6 @@ For these spaces to be ignored when reading the \verb|<list>|, execute the starr
\showitems\foo|
\paragraph{Managing empty items}
-\begin{sloppypar}
By default, the \listofitems package retains and accounts for empty items.
Thus, in the previous ex\-am\-ple, the 2nd expansion of \verb|\foo[7]| is empty.
For empty items of the list (i.e., those list items defined by two
@@ -286,7 +287,6 @@ For empty items of the list (i.e., those list items defined by two
execute the macro \verb|\ignoreemptyitems| .
To return to the default package behavior, simply execute the macro
\verb|\reademptyitems|.
-\end{sloppypar}
This option can be used alone or in combination with \verb|\readlist*|,
in which case the suppression of extreme (leading/trailing) spaces occurs
@@ -401,7 +401,6 @@ Term 3: \numbers[3] (factors: \numbers[3,1],
\numbers[3,2] and \numbers[3,3])=
\paragraph{Number of list items}
-\begin{sloppypar}
The macro \verb|\listlen<macro-list>[<index>]| requires 2 expansions
in order to
give the number of items in the list specified by the \verb|<index>|.
@@ -411,7 +410,6 @@ The \verb|<depth>| of the \verb|<index>| must be strictly less than that
For the case where the \verb|<index>| is empty,
\verb|\listlen<macro-list>[]|, with 2 expansions, yields the identical result
as \verb|<macro-list>len| with 1 expansion.
-\end{sloppypar}
\exemple|\setsepchar{\\/,/ }
\readlist\baz{1,2 a b,3 c\\4 d e f,5,6\\7,,8, ,9 xy z}
diff --git a/Master/texmf-dist/doc/generic/listofitems/listofitems-fr.pdf b/Master/texmf-dist/doc/generic/listofitems/listofitems-fr.pdf
index 07f1b2307fe..af268df94f7 100644
--- a/Master/texmf-dist/doc/generic/listofitems/listofitems-fr.pdf
+++ b/Master/texmf-dist/doc/generic/listofitems/listofitems-fr.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/listofitems/listofitems-fr.tex b/Master/texmf-dist/doc/generic/listofitems/listofitems-fr.tex
index 43f17933043..375327991f8 100644
--- a/Master/texmf-dist/doc/generic/listofitems/listofitems-fr.tex
+++ b/Master/texmf-dist/doc/generic/listofitems/listofitems-fr.tex
@@ -2,11 +2,11 @@
%
% Fichier compilé avec pdflatex
\documentclass[frenchb,a4paper]{article}
-\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
\usepackage{listofitems,babel,xspace}
\usepackage[bottom]{footmisc}
-\usepackage{libertine}\usepackage[libertine]{newtxmath}
+\usepackage{libertine}\usepackage[italic,frenchmath]{mathastext}
\usepackage[scaled=0.8]{luximono}
\usepackage[margin=3cm]{geometry}
\usepackage{fancybox}
@@ -147,7 +147,7 @@ Si la \verb|<liste>| est contenue dans une macro, alors cette macro est dévelop
\readlist\foo\liste|
\paragraph{Accéder à un élément}
-La macro \verb|\foo| attend un argument numérique \emph{obligatoire} entre crochets, que nous notons $i$ et qui désigne le rang de l'élément auquel on souhaite accéder. Ainsi, \verb|\foo[1]| est\footnote{Il faut 2 développements à \texttt{\textbackslash foo[}$i$\texttt] pour obtenir l'élément \no$i$.} \og\verb|12|\fg. De la même façon, \verb|\foo[4]| est \og\verb|{\bfseries z}|\fg.
+La macro \verb|\foo| attend un argument numérique \emph{obligatoire} entre crochets, que nous notons $i$ et qui désigne le rang de l'élément auquel on souhaite accéder. Ainsi, \verb|\foo[1]| est\footnote{Il faut 2 développements à \texttt{\textbackslash foo[}$i$\texttt] pour obtenir l'élément \no$i$.} \og\verb|12|\fg. De la même façon, \verb|\foo[4]| est \og\verb|{\bfseries z}|\fg.
Le nombre $i$ peut également être négatif auquel cas le comptage se fait à partir de la fin de la liste : $-1$ représente le dernier rang, $-2$ l'avant-dernier, etc. Si le nombre d'éléments est $n$, alors l'argument $-n$ est le premier élément.
\medbreak
@@ -156,15 +156,17 @@ D'une façon générale, si une \verb|<liste>| a une longueur $n$, alors l'index
Si l'index est vide, alors \verb|\foo[]| se développe en la \verb|<liste>| entière.
+La macro \verb|\foosep| est créé. Elle s'utilise avec la syntaxe \verb|\foosep[<index>]| et permet d'accéder au séparateur qui suit l'élément de rang \verb|<index>|. Le dernier séparateur (celui qui suit le dernier élément) est défini par \listofitems. Si l'\verb|<index>| est vide, \verb|\foosep[]| a un développement vide.
+
\paragraph{Choisir plusieurs séparateurs possibles}
Pour spécifier plusieurs séparateurs possibles, il faut utiliser l'opérateur \textbf{OU} noté \og\verb-||-\fg{}. On peut par exemple utiliser cette fonctionnalité pour isoler les termes dans une somme algébrique :
\exemple/\setsepchar{+||-}
\readlist\terme{17-8+4-11}
-1) \terme[1]\par
-2) \terme[2]\par
-3) \terme[3]\par
-4) \terme[4]/
+1) \terme[1] (séparateur = \termesep[1])\par
+2) \terme[2] (séparateur = \termesep[2])\par
+3) \terme[3] (séparateur = \termesep[3])\par
+4) \terme[4] (séparateur = \termesep[4])/
\paragraph{Nombre d'éléments}
Si l'on écrit \verb|\readlist<macroliste>{<liste>}| alors la macro \verb|<macroliste>len| contient\footnote{C'est-à-dire qu'elle est purement développable et se développe en un nombre} le nombre d'éléments de la \verb|<liste>|. Dans l'exemple avec \verb|\foo|, la macro \verb|\foolen| contient \foolen.