errors building docs

I am seeing some errors when I build the docs, including import errors for nonexistent date_support and basic_units modules, and:

WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.BracketB: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Curve: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.CurveA: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.CurveAB: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.CurveB: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Fancy: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Simple: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Wedge: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.LArrow: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.RArrow: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Round: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Round4: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Roundtooth: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Sawtooth: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Square: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Angle: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Angle3: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Arc: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Arc3: arg is not a Python function
WARNING: /usr/lib/python2.5/site-packages/matplotlib/patches.py:docstring of matplotlib.patches.FancyBboxPatch.set_width:2: (WARNING/2) Block quote ends without a blank line; unexpected unindent.
WARNING: /usr/lib/python2.5/site-packages/matplotlib/axes.py:docstring of matplotlib.axes.Axes.acorr:22: (ERROR/3) Unexpected indentation.
WARNING: /usr/lib/python2.5/site-packages/matplotlib/axes.py:docstring of matplotlib.axes.Axes.semilogy:3: (ERROR/3) Inconsistent literal block quoting.
WARNING: :0: (ERROR/3) Unexpected indentation.
WARNING: /home/darren/src/matplotlib/doc/api/backend_wxagg_api.rst:5: (WARNING/2) autodoc can’t import/find module ‘matplotlib.backends.backend_wxagg’, it reported error: “No module named wx”,please check your spelling and sys.path
WARNING: /home/darren/src/matplotlib/doc/api/cbook_api.rst:9: (WARNING/2) error while formatting signature for matplotlib.cbook.Xlator: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/font_manager_api.rst:: (WARNING/2) Duplicate explicit target name: “fontconfig”.
WARNING: /home/darren/src/matplotlib/doc/api/mathtext_api.rst:11: (WARNING/2) error while formatting signature for matplotlib.mathtext.Parser.State: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/mathtext_api.rst:11: (WARNING/2) error while formatting signature for matplotlib.mathtext.TruetypeFonts.CachedFont: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/api/path_api.rst:9: (WARNING/2) error while formatting signature for matplotlib.path.Path.code_type: arg is not a Python function
WARNING: /usr/lib/python2.5/site-packages/matplotlib/pyplot.py:docstring of matplotlib.pyplot.acorr:41: (ERROR/3) Unexpected indentation.
WARNING: :0: (ERROR/3) Inconsistent literal block quoting.
WARNING: /usr/lib/python2.5/site-packages/matplotlib/pyplot.py:docstring of matplotlib.pyplot.annotate:19: (ERROR/3) Unexpected indentation.
WARNING: /home/darren/src/matplotlib/doc/api/pyplot_api.rst:6380: (ERROR/3) Unknown interpreted text role “module”.
WARNING: /home/darren/src/matplotlib/doc/api/ticker_api.rst:9: (WARNING/2) error while formatting signature for matplotlib.ticker.TickHelper.DummyAxis: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.InvertedPolarTransform: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.PolarAffine: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.PolarTransform: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.RadialLocator: arg is not a Python function
WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.ThetaFormatter: arg is not a Python function

and:

checking consistency…
WARNING: /home/darren/src/matplotlib/doc/examples/index.rst:: document isn’t included in any toctree
WARNING: /home/darren/src/matplotlib/doc/faq/environment_variables_faq.rst:: document isn’t included in any toctree
WARNING: /home/darren/src/matplotlib/doc/users/arraydata.rst:: document isn’t included in any toctree

Most importantly:

copying static files…
Exception occurred:
File “/usr/lib/python2.5/shutil.py”, line 165, in rmtree
names = os.listdir(path)
OSError: [Errno 2] No such file or directory: ‘/home/darren/src/matplotlib/doc/build/html/_static/plot_directive’
The full traceback has been saved in /tmp/sphinx-err-qaZ8fg.log, if you want toreport the issue to the author.
Please also report this if it was a user error, so that a better error message can be provided next time.
Send reports to sphinx-dev@…614… Thanks!
Building HTML failed.

