Error building docs

[Tony Yu]

I'm getting an IOError when rebuilding the docs and I can't figure out the cause. The error is raised during the build of the api docs and appears to be in `source/api/skimage.filter.lpi_filter.txt`:

writing output... [ 22%] api/skimage.filter.lpi_filter                              

Exception occurred:

  File "/Library/Python/2.6/site-packages/sphinx/ext/graphviz.py", line 219, in render_dot_html

    mapfile = open(outfn + '.map', 'rb')

IOError: [Errno 2] No such file or directory: '/Users/Tony/python/devel/skimage/doc/build/html/_images/inheritance-f7d294ea888e27c920fbf193effa642a3152b1be.png.map'

The full sphinx traceback is at the end of this email. NOTE: this error only occurs when *RE*building. Running `make clean` and then `make html` in the doc directory works fine, but re-running `make html` will raise this error.

Any ideas what's going on here?

-Tony

# Sphinx version: 1.1.3

# Python version: 2.6.1

# Docutils version: 0.9 release

# Jinja2 version: 2.6

Traceback (most recent call last):

  File "/Library/Python/2.6/site-packages/sphinx/cmdline.py", line 189, in main

    app.build(force_all, filenames)

  File "/Library/Python/2.6/site-packages/sphinx/application.py", line 204, in build

    self.builder.build_update()

  File "/Library/Python/2.6/site-packages/sphinx/builders/__init__.py", line 196, in build_update

    'out of date' % len(to_build))

  File "/Library/Python/2.6/site-packages/sphinx/builders/__init__.py", line 252, in build

    self.write(docnames, list(updated_docnames), method)

  File "/Library/Python/2.6/site-packages/sphinx/builders/__init__.py", line 292, in write

    self.write_doc(docname, doctree)

  File "/Library/Python/2.6/site-packages/sphinx/builders/html.py", line 419, in write_doc

    self.docwriter.write(doctree, destination)

  File "/Library/Python/2.6/site-packages/docutils/writers/__init__.py", line 77, in write

    self.translate()

  File "/Library/Python/2.6/site-packages/sphinx/writers/html.py", line 38, in translate

    self.document.walkabout(visitor)

  File "/Library/Python/2.6/site-packages/docutils/nodes.py", line 173, in walkabout

    if child.walkabout(visitor):

  File "/Library/Python/2.6/site-packages/docutils/nodes.py", line 173, in walkabout

    if child.walkabout(visitor):

  File "/Library/Python/2.6/site-packages/docutils/nodes.py", line 165, in walkabout

    visitor.dispatch_visit(self)

  File "/Library/Python/2.6/site-packages/docutils/nodes.py", line 1611, in dispatch_visit

    return method(node)

  File "/Library/Python/2.6/site-packages/sphinx/ext/inheritance_diagram.py", line 340, in html_visit_inheritance_diagram

    alt='Inheritance diagram of ' + node['content'])

  File "/Library/Python/2.6/site-packages/sphinx/ext/graphviz.py", line 219, in render_dot_html

    mapfile = open(outfn + '.map', 'rb')

IOError: [Errno 2] No such file or directory: '/Users/Tony/python/devel/skimage/doc/build/html/_images/inheritance-f7d294ea888e27c920fbf193effa642a3152b1be.png.map'

[Stéfan van der Walt]

On May 8, 2012 8:53 PM, "Tony Yu" <tsy...@gmail.com> wrote:
>
> I'm getting an IOError when rebuilding the docs and I can't figure out the cause. The error is raised during the build of the api docs and appears to be in `source/api/skimage.filter.lpi_filter.txt`:
>
> writing output... [ 22%] api/skimage.filter.lpi_filter                              
> Exception occurred:
>   File "/Library/Python/2.6/site-packages/sphinx/ext/graphviz.py", line 219, in render_dot_html
>     mapfile = open(outfn + '.map', 'rb')
> IOError: [Errno 2] No such file or directory: '/Users/Tony/python/devel/skimage/doc/build/html/_images/inheritance-f7d294ea888e27c920fbf193effa642a3152b1be.png.map'

Why are inheritance trees generated? I didn't think we enabled those?

Stéfan

[Tony Yu]

I don't know, @stefanv: why are inheritance trees generated? ;)

The build runs fine if 'sphinx.ext.inheritance_diagram' is removed from the list of sphinx extensions.

-Tony

[Stéfan van der Walt]

On Wed, May 9, 2012 at 7:25 AM, Tony Yu <tsy...@gmail.com> wrote:
> I don't know, @stefanv: why are inheritance trees generated? ;)
>
> The build runs fine if 'sphinx.ext.inheritance_diagram' is removed from the
> list of sphinx extensions.

Well, let's do that then :)

Stéfan

[Tony Yu]

On Thu, Sep 13, 2012 at 8:01 PM, Melissa Cline <melissa...@gmail.com> wrote:

Did you ever get this problem figured out?  I'm having exactly the same problem...

Hi Melissa,

This was fixed back in May: 

    https://github.com/scikits-image/scikits-image/commit/01d86e3317e63d94286166962c1c7c0229a08538

Which version of scikits-image are you using? The latest release (0.6, released in June) shouldn't have this issue.

Best,

-Tony