diff options
author | Karl Berry <karl@freefriends.org> | 2009-11-26 19:24:51 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-11-26 19:24:51 +0000 |
commit | 7749142c6b66c1dc668af8960889578eb9a08e0a (patch) | |
tree | 7c72d5f4899829f6bb46d603ae6f1b7fa05213e4 /Master/texmf-dist/doc/latex | |
parent | 5273fcd7dff0684b0cce66c6baa4b32589909357 (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')
-rw-r--r-- | Master/texmf-dist/doc/latex/xpackages/README | 59 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xpackages/xbase/ldcsetup.pdf | bin | 207075 -> 355486 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xpackages/xbase/template.pdf | bin | 361353 -> 542520 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdf | bin | 764909 -> 805759 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xpackages/xbase/xtemplate.pdf | bin | 0 -> 927934 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdf | bin | 419801 -> 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 Binary files differindex 07615093cbe..8419fc46f85 100644 --- a/Master/texmf-dist/doc/latex/xpackages/xbase/ldcsetup.pdf +++ b/Master/texmf-dist/doc/latex/xpackages/xbase/ldcsetup.pdf diff --git a/Master/texmf-dist/doc/latex/xpackages/xbase/template.pdf b/Master/texmf-dist/doc/latex/xpackages/xbase/template.pdf Binary files differindex 4d67cb17a13..4c1585d2b95 100644 --- a/Master/texmf-dist/doc/latex/xpackages/xbase/template.pdf +++ b/Master/texmf-dist/doc/latex/xpackages/xbase/template.pdf diff --git a/Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdf b/Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdf Binary files differindex 8dd55866da1..e160164393e 100644 --- a/Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdf +++ b/Master/texmf-dist/doc/latex/xpackages/xbase/xparse.pdf diff --git a/Master/texmf-dist/doc/latex/xpackages/xbase/xtemplate.pdf b/Master/texmf-dist/doc/latex/xpackages/xbase/xtemplate.pdf Binary files differnew file mode 100644 index 00000000000..559fe9e22c0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/xpackages/xbase/xtemplate.pdf diff --git a/Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdf b/Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdf Binary files differindex 75583163f48..2faa703aa9d 100644 --- a/Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdf +++ b/Master/texmf-dist/doc/latex/xpackages/xtras/l3keys2e.pdf |