lthooks: new \ShowHook command

.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

.github/pull_request_template.md

@@ -17,4 +17,5 @@
 - [ ] Version and date string updated in changed source files
 - [ ] Relevant `\changes` entries in source included
 - [ ] Relevant `changes.txt` updated
+- [ ] Rollback provided (if necessary)?
 - [ ] `ltnewsX.tex` (and/or `latexchanges.tex`) updated

.github/workflows/deploy.yaml

@@ -16,12 +16,12 @@ jobs:
     steps:
       # Boilerplate
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       # We need Ghostscript for dvips and XeTeX tests.
       - name: Install Ghostscript
         run: sudo apt-get update && sudo apt-get install ghostscript
       - name: Install TeX Live
-        uses: zauguin/install-texlive@v2
+        uses: zauguin/install-texlive@v3
         with:
           # List the required TeX Live packages in a separate file to allow reuse in
           # different workflows.
@@ -47,7 +47,7 @@ jobs:
           retention-days: 3
       # Now create the release (this only runs if the previous steps were successful)
       - name: Create GitHub release
-        uses: ncipollo/release-action@880be3d0a71bc0fa98db60201d2cbdc27324f547
+        uses: ncipollo/release-action@2c591bcc8ecdcd2db72b97d6147f871fcd833ba5
         id: release
         with:
           artifacts: "*.zip"
@@ -57,7 +57,7 @@ jobs:
       - name: Send mail
         # The explicit commit hash ensures that this can't be used by dawidd6 as a
         # backdoor to execute arbitrary code during our runs.
-        uses: dawidd6/action-send-mail@6063705cefe50cb915fc53bb06d4049cae2953b2
+        uses: dawidd6/action-send-mail@4226df7daafa6fc901a43789c49bf7ab309066e7
         with:
           # Currently using my (Marcel's) mail server for sending mails.
           server_address: typesetting.eu
@@ -80,7 +80,7 @@ jobs:
             More information can be found at
             ${{steps.release.outputs.html_url}}
       - name: Send failure notification
-        uses: dawidd6/action-send-mail@6063705cefe50cb915fc53bb06d4049cae2953b2
+        uses: dawidd6/action-send-mail@4226df7daafa6fc901a43789c49bf7ab309066e7
         if: ${{ failure() }}
         with:
           server_address: typesetting.eu

.github/workflows/main.yaml

@@ -22,7 +22,7 @@ jobs:
     steps:
       # Boilerplate
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Install TeX Live
         id: texlive
         uses: zauguin/install-texlive@v3
@@ -122,17 +122,19 @@ jobs:
             config: config-table-pdftex            
           - module: required/latex-lab
             config: config-table-luatex                                    
+          - module: required/latex-lab
+            config: config-title
           - module: required/tools
     name: "Tests: ${{ matrix.module }}${{ matrix.config && format(' - {0}', matrix.config) || ''}}${{ matrix.engine && format(' - {0}', matrix.engine) || ''}}${{ (matrix.first || matrix.last) && format(' ({0} - {1})', matrix.first || '<first>', matrix.last || '<last>') || ''}}"
     needs: texlive-cache
     steps:
       # Boilerplate
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       # We need Ghostscript for dvips and XeTeX tests.
       - run: sudo apt-get update && sudo apt-get install ghostscript
       - name: Restore TeX Live from cache
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ~/texlive
           key: ${{ needs.texlive-cache.outputs.cache_key }}
@@ -148,7 +150,11 @@ jobs:
         if: ${{ always() }}
         uses: zauguin/l3build-failure-artifacts@v1
         with:
-          name: testfiles
+          # example names:
+          # - "testfiles-base-build-pdflatex"
+          # - "testfiles-base-config-1run"
+          # - "testfiles-required/amsmath"
+          name: testfiles-${{ matrix.module }}${{ matrix.config && format('-{0}', matrix.config)  || ''}}${{ matrix.engine && format('-{0}', matrix.engine) || ''}}
           # Decide how long to keep the test output artifact:
           retention-days: 3
   docs:
