Document deb822 sources for Ubuntu 24.04 and later - #1885
Conversation
Closes python#1530. The dependency instructions tell you to uncomment `deb-src` lines in /etc/apt/sources.list. On Ubuntu 24.04 that file is a four line stub whose own comments say the sources have moved, and there is nothing to uncomment. A contributor following the guide gets: E: You must put some 'deb-src' URIs in your sources.list Verified on Ubuntu 24.04.4 LTS. `apt-get build-dep -s python3` fails exactly as above with the file as shipped. Adding `deb-src` to the `Types` field in /etc/apt/sources.list.d/ubuntu.sources and running `apt-get update` makes it resolve. Ubuntu's own generated file documents this at line 21: ## Types: Append deb-src to enable the fetching of source package. The 22.04 one-line instructions are kept rather than replaced, since releases still using that format need them.
|
The following commit authors need to sign the Contributor License Agreement: |
Documentation build overview
|
|
Why are you closing and re-opening? You also have to sign the CLA before we can review. |
|
Asking for a hand with the I have signed the CLA. Everything I can verify myself lines up, so there is no address mismatch to correct:
Both identity fields on the commit also resolve to this account rather than sitting unlinked. The bot has re-evaluated four times today and returned One thing I should own up to: those re-evaluations came from me closing and reopening this PR, since So my question is whether there is something further on my end that I have missed, or whether this needs someone who can see the CLA records. Happy to try anything suggested. I am equally happy for this to sit until someone has time, since it is a small documentation change and nothing is urgent about it. For what it is worth the content side is green: |
|
I expect this is due to the recent GitHub outage, which had apparently just been resolved: https://www.githubstatus.com/incidents/zkxwbgr0cnmx So let's try again. @opensource-joe Please also read the AI policy: https://devguide.python.org/getting-started/ai-tools/ Specifically:
Which also applies to PR and issue comments, so please avoid pasting AI output directly. |
Closes #1530.
The problem, reproduced
The Debian/Ubuntu tab tells you to enable source packages by editing
/etc/apt/sources.list, either by adding adeb-srcline or by uncommenting the ones already there.On Ubuntu 24.04 that file is a four line stub, and its own comments explain why:
There is nothing to uncomment. A contributor who follows the guide as written reaches the next step and gets:
Which is an unhelpful place to land on your first CPython build.
Verification
On Ubuntu 24.04.4 LTS, tested in both directions:
/etc/apt/sources.listas shippeddeb-srclines to uncommentapt-get build-dep -s python3before the changeE: You must put some 'deb-src' URIs in your sources.listdeb-srctoTypesinubuntu.sourcesandapt-get updatepython3-sphinxdiffagainst the backup is identical, andbuild-depfails again as beforeUbuntu's own generated
ubuntu.sourcesdocuments the fix at line 21:What changed
The 22.04 one-line instructions are kept, not replaced, since releases still using that format need them. The section now branches on which format the release uses, and names the file each one actually lives in.
I have not built the docs locally to check the rendering of the nested literal blocks inside the tab, so that is worth a glance in review.