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

2015-10-28 Thread Brian May
Matthias Klose writes: > I'd like to see a section with examples too, maybe even referencing > particular > packages, which show good practice for a given use case, or which demonstrate > some feature. Examples of how to override dh_auto_test to run custom tests would be good. It seems to be

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-28 Thread Piotr Ożarowski
> > I stopped working on it because now I > > have to prove dh-python is not responsible for maintainers that override > > dh_auto_install and rm egg-info or new "features" in python3.5 > > I don't understand that sentence. it's just my rant of the day. Each day I choose a victim and enable Piotr

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

2015-10-28 Thread Nikolaus Rath
On Oct 28 2015, Piotr Ożarowski wrote: >> > 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). Looks great. That would

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 responsi

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 su

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 ar

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 ve

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 m