issue doxygen#11702 LaTeX output does not properly break lines with long indexed parameters

making the `\mbox` usage a bit more sophisticated (checking the length so long links can be wrapped) using `\doxymbox`.
Based on
- idea from https://tex.stackexchange.com/a/18577/44119 , there were problems with a.o. `\hbox` in hyperlinks, so using:
  - strategy / code used for length determination of tables

Author: albert-github

src/latexdocvisitor.cpp

@@ -122,7 +122,7 @@ static void visitPreStart(TextStream &t, bool hasCaption, QCString name,  QCStri
       else
       {
         t << "\n\\begin{DoxyImageNoCaption}%\n"
-               "  \\mbox{";
+               "  \\doxymbox{";
       }
     }
 
@@ -194,7 +194,7 @@ static void visitPostEnd(TextStream &t, bool hasCaption, bool inlineImage = FALS
     }
     else
     {
-      t << "}%\n"; // end mbox or caption
+      t << "}%\n"; // end doxymbox or caption
       if (hasCaption)
       {
         t << "\\end{DoxyImage}\n";
@@ -1737,7 +1737,7 @@ void LatexDocVisitor::operator()(const DocParamList &pl)
   {
     if (pl.direction()!=DocParamSect::Unspecified)
     {
-      m_t << "\\mbox{\\texttt{";
+      m_t << "\\doxymbox{\\texttt{";
       if (pl.direction()==DocParamSect::In)
       {
         m_t << "in";
@@ -1804,7 +1804,7 @@ void LatexDocVisitor::operator()(const DocXRefItem &x)
   m_t << "\\item[";
   if (pdfHyperlinks && !anonymousEnum)
   {
-    m_t << "\\mbox{\\hyperlink{" << stripPath(x.file()) << "_" << x.anchor() << "}{";
+    m_t << "\\doxymbox{\\hyperlink{" << stripPath(x.file()) << "_" << x.anchor() << "}{";
   }
   else
   {

src/latexgen.cpp

@@ -204,7 +204,7 @@ void LatexCodeGenerator::writeCodeLink(CodeSymbolType,
   size_t l = name.length();
   if (ref.isEmpty() && usePDFLatex && pdfHyperlinks)
   {
-    *m_t << "\\mbox{\\hyperlink{";
+    *m_t << "\\doxymbox{\\hyperlink{";
     if (!f.isEmpty()) *m_t << stripPath(f);
     if (!f.isEmpty() && !anchor.isEmpty()) *m_t << "_";
     if (!anchor.isEmpty()) *m_t << anchor;
@@ -1381,7 +1381,7 @@ void LatexGenerator::startTextLink(const QCString &f,const QCString &anchor)
   bool pdfHyperlinks = Config_getBool(PDF_HYPERLINKS);
   if (!m_disableLinks && pdfHyperlinks)
   {
-    m_t << "\\mbox{\\hyperlink{";
+    m_t << "\\doxymbox{\\hyperlink{";
     if (!f.isEmpty()) m_t << stripPath(f);
     if (!anchor.isEmpty()) m_t << "_" << anchor;
     m_t << "}{";
@@ -1410,7 +1410,7 @@ static QCString objectLinkToString(const QCString &ref, const QCString &f,
   QCString result;
   if (!disableLinks && ref.isEmpty() && pdfHyperlinks)
   {
-    result += "\\mbox{\\hyperlink{";
+    result += "\\doxymbox{\\hyperlink{";
     if (!f.isEmpty()) result += stripPath(f);
     if (!f.isEmpty() && !anchor.isEmpty()) result += "_";
     if (!anchor.isEmpty()) result += anchor;
@@ -1632,7 +1632,7 @@ void LatexGenerator::startDoxyAnchor(const QCString &fName,const QCString &,
 {
   bool pdfHyperlinks = Config_getBool(PDF_HYPERLINKS);
   bool usePDFLatex   = Config_getBool(USE_PDFLATEX);
-  if (m_insideTableEnv) m_t << "\\mbox{"; // see issue #6093
+  if (m_insideTableEnv) m_t << "\\doxymbox{"; // see issue #6093
   if (usePDFLatex && pdfHyperlinks)
   {
     m_t << "\\Hypertarget{";
@@ -2484,13 +2484,13 @@ void filterLatexString(TextStream &t,const QCString &str,
         case '|':  processEntity(t,pdfHyperlinks,"$\\vert$","|");    break;
         case '~':  processEntity(t,pdfHyperlinks,"$\\sim$","\\string~");    break;
         case '[':  if (Config_getBool(PDF_HYPERLINKS) || insideItem)
-                     t << "\\mbox{[}";
+                     t << "\\+[";
                    else
                      t << "[";
                    break;
         case ']':  if (pc=='[') t << "$\\,$";
                      if (Config_getBool(PDF_HYPERLINKS) || insideItem)
-                       t << "\\mbox{]}";
+                       t << "]\\+";
                      else
                        t << "]";
                    break;

templates/latex/doxygen.sty

@@ -657,9 +657,21 @@
   \end{list}%
 }
 
+\newsavebox{\doxymboxbox}
+\newlength{\doxymboxlength}
+\newcommand{\doxymbox}[1]{%
+  \sbox{\doxymboxbox}{#1}%
+  \setlength{\doxymboxlength}{\wd\doxymboxbox}%
+  \ifthenelse{\doxymboxlength>\linewidth}{%
+    #1%
+  }{%
+    \mbox{#1}%
+  }%
+}
+
 % Used when hyperlinks are turned on
 \newcommand{\doxylink}[2]{%
-  \mbox{\hyperlink{#1}{#2}}%
+  \doxymbox{\hyperlink{#1}{#2}}%
 }
 
 % Used for the cite command
@@ -697,7 +709,7 @@
 % Third argument is the SectionType, see the doxygen internal
 % documentation for the values (relevant: Page ... Subsubsection).
 \newcommand{\doxysectlink}[3]{%
-  \mbox{\hyperlink{#1}{#2}}%
+  \doxymbox{\hyperlink{#1}{#2}}%
 }
 % Used when hyperlinks are turned off
 \newcommand{\doxyref}[3]{%