Hello,

I have some issues generating Pyglet's documentation.

1.1.x was using epydoc (and probably some sphinx too), but 1.2 is using
sphinx only. Looks like we have a patched Sphinx extension in our tree
to make autodoc work with pyglet.

My problem is basically that some autodoc strings aren't extracted properly.

For example:

 this:

 https://code.google.com/p/pyglet/source/browse/pyglet/window/__init__.py#362

 results in:

http://pyglet-current.usebox.net/api/window/pyglet.window.Window.html#pyglet.window.Window.invalid

We're using `autoattribute` and that result isn't correct according to
Sphinx documentation:

http://sphinx-doc.org/ext/autodoc.html#directive-autoattribute

I can't explain what's going on. I suspect this behaviour is related to
our patched version of autosummary, but I don't have the knowledge or
the time to find out what's going on.

May be someone on the list knows how Pyglet's doc generation works and
can give me some pointers.

Regards,

Juan

-- 
jjm's home: http://www.usebox.net/jjm/
blackshell: http://blackshell.usebox.net/

-- 
You received this message because you are subscribed to the Google Groups 
"pyglet-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/pyglet-users.
For more options, visit https://groups.google.com/groups/opt_out.

Reply via email to