Darren Dale wrote:

I am seeing some errors when I build the docs, including import errors for nonexistent date_support and basic_units modules, and:

I added the ability for explicitly setting sys.path so that modules in the same directory as an example would be importable. It looks likes that has somehow broken again. I'll look into it.

WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.BracketB: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Curve: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.CurveA: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.CurveAB: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.CurveB: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Fancy: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Simple: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Wedge: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.LArrow: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.RArrow: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Round: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Round4: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Roundtooth: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Sawtooth: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Square: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Angle: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Angle3: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Arc: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Arc3: arg is not a Python function

I have never had any idea what this warning means,

WARNING: /usr/lib/python2.5/site-packages/matplotlib/patches.py:docstring of matplotlib.patches.FancyBboxPatch.set_width:2: (WARNING/2) Block quote ends without a blank line; unexpected unindent. WARNING: /usr/lib/python2.5/site-packages/matplotlib/axes.py:docstring of matplotlib.axes.Axes.acorr:22: (ERROR/3) Unexpected indentation. WARNING: /usr/lib/python2.5/site-packages/matplotlib/axes.py:docstring of matplotlib.axes.Axes.semilogy:3: (ERROR/3) Inconsistent literal block quoting. WARNING: :0: (ERROR/3) Unexpected indentation. WARNING: /home/darren/src/matplotlib/doc/api/backend_wxagg_api.rst:5: (WARNING/2) autodoc can't import/find module 'matplotlib.backends.backend_wxagg', it reported error: "No module named wx",please check your spelling and sys.path WARNING: /home/darren/src/matplotlib/doc/api/cbook_api.rst:9: (WARNING/2) error while formatting signature for matplotlib.cbook.Xlator: arg is not a Python function

WARNING: /home/darren/src/matplotlib/doc/api/font_manager_api.rst:: (WARNING/2) Duplicate explicit target name: "fontconfig". WARNING: /home/darren/src/matplotlib/doc/api/mathtext_api.rst:11: (WARNING/2) error while formatting signature for matplotlib.mathtext.Parser.State: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/mathtext_api.rst:11: (WARNING/2) error while formatting signature for matplotlib.mathtext.TruetypeFonts.CachedFont: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/path_api.rst:9: (WARNING/2) error while formatting signature for matplotlib.path.Path.code_type: arg is not a Python function

WARNING: /usr/lib/python2.5/site-packages/matplotlib/pyplot.py:docstring of matplotlib.pyplot.acorr:41: (ERROR/3) Unexpected indentation. WARNING: :0: (ERROR/3) Inconsistent literal block quoting. WARNING: /usr/lib/python2.5/site-packages/matplotlib/pyplot.py:docstring of matplotlib.pyplot.annotate:19: (ERROR/3) Unexpected indentation. WARNING: /home/darren/src/matplotlib/doc/api/pyplot_api.rst:6380: (ERROR/3) Unknown interpreted text role "module". WARNING: /home/darren/src/matplotlib/doc/api/ticker_api.rst:9: (WARNING/2) error while formatting signature for matplotlib.ticker.TickHelper.DummyAxis: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.InvertedPolarTransform: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.PolarAffine: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.PolarTransform: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.RadialLocator: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.ThetaFormatter: arg is not a Python function

and:

checking consistency... WARNING: /home/darren/src/matplotlib/doc/examples/index.rst:: document isn't included in any toctree

This one is deliberate -- it's there to help the search engine, but we don't actually want to include it in the doc.

                                                           WARNING: /home/darren/src/matplotlib/doc/faq/environment_variables_faq.rst:: document isn't included in any toctree WARNING: /home/darren/src/matplotlib/doc/users/arraydata.rst:: document isn't included in any toctree

These (I believe) are unfinished documents, that should be added to the index once they are.

Most importantly:

