Em Tue, 8 Jul 2025 12:09:52 +0900
Akira Yokosawa <akiyks@xxxxxxxxx> escreveu:
> Hi Mauro,
>
> On Mon, 30 Jun 2025 23:34:48 +0200, Mauro Carvalho Chehab wrote:
> [...]
>
> > The test script also ran the install procedure for system,
> > venv and native Sphinx install.
>
> Which install procedure did you test? The short one with the "--no-pdf"
> option?
No, I'm testing it with PDF.
> I am asking because installing the full list of packages in podman run
> of opensuse/leap:15.6 didn't complete successfully for me.
I got a couple of extra fixes for Leap. Will be submitting in a few.
> And by the look of things, you stopped at installation, because you are
> well aware of all the issues in running "make htmldocs" and its friends
> after the install.
>
> I assume you (or somebody else) are going to update the script once this
> series is applied to make the suggested lists of packages be useful for
> newcomers.
I'm not actually building the docs, just checking that the script will
install Sphinx and required dependencies. There are a couple of reasons
for that:
- the disk space on my desktop. Right now, I'm just copying the
files instead of doing a Kernel git clone. Even so, testing all
those distros is requiring about 100GB on my /var partition;
- test time. Right now, I'm starting dozens of machines in
lxc or podman in parallel. Still, it takes a lot of time to
download and install all packages;
- compilation build itself is out of the scope of the script.
I'm pretty sure we'll have compilation issues(*).
(*) on some RHEL-based distros, for instance, texlive-ctex package
is not there (I guess version 8). so, I suspect that CJK
builds may fail.
Anyway, fore sure there will be space for improvements after it, and
I really appreciate if you could send patches on the top of the new
series addressing the issues.
> > The tests were done with those containers, obtained from
> > lxc download templates or via podman run:
> [...]
>
> > It also properly detected RHEL 8 string:
> >
> > Detected OS : Red Hat Enterprise Linux release 8.10 (Ootpa).
> > Installing venv : WARNING: No such file or directory: 'sphinx-build'
> > Installing package_install : WARNING: No such file or directory: 'sphinx-build'
> >
> > But, at this particular docker container, no repositories had
> > python3-sphinx nor python3-virtualenv, but I suspect that this
> > is a problem on this particular image, as I'm almost sure we
> > tested RHEL 8 in the past, so, I have hopes that this could
> > still work with real RHEL, if it has Python >= 3.7.
On this container, you can only install Sphinx with packages with
a subscription, as the repository where it sits can't be enabled
without registering.
> FWIW, almalinux 8 provides python3-sphinx in the "PowerTools" repo.
> It installs Sphinx 1.7.6 on top of python 3.6.8.
> python3-virtualenv is in the "AppStream" repo. It also comes with
> python 3.6.8.
I added a version check on my test script. I'm opting to use
rockylinux 8 instead, as it is meant to be 1:1 binary compatible
with RHEL.
I will provide the output for it at the next version.
> >
> > Yet, our goal is to support the latest LTS version, so
> > RHEL 8 is out of scope.
>
> Yes, I think it is reasonable to ignore RHEL 8 and its clones.
Yes, but still it may work with venv. I'm adjusting the script
right now for it to propose installing python39 package and
accepting install on venv.
> For the record, here is a WIP scorecard of suggested procedure by
> actually running "make htmldocs" and its friends after installing distro
> packages (if it succeeds):
>
> ------------------------------------------------------------------------
> * debian:12
>
> htmldocs: OK
> latexdocs: NG
>
> Debian and its derivative prohibit convert(1) (of ImageMagick) from
> generating PDF by their default policy, so you'll get a bunch of:
>
> [while building userspace-api.tex]
>
> WARNING: Error #1 when calling: /usr/bin/convert /<srcdir>/Documentation/userspace-api/media/typical_media_device.svg /<srcdir>/Documentation/output/userspace-api/latex/typical_media_device.pdf
> WARNING: Warning msg from convert(1): convert: attempt to perform an operation not allowed by the security policy `PDF' @ error/constitute.c/IsCoderAuthorized/426.
>
> , and if you ignore them and try to build PDF, you'll get:
>
> [while building userspace-api.pdf]
>
> ! Dimension too large.
> \spx@boxes@fcolorbox ...dimexpr \ht \spx@tempboxa
> +\spx@boxes@border@top +\s...
> l.54887 \end{sphinxVerbatim}
>
> ?
> ! Emergency stop.
> \spx@boxes@fcolorbox ...dimexpr \ht \spx@tempboxa
> +\spx@boxes@border@top +\s...
> l.54887 \end{sphinxVerbatim}
I use Debian to regularly produce html results. It requires a
change at ImageMagick policies for it to run.
> * fedora:latest (42)
>
> htmldocs: NG
>
> Container images of fedora has stopped having "which" as a command.
> You need to install it manually. After installing "which": OK
Thanks for the feedback! I'm installing which on my container's
setup, as my test scripts require it. I'll add a check to install
it.
>
> pdfdocs: OK
>
> * opensuse/leap:15.6
>
> htmldocs: NG
> After installing "which": OK
Will do the same here.
>
> latexdocs: NG
> Can't complete "zypper install" inside a podman container run using the
> full package list ???
I added some fixes for it.
> Having look at these poor results, I don't see any reason to continue
> testing further.
Thanks for the feedback!
Thanks,
Mauro
