Skip to content

New package: python3-doc-3.14.3.#59858

Open
mmdbalkhi wants to merge 1 commit intovoid-linux:masterfrom
mmdbalkhi:new/pydoc
Open

New package: python3-doc-3.14.3.#59858
mmdbalkhi wants to merge 1 commit intovoid-linux:masterfrom
mmdbalkhi:new/pydoc

Conversation

@mmdbalkhi
Copy link
Copy Markdown
Contributor

@mmdbalkhi mmdbalkhi commented Apr 9, 2026

Testing the changes

  • I tested the changes in this PR: YES

New package

cc: @ahesford

@tranzystorekk tranzystorekk added the new-package This PR adds a new package label Apr 9, 2026
@tranzystorekk tranzystorekk removed the new-package This PR adds a new package label Apr 9, 2026
@ahesford
Copy link
Copy Markdown
Member

ahesford commented Apr 9, 2026

The commit message doesn't match what you're doing, which should be more like

python3: add documentation subpackage

I have a couple of broader issues. First, I'm not sure whether we should bother with this at all, when all we end up doing is fetching and unpacking a tarball of HTML for users. Second, even if there is enough merit to offer a package, I don't know that we should complicate the existing python3 template to do so. This is a completely separate packaging process for entirely different distfiles, so it would be better served by a dedicated template.

@mmdbalkhi
Copy link
Copy Markdown
Contributor Author

I agree that it shouldn’t complicate the existing python3 template. A separate python3-doc template makes more sense since the documentation comes from different distfiles and has a completely separate packaging process.
I still think the package itself can be useful in some cases (for example for offline documentation). My original idea was to build the docs with make -C Doc so the version would always match the Python source, but that introduces a large dependency chain (python3-sphinx, etc). Because of that, using the upstream HTML(and possibly text/texinfo) docs tarball is probably the simplest approach. It keeps the package lightweight while still providing version‑matched documentation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants