Path: csiph.com!news.mixmin.net!aioe.org!bofh.it!news.nic.it!robomod From: Simon McVittie 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: References: X-Mailbox-Line: From debian-python-request@lists.debian.org Mon Mar 12 10:32:49 2018 Old-Return-Path: 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: archive/latest/15629 List-ID: List-URL: 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 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