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

2015-10-28 Thread Matthias Klose
On 26.10.2015 12:36, Piotr Ożarowski wrote: there are manpages: pybuild¹, dh_python3² / dh_python2³ / dh_pypy⁴ there's a wiki page⁵ with examples, there's even /usr/share/doc/dh-python/README.PyDist⁶ and a talk⁷ about pybuild during DebConf... but people still tell me dh-python's documentation

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

2015-10-28 Thread Piotr Ożarowski
> > Can you be more specific about what's missing? > > I for one lack a high level presentation of how the various bits work together here's what I got so far (I wanted to provide it as /usr/share/doc/dh-python/README). I stopped working on it because now I have to prove dh-python is not

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

2015-10-28 Thread Barry Warsaw
On Oct 28, 2015, at 05:59 PM, Piotr Ożarowski wrote: >Each day I choose a victim and enable Piotr's evil mode. Beware the Eye of Piotr. :) -Barry

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

2015-10-27 Thread Barry Warsaw
On Oct 26, 2015, at 06:28 PM, Raphael Hertzog wrote: >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. I agree with this. When you know where to look, the documentation is actually quite good. Maybe there

dh-python (pybuild + dh_py*) documentation

2015-10-26 Thread Piotr Ożarowski
there are manpages: pybuild¹, dh_python3² / dh_python2³ / dh_pypy⁴ there's a wiki page⁵ with examples, there's even /usr/share/doc/dh-python/README.PyDist⁶ and a talk⁷ about pybuild during DebConf... but people still tell me dh-python's documentation sucks so... How can I improve it? Do you need

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

2015-10-26 Thread Raphael Hertzog
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