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

Re: Side effect of dropping python2 with -doc packages

Path	csiph.com!aioe.org!bofh.it!news.nic.it!robomod
From	Andrey Rahmatullin <wrar@debian.org>
Newsgroups	linux.debian.maint.python
Subject	Re: Side effect of dropping python2 with -doc packages
Date	Tue, 13 Aug 2019 19:50:01 +0200
Message-ID	<yuJ5L-4Wj-1@gated-at.bofh.it> (permalink)
References	<yuICJ-4LH-7@gated-at.bofh.it>
X-Original-To	debian-python@lists.debian.org
X-Mailbox-Line	From debian-python-request@lists.debian.org Tue Aug 13 17:40:50 2019
Old-Return-Path	<wrar@debian.org>
X-Amavis-Spam-Status	No, score=-12 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, LDO_WHITELIST=-5, PGPSIGNATURE=-5, RCVD_IN_DNSWL_NONE=-0.0001] autolearn=ham autolearn_force=no
X-Policyd-Weight	using cached result; rate:hard: -3.5
Dkim-Signature	v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=wrar.name; s=20160710; h=In-Reply-To:Content-Type:MIME-Version:References:Message-ID: Subject:To:From:Date:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:List-Subscribe: List-Post:List-Owner:List-Archive; bh=ZbqYmuxLHajr5p4L1lEeE1d5kJhSkYB1Xaz+3PCll8k=; b=odkutCdB7YU9QrIWPLPg0n7Ova McfzHl5gTIsTT9GFnArRdSBcXfAiHEjmmwiFbF7NDDN7oKzILAMyxqXwr4i9aqnPFg5Nx0/tC30q/ GQLU9Olp4+spYfq2eXzoPmDG6YqsVKkBCzFN4HYri4YIXg1f5WlYxHJLD+Ro7B5WjXbk=;
MIME-Version	1.0
Content-Type	multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="lMM8JwqTlfDpEaS6"
Content-Disposition	inline
User-Agent	Mutt/1.10.1 (2018-07-13)
X-Mailing-List	<debian-python@lists.debian.org> archive/latest/17120
List-ID	<debian-python.lists.debian.org>
List-URL	<https://lists.debian.org/debian-python/>
List-Archive	https://lists.debian.org/msgid-search/20190813174035.GC1759@belkar.wrar.name
Approved	robomod@news.nic.it
Lines	70
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Tue, 13 Aug 2019 22:40:35 +0500
X-Original-Message-ID	<20190813174035.GC1759@belkar.wrar.name>
X-Original-References	<CAPQicOy1fS2y7ZXQXAoz5wu8m=LZ+a5jy9Hd6c=TSVODXm=J+Q@mail.gmail.com>
Xref	csiph.com linux.debian.maint.python:11616

Show key headers only | View raw

[Multipart message — attachments visible in raw view] - view raw

On Tue, Aug 13, 2019 at 10:16:28AM -0700, Joseph Herlant wrote:
> While tidying up some packages before taking some time off I realized
> that some packages like django-tables had binary packages that took
> the convention of creating -doc packages using <binary package>-doc (a
> very long time ago).
> 
> The result was the location of the doc changed from
> /usr/share/doc/python-django-tables2-doc to
> /usr/share/doc/python-django-tables2 with the bump to compat 11.
> 
> But now that we dropped the python2 binary package we end up with the
> "main package" not being detected anymore and the doc moved back to
> /usr/share/doc/python-django-tables2-doc.
Yes, this is the third email on this in the last month, previous two
didn't get any replies.

> The way I read the policy, it seems the -doc package should be <source
> package name>-doc. Am I correct to read it this way?
I don't think 12.3 mentions source packages or describes what to do when
there are multiple main subpackages.

> I see several possibilities on how to handle that:
>  * leave it as is and it's fine (but doesn't match Policy 12.3)
>  * overwrite dh_installdocs to pass --doc-main-package
>  * rename the -docs package to match <source package>-doc and have the
> ftp-master rm the old one
>  * have dh_installdocs translate python into python3 package names
> when looking for the main package
Note that there are two questions here, about the package name and about
the file path. For the first question the answer is in
https://lists.debian.org/debian-python/2019/07/msg00080.html: "Please keep
the python-foo-doc package. Do not rename it to python3-foo-doc. If
python-foo was providing documentation: move it to python3-foo or create
python-foo-doc (not python3-foo-doc!) binary package."
For the second question, I'm keeping the things as is if the docs are
installed into /python-foo-doc/ and change /python-foo/ to /python3-foo/
otherwise. I'm not bumping the compat level so no /python-foo-doc/ to
/python-foo/ changes occur.

-- 
WBR, wRAR

Thread

Side effect of dropping python2 with -doc packages Joseph Herlant <aerostitch@debian.org> - 2019-08-13 19:20 +0200
  Re: Side effect of dropping python2 with -doc packages Andrey Rahmatullin <wrar@debian.org> - 2019-08-13 19:50 +0200
    Re: Side effect of dropping python2 with -doc packages Joseph Herlant <herlantj@gmail.com> - 2019-08-13 20:10 +0200
      Re: Side effect of dropping python2 with -doc packages Andrey Rahmatullin <wrar@debian.org> - 2019-08-13 20:20 +0200

csiph-web