Bug 2119288

Summary:	python-sklearn-genetic-opt fails to produce PDF docs with Sphinx 5.1.1 in Rawhide
Product:	[Fedora] Fedora	Reporter:	Karolina Surma <ksurma>
Component:	python-sklearn-genetic-opt	Assignee:	Iztok Fister Jr. <iztok>
Status:	CLOSED CURRENTRELEASE	QA Contact:
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	38	CC:	code, iztok, orion
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2023-06-25 17:32:56 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Karolina Surma 2022-08-18 08:06:42 UTC

Hello,

when integrating Sphinx 5.1.1 to Rawhide, python-sklearn-genetic-opt was a package that failed to build documentation.
I tried to pin point the issue there, but my knowledge about LaTeX and building PDF docs is really scarce. Can you take a look and help me understand whether this is something to raise to Sphinx or should it be rather solved in this package's upstream?

PDF built with Sphinx 5.0.2 just fine.
There are some LaTeX changes in the latest Sphinx versions: https://www.sphinx-doc.org/en/master/changes.html#release-5-1-0-released-jul-24-2022
Now, building PDF fails the entire build. The built PDF lacks the index and ToC.

You can grab the logs from this build: https://copr.fedorainfracloud.org/coprs/ksurma/sphinx-5.1.1-clean/build/4742258/

Or test the build in your local mock adding the test repo to your environment

mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-5.1.1-clean/fedora-rawhide-x86_64/ --no-clean your.src.rpm
mock -r fedora-rawhide-x86_64 --addrepo=https://download.copr.fedorainfracloud.org/results/ksurma/sphinx-5.1.1-clean/fedora-rawhide-x86_64/ shell


Version-Release number of selected component (if applicable):
0.9.0-3

How reproducible:
Always

Actual results:
+ /usr/bin/make -O -j2 V=1 VERBOSE=1 -C docs/_build/latex LATEXMKOPTS=-quiet
make: Entering directory '/builddir/build/BUILD/Sklearn-genetic-opt-0.9.0/docs/_build/latex'
latexmk -pdf -dvi- -ps- -quiet 'sklearngeneticopt.tex'
Rc files read:
  /etc/latexmkrc
  latexmkrc
Latexmk: Run number 1 of rule 'pdflatex'
This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021) (preloaded format=pdflatex)
 restricted \write18 enabled.
entering extended mode
Latexmk: Getting log file 'sklearngeneticopt.log'
Latexmk: Summary of warnings from last run of *latex:
  Latex failed to resolve 2 reference(s)
Collected error summary (may duplicate other messages):
  pdflatex: Command for 'pdflatex' gave return code 1
      Refer to 'sklearngeneticopt.log' for details
make: Leaving directory '/builddir/build/BUILD/Sklearn-genetic-opt-0.9.0/docs/_build/latex'

Comment 1 Ben Beasley 2022-08-18 12:51:27 UTC

In /root/builddir/build/BUILD/Sklearn-genetic-opt-0.9.0/docs/_build/latex/sklearngeneticopt.log:

> [41] [42] [43] [44] [45]
> ! Undefined control sequence.
> \nbsphinxfcolorbox ->\spx@fcolorbox
>                                     {nbsphinx-code-border}{white}
> l.2819 \begin{nbsphinxfancyoutput}
> 
> The control sequence at the end of the top line
> of your error message was never \def'ed. If you have
> misspelled it (e.g., `\hobx'), type `I' and the correct
> spelling (e.g., `I\hbox'). Otherwise just continue,
> and I'll forget about whatever was undefined.

The root cause is https://github.com/spatialaudio/nbsphinx/issues/656.

Comment 2 Ben Cotton 2023-02-07 14:53:55 UTC

This bug appears to have been reported against 'rawhide' during the Fedora Linux 38 development cycle.
Changing version to 38.

Comment 3 Orion Poplawski 2023-06-25 17:32:56 UTC

I'm going to assume that this was fixed then in nbsphinx.