Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

possible race-condition with python-doc #130979

Open
bmwiedemann opened this issue Mar 8, 2025 · 1 comment
Open

possible race-condition with python-doc #130979

bmwiedemann opened this issue Mar 8, 2025 · 1 comment
Labels
docs Documentation in the Doc dir type-bug An unexpected behavior, bug, or error

Comments

@bmwiedemann
Copy link
Contributor

bmwiedemann commented Mar 8, 2025

Bug report

Bug description:

While working on reproducible builds for openSUSE, I found that our python314 (and python311) doc sub-packages produce different html on 1-core-VMs and 4-core-VMs. This suggests that there is some race going on about what the correct content should be.

https://rb.zq1.de/other/python314-doc-compare.out has a diff

The interesting bit of it is

-<p class="audit-hook" id="audit_event_cpython_run_stdin_1">
+<p class="audit-hook" id="audit_event_cpython_run_stdin_2">

How to Reproduce

To test on openSUSE or Debian, use

osc checkout openSUSE:Factory/python314 && cd $_
for N in 1 14 ; do
    osc build -M=doc --noservice --clean --vm-type=kvm -j$N --release=1.1 --keep-pkg=RPMS.$N standard
    (cd RPMS.$N && unrpm python314-doc-3*.x86_64.rpm)
done
diff -ru RPMS.{1,14}/usr/

Environment Information

OS: openSUSE Tumbleweed 20250302
Sphinx-8.1.3

Sphinx extensions

Additional context

This bug was found while working on reproducible builds for openSUSE.

This was originally filed in sphinx-doc/sphinx#13419 but apparently the Sphinx people think this is an issue in cpython.

CPython versions tested on:

3.11, 3.14, 3.13, 3.12

Operating systems tested on:

Linux

@bmwiedemann bmwiedemann added the type-bug An unexpected behavior, bug, or error label Mar 8, 2025
@picnixz
Copy link
Member

picnixz commented Mar 8, 2025

I think Adam thinks its a CPython issue because it happens when building the docs of CPython. However it could also be a Sphinx issue (but first let's investigate if it's a CPython issue due to our CPython Sphinx extensions)

(btw, Adam and I are both Sphinx maintainers and CPython core devs so we would probably be responsible for solving the problem on either side)

@picnixz picnixz added the docs Documentation in the Doc dir label Mar 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir type-bug An unexpected behavior, bug, or error
Projects
Status: Todo
Development

No branches or pull requests

2 participants