Tommy Beadle added the comment:
The attached patch makes it so that 'code object' is its own 'top-level' entry
in the index instead of being 'code' with an 'object' sub-item. It also makes
the links from the index go to the location in the documents just before the
header instead of having the header be off-screen when the user navigates to it.
One thing about the ordering of the generated links, though, is that sphinx
appears to generate them based on the alphabetical ordering of the path to the
files that they're in:
c-api/code.rst
library/marshal.rst
library/stdtypes.rst
reference/datamodel.rst
If the order is that important, I believe it would require us to create
sub-items that could look like this:
code object
C API
built-in type
type reference
marshaling
It didn't seem like other indexed entries follow this breakout pattern, but if
that's what's desired for this case, just let me know and I'll submit a
different patch.
----------
keywords: +patch
nosy: +tbeadle
Added file:
http://bugs.python.org/file43126/0001-Issue-15476-Make-code-object-its-own-entry-in-the-do.patch
_______________________________________
Python tracker <[email protected]>
<http://bugs.python.org/issue15476>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
