Vinay Sajip schrieb: > 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,
I wouldn't recommend changing the current module just for references. Instead, use :class:`~handlers.FileHandler` or somesuch -- the tilde will remove everything before the last name part from the output while pointing to the right class. Georg --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
