summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/l3experimental
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-09-12 21:24:44 +0000
committerKarl Berry <karl@freefriends.org>2015-09-12 21:24:44 +0000
commitd501b4397bbc0f4389add919be80ccfca5b3863e (patch)
tree41af122e914676e41bc048a14128468bdfa83f6d /Master/texmf-dist/doc/latex/l3experimental
parentaf6faae1a8553e2c55f7980152d84d8cf4ac5a96 (diff)
l3 (12sep15)
git-svn-id: svn://tug.org/texlive/trunk@38360 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/l3experimental')
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/README.md128
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/l3sort/l3sort.pdfbin377484 -> 377156 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/l3str/l3flag.pdfbin320310 -> 319977 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/l3str/l3regex.pdfbin456243 -> 455921 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-convert.pdfbin448576 -> 448216 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-expl.pdfbin415603 -> 415277 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-format.pdfbin379605 -> 379605 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-analysis.pdfbin352835 -> 352835 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-build.pdfbin385138 -> 385138 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/xcoffins/xcoffins.pdfbin395295 -> 395295 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/xgalley/l3galley.pdfbin397508 -> 397180 bytes
-rw-r--r--Master/texmf-dist/doc/latex/l3experimental/xgalley/xgalley.pdfbin291807 -> 291807 bytes
12 files changed, 78 insertions, 50 deletions
diff --git a/Master/texmf-dist/doc/latex/l3experimental/README.md b/Master/texmf-dist/doc/latex/l3experimental/README.md
index 3e2caa7eb4e..e843f68e93d 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/README.md
+++ b/Master/texmf-dist/doc/latex/l3experimental/README.md
@@ -1,24 +1,12 @@
+Experimental LaTeX3 Concepts
+============================
- Experimental LaTeX3 High-Level Concepts
- =======================================
+Released 2015/09/11
- 2011/08/14
-
-
-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
+Overview
--------
-The l3experimental packages are a collection of experimental implementations
+The `l3experimental` packages are a collection of experimental implementations
for aspects of the LaTeX3 kernel, dealing with higher-level ideas such as the
Designer 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
@@ -26,45 +14,51 @@ existing kernel. Others go further, and redefine LaTeX2e internals to provide
better methods for managing certain constructs. The packages in the collection
are under active development and the interfaces may change.
+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 `l3experimental`, make sure that `l3kernel` is
+updated at the same time.
+
Currently included in the CTAN release of l3experimental are the following
bundles:
- * l3sort
- * l3str
- * xcoffins
- * xgalley
+ * `l3sort`
+ * `l3str`
+ * `xcoffins`
+ * `xgalley`
-l3sort
-------
+`l3sort`
+--------
-Ordered variables content (in tl, clist or seq variables) may be sorted
-in a flexible manner using the l3sort module. The definition of how to sort
+Ordered variables content (in `tl`, `clist` or `seq` variables) may be sorted
+in a flexible manner using the `l3sort` module. The definition of how to sort
two items is provided by the programmer at the point at which the sort is
carried out. Internally, the sorting algorithm is designed to take advantage
of TeX token registers to allow a high performance and scalable sort.
-l3str
------
+`l3str`
+-------
A 'string' in TeX terms is a token list in which all of the tokens have
category code 12 ('other'), with the exception of spaces which have the
-category code 10 ('space'). The l3str bundle consists of two parts. The
-first is l3str itself. This is a collection of functions to act on strings,
+category code 10 ('space'). The `l3str` bundle consists of two parts. The
+first is `l3str` itself. This is a collection of functions to act on strings,
including for manipulations such as UTF8 mappings in pdfTeX. The second
-part of the bundle is l3regex, a regular expression search-and-replace
-implementation written in TeX primitives. The regex module works on a string
-basis, ignoring category codes.
+part of the bundle is `l3regex`, a regular expression search-and-replace
+implementation written in TeX primitives. The regex module works on token
+lists, and is part of `l3str` (currently) for historical reasons: the team
+anticipate splitting the two in the future.
-xcoffins
---------
+`xcoffins`
+----------
A _coffin_ is a 'box with handles': a data structure which comprises
both a TeX box and associated information to allow controlled typesetting.
-The xcoffins package provides a high-level interface for manipulating
-coffins. This is supported by the lower-level l3coffins package, which
+The `xcoffins` package provides a high-level interface for manipulating
+coffins. This is supported by the lower-level `l3coffins` package, which
provides the data structure.
-xgalley
--------
+`xgalley`
+---------
In LaTeX3 terminology a galley is a rectangular area which receives
text and other material filling it from top. The vertically extend of
@@ -75,29 +69,63 @@ there are ways to control or change its behaviour. The xgalley module
provides a mechanism for filling galleys and controlling the spacing,
hyphenation and justification within them.
-DISCUSSION
+Discussion
----------
Discussion concerning the approach, suggestions for improvements,
-changes, additions, etc. should be addressed to the list LaTeX-L.
+changes, additions, _etc._ should be addressed to the list
+[LaTeX-L](http://news.gmane.org/group/gmane.comp.tex.latex.latex3).
You can subscribe to this list by sending mail to
- listserv@urz.uni-heidelberg.de
+ listserv@urz.uni-heidelberg.de
with the body containing
- subscribe LATEX-L <Your-First-Name> <Your-Second-Name>
+ subscribe LATEX-L <Your-First-Name> <Your-Second-Name>
+
+Issues
+------
+
+The issue tracker for LaTeX3 is currently located at
+
+ https://github.com/latex3/latex3/issues
-BUGS
-----
+Please report specific issues with LaTeX3 code there; more general
+discussion should be directed to the [LaTeX-L list](#Discussion).
-The issue tracker for LaTeX3 bugs is currently located at
+The LaTeX3 Project
+------------------
- https://github.com/latex3/latex3/issues
+Development of LaTeX3 is carried out by
+[The LaTeX3 Project](http://www.latex-project.org/latex3.html). Currently,
+the team members are
-Please report specific issues with LaTeX3 code there. More general
-discussion should be directed to the LaTeX-L lists.
+ * Johannes Braams
+ * David Carlisle
+ * Robin Fairbairns
+ * Morten Høgholm
+ * Bruno Le Floch
+ * Thomas Lotze
+ * Frank Mittelbach
+ * Will Robertson
+ * Chris Rowley
+ * Rainer Schöpf
+ * Joseph Wright
+
+Former members of The LaTeX3 Project team were
+
+ * Michael Downes
+ * Denys Duchier
+ * Alan Jeffrey
+ * Martin Schröder
+
+The development team can be contacted
+by e-mail: <latex-team@latex-project.org>; for general LaTeX3 discussion
+the [LaTeX-L list](#Discussion) should be used.
+
+-----
---- Copyright 1998 -- 2011
- The LaTeX3 Project. All rights reserved ---
+<p>Copyright (C) 1998-2011,2015 The LaTeX3 Project <br />
+<a href="http://latex-project.org/">http://latex-project.org/</a> <br />
+All rights reserved.</p>
diff --git a/Master/texmf-dist/doc/latex/l3experimental/l3sort/l3sort.pdf b/Master/texmf-dist/doc/latex/l3experimental/l3sort/l3sort.pdf
index f9d179aeb54..797da4cae3e 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/l3sort/l3sort.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/l3sort/l3sort.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3flag.pdf b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3flag.pdf
index 61abc223f25..61fd18802fb 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3flag.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3flag.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3regex.pdf b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3regex.pdf
index 1f24dbe24ab..565edcb5068 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3regex.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3regex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-convert.pdf b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-convert.pdf
index 00729108192..c4e96c9ddad 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-convert.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-convert.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-expl.pdf b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-expl.pdf
index 0265abfc56c..52e065fc76d 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-expl.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-expl.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-format.pdf b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-format.pdf
index 279948ceab8..e2a0349fe3e 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-format.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3str-format.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-analysis.pdf b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-analysis.pdf
index 7096c141088..53571442520 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-analysis.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-analysis.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-build.pdf b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-build.pdf
index a99f80bf833..2f2fffe31c4 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-build.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/l3str/l3tl-build.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/xcoffins/xcoffins.pdf b/Master/texmf-dist/doc/latex/l3experimental/xcoffins/xcoffins.pdf
index 88a5daa5b75..abb6fd5860a 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/xcoffins/xcoffins.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/xcoffins/xcoffins.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/xgalley/l3galley.pdf b/Master/texmf-dist/doc/latex/l3experimental/xgalley/l3galley.pdf
index cc26c985823..9e166e0cc15 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/xgalley/l3galley.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/xgalley/l3galley.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/l3experimental/xgalley/xgalley.pdf b/Master/texmf-dist/doc/latex/l3experimental/xgalley/xgalley.pdf
index 3e85609cf51..4c24ea86f43 100644
--- a/Master/texmf-dist/doc/latex/l3experimental/xgalley/xgalley.pdf
+++ b/Master/texmf-dist/doc/latex/l3experimental/xgalley/xgalley.pdf
Binary files differ