From 59de7c7b10b27bdd84bb93895b1ba9337cfd8144 Mon Sep 17 00:00:00 2001
From: gusbrs <19410606+gusbrs@users.noreply.github.com>
Date: Tue, 10 Sep 2024 15:56:56 -0300
Subject: [PATCH] Add comment about compat module settings to User manual

---
 zref-clever-doc.tex | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/zref-clever-doc.tex b/zref-clever-doc.tex
index 7b8e27a..b91cceb 100644
--- a/zref-clever-doc.tex
+++ b/zref-clever-doc.tex
@@ -2332,6 +2332,13 @@ \section{Compatibility modules}
 required.  Of course, this effort is bound to be incomplete (see
 \zcref{sec:limitations}).
 
+Note that settings performed by the compatibility modules require special care
+if they are to be changed by users.  Since the modules depend on what has been
+loaded or not in the document, the settings are done at
+\texttt{begindocument}.  Hence, to override a setting performed by a
+compatibility module, the user must ensure their change comes after that,
+e.g.\ by adding their setting to the \texttt{begindocument} hook.
+
 The purpose of outlining to some extend what the compatibility modules do is
 twofold.  First, some of them require usage adjustments for label setting,
 which must be somehow conveyed in this documentation.  Second, the kind and