As explained in the title, =dev-tex/biblatex-3.19 does not provide its package documentation. This means that running texdoc biblatex does not work as expected (in my case it opens some "NBR 10520:2002 - Referência" document from the dev-texlive/texlive-bibtexextra package). Reproducible: Always Steps to Reproduce: 1. install biblatex 2. run texdoc biblatex 3. cry Actual Results: texdoc biblatex opens some "NBR 10520:2002 - Referência" document from the dev-texlive/texlive-bibtexextra package Expected Results: texdoc biblatex should open the biblatex documentation
The ebuild needs: - pushd doc || die + pushd doc/latex/biblatex || die And we need to change latex-package.eclass because the package uses fontspec and that requires lualatex or xetex.
*** Bug 943389 has been marked as a duplicate of this bug. ***
The bug has been closed via the following commit(s): https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=f84b09f5dd30d2e41d33afd6c284cc99cd9e22fa commit f84b09f5dd30d2e41d33afd6c284cc99cd9e22fa Author: Florian Schmaus <flow@gentoo.org> AuthorDate: 2025-03-26 14:39:23 +0000 Commit: Florian Schmaus <flow@gentoo.org> CommitDate: 2025-03-26 14:42:15 +0000 dev-tex/biblatex: add media-fonts/corefonts as USE 'doc' conditional dep The biblatex documentation at doc/latex/biblatex/biblatex.tex uses "Courier New" as mono font. Therefore, we add media-libs/corefonts as conditional BDEPEND. We also mark two bugs now closed, that are related to biblatex.pdf not being installed if USE=doc. Technically, this was fixed with the when biblatex-3.20-r1 was first added but was forgotten back then. Hence we do it now. Closes: https://bugs.gentoo.org/938927 Closes: https://bugs.gentoo.org/945334 Signed-off-by: Florian Schmaus <flow@gentoo.org> dev-tex/biblatex/biblatex-3.20-r1.ebuild | 6 ++++++ 1 file changed, 6 insertions(+)
Is it really necessary to build biblatex.pdf instead of just using the prebuilt one that is included in the archive?
No, it's probably not necessary but potentially beneficial. If it turns out that we have opened a can of worms doing so, then we will switch back to using the pre-build PDF.
My thinking was that with the prebuilt pdf, there is no need to depend on corefonts (and the build time is marginally faster, and fewer things can go wrong). My local repo has - pushd doc || die - latex-package_src_doinstall doc - popd || die + insinto "${TEXMF}"/doc/latex/biblatex + doins doc/latex/biblatex/biblatex.pdf I have no strong opinion on this, though. In the end, I am happy with whichever method makes "texdoc biblatex" bring up the relevant documentation when I need it.
