.github/tl_packages

@@ -0,0 +1,56 @@
+# The test framework itself
+#
+luatex
+#
+# Required to build formats
+#
+latex-bin
+luahbtex
+platex
+uplatex
+tex
+xetex
+# Requirements for the tests
+amsfonts
+etex-pkg
+#
+# Support for typesetting the docs
+#
+alphalph
+atbegshi
+atveryend
+amsmath
+bigintcalc
+bitset
+booktabs
+ec
+colortbl
+csquotes
+enumitem
+etexcmds
+fancyvrb
+gettitlestring
+graphics
+hologo
+hycolor
+iftex
+intcalc
+kvdefinekeys
+kvsetkeys
+l3packages
+letltxmacro
+listings
+ltxcmds
+makeindex
+needspace
+oberdiek
+pdfescape
+pdftexcmds
+psnfss
+refcount
+rerunfilecheck
+hyperref
+titlesec
+tools
+underscore
+uniquecounter

.github/workflows/deploy.yaml

@@ -0,0 +1,54 @@
+name: Create release
+
+# We create releases for all new tags
+on:
+  push:
+    tags:
+      - "*"
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    name: Build release
+    environment: Release
+    steps:
+      # Boilerplate
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      # GitHub Actions don't regenerate the test if the key doesn't change, so
+      # we integrate a random UUID into the key to keep them different.
+      # DO NOT CHANGE THIS
+      - name: Generate unique ID
+        id: get-id
+        run: |
+          echo -n ::set-output name=id::
+          cat /proc/sys/kernel/random/uuid
+      # Actually load the cache. Since we never reuse the key, we need restore-keys
+      # to indicate the prefix of our caches. This loads the newest cache with this
+      # prefix in the key.
+      #
+      # If we want to force regeneration of the cache, increase the number after
+      # *both* instances of "texlive-v"
+      - name: Load cache
+        uses: actions/cache@v2
+        with:
+          path: ~/texlive
+          key: texlive-v0-${{ steps.get-id.outputs.id }}
+          restore-keys: texlive-v0-
+      # We need Ghostscript for XeTeX tests.
+      - run: sudo apt-get install ghostscript
+      - name: Install TeX Live
+        uses: zauguin/install-texlive@v1
+        with:
+          # List the required TeX Live packages in a separate file to allow reuse in
+          # different workflows.
+          package_file: .github/tl_packages
+      - name: Run l3build
+        run: texlua l3build.lua ctan -H --show-log-on-error
+      # Now create the release (this only runs if the previous steps were successful)
+      - name: Create GitHub release
+        uses: ncipollo/release-action@880be3d0a71bc0fa98db60201d2cbdc27324f547
+        id: release
+        with:
+          artifacts: "build/distrib/ctan/*.zip"
+          token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/main.yaml

@@ -0,0 +1,45 @@
+name: Automated testing
+
+on:
+  push:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  l3build:
+    runs-on: ubuntu-latest
+    steps:
+      # Boilerplate
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      # GitHub Actions don't regenerate the test if the key doesn't change, so
+      # we integrate a random UUID into the key to keep them different.
+      # DO NOT CHANGE THIS
+      - name: Generate unique ID
+        id: get-id
+        run: |
+          echo -n ::set-output name=id::
+          cat /proc/sys/kernel/random/uuid
+      # Actually load the cache. Since we never reuse the key, we need restore-keys
+      # to indicate the prefix of our caches. This loads the newest cache with this
+      # prefix in the key.
+      #
+      # If we want to force regeneration of the cache, increase the number after
+      # *both* instances of "texlive-v"
+      - name: Load cache
+        uses: actions/cache@v2
+        with:
+          path: ~/texlive
+          key: texlive-v0-${{ steps.get-id.outputs.id }}
+          restore-keys: texlive-v0-
+      # We need Ghostscript for XeTeX tests.
+      - run: sudo apt-get install ghostscript
+      - name: Install TeX Live
+        uses: zauguin/install-texlive@v1
+        with:
+          # List the required TeX Live packages in a separate file to allow reuse in
+          # different workflows.
+          package_file: .github/tl_packages
+      - name: Run l3build
+        run: texlua l3build.lua ctan -H --show-log-on-error

.gitignore

@@ -1,5 +1,20 @@
-build/
-*.pdf
+build/*
+
 *.zip
-!testfiles/*.pdf
 
+*.pdf
+!*/testfiles/*.pdf
+
+*.*~
+
+*.aux
+*.bbl
+*.glo
+*.gz
+*.hd
+*.idx
+*.ilg
+*.ind
+*.log
+*.out
+*.toc

CHANGELOG.md

@@ -7,6 +7,148 @@ this project uses date-based 'snapshot' version identifiers.
 
 ## [Unreleased]
 
+### Changed
+- Documentation improvements
+
+## [2021-08-28]
+
+### Fixed
+- Creation of zip files on Windows
+- Only match filename and not full path for `exefiles`
+
+## [2021-08-27]
+
+### Added
+- Add the `--show-saves` flag for `l3build check` to generate a list of
+  `l3build save` commands to regenerate all failing tests
+
+### Changed
+- No longer call an external program to generate `zip` files and generate
+  them directly instead. This disables the options `zipexe` and `zipopts`.
+- Copy TDS-style zip files to main dir
+
+## [2021-05-06]
+
+### Fixed
+- Issue when running PDF-based tests
+
+## [2021-05-05]
+
+### Changed
+- Normalise Lua function calls (issue #127) - may require `.tlg` update
+- LuaTeX from TL'21 is no longer 'off by one' in log files - may require
+  `.tlg` update
+
+### Fixed
+- Installation now supports deeper directory levels (issue #182)
+- The `texmfhome` directory is now created before use if required
+- Crash caused by yyyy-mm-dd epoch format
+
+### Removed
+- Support for use as `texlua build.lua <target>`
+
+## [2020-06-04]
+
+### Added
+- Store 'raw' PDF files when testing using PDFs, to allow further checks
+  with e.g. PDF validators
+
+## [2020-03-25]
+
+### Changed
+- Exclude `sourcefiles` entries from file clean-up
+- Adjust defaults for TeX Live 2020 LuaHBTeX usage
+
+## [2020-03-16]
+
+### Changed
+- Suppress PDF compression in DVI route
+- Suppress PDF ID data in DVI route
+- Default to `dvips` for (p)TeX
+- Refinement of `/ID` line suppression
+
+## [2020-03-13]
+
+### Changed
+- Refinement of PDF test normalisation
+
+## [2020-03-12]
+
+### Added
+- Option `ps2pdfopt`
+
+### Changed
+- Normalise `/ID` lines in PDF comparisons
+- Normalise `%%` lines in PDF comparisons
+
+### Fixed
+- Enable `cleandir()` recursively
+- Install files after *all* directory cleaning/creation
+
+## [2020-02-21]
+
+### Changed
+- Avoid temporary file when unpacking
+
+### Deprecated
+- `os_yes`: use `io.popen(...,w)` instead
+
+## [2020-02-17]
+
+### Added
+- Variable `textfiledir`
+- Table `specialtypesetting` and support data
+
+### Changed
+- Documentation improvements
+
+### Fixed
+- When `checkruns` > 1 and `recordstatus=true`, testing code would crash
+  (issue #90)
+
+## [2020-02-03]
+
+### Changed
+- Normalise out DVI header lines
+
+### Fixed
+- Allow announcement field to be empty
+  (with a warning this suppresses the CTAN announcement)
+
+## [2020-01-14]
+
+### Fixed
+
+- Allow for more extracted files from DocStrip
+
+## [2019-11-27]
+
+### Changed
+
+- `\ASSERTSTR` no longer needs e-TeX
+
+### Fixed
+
+- Installation of files using the `--full` switch
+
+## [2019-11-01]
+
+### Added
+
+- New `\ASSERT` and `\ASSERTSTR` functions (issue #102)
+
+### Changed
+
+- Avoid normalisation of (u)pTeX data when this is standard engine
+  (fixes #103)
+- Normalise Lua data references (#107)
+- Extend `runtest_task()` to pass run number
+- Allow `regression-test` to load when e-TeX is unavailable (fixes #105)
+
+### Fixed
+
+- Location of `testsuppdir` when multiple configurations are used
+
 ## [2019-10-02]
 
 ### Added
@@ -368,9 +510,24 @@ this project uses date-based 'snapshot' version identifiers.
 
 ### Removed
 - Rationalise short option names: removed `-d`, `-E`, `-r`
-- Target `cmdcheck`: specific to LaTeX3 kernel work
-
-[Unreleased]: https://github.com/latex3/l3build/compare/2019-10-02...HEAD
+- Target `cmdcheck`: specific to LaTeX kernel work
+
+[Unreleased]: https://github.com/latex3/l3build/compare/2021-08-28...HEAD
+[2021-08-28]: https://github.com/latex3/l3build/compare/2021-08-27...2021-08-28
+[2021-08-27]: https://github.com/latex3/l3build/compare/2021-05-06...2021-08-27
+[2021-05-06]: https://github.com/latex3/l3build/compare/2021-05-05...2021-05-06
+[2021-05-05]: https://github.com/latex3/l3build/compare/2020-06-04...2021-05-05
+[2020-06-04]: https://github.com/latex3/l3build/compare/2020-03-25...2020-06-04
+[2020-03-25]: https://github.com/latex3/l3build/compare/2020-03-16...2020-03-25
+[2020-03-16]: https://github.com/latex3/l3build/compare/2020-03-13...2020-03-16
+[2020-03-13]: https://github.com/latex3/l3build/compare/2020-03-12...2020-03-13
+[2020-03-12]: https://github.com/latex3/l3build/compare/2020-02-21...2020-03-12
+[2020-02-21]: https://github.com/latex3/l3build/compare/2020-02-17...2020-02-21
+[2020-02-17]: https://github.com/latex3/l3build/compare/2020-02-03...2020-02-17
+[2020-02-03]: https://github.com/latex3/l3build/compare/2020-01-14...2020-02-03
+[2020-01-14]: https://github.com/latex3/l3build/compare/2019-11-27...2020-01-14
+[2019-11-27]: https://github.com/latex3/l3build/compare/2019-11-01...2019-11-27
+[2019-11-01]: https://github.com/latex3/l3build/compare/2019-10-02...2019-11-01
 [2019-10-02]: https://github.com/latex3/l3build/compare/2019-09-30...2019-10-02
 [2019-09-30]: https://github.com/latex3/l3build/compare/2019-09-29...2019-09-30
 [2019-09-29]: https://github.com/latex3/l3build/compare/2019-09-28...2019-09-29

CONTRIBUTING.md

@@ -1,5 +1,5 @@
 Thanks for considering contributing to `l3build`: feedback, fixes and ideas are
-all useful. Here, we ([The LaTeX3 Project](https://www.latex-project.org)) have
+all useful. Here, we ([The LaTeX Project](https://www.latex-project.org)) have
 collected together a few pointers to help things along.
 
 ## Bugs