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

Re: dh-python (pybuild + dh_py*) documentation

Path	csiph.com!eternal-september.org!feeder.eternal-september.org!aioe.org!bofh.it!news.nic.it!robomod
From	Raphael Hertzog <hertzog@debian.org>
Newsgroups	linux.debian.maint.python
Subject	Re: dh-python (pybuild + dh_py*) documentation
Date	Mon, 26 Oct 2015 18:30:01 +0100
Message-ID	<qnTKN-2CZ-9@gated-at.bofh.it> (permalink)
References	<qnOi6-7DV-19@gated-at.bofh.it>
X-Original-To	debian-python@lists.debian.org
X-Mailbox-Line	From debian-python-request@lists.debian.org Mon Oct 26 17:28:44 2015
Old-Return-Path	<raphael@ouaza.com>
X-Amavis-Spam-Status	No, score=-7.009 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, HEADER_FROM_DIFFERENT_DOMAINS=0.001, LDO_WHITELIST=-5, T_RP_MATCHES_RCVD=-0.01] autolearn=ham autolearn_force=no
Mail-Followup-To	Raphael Hertzog <hertzog@debian.org>, debian-python@lists.debian.org
MIME-Version	1.0
Content-Type	text/plain; charset=utf-8
Content-Disposition	inline
Content-Transfer-Encoding	8bit
User-Agent	Mutt/1.5.24 (2015-08-30)
X-Virus-Status	Clean
X-Mailing-List	<debian-python@lists.debian.org> archive/latest/13119
List-ID	<debian-python.lists.debian.org>
List-URL	<https://lists.debian.org/debian-python/>
List-Archive	https://lists.debian.org/msgid-search/20151026172829.GC6492@home.ouaza.com
Approved	robomod@news.nic.it
Lines	26
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Mon, 26 Oct 2015 18:28:29 +0100
X-Original-Message-ID	<20151026172829.GC6492@home.ouaza.com>
X-Original-References	<20151026113605.GW15907@sar0.p1otr.com>
Xref	csiph.com linux.debian.maint.python:7807

Show key headers only | View raw

Hi Piotr,

On Mon, 26 Oct 2015, Piotr Ożarowski wrote:
> How can I improve it? Do you need more detailed description of options?
> Do you need more examples? Or maybe I should hide most of options, the
> "corner case" ones? I focus on making things work out of the box, if
> possible, and make it very customizable so that weird corner cases are
> possible as well - this means there are a lot of options, is this the
> problem?
> 
> Can you be more specific about what's missing?

I for one lack a high level presentation of how the various bits work together
and a clear description of the "magic" behind each tool.

For instance, dh_python2 explains that it tries to translate Python
dependencies into Debian dependencies but it's not clear that it needs
the corresponding packages installed (so it's not clear that for this
to work you have to add something to Build-Depends).

Cheers,
-- 
Raphaël Hertzog ◈ Debian Developer

Support Debian LTS: http://www.freexian.com/services/debian-lts.html
Learn to master Debian: http://debian-handbook.info/get/

Thread

dh-python (pybuild + dh_py*) documentation Piotr Ożarowski <piotr@debian.org> - 2015-10-26 12:40 +0100
  Re: dh-python (pybuild + dh_py*) documentation Raphael Hertzog <hertzog@debian.org> - 2015-10-26 18:30 +0100
    Re: dh-python (pybuild + dh_py*) documentation Barry Warsaw <barry@debian.org> - 2015-10-27 20:20 +0100
    Re: dh-python (pybuild + dh_py*) documentation Piotr Ożarowski <piotr@debian.org> - 2015-10-28 14:10 +0100
      Re: dh-python (pybuild + dh_py*) documentation Nikolaus Rath <Nikolaus@rath.org> - 2015-10-28 17:40 +0100
        Re: dh-python (pybuild + dh_py*) documentation Piotr Ożarowski <piotr@debian.org> - 2015-10-28 18:00 +0100
          Re: dh-python (pybuild + dh_py*) documentation Barry Warsaw <barry@debian.org> - 2015-10-28 19:30 +0100
  Re: dh-python (pybuild + dh_py*) documentation Matthias Klose <doko@debian.org> - 2015-10-28 13:30 +0100
    Re: dh-python (pybuild + dh_py*) documentation Brian May <bam@debian.org> - 2015-10-28 22:50 +0100

csiph-web