Re: [Distutils] layout and setup.py for packaging documentation

2010-03-01 Thread Marius Gedminas
On Sun, Feb 28, 2010 at 10:49:25PM -0500, P.J. Eby wrote: In other words, Jean Daniel should retain his source layout of: wordish-1.0.2/ setup.py wordish.py docs/ index.html command-ref.html And simply make sure that docs/ is under

Re: [Distutils] layout and setup.py for packaging documentation

2010-03-01 Thread Tarek Ziadé
On Mon, Mar 1, 2010 at 1:08 PM, Jean Daniel jeandaniel.bro...@gmail.com wrote: As a matter of fact, we've worked on this during the sprints, and are preparing a proposal that will let people define a place for doc (and other stuff) and let the OS packager decide where it lands (with defaults

Re: [Distutils] layout and setup.py for packaging documentation

2010-03-01 Thread Sridhar Ratnakumar
Ah, very nice! This was one of the things I wanted to discuss in the sprints. I've been mentioning this idea internally as well. Having documentation standards would ultimately benefit the user who could thus have a central place on his computer to browse documentation for installed Python

Re: [Distutils] layout and setup.py for packaging documentation

2010-03-01 Thread Sridhar Ratnakumar
On 2010-03-01, at 8:44 AM, Sridhar Ratnakumar wrote: Is the documentation directory expected to contain files in certain format - for example, with a file describing the Table-of-Contents (toc.xml) that would then be used to render MSDN like doc tree? .. and/or make a single-container (eg:

Re: [Distutils] layout and setup.py for packaging documentation

2010-03-01 Thread Tarek Ziadé
On Mon, Mar 1, 2010 at 5:52 PM, Sridhar Ratnakumar sridh...@activestate.com wrote: On 2010-03-01, at 8:44 AM, Sridhar Ratnakumar wrote: Is the documentation directory expected to contain files in certain format - for example, with a file describing the Table-of-Contents (toc.xml) that

[Distutils] layout and setup.py for packaging documentation

2010-02-28 Thread Jean Daniel
Hello, I am looking for the simplest way to package the html files related to a pure python module. At this point, I would like to just embed them in the source tarball generated by distribute and leave it to a debian or fedora package to install them. I would like a source tarball laid out as

Re: [Distutils] layout and setup.py for packaging documentation

2010-02-28 Thread P.J. Eby
At 10:03 PM 2/28/2010 +0100, Jean Daniel wrote: Can this be simpler? Yes. Don't install docs with your package. People who want them installed locally can just download your source install or use easy_install -e. Also, if your module is popular enough that people make Linux system

Re: [Distutils] layout and setup.py for packaging documentation

2010-02-28 Thread Michael Foord
On 28 February 2010 22:14, P.J. Eby p...@telecommunity.com wrote: At 10:03 PM 2/28/2010 +0100, Jean Daniel wrote: Can this be simpler? Yes. Don't install docs with your package. People who want them installed locally can just download your source install or use easy_install -e. Also,

Re: [Distutils] layout and setup.py for packaging documentation

2010-02-28 Thread Tarek Ziadé
On Sun, Feb 28, 2010 at 11:39 PM, Michael Foord fuzzy...@gmail.com wrote: On 28 February 2010 22:14, P.J. Eby p...@telecommunity.com wrote: At 10:03 PM 2/28/2010 +0100, Jean Daniel wrote: Can this be simpler? Yes.  Don't install docs with your package.  People who want them installed

Re: [Distutils] layout and setup.py for packaging documentation

2010-02-28 Thread Michael Foord
On 28 February 2010 23:03, Tarek Ziadé ziade.ta...@gmail.com wrote: On Sun, Feb 28, 2010 at 11:39 PM, Michael Foord fuzzy...@gmail.com wrote: On 28 February 2010 22:14, P.J. Eby p...@telecommunity.com wrote: At 10:03 PM 2/28/2010 +0100, Jean Daniel wrote: Can this be simpler?

Re: [Distutils] layout and setup.py for packaging documentation

2010-02-28 Thread P.J. Eby
At 10:39 PM 2/28/2010 +, Michael Foord wrote: On 28 February 2010 22:14, P.J. Eby mailto:p...@telecommunity.comp...@telecommunity.com wrote: At 10:03 PM 2/28/2010 +0100, Jean Daniel wrote: Can this be simpler? Yes. Don't install docs with your package. People who want them installed