Path: csiph.com!news.dns-netz.com!news.freedyn.net!aioe.org!bofh.it!news.nic.it!robomod From: Simon McVittie 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: References: 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: 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: archive/latest/18049 List-ID: List-URL: 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: Xref: csiph.com linux.debian.maint.python:12400 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 . smcv