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


Groups > linux.debian.maint.python > #12398 > unrolled thread

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

Started byChristian Kastner <ckk@debian.org>
First post2020-03-28 11:40 +0100
Last post2020-03-28 12:30 +0100
Articles 3 — 3 participants

Back to article view | Back to linux.debian.maint.python


Contents

  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

#12398 — New packages: -doc package with python or python3 prefix?

FromChristian Kastner <ckk@debian.org>
Date2020-03-28 11:40 +0100
SubjectNew packages: -doc package with python or python3 prefix?
Message-ID<zPh2F-2bp-3@gated-at.bofh.it>
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

[toc] | [next] | [standalone]


#12399

Fromghisvail@gmail.com
Date2020-03-28 11:50 +0100
Message-ID<zPhcl-2eE-3@gated-at.bofh.it>
In reply to#12398
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).

[toc] | [prev] | [next] | [standalone]


#12400

FromSimon McVittie <smcv@debian.org>
Date2020-03-28 12:30 +0100
Message-ID<zPhP3-2HF-1@gated-at.bofh.it>
In reply to#12399
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

[toc] | [prev] | [standalone]


Back to top | Article view | linux.debian.maint.python


csiph-web