Bug 609642

Summary:	sphinx-1.0b is breaking autodoc
Product:	[Fedora] Fedora	Reporter:	Toshio Kuratomi <tkuratom>
Component:	python-sphinx	Assignee:	Michel Lind <michel>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	medium	Docs Contact:
Priority:	low
Version:	14	CC:	a.badger, michel
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2011-01-18 05:28:40 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Toshio Kuratomi 2010-06-30 18:23:56 UTC

Description of problem:

Just tried to rebuild python-nose and got a failure in building the docs:
http://koji.fedoraproject.org/koji/taskinfo?taskID=2283973

Looking at the build.log, sphinx is failing here:

reading sources... [ 48%] plugins/allmodules
reST markup error:
<autodoc>:19: (SEVERE/4) Problems with "include" directive path:
IOError: [Errno 2] No such file or directory: 'builddir/build/BUILD/nose-0.11.3/nose/plugins/allmodules.py'.
make: *** [html] Error 1

Looks like the directory is missing an initial '/' (should be /builddir/build/BUILD/nose-0.11.3/nose/plugins/allmodules.py)


Version-Release number of selected component (if applicable):
python-sphinx-1.0-0.1.b2.fc14

How reproducible:
Everytime

Steps to Reproduce:
1. try to scratch build python-nose from the devel branch in rawhide
2.
3.

Additional info:

The same srpm will scratch build on F-13 where we have sphinx-0.6.6

Comment 1 Michel Lind 2010-07-02 15:23:14 UTC

Has upstream been contacted? If sphinx 1.0 is likely to be out in the F-14 time frame then we probably should encourage projects using it to upgrade to the new API.

If that does not happen fast enough, perhaps a compatibility package is needed (yikes).

Comment 2 Toshio Ernie Kuratomi 2010-07-02 15:37:52 UTC

Upstream hasn't been contacted yet -- I've got my hands in a lot of areas right now :-(  If you can reproduce and take it to upstream that would be great.

I haven't found precisely where the include path is being created but I think this is a simple bug rather than an API change.

Comment 3 Michel Lind 2010-07-02 15:47:47 UTC

Noticed after posting my comment that this is indeed just a simple bug -- I can reproduce it, but have not pinpointed the exact fault yet. Let me try looking at post-beta2 changes to see if this has actually been fixed.

Comment 4 Bug Zapper 2010-07-30 12:21:02 UTC

This bug appears to have been reported against 'rawhide' during the Fedora 14 development cycle.
Changing version to '14'.

More information and reason for this action is here:
http://fedoraproject.org/wiki/BugZappers/HouseKeeping

Comment 5 Toshio Ernie Kuratomi 2011-01-18 05:28:40 UTC

Looks to be fixed:

http://koji.fedoraproject.org/koji/taskinfo?taskID=2727800