copying static files…
Exception occurred:
  File "/usr/lib/python2.5/shutil.py", line 165, in rmtree
    names = os.listdir(path)
OSError: [Errno 2] No such file or directory: '/home/darren/src/matplotlib/doc/build/html/_static/plot_directive'
The full traceback has been saved in /tmp/sphinx-err-qaZ8fg.log, if you want toreport the issue to the author.
Please also report this if it was a user error, so that a better error message can be provided next time.
Send reports to sphinx-dev@…614… <mailto:sphinx-dev@…614…>. Thanks!
Building HTML failed.

I haven't been able to get to the root of this problem, but an "svn-clean" in the doc directory always fixes it for me.

Cheers,
Mike

···

------------------------------------------------------------------------

------------------------------------------------------------------------------
SF.Net email is Sponsored by MIX09, March 18-20, 2009 in Las Vegas, Nevada.
The future of the web can't happen without you. Join us at MIX09 to help
pave the way to the Next Web now. Learn more and register at
http://ad.doubleclick.net/clk;208669438;13503038;i?http://2009.visitmix.com/
------------------------------------------------------------------------

_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

Michael Droettboom <mdroe@...31...> writes:

Darren Dale wrote:
> I am seeing some errors when I build the docs, including import errors
> for nonexistent date_support and basic_units modules, and:
I added the ability for explicitly setting sys.path so that modules in
the same directory as an example would be importable. It looks likes
that has somehow broken again. I'll look into it.

>
> Most importantly:
>
> copying static files…
> Exception occurred:
> File "/usr/lib/python2.5/shutil.py", line 165, in rmtree
> names = os.listdir(path)
> OSError: [Errno 2] No such file or directory:
> '/home/darren/src/matplotlib/doc/build/html/_static/plot_directive'
> The full traceback has been saved in /tmp/sphinx-err-qaZ8fg.log, if
> you want toreport the issue to the author.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> Send reports to sphinx-dev@…614…
> <mailto:sphinx-dev@…614…>. Thanks!
> Building HTML failed.
I haven't been able to get to the root of this problem, but an
"svn-clean" in the doc directory always fixes it for me.

I get a similar error that I assumed was caused by the docs being
generated by the version of matplotlib that is currently installed,
rather than the new version that has just been compiled. I know the
debian package has a workaround for this.

I get:

  Sphinx v0.5, building html
  loading pickled environment... not found
  building [html]: targets for 369 source files that are out of date
  updating environment: 369 added, 0 changed, 0 removed
  reading sources... api/afm_api api/api_changes api/artist_api makefig: fullpath=../mpl_examples/pylab_examples/findobj_demo.py, outdir=_static/plot_directive/../mpl_examples/pylab_examples
  Exception occurred:
    File "/usr/lib/python2.5/shutil.py", line 46, in copyfile
      fsrc = open(src, 'rb')
  IOError: [Errno 2] No such file or directory: '../mpl_examples/pylab_examples/findobj_demo.py'
  The full traceback has been saved in /tmp/sphinx-err-L8wLV6.log, if you want to report the issue to the author.
  Please also report this if it was a user error, so that a better error message can be provided next time.
  Send reports to sphinx-dev@...605... Thanks!
  Building HTML failed.
  
There is an examples directory, but no mpl_examples directory. Nb this
error is from the 0.98.4 tarfile compiled on debian lenny with the
sphinx 0.5 from debian's experimental packages.

Chris

I get a similar error that I assumed was caused by the docs being
generated by the version of matplotlib that is currently installed,
rather than the new version that has just been compiled. I know the
debian package has a workaround for this.

Of course we have one :slight_smile:

We build doc this way:

        ( cd doc ; MATPLOTLIBDATA=../lib/matplotlib/mpl-data/ \
                    PYTHONPATH=../build/lib.$(PY_PLATFORM)-$(DEFPY) ./make.py )

after having built mpl module. $(PY_PLATFORM)-$(DEFPY) is to be
generic on the arch and the python version we are using to build the
package, so you can replace it with the dir where the module was
compiled.

