[latex3-commits] [git/LaTeX3-latex3-hyperref] main: typo (baa4385)
Ulrike Fischer
fischer at troubleshooting-tex.de
Mon Jun 13 12:14:32 CEST 2022
Repository : https://github.com/latex3/hyperref
On branch : main
Link : https://github.com/latex3/hyperref/commit/baa438582dac3426956093c1cfdafd05529f7d04
>---------------------------------------------------------------
commit baa438582dac3426956093c1cfdafd05529f7d04
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date: Mon Jun 13 12:14:32 2022 +0200
typo
>---------------------------------------------------------------
baa438582dac3426956093c1cfdafd05529f7d04
doc/hyperref-doc.tex | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
diff --git a/doc/hyperref-doc.tex b/doc/hyperref-doc.tex
index 508f566..cae416b 100644
--- a/doc/hyperref-doc.tex
+++ b/doc/hyperref-doc.tex
@@ -331,6 +331,13 @@ Make sure it comes \emph{last} of your loaded packages, to give it a
fighting chance of not being over-written, since its job is to redefine
many \LaTeX\ commands.\footnote{But work has started to reduce the
number of redefinition and so the dependencies on the loading order.}
+
+\emph{Do not load it in \ci{AtBeginDocument} or the \texttt{begindocument} hook!}
+While this often worked in the past this is not officially supported.
+As \xpackage{hyperref} and \xpackage{nameref} use this hook too to initialize commands,
+timing of code execution is tricky and fragile if the packages are loaded there.
+If you want to delay the loading, use the \texttt{begindocument/before} hook.
+
Hopefully you will find that all cross-references
work correctly as hypertext. For example, \ci{section} commands will
produce a bookmark and a link, whereas \ci{section*} commands will only
@@ -459,7 +466,7 @@ Until \LaTeX{} is updated package authors can also provide these definitions dir
\subsection{Patches and how to suppress them}
The patches to external commands made by
-\xpackage{hyperref} can be avoided completly by loading \xpackage{hyperref}
+\xpackage{hyperref} can be avoided completely by loading \xpackage{hyperref}
with the option \texttt{implicit=false}.
But suppressing everything is often too drastic.
There is a work in progress to classify
More information about the latex3-commits
mailing list.