Merge branch 'develop' into ltmarks-enhance

# Conflicts:
#	base/changes.txt
#	base/doc/ltnews39.tex
#	base/ltmarks.dtx

.github/workflows/deploy.yaml

@@ -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@48476814b0338573004e9de1e8504b25ff8cc23c
+        uses: dawidd6/action-send-mail@dc13c734ff2b581c12c1b59958ba73d6fa95b371
         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@48476814b0338573004e9de1e8504b25ff8cc23c
+        uses: dawidd6/action-send-mail@dc13c734ff2b581c12c1b59958ba73d6fa95b371
         if: ${{ failure() }}
         with:
           server_address: typesetting.eu

.github/workflows/main.yaml

@@ -132,7 +132,7 @@ jobs:
       # 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 +148,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:
@@ -172,7 +176,7 @@ jobs:
       # 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 +189,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 +215,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@48476814b0338573004e9de1e8504b25ff8cc23c
+        uses: dawidd6/action-send-mail@dc13c734ff2b581c12c1b59958ba73d6fa95b371
         with:
           # Currently using my (Marcel's) mail server for sending mails.
           server_address: typesetting.eu

.github/workflows/pretest.yaml

@@ -109,7 +109,7 @@ jobs:
       # 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 +125,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:
@@ -150,7 +154,7 @@ jobs:
       # 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 +167,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

CONTRIBUTING.md

@@ -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/alltt.ins

@@ -3,7 +3,7 @@
 %% driver files from the doc files in this package when run through
 %% LaTeX or TeX.
 %%
-%% Copyright (C) 1993-2023
+%% Copyright (C) 1993-2024
 %% The LaTeX Project and any individual authors listed elsewhere
 %% in this file.
 %%
@@ -48,7 +48,7 @@ reports for it can be opened at https://latex-project.org/bugs.html
 (but please observe conditions on bug reports sent to that address!)
 
 
-Copyright (C) 1993-2023
+Copyright (C) 1993-2024
 The LaTeX Project and any individual authors listed elsewhere
 in this file.
 

base/build.lua

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

base/changes.txt

@@ -6,20 +6,68 @@ to completeness or accuracy and it contains some references to files that are
 not part of the distribution.
 ================================================================================
 