Cheers,

···

--
Sandro Tosi (aka morph, Morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

I tried that but the problem persists. I have sphinx-0.4.2 installed, are you using the same version?

···

On Sat, Dec 13, 2008 at 8:48 AM, Michael Droettboom <mdroe@…31…> wrote:

Darren Dale wrote:

I am seeing some errors when I build the docs, including import errors for nonexistent date_support and basic_units modules, and:

I added the ability for explicitly setting sys.path so that modules in the same directory as an example would be importable. It looks likes that has somehow broken again. I’ll look into it.

WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.BracketB: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Curve: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.CurveA: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.CurveAB: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.CurveB: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Fancy: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Simple: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ArrowStyle.Wedge: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.LArrow: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.RArrow: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Round: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Round4: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Roundtooth: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Sawtooth: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.BoxStyle.Square: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Angle: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Angle3: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Arc: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/artist_api.rst:37: (WARNING/2) error while formatting signature for matplotlib.patches.ConnectionStyle.Arc3: arg is not a Python function

I have never had any idea what this warning means,

WARNING: /usr/lib/python2.5/site-packages/matplotlib/patches.py:docstring of matplotlib.patches.FancyBboxPatch.set_width:2: (WARNING/2) Block quote ends without a blank line; unexpected unindent. WARNING: /usr/lib/python2.5/site-packages/matplotlib/axes.py:docstring of matplotlib.axes.Axes.acorr:22: (ERROR/3) Unexpected indentation. WARNING: /usr/lib/python2.5/site-packages/matplotlib/axes.py:docstring of matplotlib.axes.Axes.semilogy:3: (ERROR/3) Inconsistent literal block quoting. WARNING: :0: (ERROR/3) Unexpected indentation. WARNING: /home/darren/src/matplotlib/doc/api/backend_wxagg_api.rst:5: (WARNING/2) autodoc can’t import/find module ‘matplotlib.backends.backend_wxagg’, it reported error: “No module named wx”,please check your spelling and sys.path WARNING: /home/darren/src/matplotlib/doc/api/cbook_api.rst:9: (WARNING/2) error while formatting signature for matplotlib.cbook.Xlator: arg is not a Python function

WARNING: /home/darren/src/matplotlib/doc/api/font_manager_api.rst:: (WARNING/2) Duplicate explicit target name: “fontconfig”. WARNING: /home/darren/src/matplotlib/doc/api/mathtext_api.rst:11: (WARNING/2) error while formatting signature for matplotlib.mathtext.Parser.State: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/mathtext_api.rst:11: (WARNING/2) error while formatting signature for matplotlib.mathtext.TruetypeFonts.CachedFont: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/api/path_api.rst:9: (WARNING/2) error while formatting signature for matplotlib.path.Path.code_type: arg is not a Python function

WARNING: /usr/lib/python2.5/site-packages/matplotlib/pyplot.py:docstring of matplotlib.pyplot.acorr:41: (ERROR/3) Unexpected indentation. WARNING: :0: (ERROR/3) Inconsistent literal block quoting. WARNING: /usr/lib/python2.5/site-packages/matplotlib/pyplot.py:docstring of matplotlib.pyplot.annotate:19: (ERROR/3) Unexpected indentation. WARNING: /home/darren/src/matplotlib/doc/api/pyplot_api.rst:6380: (ERROR/3) Unknown interpreted text role “module”. WARNING: /home/darren/src/matplotlib/doc/api/ticker_api.rst:9: (WARNING/2) error while formatting signature for matplotlib.ticker.TickHelper.DummyAxis: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.InvertedPolarTransform: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.PolarAffine: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.PolarTransform: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.RadialLocator: arg is not a Python function WARNING: /home/darren/src/matplotlib/doc/devel/add_new_projection.rst:132: (WARNING/2) error while formatting signature for matplotlib.projections.polar.PolarAxes.ThetaFormatter: arg is not a Python function

and:

checking consistency… WARNING: /home/darren/src/matplotlib/doc/examples/index.rst:: document isn’t included in any toctree

This one is deliberate – it’s there to help the search engine, but we don’t actually want to include it in the doc.

WARNING: /home/darren/src/matplotlib/doc/faq/environment_variables_faq.rst:: document isn’t included in any toctree WARNING: /home/darren/src/matplotlib/doc/users/arraydata.rst:: document isn’t included in any toctree

These (I believe) are unfinished documents, that should be added to the index once they are.

Most importantly:

copying static files…

Exception occurred:

File “/usr/lib/python2.5/shutil.py”, line 165, in rmtree

names = os.listdir(path)

OSError: [Errno 2] No such file or directory: ‘/home/darren/src/matplotlib/doc/build/html/_static/plot_directive’

The full traceback has been saved in /tmp/sphinx-err-qaZ8fg.log, if you want toreport the issue to the author.

Please also report this if it was a user error, so that a better error message can be provided next time.

Send reports to sphinx-dev@…614… mailto:sphinx-dev@...614.... Thanks!

Building HTML failed.
I haven’t been able to get to the root of this problem, but an “svn-clean” in the doc directory always fixes it for me.

Can you post the full traceback sphinx is pointing you to,o:

/tmp/sphinx-err-qaZ8fg.log

as of your earlier post

···

On Sat, Dec 13, 2008 at 9:22 AM, Darren Dale <dsdale24@...149...> wrote:

I haven't been able to get to the root of this problem, but an "svn-clean"
in the doc directory always fixes it for me.

I tried that but the problem persists. I have sphinx-0.4.2 installed, are
you using the same version?

(John suggested in a private email to try upgrading to sphinx-0.5.)

You’re right, the error does not occur with sphinx-0.5. It looks like
the API for registering nodes has changed as of 0.5. The development
branch of sphinx was throwing errors when it got to latex, so I had a
look and came up with some changes that work with both version 0.5 and
the development branch. The changes are not compatible with
sphinx-0.4.2, but it looks like we are requiring version 0.5 or later
now anyway. If this is the case, I’ll go ahead and commit the changes.
Here is the diff, please let me know if I should commit or if I should
hold off:

$ svn diff sphinxext/

Index: sphinxext/inheritance_diagram.py

···

On Sat, Dec 13, 2008 at 10:32 AM, John Hunter <jdh2358@…149…> wrote:

On Sat, Dec 13, 2008 at 9:22 AM, Darren Dale <dsdale24@…149…> wrote:

I haven’t been able to get to the root of this problem, but an “svn-clean”

in the doc directory always fixes it for me.

I tried that but the problem persists. I have sphinx-0.4.2 installed, are

you using the same version?

===================================================================

— sphinxext/inheritance_diagram.py (revision 6612)

+++ sphinxext/inheritance_diagram.py (working copy)

@@ -39,8 +39,6 @@

 from md5 import md5                                          

from docutils.nodes import Body, Element

-from docutils.writers.html4css1 import HTMLTranslator

-from sphinx.latexwriter import LaTeXTranslator

from docutils.parsers.rst import directives

from sphinx.roles import xfileref_role

@@ -409,12 +407,9 @@

                               inheritance_diagram_directive) 

