summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/l3packages/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/l3packages/README.md')
-rw-r--r--macros/latex/contrib/l3packages/README.md104
1 files changed, 21 insertions, 83 deletions
diff --git a/macros/latex/contrib/l3packages/README.md b/macros/latex/contrib/l3packages/README.md
index d3ecea7028..2579ee6e96 100644
--- a/macros/latex/contrib/l3packages/README.md
+++ b/macros/latex/contrib/l3packages/README.md
@@ -1,99 +1,37 @@
-LaTeX3 High-Level Concepts
-==========================
+# `l3packages`: Higher-level LaTeX3 Concepts (Deprecated)
-Release 2023-10-10
+Release 2024-02-13
-Overview
---------
+## Overview
-The `l3packages` collection 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 LaTeX 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.
+The `l3packages` collection dealing with higher-level ideas such as the
+Designer Interface, as part of 'LaTeX3' developments. The packages here have
+over time migrated into the LaTeX kernel: the material here is retained to
+support older files.
-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.
+The appropriate LaTeX kernel releases incorporating the ideas from the packages
+here are
-Currently included in the CTAN release of `l3packages` are the following
-bundles:
-* `l3keys2e` (deprecated in favor of updated LaTeX kernel methods)
-* `xfp` (from 2022-06-01 part of the LaTeX format)
-* `xfrac`
-* `xparse` (deprecated in favor of elements move to the LaTeX kernel)
-* `xtemplate`
+- `l3keys2e` 2022-06-01
+- `xfp` 2022-06-01
+- `xparse` 2020-10-01
+- `xtemplate` 2024-06-01
-`l3keys2e` (deprecated)
-----------
+## Issues
-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.
-
-`xfp` (deprecated)
------
-
-The `xfp` package provides a document-level interface for the LaTeX3
-FPU. As such, it is a wrapper around the core `\fp_eval:n` function
-but does not require code syntax. It provides the expandable command
-`\fpeval`, which can be used inside for example `\edef` or contexts
-where TeX requires a number.
-
-From 2022-06-01 release of LaTeX this will be included in the format
-so that the package doesn't need loading any longer.
-
-`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` (deprecated)
--------
-
-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 development of `xparse` moved to the
-[LaTeX2e repository](https://github.com/latex3/latex2e) as `ltcmd`, which is
-preloaded in the LaTeX format, and the code for `xparse` in this repository
-contains only the deprecated argument types `G`, `l`, and `u`.
-
-`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.
-
-
-Issues
-------
-
-The issue tracker for LaTeX3 is currently located
+The issue tracker for LaTeX is currently located
[on GitHub](https://github.com/latex3/latex3/issues).
+## Development team
-The LaTeX Project
-------------------
+This code is developed by [The LaTeX Project](https://latex-project.org).
-Development of LaTeX3 is carried out by
-[The LaTeX Project](https://www.latex-project.org/latex3/).
+## License
-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.
+Released under the LaTeX Project Public License v1.3c or later. See https://www.latex-project.org/lppl.txt
-----
-<p>Copyright (C) 1998-2012,2015-2023 The LaTeX Project <br />
-<a href="http://latex-project.org/">http://latex-project.org/</a> <br />
+<p>Copyright (C) 2024 The LaTeX Project <br />
+<a href="https://latex-project.org/">https://latex-project.org/</a> <br />
All rights reserved.</p>