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

Re: Where to put docs of a -doc package for python 2 + 3 modules?

Path	csiph.com!news.mixmin.net!aioe.org!bofh.it!news.nic.it!robomod
From	Simon McVittie <smcv@debian.org>
Newsgroups	linux.debian.maint.python
Subject	Re: Where to put docs of a -doc package for python 2 + 3 modules?
Date	Mon, 12 Mar 2018 11:40:02 +0100
Message-ID	<vst22-6Ga-15@gated-at.bofh.it> (permalink)
References	<vssIG-6zE-9@gated-at.bofh.it>
X-Mailbox-Line	From debian-python-request@lists.debian.org Mon Mar 12 10:32:49 2018
Old-Return-Path	<smcv@debian.org>
X-Amavis-Spam-Status	No, score=-7 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, LDO_WHITELIST=-5] autolearn=ham autolearn_force=no
X-Policyd-Weight	using cached result; rate: -5
MIME-Version	1.0
Content-Type	text/plain; charset=iso-8859-1
Content-Disposition	inline
Content-Transfer-Encoding	8bit
User-Agent	Mutt/1.9.4 (2018-02-28)
X-Mailing-List	<debian-python@lists.debian.org> archive/latest/15629
List-ID	<debian-python.lists.debian.org>
List-URL	<https://lists.debian.org/debian-python/>
List-Archive	https://lists.debian.org/msgid-search/20180312103200.GA18414@espresso.pseudorandom.co.uk
Approved	robomod@news.nic.it
Lines	16
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Mon, 12 Mar 2018 10:32:00 +0000
X-Original-Message-ID	<20180312103200.GA18414@espresso.pseudorandom.co.uk>
X-Original-References	<20180312101616.GA21465@fama>
Xref	csiph.com linux.debian.maint.python:10234

Show key headers only | View raw

On Mon, 12 Mar 2018 at 11:16:16 +0100, W. Martin Borgert wrote:
> policy (12.3) says, that putting the contents of package-doc
> into /usr/share/doc/package/ (main package) is preferred over
> /usr/share/doc/package-doc/. debhelper detects the Python 2
> package as main package. One can override this to the path for
> the Python 3 package, but both feels wrong to me. Even if we
> drop Python 2 at some point, maybe then there is Python 4 or
> PyPy.

In python-mpd-doc and python-dbus-doc, I installed the real documentation
files in /u/s/d/python-*-doc, but placed symlinks to them in both
/u/s/d/python-* and /u/s/d/python3-*. Perhaps that's a reasonable way
to achieve the spirit of the Policy §12.3 recommendation while not
privileging one of Python 2, Python 3, PyPy, etc. over the others?

    smcv

Thread

Where to put docs of a -doc package for python 2 + 3 modules? "W. Martin Borgert" <debacle@debian.org> - 2018-03-12 11:20 +0100
  Re: Where to put docs of a -doc package for python 2 + 3 modules? Simon McVittie <smcv@debian.org> - 2018-03-12 11:40 +0100
    Re: Where to put docs of a -doc package for python 2 + 3 modules? "W. Martin Borgert" <debacle@debian.org> - 2018-03-12 14:30 +0100
  Re: Where to put docs of a -doc package for python 2 + 3 modules? Thomas Goirand <zigo@debian.org> - 2018-03-12 23:20 +0100
    Re: Where to put docs of a -doc package for python 2 + 3 modules? "W. Martin Borgert" <debacle@debian.org> - 2018-03-12 23:40 +0100
      Re: Where to put docs of a -doc package for python 2 + 3 modules? Ghislain Vaillant <ghisvail@gmail.com> - 2018-03-13 00:40 +0100
        Re: Where to put docs of a -doc package for python 2 + 3 modules? Ben Finney <bignose@debian.org> - 2018-03-13 08:20 +0100
        Re: Where to put docs of a -doc package for python 2 + 3 modules? Thomas Goirand <zigo@debian.org> - 2018-03-13 09:20 +0100
          Re: Where to put docs of a -doc package for python 2 + 3 modules? Ghislain Vaillant <ghisvail@gmail.com> - 2018-03-13 10:00 +0100
          Re: Where to put docs of a -doc package for python 2 + 3 modules? "W. Martin Borgert" <debacle@debian.org> - 2018-03-13 10:00 +0100
          Re: Where to put docs of a -doc package for python 2 + 3 modules? Ole Streicher <olebole@debian.org> - 2018-03-13 10:30 +0100
            Re: Where to put docs of a -doc package for python 2 + 3 modules? Thomas Goirand <zigo@debian.org> - 2018-03-13 14:10 +0100

csiph-web