def setup(app):

  • app.add_node(inheritance_diagram)

  • HTMLTranslator.visit_inheritance_diagram = \

  •    visit_inheritance_diagram(html_output_graph)             
    
  • HTMLTranslator.depart_inheritance_diagram = do_nothing

  • LaTeXTranslator.visit_inheritance_diagram = \

  •    visit_inheritance_diagram(latex_output_graph)            
    
  • LaTeXTranslator.depart_inheritance_diagram = do_nothing

  • app.add_node(inheritance_diagram,

  •             html=(visit_inheritance_diagram(html_output_graph),
    
  •                   do_nothing))                                
    
  • app.add_node(inheritance_diagram,

  •             latex=(visit_inheritance_diagram(latex_output_graph),
    
  •                    do_nothing))                                 
    

Index: sphinxext/mathmpl.py

===================================================================

— sphinxext/mathmpl.py (revision 6612)

+++ sphinxext/mathmpl.py (working copy)

@@ -6,8 +6,6 @@

from docutils import nodes

from docutils.parsers.rst import directives

-from docutils.writers.html4css1 import HTMLTranslator

-from sphinx.latexwriter import LaTeXTranslator

import warnings

Define LaTeX math node:

@@ -69,8 +67,6 @@

     self.body.append(latex2html(node, source))                   

 def depart_latex_math_html(self, node):                          

         pass                                                     
  • HTMLTranslator.visit_latex_math = visit_latex_math_html

  • HTMLTranslator.depart_latex_math = depart_latex_math_html

    Add visit/depart methods to LaTeX-Translator:

    def visit_latex_math_latex(self, node):

