Docs: format list of errno constants as table

[erlend-aasland]

---

📚 Documentation preview 📚: https://cpython-previews--126680.org.readthedocs.build/en/126680/library/errno.html

[asvetlov]

Looks really great, thank you!

[erlend-aasland]

Looks really great, thank you!

Thanks, Andrew, but I'm not sure we should do this; even though it looks pretty neat on desktop, the result is unfortunately not very pretty on mobile. I tried separating out the .. versionadded directives and using footnotes for the exception references, but I'm not sure if those changes makes for a better reference page.

[erlend-aasland]

We briefly discussed this on the Python Docs Discord:

• ✅ the compact layout is nice
• ✅ it's ok to group version-added directives
• ❌ putting important info into footnotes does not make for a better reference

[erlend-aasland]

BTW, the reason for removing .. availability in fd204d5, is because the errno table description already covers this:

[...] symbols that are not used on the current platform are not defined by the module.

[erlend-aasland]

putting important info into footnotes does not make for a better reference

I'm not sure how important the footnotes are in this case. Looking at this PR again three weeks later, I now think this is a net win. The preview looks nice.

[hugovk]

The first column is quite wide on mobile:

Is it possible to omit the errno. bit and just show EPERM, ENOENT, etc?

[erlend-aasland]

Is it possible to omit the errno. bit and just show EPERM, ENOENT, etc?

I'm not sure. Perhaps @AA-Turner (or another Sphinx wizard) knows? These are generated from .. data:: EPERM (and similar) directives:

.. list-table::
   :header-rows: 1

   * - Name
     - Description

   * - .. data:: EPERM
     - Operation not permitted

[AA-Turner]

See :widths:

This is relative column widths, so 1 1 would have the same effect. If you want the LHS column to be narrower then tweak the values

Suggested change

	.. list-table::
	:header-rows: 1
	.. list-table::
	:header-rows: 1
	:widths: 50 50

[AA-Turner]

Hmm, it seems the problem is actually that the names in the middle and end of the table are quite long and don't wrap -- e.g. scroll to errno.EPROTONOSUPPORT / ESOCKTNOSUPPORT / ENOTRECOVERABLE. Setting widths doesn't seem to help...