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

   Experimental Packages Demonstrating
   Possible LaTeX3 High-Level Concepts
   ====================================

   2009/06/09


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 `xpackages' term is a designation used for proto-type
implementations of new concepts for a LaTeX Designer Interface. Some
work as standalone packages providing new functionality, such as the
packages in xbase; others go deeper and redefine LaTeX internals in
order to provide newer and better methods for managing certain
constructs.

All xpackages require expl3 and, in addition to this, many require
functionality provided by the packages within the xbase bundle.

Currently included in the CTAN release of xpackages are the following
bundles:
    xbase

xbase
-----

The xbase bundle provides the packages xparse and template, and the
support package ldcsetup.

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.

The template package provides an interface for defining generic
functions using a key=val syntax.

The ldcsetup package used to establish prototype LaTeX3 coding conventions,
needed by xparse and xbase, but is now slowly being stripped in favor
of functionality added to expl3.

Files included:
  source: xbase.ins, xparse.dtx, template.dtx, ldcsetup.dtx
  test:   template-test.tex, template-test2.tex, tprestrict-test.tex,
          xparse-test.tex



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
----

If you find a real bug that makes a package stop working you can
report it via the standard LaTeX bug reporting mechanism of the LaTeX
distribution (see bugs.txt there) using the category "Experimental
LaTeX kernel".  However please do *not* use this method for
suggestions / comments / improvements / etc. For this the list LATEX-L
should be used instead.

Also please don't expect these package to work with *any* code that
floats around in the LaTeX2e world. :-)


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