[Python-modules-team] Bug#567369: python-networkx: print provide -doc package (or include most important doc pieces within package)

[Sandro Tosi]

On Thu, Jan 28, 2010 at 01:07:39PM -0500, Yaroslav Halchenko wrote:
> Version 0.99 broke API compatibility with previous release (0.37).
> Upstream nicely outlines those changes in
>
> ./doc/source/reference/api_0.99.rst
> ./doc/source/reference/api_1.0.rst
>
> It would be great to have either a complete -doc package or at least api*rst
> files shipped within python-networkx since they provide critical information
> (since no other upstream changelog  is available).

The current version of networx, 1.1, needs sphinx 1.0 to build doc,
but 1.0 is still under development and the sphinx version in debian
can't build documentation. Thus for now I'm forced to implement some
sort of workaround to it: I'll install doc/source as doc, and replace
it with he real do when I'll be able to build it from source.

Notes to self: to generate the docs

- build the module: python setup.py build
- run "make -C doc PYTHONPATH=../build/lib/ html"

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi