since "tomorrow" has passed and I haven't pushed yet: upgrade to use sphinx's 1.1 autosummary didn't go that smooth -- I could be wrong but imho there is a regression in how autosummary/generate.py behaves -- imho now sphinx-autogen doesn't behave as it should have. Here is the post I have sent to sphinx-dev which for some reason (moderation?) was not yet posted -- so I think that tomorrow I will just revert to patching our local copy for now:
,--- | Subject: [sphinx-autogen, autosummary] does not have access to any documenter? | | Hi to everyone and Georg and Pauli in particular ;) | | Was trying to address a bug against our software (PyMVPA) in Debian so | it stays compatible with new sphinx 1.1.2, where previously we were | using 1.0.8. I got a bit confused with the result of running | generate.py (or sphinx-autogen) -- all generated (only) files for | (sub)modules carried no information about methods/functions etc. | Looking into the sphinx code I saw refactoring in | | autosummary/__init__.py:get_documenter | | to rely on | | AutoDirective._registry | | to get a correct documenter for a given object... but I could not see | how AutoDirective could be populated by then with any, which is done | actually in autodoc.py:setup which requires sphinx's app, which is N/A | within sphinx-autogen (I could be wrong here). | | So -- is it my incorrect assumptions for how sphinx-autogen should | operate or there is a regression bug? | | Thank you in advance for the clarifications! `--- > thank you guys for the report, patch, discussion > I will upload the fix tomorrow -- it will revert to use sphinx's native > generate whenever sphinx >= 1.1 (so old copy will remain inside to build > docs on older releases of debian&ubuntu). -- =------------------------------------------------------------------= Keep in touch www.onerussian.com Yaroslav Halchenko www.ohloh.net/accounts/yarikoptic -- To UNSUBSCRIBE, email to debian-bugs-rc-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
