On Sat, Mar 5, 2022 at 1:35 PM Orion Poplawski orion@nwra.com wrote:

I've been poking at some packages that BR python3-docs, like python-zope-event. This apparently comes from a sphinx inventory:

# Use local objects.inv for intersphinx sed -i "s|('https://docs%5C.python%5C.org/': )None|\1'%{_docdir}/python3-docs/html/objects.inv'|" docs/conf.py

If I build without python3-docs present I get the following message but the build succeeds:

Running Sphinx v3.4.3 making output directory... done loading intersphinx inventory from /usr/share/doc/python3-docs/html/objects.inv... WARNING: failed to reach any of the inventories with the following issues: intersphinx inventory '/usr/share/doc/python3-docs/html/objects.inv' not fetchable due to <class 'FileNotFoundError'>: [Errno 2] No such file or directory: '/usr/share/doc/python3-docs/html/objects.inv'

Is this a problem or can we safely ignore it? Is there a better way to remove the intersphinx dep?

If not, how best to get python3-docs into EL9?

File a BZ against python3 in RHEL 9 to ask for it to be shipped.

On 05. 03. 22 19:34, Orion Poplawski wrote:

I've been poking at some packages that BR python3-docs, like python-zope-event.  This apparently comes from a sphinx inventory:

# Use local objects.inv for intersphinx sed -i "s|('https://docs%5C.python%5C.org/': )None|\1'%{_docdir}/python3-docs/html/objects.inv'|" docs/conf.py

If I build without python3-docs present I get the following message but the build succeeds:

Running Sphinx v3.4.3 making output directory... done loading intersphinx inventory from /usr/share/doc/python3-docs/html/objects.inv... WARNING: failed to reach any of the inventories with the following issues: intersphinx inventory '/usr/share/doc/python3-docs/html/objects.inv' not fetchable due to <class 'FileNotFoundError'>: [Errno 2] No such file or directory: '/usr/share/doc/python3-docs/html/objects.inv'

Is this a problem or can we safely ignore it?

If docs/conf.py wasn't patched, you would get a standard error that objects.inv cannot be fetched from https://docs.python.org.

I suspect many packages have that error and only couple of packagers started to pacth docs/conf.py to use python3-docs. I always considered that quite interesting but not important enough to do it myself.

Is there a better way to remove the intersphinx dep?

Don't patch/sed docs/conf.py and let it do what it does by default.

If not, how best to get python3-docs into EL9?

Package it into EPEL 9 if you really thing the instersphinx links are worth it.

It is a separate component, not a python3(.9) subpackage.

https://src.fedoraproject.org/rpms/python3-docs/

On 05. 03. 22 19:52, Neal Gompa wrote:

File a BZ against python3 in RHEL 9 to ask for it to be shipped.

That is not helpful. It's not built from python3(.9), it cannot just be shipped, it would need to be added to RHEL 9 as a new component.