'make docs' fails when building PDF

[duncan-roe]

The HTML builds fine, then I get these errors
[100%] Generating Latex and HTML documentation.
[100%] Built target run_doxygen [100%] Generating Doxygen Manual PDF.
This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021 on Slackware) (preloaded format=pdflatex)
\write18 enabled.
entering extended mode
(./doxygen_manual.tex
LaTeX2e <2020-10-01> patch level 4
L3 programming layer <2021-02-18>
make[3]: *** [doc/CMakeFiles/doxygen_pdf.dir/build.make:75: doc/CMakeFiles/doxygen_pdf] Error 1
make[2]: *** [CMakeFiles/Makefile2:661: doc/CMakeFiles/doxygen_pdf.dir/all] Error 2
make[1]: *** [CMakeFiles/Makefile2:642: doc/CMakeFiles/docs.dir/rule] Error 2
make: *** [Makefile:369: docs] Error 2

This is from commit d227628

[albert-github]

Unfortunately doesn't give a lot of information, we would need at least the doxygen_manual.log file from the latex sub directory in the build directory.

• What happens when you do (might be some corrupted files):

  rm -rf html latex
  make docs
  

[duncan-roe]

Log shows

! LaTeX Error: File `xpatch.sty' not found.

I tried:

$ locate xpatch
/usr/share/texmf-dist/tex/latex/regexpatch
/usr/share/texmf-dist/tex/latex/regexpatch/regexpatch.sty
/usr/share/texmf-dist/tex/latex/skeyval/skeyval-ltxpatch.sty
$

doxygen_manual.log

[duncan-roe]

Tried:

rm -rf html latex
make docs

Same error as before

[duncan-roe]

manual.pdf builds with this patch

--- a/doc/manual.sty
+++ b/doc/manual.sty
@@ -45,6 +45,6 @@
   \markright{\thesection\ #1}%
 }
 %
-\usepackage{xpatch}
+\usepackage{regexpatch}
 \xpatchcmd{\part}{plain}{empty}{}{}
 

[albert-github]

From https://ctan.org/pkg/xpatch I have not the idea that this package is not part of the Tex 2021 distribution.
The https://ctan.org/pkg/regexpatch package would be an alternative as it states: "The package generalises the macro patching commands provided by P. Lehmann’s etoolbox. The difference between this package and its sibling xpatch is that this package sports a very powerful \regexpatchcmd based on the l3regex module of the LaTeX3 experimental packages. "

So I'm a bit reluctant tho use it.

As I think that xpatch.sty should be provided by Tex 2021 either

• the Slackware distribution is incomplete
• the xpatch package has not been installed when installing the Tex version
  • user's choice
  • problem in the Slackware package (i.e. again the first mentioned point).

[duncan-roe]

There is no mention of xpatch in the code. But there are 2 occurrences of regexpatch

$ sfl regexpatch
src/translator_sk.h:45:             "\\usepackage{regexpatch}\n"
src/translator_cz.h:102:             "\\usepackage{regexpatch}\n"

So I think the patch is sound

[duncan-roe]

As I think that xpatch.sty should be provided by Tex 2021 either

* the Slackware distribution is incomplete

* the xpatch package has not been installed when installing the Tex version
  
  * user's choice
  * problem in the Slackware package (i.e. again the first mentioned point).

This is Slackware Current (a.k.a. Slackware 15.0 Beta). It builds texlive from 2 tarballs:

texlive-base-210418.tar.xz
texlive-20210324-source.tar.xz

xpatch.sty is not in either of these. Searching for xpatch finds:

-rw-r--r-- root/root     26367 2021-03-24 09:29 texmf-dist/tex/latex/regexpatch/regexpatch.sty
-rw-r--r-- root/root     14706 2013-05-17 08:30 texmf-dist/tex/latex/skeyval/skeyval-ltxpatch.sty

in texlive-base-210418.tar.xz (and no matches in texlive-20210324-source.tar.xz).

[albert-github]

I don't know how the Tex packages are build, but the both distributions I have both, MikTeX 2.9, and for Cygwin (TeX Live 2021/Cygwin), both up to date, have the xpatch package in their distribution. Of course Tex / LaTeX is a "kernel" with a number of packages on top of it and on Cygwin I installed the complete set of texlive packages available (and I don't know from which sub package the xpatch came). On MikTeX the system automatically installs missing packages.

It might be that https://tex.stackexchange.com/questions/158700/latex-cant-find-sty-files-altough-packages-are-installed-texlive-ubuntu-12 gives some useful suggestions for you although it is for Ubuntu.

Diving a bit into the doxygen's usage of xpatch. Doxygen uses it only for \xpatchcmd{\part}{plain}{empty}{}{} in the doxygen manual. The result is that on the "part" pages (i.e. "User Manual", "Reference Manual", "Developers Manual" and "Appendices") there is at the bottom no line like:

Generated by Doxygen 1.9.3

Can we use:

• \patchcmd{\part}{plain}{empty}{}{}, a small test shows that this looks like to work, though in the documentation of the \xpatchcmd theer are mentioned some general limitations of the \patchcmd.
• \usepackage{regexpatch}, this looks like to give some good results too. When looking in the doxygen source code the regexpatch package is used in the translators for the Czech and Slovak languages already.

Even though I still think it is an installation issue I tend a bit more to the usage of the regexpatch package as replacement for the xpatch package`.

[albert-github]

I've just pushed a proposed patch, pull request #8945