Bug 670493 - Broken link: file /usr/share/doc/python-docs-2.7/html/modindex.html is missing
Summary: Broken link: file /usr/share/doc/python-docs-2.7/html/modindex.html is missing
Keywords:
Status: CLOSED RAWHIDE
Alias: None
Product: Fedora
Classification: Fedora
Component: python-docs
Version: 14
Hardware: Unspecified
OS: Unspecified
low
medium
Target Milestone: ---
Assignee: Dave Malcolm
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
: 732190 (view as bug list)
Depends On:
Blocks: 771218
TreeView+ depends on / blocked
 
Reported: 2011-01-18 13:40 UTC by Tadej Janež
Modified: 2012-01-02 15:06 UTC (History)
6 users (show)

Fixed In Version: python-docs-2.7.2-2.fc17
Doc Type: Bug Fix
Doc Text:
Clone Of:
: 771218 (view as bug list)
Environment:
Last Closed: 2011-08-11 18:43:23 UTC


Attachments (Terms of Use)

Description Tadej Janež 2011-01-18 13:40:45 UTC
Description of problem:
A modindex.html file is missing from the python-docs package.


Version-Release number of selected component (if applicable):
python-docs-2.7-1.fc14.noarch

How reproducible:
Always.

Steps to Reproduce:
1. Open browser at file:///usr/share/doc/python-docs-2.7/html/index.html
2. Click on Global Module Index
3. Site is not found.

Additional info:
Opening the same link on Python's online documentation works ok.

Comment 1 Steve 2011-06-17 11:52:28 UTC
The problem exists on Fedora 15 too.
A workaround:
$ cd /usr/share/doc/python-docs-2.7.1/html
$ cp py-modindex.html modindex.html

Comment 2 Stefan Ring 2011-08-11 14:14:24 UTC
It's not only this file that's missing, but the entire C-API documentation is utterly broken. See <file:///usr/share/doc/python-docs-2.7/html/c-api/int.html>, for example.

When I still had Python 2.6 on my Fedora machine (I think it was F13), the local API doc did work. It seems that something bad happened with the transition to Python 2.7.

Comment 3 Dave Malcolm 2011-08-11 18:33:58 UTC
Thanks for filing this bug; sorry about the belated response.

I'm seeing comment 0 on Fedora 15 with
  python-docs-2.7.1-2.fc15.noarch
where:
  /usr/share/doc/python-docs-2.7.1/html/index.html
has two links to "py-modindex.html" (which works) but also a link to "modindex.html" (which doesn't)

As per comment #2: this works for me, albeit 2.7.1:
  file:///usr/share/doc/python-docs-2.7.1/html/c-api/int.html

This seems to come from sphinx; in domains/python.py I see:
class PythonModuleIndex(Index):
    """
    Index subclass to provide the Python module index.
    """

    name = 'modindex'

whereas:
domainds/std.py has:
            'modindex': ('py-modindex', '', l_('Module Index')),

(this is within python-sphinx-1.0.7-2.fc15.noarch)

Workaround committed to git as:
  http://pkgs.fedoraproject.org/gitweb/?p=python-docs.git;a=commitdiff;h=d465f3652c286afaeaeca012426b85729f84796d

This also adds a %check that runs linkchecker over the local links, to verify
that they all work.

Building python-docs-2.7.2-2.fc17 for dist-rawhide
Task info: http://koji.fedoraproject.org/koji/taskinfo?taskID=3266543

Comment 4 Stefan Ring 2011-08-12 08:56:50 UTC
> As per comment #2: this works for me, albeit 2.7.1:
>   file:///usr/share/doc/python-docs-2.7.1/html/c-api/int.html

True, this is only broken in F14, not in F15.

Comment 5 Dave Malcolm 2011-08-20 14:47:30 UTC
*** Bug 732190 has been marked as a duplicate of this bug. ***

Comment 6 Steve 2011-12-22 00:38:12 UTC
The problem still exists in Fedora 16 with python-docs 2.7.2 1.fc16

Steps to Reproduce:
1. Open browser at file:///usr/share/doc/python-docs-2.7.2/html/index.html
2. Click on Global Module Index
3. File not found
    Firefox can't find the file at /usr/share/doc/python-docs-2.7.2/html/modindex.html.

I see the status as "closed", "Fixed In Version: 	python-docs-2.7.2-2.fc17"
So the solution, applied in Aug-2011, fixed the next but one release (Fedora 17), but did not fix the upcoming (and now current) release Fedora 16?

Comment 7 Tadej Janež 2011-12-23 10:23:05 UTC
(In reply to comment #6)
> The problem still exists in Fedora 16 with python-docs 2.7.2 1.fc16

The fixed python-docs just has to be rebuilt on F16 and pushed as an update.
Maybe Dave or some other python-docs maintainer could do that?


Note You need to log in before you can comment on or make changes to this bug.