+2024-01-27  Frank Mittelbach  <[email protected]>
+
+	* lttextcomp.dtx (section{Font family sub-encodings setup}):
+	Adjusted/corrected TS1 sub-encoding declarations for various families.
+	Some families have changed their names (due to licensing issues),
+	some got new glyphs added, and some were simply incorrectly categorized
+	(gh/1257)
+
+	* lttextcomp.dtx (section{The \texttt{checkencodingsubset.tex} file}):
+	Added check file for encoding subset
+
+2024-01-03  Phelype Oleinik  <[email protected]>
+	* lthooks.dtx:
+	Correct expansion of \@@_print_args:nn argument (gh/1221).
+
+2023-12-30  Frank Mittelbach  <[email protected]>
+	* doc.dtx (subsection{Macros surrounding the `definition parts'}):
+	Use \@noligs from the LaTeX kernel, so that the upquote
+	package can add its patch (gh/1230)
+
+2023-12-26 Yukai Chou  <[email protected]>
+	* ltproperties.dtx:
+	Correct typo (gh/1223)
+	* doc.dtx, ltfntcmd.dtx, lthooks.dtx
+	Correct similar typos of missing backslashes
+	* ltfilehook.dtx
+	Change flag markup in macro env
+
+2023-12-07 Ulrike Fischer <[email protected]>
+	* ltproperties.dtx: use \protected@write, (gh1200)
+
+2023-12-02  Frank Mittelbach  <[email protected]>
+	* doc.dtx (subsection{API creation}):
+	Provide \ProvideDocElement for use cases where files are processed
+	individually as well as together, e.g.,	the LaTeX kernel documentation.
+
+2023-12-01  Joseph Wright  <[email protected]>
+	* ltcmd.dtx (subsection{Declaring commands and environments}):
+	Optimize creation of simple document commands (gh/1189)
+	* usrguide.tex (subsection{Performance}):
+	Document efficiency of ltcmd definitions
+
+2023-11-16  Frank Mittelbach  <[email protected]>
+	* ltpara.dtx (subsection{Providing hooks for paragraphs}):
+	Correct error message: hook left horizontal not vertical mode (gh/1182)
+
+2023-11-15  Joseph Wright  <[email protected]>
+	* ltfiles.dtx (subsection{Listing files}):
+	Extend \listfiles to optionally include file sizes and hashes
+	* usrguide.tex
+	Re-introduce \listfiles (extended) description
+
 2023-11-14  Frank Mittelbach  <[email protected]>
 
 	* ltmarks.dtx:
-	Some internal commands renamed and extended.
-
 	Generalized the support for extracting marks to cover cases like multicols.
 
+	Some internal commands renamed and extended.
 	Renamed \__mark_update_structure:nn to \__mark_update_structure_from_material:nn
-
 	Added \__mark_get_marks_for_reinsertion:nNN
-
 	Added \ShowMarksAt for debugging (might not stay this way)
 
-
 2023-11-09 Yukai Chou  <[email protected]>
 	* clsguide-historic.tex, usrguide.tex:
 	Replace quotation with quote envs for zero para indent
@@ -44,6 +92,14 @@ not part of the distribution.
 All changes above are only part of the development branch for the next release.
 ================================================================================
 
+#########################
+# 2023-11-01 PL1 Release
+#########################
+
+2024-01-13 Jonathan P. Spratte <[email protected]>
+	* ltkeys.dtx: 
+	Trim spaces off key names taken from the raw-lists (gh1238)
+
 #########################
 # 2023-11-01 Release
 #########################
@@ -169,7 +225,7 @@ All changes above are only part of the development branch for the next release.
 	* ltfiles.dtx
 	Allow for pipes in \input, etc.
 
-2023-06-16  Phelype Oleinik  <Joseph.Wright@latex-project.org>
+2023-06-16  Phelype Oleinik  <phelype.oleinik@latex-project.org>
 
 	* lthooks.dtx, ltcmdhooks.dtx
 	Correct some rollback labels and dates.

base/classes.ins

@@ -3,7 +3,7 @@
 %% driver files from the doc files in this package when run through
 %% LaTeX or TeX.
 %%
-%% Copyright (C) 1993-2023
+%% Copyright (C) 1993-2024
 %% The LaTeX Project and any individual authors listed elsewhere
 %% in this file.
 %%
@@ -48,7 +48,7 @@ reports for it can be opened at https://latex-project.org/bugs.html
 (but please observe conditions on bug reports sent to that address!)
 
 
-Copyright (C) 1993-2023
+Copyright (C) 1993-2024
 The LaTeX Project and any individual authors listed elsewhere
 in this file.
 

base/cmextra.ins

@@ -3,7 +3,7 @@
 %% driver files from the doc files in this package when run through
 %% LaTeX or TeX.
 %%
-%% Copyright (C) 1993-2023
+%% Copyright (C) 1993-2024
 %% The LaTeX Project and any individual authors listed elsewhere
 %% in this file.
 %%
@@ -48,7 +48,7 @@ reports for it can be opened at https://latex-project.org/bugs.html
 (but please observe conditions on bug reports sent to that address!)
 
 
-Copyright (C) 1993-2023
+Copyright (C) 1993-2024
 The LaTeX Project and any individual authors listed elsewhere
 in this file.
 

base/cmfonts.fdd

@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %
-% Copyright (C) 1993-2023
+% Copyright (C) 1993-2024
 % The LaTeX Project and any individual authors listed elsewhere
 % in this file.
 %

base/cmfonts.ins

@@ -3,7 +3,7 @@
 %% driver files from the doc files in this package when run through
 %% LaTeX or TeX.
 %%
-%% Copyright (C) 1993-2023
+%% Copyright (C) 1993-2024
 %% The LaTeX Project and any individual authors listed elsewhere
 %% in this file.
 %%
@@ -48,7 +48,7 @@ reports for it can be opened at https://latex-project.org/bugs.html
 (but please observe conditions on bug reports sent to that address!)
 
 
-Copyright (C) 1993-2023
+Copyright (C) 1993-2024
 The LaTeX Project and any individual authors listed elsewhere
 in this file.