[Distutils] Best practices on distributing documentation and examples with eggs?

2007-08-02 Thread Stanley A. Klein
On Thu, July 26, 2007 9:50 pm, Phillip J. Eby wrote: At 02:13 PM 7/26/2007 -0500, Dave Peterson wrote: In further discussions at Enthought, we're now thinking that creating a 'docs' dir as a top-level under python itself makes sense, and then the installation of eggs could copy docs and/or

Re: [Distutils] Best practices on distributing documentation and examples with eggs?

2007-07-31 Thread Philipp von Weitershausen
Phillip J. Eby wrote: At 02:55 PM 7/26/2007 -0400, Barry Warsaw wrote: On Jul 26, 2007, at 11:52 AM, Phillip J. Eby wrote: There are a few different ways you could do this. The easiest would be to put a docs subdirectory either inside one of your packages or inside your .egg-info

Re: [Distutils] Best practices on distributing documentation and examples with eggs?

2007-07-31 Thread Phillip J. Eby
At 08:48 AM 7/31/2007 +0200, Philipp von Weitershausen wrote: But isn't .egg-info completely recreatable through setup.py? Not if you're putting other data there, no. Chandler, for example, has an i18n framework that stores message catalogs and other localized resources there. Of course, it's

[Distutils] Best practices on distributing documentation and examples with eggs?

2007-07-26 Thread Dave Peterson
Over on the enthought-dev mailing list we're having a bit of a discussion on what the best way to distribute documenation and examples is for projects that we distribute binary eggs for. The general consensus is that it would be very nice indeed if there was a way to generate a tarball, or

Re: [Distutils] Best practices on distributing documentation and examples with eggs?

2007-07-26 Thread Phillip J. Eby
At 02:13 PM 7/26/2007 -0500, Dave Peterson wrote: In further discussions at Enthought, we're now thinking that creating a 'docs' dir as a top-level under python itself makes sense, and then the installation of eggs could copy docs and/or examples there in a manner similar to how it handles scripts

Re: [Distutils] Best practices on distributing documentation and examples with eggs?

2007-07-26 Thread Phillip J. Eby
At 04:07 PM 7/26/2007 -0400, Barry Warsaw wrote: On Jul 26, 2007, at 3:44 PM, Phillip J. Eby wrote: Note that if you are using a revision control system, and setuptools deletes a file from there, it might get restored by your revision control, and that could potentially be a problem unless you

[Distutils] Best practices on distributing documentation and examples with eggs?

2007-07-26 Thread Stanley A. Klein
On Thu, July 26, 2007 12:46 pm, Phillip J. Eby wrote: At 03:02 AM 7/26/2007 -0500, Dave Peterson wrote: Over on the enthought-dev mailing list we're having a bit of a discussion on what the best way to distribute documenation and examples is for projects that we distribute binary eggs for. The

Re: [Distutils] Best practices on distributing documentation and examples with eggs?

2007-07-26 Thread Dave Peterson
Stanley A. Klein wrote: On Thu, July 26, 2007 12:46 pm, Phillip J. Eby wrote: At 03:02 AM 7/26/2007 -0500, Dave Peterson wrote: Over on the enthought-dev mailing list we're having a bit of a discussion on what the best way to distribute documenation and examples is for projects that we

Re: [Distutils] Best practices on distributing documentation and examples with eggs?

2007-07-26 Thread Phillip J. Eby
At 02:55 PM 7/26/2007 -0400, Barry Warsaw wrote: On Jul 26, 2007, at 11:52 AM, Phillip J. Eby wrote: There are a few different ways you could do this. The easiest would be to put a docs subdirectory either inside one of your packages or inside your .egg-info directory, then use the