summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/xpackages/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/xpackages/README')
-rw-r--r--Master/texmf-dist/doc/latex/xpackages/README91
1 files changed, 91 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/xpackages/README b/Master/texmf-dist/doc/latex/xpackages/README
new file mode 100644
index 00000000000..ccef2cc6007
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xpackages/README
@@ -0,0 +1,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 ---