I've hit a snag in the Python documentation for the logging package.
The documentation has a numbered list of handlers, some of which are
in the logging module and others of which are in the logging.handlers
module. The list contains :class:directives, not all of which resolve
correctly to cross-references. Elsewhere I have been able to use the
module/currentmodule directives to resolve references, as helpfully
pointed out by Christophe de Vienne, but in the middle of the numbered
list, it throws off the numbering because each section of the list
following a module/currentmodule directive is taken as a new list.

Of course I could just make it an unordered list; but I wondered what
the correct solution to the problem is when the list needs to be
ordered. Of course I can stick a "handlers." in front of the class
name instead of a module directive, but this looks ugly because the
"handlers." appears in the HTML which is a distraction.

The logging.rst which exhibits the problem is already checked in
(r68624).

I'd be grateful for some pointers,

Regards,

Vinay Sajip

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to 
[email protected]
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to