@@ -83,9 +79,14 @@

                           '\\end{equation}'])

 def depart_latex_math_latex(self, node):

         pass
  • LaTeXTranslator.visit_latex_math = visit_latex_math_latex

  • LaTeXTranslator.depart_latex_math = depart_latex_math_latex

  • app.add_node(latex_math, html=(visit_latex_math_html,

  •                               depart_latex_math_html))
    
  • app.add_node(latex_math, latex=(visit_latex_math_latex,

  •                                depart_latex_math_latex))
    
  • app.add_role(‘math’, math_role)

from matplotlib import rcParams

from matplotlib.mathtext import MathTextParser

rcParams[‘mathtext.fontset’] = ‘cm’

Index: sphinxext/only_directives.py

===================================================================

— sphinxext/only_directives.py (revision 6612)

+++ sphinxext/only_directives.py (working copy)

@@ -4,8 +4,6 @@

from docutils.nodes import Body, Element

-from docutils.writers.html4css1 import HTMLTranslator

-from sphinx.latexwriter import LaTeXTranslator

from docutils.parsers.rst import directives

class html_only(Body, Element):

@@ -63,9 +61,6 @@

 directives.register_directive('latexonly', LatexOnlyDirective)

def setup(app):

  • app.add_node(html_only)

  • app.add_node(latex_only)

 # Add visit/depart methods to HTML-Translator:

 def visit_perform(self, node):

     pass

@@ -76,12 +71,7 @@

 def depart_ignore(self, node):

     node.children = []
  • HTMLTranslator.visit_html_only = visit_perform

  • HTMLTranslator.depart_html_only = depart_perform

  • HTMLTranslator.visit_latex_only = visit_ignore

  • HTMLTranslator.depart_latex_only = depart_ignore

  • LaTeXTranslator.visit_html_only = visit_ignore

  • LaTeXTranslator.depart_html_only = depart_ignore

  • LaTeXTranslator.visit_latex_only = visit_perform

  • LaTeXTranslator.depart_latex_only = depart_perform

  • app.add_node(html_only, html=(visit_perform, depart_perform))

  • app.add_node(html_only, latex=(visit_ignore, depart_ignore))

  • app.add_node(latex_only, latex=(visit_perform, depart_perform))

  • app.add_node(latex_only, html=(visit_ignore, depart_ignore))

So, should the doc be build using sphinx 0.5? Would it be the standard
version of sphinx used by mpl now on? Just to know what dependency to
throw in once building mpl for Debian :slight_smile:

···

On Mon, Dec 15, 2008 at 17:02, Darren Dale <dsdale24@...149...> wrote:

(John suggested in a private email to try upgrading to sphinx-0.5.)

