summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/l3packages/README
blob: f926499e5d123cb5bece29700f6d2f408dbf4622 (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

   LaTeX3 High-Level Concepts
   ==========================

   2011/06/30


WHERE TO GET IT
---------------

The files in this distribution represent a snapshot of selected files
from the Subversion (SVN) repository of the LaTeX3 Project.

To obtain current versions of the files, visit
<http://www.latex-project.org/code.html> which contains further
instructions.

OVERVIEW
--------

The l3packages collection is contains implementations for aspects of the
LaTeX3 kernel, dealing with higher-level ideas such as the Designer
Interface. The packages here are considered broadly stable (The LaTeX3
Project does not expect the interfaces to alter radically). These
packages are build on LaTeX2e conventions at the interface level, and
so may not migrate in the current form to a stand-alone LaTeX3 format.

All of the material in the collection requires the LaTeX3 base layer
package [l3kernel](http://ctan.org/pkg/l3kernel). The two packages must
be installed in matching versions: if you update l3packages, make sure
that l3kernel is updated at the same time.

Currently included in the CTAN release of l3packages are the following
bundles:
 * l3keys2e
 * xfrac
 * xparse
 * xtemplate

l3keys2e
-------- 

The l3keys2e package allows keys defined using l3keys to be used
as package and class options with LaTeX2e. This is tied to the
method the existing kernel uses for processing options, and so it
is likely that a stand-alone LaTeX3 kernel will use a very different
approach.

xfrac
-----

The xfrac package uses the interface defined by xtemplate to provide
flexible split-level fractions _via_ the `\sfrac` macro. This is both a
demonstration of the power of the template concept and also a useful
addition to the available functionality in LaTeX2e.

xparse
-----

The xparse package provides a high-level interface for declaring
document commands, e.g., a uniform way to define commands taking
optional arguments, optional stars (and others), mandatory arguments
and more.

xtemplate
-----

The xtemplate package provides an interface for defining generic
functions using a key=val syntax. This is designed to be 
"self-documenting", with the key definitions providing information
on how they are to be used.

DISCUSSION
----------

Discussion concerning the approach, suggestions for improvements, 
changes, additions, etc. should be addressed to the list LaTeX-L. 

You can subscribe to this list by sending mail to

  listserv@urz.uni-heidelberg.de

with the body containing

  subscribe LATEX-L  <Your-First-Name> <Your-Second-Name>

BUGS
----

The issue tracker for LaTeX3 bugs is currently located at

  https://github.com/latex3/svn-mirror/issues
  
Please report specific issues with LaTeX3 code there. More general
discussion should be directed to the LaTeX-L lists.

--- Copyright 1998 -- 2011
    The LaTeX3 Project.  All rights reserved ---