#sphinx-doc

I'm at a bit of a loss as to why my py-modindex is empty (https://api.pub.build.mozilla.org/docs/py-modin...) when there are classes defined (https://api.pub.build.mozilla.org/docs/developm..., bottom)

I'm using WebSupport, which may be related.. but in general I'm just not sure where to start debugging this

djmitche: Any log messages?

nothing of interest - http://pastebin.mozilla.org/7540197

Is html_domain_indices enabled?

yes

I had it at its default, but just tried setting it explicitly

I notice that https://docs.python.org/2/py-modindex.html is a single page, but that link is a directory.

I think that's a WebSupport thing

the second link I pasted ends in / too

py-modindex.fpickle is empty too

I haven't worked with py-modindex before; I'm at a loss too.

Is there a way to run the build with more verboseness? Could you add debugging print statements or something to the py-modindex generation to see where it's reading for classes?

Or see if there's a place to configure what classes are considered for the index.

I was hoping you knew :)

I was too, but I don't.

heh, well, thanks for brainstorming

Idling in an IRC channel does not, sadly, convey knowledge through osmosis. :)

I know.. I've been trying for years and still nothing

Maybe it just takes longer to kick in.

looks like a sphinx bug

There's one filed?

not yet

ah, there is - https://bitbucket.org/birkenfeld/sphinx/issue/1...

thanks again for debugging w/ me

:)

Very thorough comment!

repro recipes always help

They certainly do.

Hi all

Hi

I'm still new to the whole sphinx thingy (and I like it a lot) but I'm still tripping over little things. For example sphinx complains with "/home/ask/src/kvprinter/docs/source/api.rst:50: WARNING: invalid signature for autoclass ('KvFormatter(self, field_names, \\\ndefault=namedlist.NO_DEFAULT, filters=None)')" when I try to break a rather long line with \. What can I do?

the given line is: .. autoclass:: KvFormatter(self, field_names, \

default=namedlist.NO_DEFAULT, filters=None)