IronPort-PHdr: =?us-ascii?q?9a23=3ABjoAXxPXaYPvehWunr4l6mtXPHoOpqn0MwgJ65?=
               =?us-ascii?q?Eul7NJdOGZ8o//OFDEvKs23kXEWYzKre9Ciq/WvqHsVGgK7IyO9nwPI9RXTx?=
               =?us-ascii?q?FQr8IQkkQ7BdKdT1XhJavvbic6FcAEVAU8136+OElRXs35Yg6auWW8uAYbAQ?=
               =?us-ascii?q?63Lg9pPqLwE4/Wgd6w0rW3+pbTagEOhGDkSbx3JRSy6w7Ws5pempNsf4A2zB?=
               =?us-ascii?q?aBuX5UY6JWyGdvcEqUhAr579ys8YRL9i1Rv7c+8pcFX/mrOas/SrNcAXItNG?=
               =?us-ascii?q?Vsvp/RuBLOTBWC6j4naktNykYaJQ/D4Vm6RJr1uzq8q+x8nSmXPMH7Sbo5Qz?=
               =?us-ascii?q?vk46o5ABnvwDwKMTI06gS1woR5kb5brRS9phd+35+cYYebM+B7d7/cetVSTH?=
               =?us-ascii?q?RIX8JYXShMSo2maI5HA+0ENOde547zwjlG5R6/DgmlAKXvkGZgiXr/3Kl82O?=
               =?us-ascii?q?MkUEnH0AEmA9MSoSHMttymfKwWUO2z0OzJ1WCZN6IQiWq7sdKYNExw8pTuFf?=
               =?us-ascii?q?pqfMHcyFciDVbfg1GZuMr4OTLQ1ukMv2Wf5ed6WqSjhj1CyUk5rz6xy8Mrko?=
               =?us-ascii?q?SMiJgSzwWO8CRywI8xY93iEWZ0ZNelFN1bsCTQZO4UCosyBnplvio30OhMvJ?=
               =?us-ascii?q?+wfCEOjpR9njbQbvWGd86D5RepB4PzaX9owXlifry4nRO790Otn/b9WseD21?=
               =?us-ascii?q?FPtiNZk9PIuylXhSbe4cWGVPZxu3yZ92vfi1Lr4/pfaQAumK7SOtg8xL91lp?=
               =?us-ascii?q?cSvUnHFCLslwP6gf3eekIh8+muo+PpB9eu7pqdPI99jkf+aP0Glcm2AOB+OQ?=
               =?us-ascii?q?8LF2SW4uWz0rT/8FaxGu0byK1r1PCD4NaGdIwSveahDhVQ05o/5hrabX/uy9?=
               =?us-ascii?q?kekXQdbRpEdB+Bk4n1KgTLKfH8A+24hgfkmzNqyvbae7z5V8+Vfz6TzfG4J+?=
               =?us-ascii?q?Y7tx8PrWh7hcpS7J9VFLwbdej+Xkbg8sHeD1o5Pg24zuLtBc9ykI8TCgftSu?=
               =?us-ascii?q?eUNr3ftViQ66chOe6JMcUQuT39Ivxj56S3pXA8kF4ZO6Ku2NFEDRLwVuQjOE?=
               =?us-ascii?q?ifbXf2150EEGwKtw54TLazoFKHWD9XIX21Wuhvg1NzQJLjBoDFSIe3hbWH1y?=
               =?us-ascii?q?ruBZxaaFdNDVWUGGvpfYGJCL8cLTifKch7nnkYRKCsHsU/gAq2ulawmN8FZq?=
               =?us-ascii?q?LEvzcVvpX52J1p6v3PwFssoCdsAZ3V0nnRHTop2DpZH3lsgP85+Qsnlh+Cyf?=
               =?us-ascii?q?Qq3aAeT4cIoaoXCkFicseNqo4yQ9HqBlCfIJHQEAzgGpP+RmtpBtMpn41QPQ?=
               =?us-ascii?q?AnR4Tk3kiFh23wW/cUj+DZW8Zyq/6ahimrYZ46kiajtuFpjkF6EJQTczT82+?=
               =?us-ascii?q?gnsVCUXtCBkl3Fxf/yJeJFg3GLpCHbijDX9EBADFwpDv6DBCFDIBOQ9ZOguC?=
               =?us-ascii?q?agB/evEeh1aFMQj57fbPIQOpuxygwZDPb7ZIaEOjz3xjf2XEfSgOvLNduien?=
               =?us-ascii?q?1Bjn+EVg5eyFFVpizAbU9nV0LD6yrIBThqXwu1MXnh+uR/tn63C3QM4VrRNB?=
               =?us-ascii?q?9H0Ly4sl4PiPiVWrUO2LNBuCogpzhwFlun0JTaBojIoQ0pZ6habd4nhTUPnW?=
               =?us-ascii?q?vEqwxwOIChJKF+lxYfdQpwpUbnyxRwDM1Jj8ErqHogyAc6J7if1RtNcDaR3J?=
               =?us-ascii?q?a4PbOySCG65Be0d6vfwU3Tyv6T86YLres98hDt4FDvGU0l/HFqldJS1jrU55?=
               =?us-ascii?q?nHChYTTYOkUksz8EsfxfmSaS086oXIkHx0ZPPs43mShpRwXrtjlkfzN81SO6?=
               =?us-ascii?q?6FCgLoRtcXA8G/bvEsmh2pYxMIMeRY+bQ7ec+rJJ7kkOamOvhtmDW+gCFJ+o?=
               =?us-ascii?q?d4hwiJ9iF8Q+qO38xc6/6d1wqDETz7iR3y16K/0ZABfjwUEmelnGL8A5VNY6?=
               =?us-ascii?q?RpYYsRIWKnIsny2dAnwpCxCjhX81msA15A08isM0n3DRS1zUhb0kIZpmaikC?=
               =?us-ascii?q?2zwmlvkj0nmaGY2TTH3+XocBdeZzx7AVJ6hFKpGrCaytAXWE/yMlosnRqhoF?=
               =?us-ascii?q?n/nu1V+PU5IG7UTkNFOSPxKjM6C/fihv+5e8dKragQn2BPSu3lOAKVT7f8p1?=
               =?us-ascii?q?0R1CaxRzIPlgB+TCmjv9DCpzI/jWucKHhpq3+AIJN/wB7e4JrXQvsDhzc=3D?=
