summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/xpackages/readme-ctan.txt
blob: ed0886c4358259e2e7e4cc4b6b7adba7e3fd0261 (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

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

   2008/08/03


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

The current version of these packages can be obtained by following the
instructions at <http://www.latex-project.org/code.html>.

OVERVIEW
--------

Currently included in the CTAN release is the following bundle:
  xbase
  
It requires expl3 to be installed.


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 -- 2008
    The LaTeX3 Project.  All rights reserved ---