sage-doc-9999 (9.5.beta3) fails to build

[strogdon]

[reference] building [latex]: all documents
[reference] updating environment: [config changed ('autodoc_builtin_argspec')] 1 added, 0 changed, 0 removed
[reference] updating environment: [config changed ('autodoc_builtin_argspec')] 1 added, 0 changed, 0 removed
[reference] processing references.tex... index
[reference] resolving references...
[reference] done
[reference] writing... done
[reference] copying TeX support files... copying TeX support files...
[reference] done
[reference] The LaTeX files are in ../../../build_doc/latex/en/reference/references.
[reference] Run 'make' in that directory to run these through (pdf)latex
[reference] (use `make latexpdf' here to do that automatically).
LaTeX file written to /var/tmp/portage/sci-mathematics/sage-doc-9999/work/build_doc/latex/en/reference/references
/bin/sh: line 1: all-pdf: command not found
Error building the documentation.
Traceback (most recent call last):
  File "/usr/lib/python3.9/runpy.py", line 197, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "/usr/lib/python3.9/runpy.py", line 87, in _run_code
    exec(code, run_globals)
  File "/usr/lib/python3.9/site-packages/sage_docbuild/__main__.py", line 2, in <module>
    main()
  File "/usr/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 1814, in main
    builder()
  File "/usr/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 266, in pdf
    raise RuntimeError(error_message%(command, tex_dir))
RuntimeError: failed to run $MAKE all-pdf in /var/tmp/portage/sci-mathematics/sage-doc-9999/work/build_doc/latex/en/reference/references

    Note: incremental documentation builds sometimes cause spurious
    error messages. To be certain that these are real errors, run
    "make doc-clean" first and try again.
make[1]: *** [Makefile:52: doc-pdf--reference-references] Error 1
make[1]: Leaving directory '/var/tmp/portage/sci-mathematics/sage-doc-9999/work/sage-doc-9999/src/doc'
make: *** [Makefile:59: doc-pdf-reference] Error 2
make: *** Waiting for unfinished jobs....
[reference] dumping search index in English (code: en)... done
[reference] The HTML pages are in ../../../build_doc/html/en/reference/references.

Since this is new and I haven't looked at the ebuild, I'm not sure the order in which things are to be built.

[strogdon]

sage-9999 apparently did build.

[kiwifb]

I haven't tested pdf. I meant too but I forgot, it is probably the wrong command.

[kiwifb]

I am not sure where that all-pdf comes from, I'd say it is sphinx internal. Which version of sphinx?

[strogdon]

sphinx-4.1.2. The above says

RuntimeError: failed to run $MAKE all-pdf in /var/tmp/portage/sci-mathematics/sage-doc-9999/work/build_doc/latex/en/reference/references

However, Make all-pdf in that folder works.

[kiwifb]

I can reproduce the failure. I even tried USE="-doc-html doc-pdf" in case there was some conflicts between html and pdf builds. But no, it still failed. If vanilla works, I will be looking at increasing the sphinx dependency to 4.2.0 like in vanilla.

[strogdon]

A different error in a Prefix

[reference] building [latex]: all documents
[reference] updating environment: [config changed ('autodoc_builtin_argspec')] 1 added, 0 changed, 0 removed
[reference] updating environment: [config changed ('autodoc_builtin_argspec')] 1 added, 0 changed, 0 removed
[reference] processing references.tex... index
[reference] resolving references...
[reference] failed
[reference] Exception occurred:
[reference]   File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/site-packages/sphinx/environment/__init__.py", line 517, in get_doctree
[reference]     doctree = pickle.load(f)
[reference] _pickle.UnpicklingError: pickle data was truncated
[reference] The full traceback has been saved in /storage/strogdon/gentoo-rap/var/tmp/portage/sci-mathematics/sage-doc-9999/temp/sphinx-err-rvcclfms.log, if you want to report the issue to the developers.
[reference] Please also report this if it was a user error, so that a better error message can be provided next time.
[reference] A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
Error building the documentation.
Traceback (most recent call last):
  File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/runpy.py", line 197, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/runpy.py", line 87, in _run_code
    exec(code, run_globals)
  File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/site-packages/sage_docbuild/__main__.py", line 2, in <module>
    main()
  File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 1814, in main
    builder()
  File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 243, in pdf
    self.latex()
  File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 822, in _wrapper
    getattr(DocBuilder, build_type)(self, *args, **kwds)
  File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/site-packages/sage_docbuild/__init__.py", line 133, in f
    runsphinx()
  File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/site-packages/sage_docbuild/sphinxbuild.py", line 323, in runsphinx
    sys.stderr.raise_errors()
  File "/storage/strogdon/gentoo-rap/usr/lib/python3.9/site-packages/sage_docbuild/sphinxbuild.py", line 258, in raise_errors
    raise OSError(self._error)
OSError: Exception occurred:

    Note: incremental documentation builds sometimes cause spurious
    error messages. To be certain that these are real errors, run
    "make doc-clean" first and try again.
make[1]: *** [Makefile:52: doc-pdf--reference-references] Error 1
make[1]: Leaving directory '/storage/strogdon/gentoo-rap/var/tmp/portage/sci-mathematics/sage-doc-9999/work/sage-doc-9999/src/doc'
make: *** [Makefile:59: doc-pdf-reference] Error 2
make: *** Waiting for unfinished jobs....
[reference] dumping search index in English (code: en)... done
[reference] The HTML pages are in ../../../build_doc/html/en/reference/references.

still with sphinx-4.1.2. I haven't tried the pdf-docs in vanilla.

[strogdon]

No the Prefix has sphinx-4.2.0.

[kiwifb]

Building vanilla right now. I am expecting vanilla to fail.

[kiwifb]

OK so vanilla worked :(

[kiwifb]

OK, that's what I thought. $MAKE is not substituted for the right thing. It is probably empty when running sphinx. I have to find the right place to pass it to the sub-process. It only happens with pdf because only the build-pdf driver does call make.

[strogdon]

I'm doing a serial build to see if that gives any info.

[kiwifb]

I have a fix. I'll push it once the build is completely finished, hopefully without further issues :)

[kiwifb]

Let me know if the prefix issue persists. There is also a QA issue about jobserver being unavailable that I will have to sort at some point. make launching a program launching a different instance of make makes parallel make a bit shaky.

[strogdon]

Did a serial build because the Prefix failure was different. Serial in Prefix gives

RuntimeError: failed to run $MAKE all-pdf in /storage/strogdon/gentoo-rap/var/tmp/portage/sci-mathematics/sage-doc-9999/work/build_doc/latex/en/reference/references

which indicates the real issue is with MAKE.

[strogdon]

Installs here on both gentoo and prefix with, of course, QA Notice: make jobserver unavailable:.

[kiwifb]

I'll deal with that separately, eventually.