MIME-Version: 1.0
References: <20200723020053.jq6lnwl7k23htouz@vento15post8>
            <CAOCj1Od4FqYrO02drsP43KWWEqusyYiGNgTLgsuvmELTKXxgBQ@mail.gmail.com>
            <3f1f9ba8-7a63-bc32-58ec-b70a5d8fda11@morningstar2.co.uk>
Content-Type: text/plain; charset="UTF-8"
Message-ID:  <CAOCj1OcjxB7G-VFmeNJH3z55Yw-n=qEPCfnVxhPrxSgfPm4H-A@mail.gmail.com>
Date:         Thu, 23 Jul 2020 14:37:09 +0200
Reply-To:     Mailing list for the LaTeX3 project
              <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
Sender:       Mailing list for the LaTeX3 project <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
From:         Michal Hoftich <michal.h21@GMAIL.COM>
Subject: Re: Guidelines on the new hook management
To:           LATEX-L@LISTSERV.UNI-HEIDELBERG.DE
In-Reply-To:  <3f1f9ba8-7a63-bc32-58ec-b70a5d8fda11@morningstar2.co.uk>
Precedence: list
Envelope-To: <rainer.schoepf@gmx.net>
Status: R

Hello Joseph,

Thank you for your detailed answer.

> # \shipout
>
> There are very few packages that actually modify the \shipout primitive:
> almost everyone uses either everyshi or atbegshi, and we have arranged
> for those to be emulated. As such, the only packages that need to be
> modified here are those that *directly*, which is limited as far as we
> know to pgf, crop and a few other packages. There are then a number of
> hooks one can use
>
> - shipout/before
> - shipout/foreground
> - shipout/background
> - shipout/firstpage
> - shipout/lastpage
>
> as described in "texdoc ltshipout".

We patch \shipout on one occasion:

\let\:shipout=\shipout
\def\shipout{\vfil\break\let\shipout=\:shipout \shipout}

If I understand correctly, it is executed only in the first use of
\shipout  and it doesn't seem to do anything useful, although I am
sure there was a use case at some point for that.

Is this code OK? It should work even in Plain.


> # \document
>
> Many more packages patch \document. Those adding code using
> \AtBeginDocument will have no issues: this kernel-level hook will
> continue to be available, although it is now a wrapper around
> \AddToHook. Many others will be using etoolbox's hooks: they are already
> aware of the new kernel hooks and again will need no work from package
> authors.
>

Yes, we use \AtBeginDocument a lot. It is good that this will continue to work.

> For people directly altering \document, the need to take action will
> depend on the exact nature of the changes. For example, I have had to
> adjust beamer, but siunitx, which also patches \document, continues to
> work with no action. (I will update to use 'best practice', but that is
> not a *requirement*.) Basically, anything that starts messing with the
> detail of \document needs action, whereas simply adding a macro to the
> end of \document works out OK.
>
> Where you do need to take action, there are now a number of hooks
>
> - env/document/before: Occurs as soon as \begin{document} is seen,
>      before the group is opened
> - env/document/begin: Occurs just after environment group is opened:
>     for \document this is not really different from the above due to
>     the special nature of \document
> - begindocument: Replaces \AtBeginDocument, occurring after the .aux
>      file is read
> - begindocument/end: Occurs right at the end of \document, followed
>      only by \ignorespaces: where many people add 'last minute' stuff to
>      \document
>

This seems really useful, thanks.

BTW, I was able to find the main clashes between TeX4ht and new LaTeX
code, so it works for the test file. I hope it will work also for real
world documents.

Best regards,
Michal