You're right, the error does not occur with sphinx-0.5. It looks like the
API for registering nodes has changed as of 0.5. The development branch of
sphinx was throwing errors when it got to latex, so I had a look and came up
with some changes that work with both version 0.5 and the development
branch. The changes are not compatible with sphinx-0.4.2, but it looks like
we are requiring version 0.5 or later now anyway. If this is the case, I'll
go ahead and commit the changes. Here is the diff, please let me know if I
should commit or if I should hold off:

--
Sandro Tosi (aka morph, Morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

Yep, 0.5 it is.

···

On Tue, Dec 16, 2008 at 6:12 AM, Sandro Tosi <matrixhasu@...149...> wrote:

So, should the doc be build using sphinx 0.5? Would it be the standard
version of sphinx used by mpl now on? Just to know what dependency to
throw in once building mpl for Debian :slight_smile:

Let me correct that -- I will test Darren's patch and if we can make
it work with an earlier sphinx I'm happy to try. Stay tuned. Darren,
can I assume you have tested this with 0.4.2 and the docs are building
for you with your patch. I will test on my tree.

JDH

···

On Tue, Dec 16, 2008 at 8:40 AM, John Hunter <jdh2358@...149...> wrote:

On Tue, Dec 16, 2008 at 6:12 AM, Sandro Tosi <matrixhasu@...149...> wrote:

So, should the doc be build using sphinx 0.5? Would it be the standard
version of sphinx used by mpl now on? Just to know what dependency to
throw in once building mpl for Debian :slight_smile:

Yep, 0.5 it is

I am getting errors trying to apply this patch on the 0.98.5 branch.
Could you send a fresh diff against the HEAD of that branch, and
attach it rather than paste it.

Thanks,
JDH

···

On Mon, Dec 15, 2008 at 10:02 AM, Darren Dale <dsdale24@...149...> wrote:

You're right, the error does not occur with sphinx-0.5. It looks like the
API for registering nodes has changed as of 0.5. The development branch of
sphinx was throwing errors when it got to latex, so I had a look and came up
with some changes that work with both version 0.5 and the development
branch. The changes are not compatible with sphinx-0.4.2, but it looks like
we are requiring version 0.5 or later now anyway. If this is the case, I'll
go ahead and commit the changes. Here is the diff, please let me know if I
should commit or if I should hold off:

Here is the diff. I think I wasn’t clear though, this diff is intended to be compatible with sphinx-0.5 and later, it is not compatible with earlier versions. I can build the documentation using sphinx-0.5 with or without this patch, but the patch will be needed for future versions of sphinx, including the sphinx development branch.

I never did get to the bottom of the error building our docs with sphinx-0.4.2. I think it was an entirely different issue.

sphinxext.diff (4.14 KB)

···

On Tue, Dec 16, 2008 at 9:48 AM, John Hunter <jdh2358@…149…> wrote:

On Mon, Dec 15, 2008 at 10:02 AM, Darren Dale <dsdale24@…149…> wrote:

You’re right, the error does not occur with sphinx-0.5. It looks like the

API for registering nodes has changed as of 0.5. The development branch of

sphinx was throwing errors when it got to latex, so I had a look and came up

with some changes that work with both version 0.5 and the development

branch. The changes are not compatible with sphinx-0.4.2, but it looks like

we are requiring version 0.5 or later now anyway. If this is the case, I’ll

go ahead and commit the changes. Here is the diff, please let me know if I

should commit or if I should hold off:

I am getting errors trying to apply this patch on the 0.98.5 branch.

Could you send a fresh diff against the HEAD of that branch, and

attach it rather than paste it.

OK, after hearing the correction from Darren, the answer is that the
docs depend on sphinx 0.5 or later

Thanks,
JDH

···

On Tue, Dec 16, 2008 at 8:42 AM, John Hunter <jdh2358@...149...> wrote:

Yep, 0.5 it is

Let me correct that -- I will test Darren's patch and if we can make
it work with an earlier sphinx I'm happy to try. Stay tuned. Darren,
can I assume you have tested this with 0.4.2 and the docs are building
for you with your patch. I will test on my tree.