[issue7634] next/previous links in documentation skip some sections
report at bugs.python.org
Tue Jan 5 01:19:51 CET 2010
New submission from Gabriel Genellina <gagsl-py2 at yahoo.com.ar>:
The next/previous links in the documentation skip some sections. This happens both in HTML format and the CHM Windows help file.
e.g.: in the Library Reference, section "8.5 StringIO" [next] points to "8.7 textwrap", skipping section "8.6 cStringIO". And section "9.12 UserDict" [next] points to "9.15 Types", skipping sections 9.13 and 9.14 (UserList and UserString). Same with their reverse links: 9.15 [previous] points to 9.12.
It seems those links connect *files*, not *sections*, and such logic fails when a single file contains more than a section. From a user POV that's not the expected behavior: the next/previous links should navigate the complete document, regardless of its physical implementation (the actual .rst files).
(In that case this might be a Sphinx bug rather than a Python one)
nosy: gagenellina, georg.brandl
title: next/previous links in documentation skip some sections
versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2
Python tracker <report at bugs.python.org>
More information about the Python-bugs-list