On Tue, Sep 30, 2008 at 10:35 AM, Robert Bradshaw
<[EMAIL PROTECTED]> wrote:

>> b) A script to build them is shipped with Cython (setup.py could do
>> this
>> I suppose)
>
> If Sphinx is detected, and it's fast. I certainly don't want it to be
> a requirement.

Please feel free to pillage anything from the ipython sources you may
want for this.  We build the docs only when
'sdist' or 'bdist_rpm' are given, so that only package distributors
need to have the toolchain installed:

http://bazaar.launchpad.net/%7Eipython-dev/ipython/trunk/annotate/1147?file_id=setup.py-20080216095032-xb0is4a97lmosv2z-14

lines 97-120.

There's also a bit of nasty trickery in

http://bazaar.launchpad.net/%7Eipython-dev/ipython/trunk/annotate/1147?file_id=setupbase.py-20080606221622-xwbqrw3mlwq01vyb-1

line 146, func make_dir_struct() to be able to easily produce the
necessary data layout for distutils to ship the nested doc tree.

You guys already have the makefile and sphinx code, but take any of
this you may find useful.

Anything for better docs :)

Cheers,

f
_______________________________________________
Cython-dev mailing list
[email protected]
http://codespeak.net/mailman/listinfo/cython-dev

Reply via email to