branch: main
commit 8ebe9ad8330014e3094c40c930c9567512a3aed9
Author: Ikumi Keita <ik...@ikumi.que.jp>
Commit: Ikumi Keita <ik...@ikumi.que.jp>
Add warning in documentation
* doc/install.texi (Customizing): Mention caveat of running
`TeX-auto-generate-global'.
---
doc/install.texi | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/doc/install.texi b/doc/install.texi
index d3e1c4a9..92a5dd36 100644
--- a/doc/install.texi
+++ b/doc/install.texi
@@ -216,7 +216,6 @@ accessible directly by typing @kbd{M-x customize-option
@key{RET} @var{option}
@defopt TeX-macro-global
Directories containing the site's @TeX{} style files.
-@end defopt
Normally, @AUCTeX{} will only allow you to complete macros and
environments which are built-in, specified in @AUCTeX{} style files or
@@ -230,6 +229,11 @@ subdirectories explicitly. Automatic configuration will
already have
set the variable for you if it could use the program @command{kpsewhich}.
In this case you normally don't have to alter anything.
+Note that @code{TeX-auto-generate-global} is not so smart and it can
+introduce unexpected side effects as discussed in
+@uref{https://lists.gnu.org/r/auctex/2021-01/msg00037.html}.
+@end defopt
+
@c Local Variables:
@c mode: Texinfo
@c TeX-master: "auctex"
