[Distutils] layout and setup.py for packaging documentation

[Michael Foord]

On 28 February 2010 23:03, Tarek Ziadé <ziade.tarek at gmail.com> wrote:

> On Sun, Feb 28, 2010 at 11:39 PM, Michael Foord <fuzzyman at gmail.com>
> wrote:
> >
> >
> > On 28 February 2010 22:14, P.J. Eby <pje at 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, if your module is popular enough that people make Linux system
> >> packages for it, they will make sure the docs get put in a blessed
> install
> >> location.  Python doesn't currently have a blessed install location for
> >> documentation, though perhaps it *should* have one in distutils2.
> >
> > How to include documentation in a package is a common question, so it
> would
> > be great if distutils2 could deal with this issue.
>
> 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 per OS).
>
> I'll post if there when its ready, hopefully soon
>

That sounds great.

Michael



>
> Tarek
>



-- 
http://www.ironpythoninaction.com/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20100228/4d3af46f/attachment.html>