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

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

Path	csiph.com!news.dns-netz.com!news.freedyn.net!aioe.org!bofh.it!news.nic.it!robomod
From	Simon McVittie <smcv@debian.org>
Newsgroups	linux.debian.maint.python
Subject	Re: New packages: -doc package with python or python3 prefix?
Date	Sat, 28 Mar 2020 12:30:01 +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>
X-Original-To	debian-python@lists.debian.org
X-Mailbox-Line	From debian-python-request@lists.debian.org Sat Mar 28 11:23:17 2020
Old-Return-Path	<smcv@debian.org>
X-Amavis-Spam-Status	No, score=-5.98 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, GMAIL=1, LDO_WHITELIST=-5, MURPHY_DRUGS_REL8=0.02, RCVD_IN_DNSWL_NONE=-0.0001] autolearn=no autolearn_force=no
MIME-Version	1.0
Content-Type	text/plain; charset=iso-8859-1
Content-Disposition	inline
Content-Transfer-Encoding	8bit
X-Mailing-List	<debian-python@lists.debian.org> archive/latest/18049
List-ID	<debian-python.lists.debian.org>
List-URL	<https://lists.debian.org/debian-python/>
List-Archive	https://lists.debian.org/msgid-search/20200328112258.GA470453@espresso.pseudorandom.co.uk
Approved	robomod@news.nic.it
Lines	30
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Sat, 28 Mar 2020 11:22:58 +0000
X-Original-Message-ID	<20200328112258.GA470453@espresso.pseudorandom.co.uk>
X-Original-References	<f180b2c6-97c6-70cb-9a23-7695a13ee183@debian.org> <a08b2604ba34cd6660ae8950f4c44418bc0cb305.camel@gmail.com>
Xref	csiph.com linux.debian.maint.python:12400

Show key headers only | 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