The LaTeX3 Development Repository

Overview

The repository contains development material for LaTeX3. This includesnot only code to be developed into the LaTeX3 kernel, but also a varietyof test, documentation and more experimental material. A great deal ofthe experimental LaTeX3 code can be loaded within LaTeX2e to allowdevelopment and testing to occur.

The following directories contain experimental LaTeX3 code:

• l3kernel: code which is intended to eventually appear in astand-alone LaTeX3 format. Most of this material is alsousable on top of LaTeX2e when loading the expl3 package.
• l3backend: code for backend (driver) level interaces acrossthe expl3 codebase.
• l3packages: code which is written to be used on top ofLaTeX2e to experiment with LaTeX3 concepts. The interfaces to thesehigher-level packages are 'stable'.
• l3experimental: code which is written to be used on top ofLaTeX2e to experiment with LaTeX3 concepts. The interfacesfor these packages are still under active discussion. Parts of this code mayeventually be migrated to l3kernel, while other parts are tied closelyto LaTeX2e and are intended to support mixing LaTeX2e and LaTeX3 concepts.
• l3trial: material which is under very active development, for potentialaddition to l3kernel or l3experimental. Material in this directorymay include potential replacements for existing modules, where large-scalechanges are under-way.
• l3leftovers: code which has been developed in the past by TheLaTeX3 Project but is not suitable for use in its current form.Parts of this code may be used as the basis for new developmentsin l3kernel or l3experimental over time.

Support material for development is found in:

• support, which contains files for the automated test suite which are'local' to the LaTeX3 repository.

Documentation is found in:

• articles: discussion of LaTeX3 concepts by team members forpublication in TUGBoat or elsewhere.

The repository also contains the directory xpackages. Thiscontain code which is being moved (broadly) l3experimental.Over time, xpackages is expected to be removed from the repository.The directory contrib is used to test the interaction of LaTeX3code with selected contributed packages.

Discussion

Discussion concerning the approach, suggestions for improvements,changes, additions, etc. should be addressed to the listLaTeX-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>

Issues

The issue tracker for LaTeX3 is currently locatedon GitHub.

Please report specific issues with LaTeX3 code there; more generaldiscussion should be directed to the LaTeX-L list.

Build status

LaTeX3 uses Travis CI as a hosted continuousintegration service. For each commit, the build status is tested usingthe current release of TeX Live.

Current build status:

Development team

LaTeX3 is developed by The LaTeX Project.

Copyright

This README file is copyright 2021 The LaTeX Project.