Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.maint.python > #12400

Re: New packages: -doc package with python or python3 prefix?

From Simon McVittie <smcv@debian.org>
Newsgroups linux.debian.maint.python
Subject Re: New packages: -doc package with python or python3 prefix?
Date 2020-03-28 12:30 +0100
Message-ID <zPhP3-2HF-1@gated-at.bofh.it> (permalink)
References <zPh2F-2bp-3@gated-at.bofh.it> <zPhcl-2eE-3@gated-at.bofh.it>
Organization linux.* mail to news gateway

Show all headers | View raw


On Sat, 28 Mar 2020 at 11:44:35 +0100, ghisvail@gmail.com wrote:
> Le samedi 28 mars 2020 à 11:22 +0100, Christian Kastner a écrit :
> > The Python 2 removal page [1] states that existing python-$foo-doc
> > packages should not be renamed to python3-$foo-doc.
> > 
> > But what about new packages? I have a package in NEW that provides
> > python3-tpot, but should the doc package have a python- or python-3
> > prefix?
> > 
> > [1] https://wiki.debian.org/Python/2Removal
> 
> I believe it should remain python- (as the programming language),
> instead of python3- (the major version targeted).

In cases where the documentation is large enough to justify a separate
binary package, this matches my understanding of the policy. If/when there
is eventually a Python 4, I think we would want the module that is used
via "import tpot" to ship python3-tpot, python4-tpot and python-tpot-doc
binary packages; it would seem odd for the documentation for python4-tpot
to be in python3-tpot-doc.

If the documentation is small (in particular if there's just a README),
skip the -doc package and include the documentation in python3-tpot.

Unfortunately https://www.debian.org/doc/packaging-manuals/python-policy/
doesn't say anything either way on this. I think it should, and I'll open
a bug with a reference to the proposed patch in
<https://salsa.debian.org/cpython-team/python3-defaults/-/merge_requests/4>.

    smcv

Back to linux.debian.maint.python | Previous | Next — Previous in thread | Find similar | Unroll thread


Thread

New packages: -doc package with python or python3 prefix? Christian Kastner <ckk@debian.org> - 2020-03-28 11:40 +0100
  Re: New packages: -doc package with python or python3 prefix? ghisvail@gmail.com - 2020-03-28 11:50 +0100
    Re: New packages: -doc package with python or python3 prefix? Simon McVittie <smcv@debian.org> - 2020-03-28 12:30 +0100

csiph-web