@@ -168,11 +174,11 @@ jobs:
     steps:
       # Boilerplate
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       # We need Ghostscript for dvips and XeTeX tests.
       - run: sudo apt-get update && sudo apt-get install ghostscript
       - name: Restore TeX Live from cache
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ~/texlive
           key: ${{ needs.texlive-cache.outputs.cache_key }}
@@ -185,9 +191,10 @@ jobs:
         run: l3build doc -q -H --show-log-on-error
       # Now we create the artifacts for the generated documentation
       - name: Archive documentation
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
-          name: Documentation
+          # example names: "Documentation-base-1", "Documentation-requires"
+          name: Documentation-${{ matrix.module }}${{ matrix.environment && format('-{0}', env.LTX_DOC_COMPONENT) || ''}}
           path: "**/*.pdf"
           # Decide how long to keep the test output artifact:
           retention-days: 21
@@ -210,7 +217,7 @@ jobs:
       - name: Send mail
         # The explicit commit hash ensures that this can't be used by dawidd6 as a
         # backdoor to execute arbitrary code during our runs.
-        uses: dawidd6/action-send-mail@6063705cefe50cb915fc53bb06d4049cae2953b2
+        uses: dawidd6/action-send-mail@4226df7daafa6fc901a43789c49bf7ab309066e7
         with:
           # Currently using my (Marcel's) mail server for sending mails.
           server_address: typesetting.eu

.github/workflows/pretest.yaml

@@ -14,7 +14,7 @@ jobs:
     steps:
       # Boilerplate
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Install TeX Live
         id: texlive
         uses: zauguin/install-texlive@v3
@@ -98,18 +98,20 @@ jobs:
             config: config-table-pdftex            
           - module: required/latex-lab
             config: config-table-luatex                        
+          - module: required/latex-lab
+            config: config-title
           - module: required/tools
     name: "Tests: ${{ matrix.module }}${{ matrix.config && format(' - {0}', matrix.config) || ''}}${{ matrix.engine && format(' - {0}', matrix.engine) || ''}}"
     needs: texlive-cache
     continue-on-error: true
     steps:
       # Boilerplate
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       # We need Ghostscript for dvips and XeTeX tests.
       - run: sudo apt-get update && sudo apt-get install ghostscript
       - name: Restore TeX Live from cache
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ~/texlive
           key: ${{ needs.texlive-cache.outputs.cache_key }}
@@ -125,7 +127,11 @@ jobs:
         if: ${{ always() }}
         uses: zauguin/l3build-failure-artifacts@v1
         with:
-          name: testfiles
+          # example names:
+          # - "testfiles-base-build-pdflatex"
+          # - "testfiles-base-config-1run"
+          # - "testfiles-required/amsmath"
+          name: testfiles-${{ matrix.module }}${{ matrix.config && format('-{0}', matrix.config)  || ''}}${{ matrix.engine && format('-{0}', matrix.engine) || ''}}
           # Decide how long to keep the test output artifact:
           retention-days: 3
   docs:
@@ -146,11 +152,11 @@ jobs:
     steps:
       # Boilerplate
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       # We need Ghostscript for dvips and XeTeX tests.
       - run: sudo apt-get update && sudo apt-get install ghostscript
       - name: Restore TeX Live from cache
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: ~/texlive
           key: ${{ needs.texlive-cache.outputs.cache_key }}
@@ -163,9 +169,10 @@ jobs:
         run: l3build doc -q -H --show-log-on-error
       # Now we create the artifacts for the generated documentation
       - name: Archive documentation
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
-          name: Documentation
+          # example names: "Documentation-base-1", "Documentation-requires"
+          name: Documentation-${{ matrix.module }}${{ matrix.environment && format('-{0}', env.LTX_DOC_COMPONENT) || ''}}
           path: "**/*.pdf"
           # Decide how long to keep the test output artifact:
           retention-days: 21

.github/workflows/stale.yaml

@@ -11,7 +11,7 @@ jobs:
   stale:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@v8
