[cctbxbb] Python documentation

Nathaniel Echols nechols at lbl.gov
Mon Oct 8 06:47:16 PDT 2012


On Mon, Oct 8, 2012 at 3:48 AM, David Waterman <dgwaterman at gmail.com> wrote:
> I've got a few questions about the automatically generated Python
> documentation.
> ...
> 3. Similarly, what determines which packages are documented or not? For
> example, from http://cctbx.sourceforge.net/current/python/rstbx.html, cftbx
> is documented but bpcx is not. Is there at some point a manual decision
> about what should be documented?

I think the partial answer is that the while the documentation is
automatically generated, it is only updated on demand - i.e. someone
needs to run a script to rebuild the online docs.  Not surprisingly,
this hasn't been done since at least May.  I'll see if I can figure
out how to do this today (which may help answer the other questions).

-Nat


More information about the cctbxbb mailing list