Document deb822 sources for Ubuntu 24.04 and later - #1885
Open
opensource-joe wants to merge 1 commit into
Open
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
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.