+      - uses: actions/stale@v9
         with:
           # Number of days of inactivity before an issue becomes stale
           days-before-stale: 60

.github/workflows/trigger.yaml

@@ -21,7 +21,7 @@ jobs:
       contents: read
     steps:
       - name: Check out code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Clean old caches
         run: |

CONTRIBUTING.md

@@ -55,7 +55,7 @@ Latin Modern fonts in the test files.
 
 ## Layout and interface deficiencies
 
-Upfront we should probably stress that 'deficiencies' in the design of
+Upfront we should probably stress that 'deficiencies' in the design
 of the standard document classes (`article`, `report` and `book`) as
 well a questionable but long established interface behavior of commands
 is something that we will normally not change, even if we can all agree
@@ -75,10 +75,6 @@ regard to this policy.
 
 ## Code contributions
 
-If you want to discuss a possible contribution before (or instead of)
-making a pull request, drop a line to
-[the team](mailto:[email protected]).
-
 The stability of LaTeX is very important and this means that change in
 the kernel is necessarily very conservative. It also means that a lot of
 discussion happens before any changes are made. If you do decide to post
@@ -87,10 +83,24 @@ cannot always integrate them into the kernel.
 
 If you are submitting a pull request, notice that
 
-- The first line of commit messages should be a short summary (up to about
-  50 chars); leave a blank line then give more detail if required
-- We use Travis-CI for (light) testing so add `[ci skip]` to documentation-only
-  commit messages
+- The first line of commit messages should be a short summary (up to about 50
+  chars); leave a blank line then give more detail if required
+- We use GitHub Actions for testing; you can run the test suite locally using
+  `l3build`
 - We favour a single linear history so will rebase accepted pull requests
-- Where a commit fixes or closes an issue, please include this information
-  in the first line of the commit message [`(fixes #X)` or similar]
+- Where a commit fixes or closes an issue, please include this information in
+  the first line of the commit message [`(fixes #X)` or similar]
+- There is a checklist in the [pull request
+  template](.github/pull_request_template.md) for the various bit of admin that
+  are needed: the key points are
+  - Almost all changes should be listed in the relevant `changes.txt` file
+  - The date in the `\ProvidesPackage` (or similar) line should be updated
+    whenever the file changes
+  - The version in the `\ProvidesPackage` (or similar) should be incremented
+    whenever the code changes
+  - The LaTeX sources include `\changes` that are typeset
+  - Almost always, a code change should be accompanied by a matching test file
+  - More significant changes will need an entry in _LaTeX News_
+- Pull requests that are intended for the next major release of LaTeX should be
+  made against `develop`; if you feel the change is urgent and requires a patch
+  level, the pull request should be made against `main`

base/README.md

@@ -1,7 +1,7 @@
 The LaTeX kernel
 ================
 
-Release 2023-11-01 patch level 1
+Release 2024-06-01 pre-release 1
 
 Overview
 --------

base/alltt.dtx

@@ -40,7 +40,7 @@
 %<package>\ProvidesPackage{alltt}
 %<driver>\ProvidesFile{alltt.drv}
 %\ProvidesFile{alltt.dtx}
-              [2021/01/29 v2.0g defines alltt environment]
+              [2024/02/08 v2.0g defines alltt environment]
 %
 %<*driver>
 \documentclass{ltxdoc}
@@ -97,7 +97,7 @@
 %   \end{itemize}
 %
 %    \textbf{NB} When you are using \textsf{OT1} encoded fonts you might
-%    be surprsied when you switch to italics, becuase those fonts have
+%    be surprised when you switch to italics, because those fonts have
 %    a different set of glyphs:
 %    \begin{alltt}
 %  The glyph at the position of the $ in a slanted font: \textsl{$}.

base/build.lua

@@ -26,6 +26,7 @@ installfiles   =
     "*.ltx",
     "*.lua",
     "*.sty",
+    "checkencodingsubset.tex",
     "docstrip.tex",
     "idx.tex",
     "lablst.tex",