l3packages (5jun11)

git-svn-id: svn://tug.org/texlive/trunk@23283 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 98 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/l3packages/README b/Master/texmf-dist/doc/latex/l3packages/README
new file mode 100644
index 00000000000..f926499e5d1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/l3packages/README
@@ -0,0 +1,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 ---