[Distutils] layout and setup.py for packaging documentation

[Michael Foord]

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.

My current solution is, as Phillip suggests, to not include the docs in
distributions available via PyPI and to provide a more 'complete' download
separately.

Michael



>
>
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> http://mail.python.org/mailman/listinfo/distutils-sig
>



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