branch master updated: LaTeX.pm: describe \fbox in sectioning command issue and solutions

[Patrice Dumas]

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 7af8bbfc12 LaTeX.pm: describe \fbox in sectioning command issue and 
solutions
7af8bbfc12 is described below

commit 7af8bbfc127471fee78d3004352454a6e3b822f3
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Mon Feb 21 18:16:42 2022 +0100

    LaTeX.pm: describe \fbox in sectioning command issue and solutions
---
 tp/Texinfo/Convert/LaTeX.pm | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/tp/Texinfo/Convert/LaTeX.pm b/tp/Texinfo/Convert/LaTeX.pm
index 09a0ee9797..29e46b1c1f 100644
--- a/tp/Texinfo/Convert/LaTeX.pm
+++ b/tp/Texinfo/Convert/LaTeX.pm
@@ -85,6 +85,21 @@
 #
 # RELEVANT BUT NOT DECISIVE
 #
+# Rendering of @error using \fbox{} in sectioning commands leads to erroneous
+# table of contents with hyperref, and with xcolor there is even a failure.
+# The hyperref maintainer does not want to handle explicitely \fbox{} in
+# sectioning commands given the rarity of this use and also because there are
+# some workarounds.
+# In particular
+# \chapter{\texorpdfstring{\fbox{fbox}}{}}
+# or
+# \pdfstringdefDisableCommands{%
+# \def\fbox#1{[#1]}%
+# }
+#
+# See
+# https://github.com/latex3/hyperref/issues/207#issuecomment-920712424
+#
 # breaking in urls is not implemented, maybe there is some support already in
 # hyperref.  @urefbreakstyle, @/
 #