The previous stable version, dev-tex/latex-beamer-3.36, installs the file beameruserguide.pdf. (It seems to be included in the distribution, so the ebuild does not have to compile it.) The new version, dev-tex/latex-beamer-3.56, installs only compressed source files for the guide. Not exactly usable in this form. Reproducible: Always Steps to Reproduce: 1. emerge '=dev-tex/latex-beamer-3.56[doc]' Actual Results: No file beameruserguide.pdf is present, only beameruserguide.tex.bz2 and other source files. Expected Results: The documentation file of the package is present in a usable form.
this up to you to compile pdf now. They do not really ship it anymore.
Could this not be automated by the ebuild? It is _really_ the expected behaviour that USE="doc" should provide the documentation.
At the time of posting, it was really complicated to compile beameruserguide.pdf; I recall that I had to patch beamer's build.lua script because of some incompatibility with l3build scripts installed by TeXLive. But now this issue seems to be resolved (with TeXLive update, I guess), and compiling beameruserguide is as simple as putting src_compile() { default if use doc ; then texlua build.lua doc || die fi } in the latex-beamer-3.59.ebuild; you will have it merged at /usr/share/texmf-site/doc/latex/beamer/doc/beameruserguide.pdf. Note that this probably creates build-time dependency on dev-texlive/texlive-latexextra because this is where mentioned l3build scripts belong.
Created attachment 867710 [details, diff] patch that extracts beameruserguide.pdf from beamer-ctan.zip and injects it into the build directory Since v3.68, upstream again provides pre-built documentation (in beamer-ctan.zip). For now, I'm using the attached changes. It's not elegant, but it's good enough for my local repo.