New submission from Gabriel Genellina <gagsl-...@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)

----------
assignee: georg.brandl
components: Documentation
messages: 97239
nosy: gagenellina, georg.brandl
severity: normal
status: open
title: next/previous links in documentation skip some sections
versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue7634>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to