Bug 771218

+++ This bug was initially created as a clone of Bug #670493 +++

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.

--- Additional comment from kkbbf81jd6.com on 2011-06-17 07:52:28 EDT ---

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

--- Additional comment from s.r on 2011-08-11 10:14:24 EDT ---

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.

--- Additional comment from dmalcolm on 2011-08-11 14:33:58 EDT ---

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

--- Additional comment from s.r on 2011-08-12 04:56:50 EDT ---

> 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.

--- Additional comment from dmalcolm on 2011-08-20 10:47:30 EDT ---

*** Bug 732190 has been marked as a duplicate of this bug. ***

--- Additional comment from kkbbf81jd6.com on 2011-12-21 19:38:12 EST ---

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?

--- Additional comment from tadej.janez.si on 2011-12-23 05:23:05 EST ---

(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?