summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/xargs/README
blob: 3df0eb23b1e5a08d97476bb6d0bf16d3cf71aa6a (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

                               The xargs package

            Defining commands with many optional arguments made easy

               Manuel P\'egouri\'e-Gonnard <mpg@math.jussieu.fr>


Presentation
------------

Defining commands with an optional argument is easy in LaTeXe. There is,
however, two limitations: only one argument can be optional and it must
be the first one. The xargs package provide extended variants of
\newcommand & friends, for which these limitations no longer hold. It
allows to control what happens with many consecutive optional arguments.
It also provide a way of making the definition global.

Some features of xargs are similar to those provided by the experimental
`xparse' package, which also allows more flexible argument syntaxes,
though the approach and syntax are different.  However, xargs is not
experimental, so I hope it can be useful while waiting for a stable
LaTeX3 release.

Contents
--------

xargs.sty:      the package itself
xargs.pdf:      the (English) documentation and documented code
xargs-fr.pdf:   the French documentation

xargs.dtx:      source for both documentations and package

Version info
------------

2007-10-20  v1.0    First release
2008-03-08  v1.09   Added the usedefault and addprefix keys, not
                    documented yet...
2008-03-22  v1.1    Updated the documentation and fixed a bug in
                    \DeclareRobustCommandx, introduced in v1.09.

License
-------

This material is subject to the LaTeX Project Public License. See
http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for the
details of that license.