summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/xpackages
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-11-26 19:24:51 +0000
committerKarl Berry <karl@freefriends.org>2009-11-26 19:24:51 +0000
commit7749142c6b66c1dc668af8960889578eb9a08e0a (patch)
tree7c72d5f4899829f6bb46d603ae6f1b7fa05213e4 /Master/texmf-dist/doc/latex/xpackages
parent5273fcd7dff0684b0cce66c6baa4b32589909357 (diff)
xpackages 1750 (25nov09)
git-svn-id: svn://tug.org/texlive/trunk@16178 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/xpackages')
-rw-r--r--Master/texmf-dist/doc/latex/xpackages/README59
-rw-r--r--Master/texmf-dist/doc/latex/xpackages/xbase/ldcsetup.pdfbin207075 -> 355486 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xpackages/xbase/template.pdfbin361353 -> 542520 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdfbin764909 -> 805759 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xpackages/xbase/xtemplate.pdfbin0 -> 927934 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdfbin419801 -> 427597 bytes
6 files changed, 35 insertions, 24 deletions
diff --git a/Master/texmf-dist/doc/latex/xpackages/README b/Master/texmf-dist/doc/latex/xpackages/README
index ccef2cc6007..571316db1dd 100644
--- a/Master/texmf-dist/doc/latex/xpackages/README
+++ b/Master/texmf-dist/doc/latex/xpackages/README
@@ -1,9 +1,8 @@
- Experimental Packages Demonstrating
- Possible LaTeX3 High-Level Concepts
- ====================================
+ Experimental LaTeX3 High-Level Concepts
+ =======================================
- 2009/06/09
+ 2009/11/25
WHERE TO GET IT
@@ -19,12 +18,13 @@ 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.
+The xpackages are a collection of experimental implementations
+for aspects of the LaTeX3 kernel, dealing with higher-level
+ideas such as the Desginer Interface. Some of them work as stand
+alone packages, providing new functionality, and can be used
+on top of LaTeX2e with no changes to the existing kernel.
+Others go further, and redefine LaTeX2e internals to provide
+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.
@@ -32,30 +32,44 @@ functionality provided by the packages within the xbase bundle.
Currently included in the CTAN release of xpackages are the following
bundles:
xbase
+ xtras
xbase
-----
-The xbase bundle provides the packages xparse and template, and the
-support package ldcsetup.
+The xbase bundle provides mechansims for defining document commands
+(xparse) and design constructions (xtemplate).
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 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.
-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.
+The legacy template and ldcsetup packages are included at the
+present time, but new LaTeX3 code will not use these!
-Files included:
- source: xbase.ins, xparse.dtx, template.dtx, ldcsetup.dtx
- test: template-test.tex, template-test2.tex, tprestrict-test.tex,
- xparse-test.tex
+Source files:
+ - xbase.ins
+ - xparse.dtx
+ - xtemplate.dtx
+xtras
+-----
+
+The xtras bundle provides functionality to bridge between LaTeX2e
+and LaTeX3. It provides add-ons to LaTeX2e to allow other xpackages
+to be used in the LaTeX2e context.
+
+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.
DISCUSSION
@@ -83,9 +97,6 @@ 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 ---
diff --git a/Master/texmf-dist/doc/latex/xpackages/xbase/ldcsetup.pdf b/Master/texmf-dist/doc/latex/xpackages/xbase/ldcsetup.pdf
index 07615093cbe..8419fc46f85 100644
--- a/Master/texmf-dist/doc/latex/xpackages/xbase/ldcsetup.pdf
+++ b/Master/texmf-dist/doc/latex/xpackages/xbase/ldcsetup.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/xpackages/xbase/template.pdf b/Master/texmf-dist/doc/latex/xpackages/xbase/template.pdf
index 4d67cb17a13..4c1585d2b95 100644
--- a/Master/texmf-dist/doc/latex/xpackages/xbase/template.pdf
+++ b/Master/texmf-dist/doc/latex/xpackages/xbase/template.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdf b/Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdf
index 8dd55866da1..e160164393e 100644
--- a/Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdf
+++ b/Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/xpackages/xbase/xtemplate.pdf b/Master/texmf-dist/doc/latex/xpackages/xbase/xtemplate.pdf
new file mode 100644
index 00000000000..559fe9e22c0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/xpackages/xbase/xtemplate.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdf b/Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdf
index 75583163f48..2faa703aa9d 100644
--- a/Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdf
+++ b/Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdf
Binary files differ