<div dir="ltr">Hi,<div>Indeed the source distribution on PyPI is broken. I have added the issue to the tracker: <a href="https://github.com/matplotlib/matplotlib/issues/9735">https://github.com/matplotlib/matplotlib/issues/9735</a></div><div>In the mean time, your best option is probably to build the docs from a git checkout (from <a href="https://github.com/matplotlib/matplotlib">https://github.com/matplotlib/matplotlib</a>).</div><div>Antony</div></div><div class="gmail_extra"><br><div class="gmail_quote">2017-11-09 5:47 GMT-08:00 Andrey G. Grozin <span dir="ltr"><<a href="mailto:A.G.Grozin@inp.nsk.su" target="_blank">A.G.Grozin@inp.nsk.su</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hello *,<br>
<br>
running ./make.py in doc/ I got<br>
<br>
Traceback (most recent call last):<br>
File "./make.py", line 200, in <module><br>
copy_if_out_of_date('../INSTAL<wbr>L.rst', 'users/installing.rst')<br>
File "./make.py", line 21, in copy_if_out_of_date<br>
shutil.copyfile(original, derived)<br>
File "/usr/lib/python2.7/shutil.py"<wbr>, line 96, in copyfile<br>
with open(src, 'rb') as fsrc:<br>
IOError: [Errno 2] No such file or directory: '../INSTALL.rst'<br>
<br>
Right, there's no ../INSTALL.rst. Removed the line<br>
copy_if_out_of_date('../INSTAL<wbr>L.rst', 'users/installing.rst')<br>
from make.py. Then I got<br>
<br>
Exception occurred:<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx_gallery/gen_galle<wbr>ry.py", line 217, in generate_gallery_rst<br>
.format(examples_dir))<br>
IOError: Main example directory /var/tmp/portage/dev-python/ma<wbr>tplotlib-2.1.0/work/matplotlib<wbr>-2.1.0-python2_7/doc/../<wbr>tutorials does not have a README.txt file. Please write one to introduce your gallery.<br>
<br>
Right,there's no ../tutorials. make.py effectively calls<br>
<br>
python -msphinx . build/html -j1 -bhtml -dbuild/doctrees -Dplot_formats=png:100 -W<br>
<br>
which produces this error message. Removed all traces of tutorials from conf.py. Then I got<br>
<br>
Warning, treated as error:<br>
/var/tmp/portage/dev-python/ma<wbr>tplotlib-2.1.0/work/matplotlib<wbr>-2.1.0-python2_7/doc/users/<wbr>index.rst:12:toctree contains reference to nonexisting document u'users/installing'<br>
<br>
Right, now there's no installing. Removed it from users/index.rst. Then I got some warning treated as an error about some docsttring in matplotlib. I don't want to edit matplotlib code, so I removed '-W' from options in the function html in make.py. Now building documentation proceeds rather far. But at the end I get<br>
<br>
copying static files... done<br>
copying extra files... done<br>
dumping search index in English (code: en) ... done<br>
dumping object inventory... done<br>
build succeeded, 63 warnings.<br>
Embedding documentation hyperlinks in examples ...<br>
gallery[ 0%] index.html<br>
gallery[ 0%] 2dcollections3d.html<br>
<br>
Exception occurred:<br>
File "/usr/lib64/python2.7/anydbm.p<wbr>y", line 85, in open<br>
return mod.open(file, flag, mode)<br>
error: (11, 'Resource temporarily unavailable')<br>
The full traceback has been saved in /var/tmp/portage/dev-python/ma<wbr>tplotlib-2.1.0/temp/sphinx-err<wbr>-KYVDSp.log, if you want to report the issue to the developers.<br>
<br>
And I don't know what to do next. The log file is:<br>
<br>
# Sphinx version: 1.6.3<br>
# Python version: 2.7.14 (CPython)<br>
# Docutils version: 0.14<br>
# Jinja2 version: 2.9.6<br>
# Last messages:<br>
# copying extra files...<br>
# done<br>
# dumping search index in English (code: en) ...<br>
# done<br>
# dumping object inventory...<br>
# done<br>
# build succeeded, 63 warnings.<br>
# Embedding documentation hyperlinks in examples ...<br>
# gallery[ 0%] index.html<br>
# gallery[ 0%] 2dcollections3d.html<br>
# Loaded extensions:<br>
# sphinx.ext.inheritance_<wbr>diagram (1.6.3) from /usr/lib64/python2.7/site-pack<wbr>ages/sphinx/ext/inheritance_<wbr>diagram.pyc<br>
# matplotlib.sphinxext.mathmpl (unknown version) from /var/tmp/portage/dev-python/ma<wbr>tplotlib-2.1.0/work/matplotlib<wbr>-2.1.0-python2_7/build/lib/<wbr>matplotlib/sphinxext/mathmpl.<wbr>py<br>
# matplotlib.sphinxext.only_dir<wbr>ectives (unknown version) from /var/tmp/portage/dev-python/ma<wbr>tplotlib-2.1.0/work/matplotlib<wbr>-2.1.0-python2_7/build/lib/<wbr>matplotlib/sphinxext/only_<wbr>directives.py<br>
# IPython.sphinxext.ipython_con<wbr>sole_highlighting (unknown version) from /usr/lib64/python2.7/site-pack<wbr>ages/IPython/sphinxext/ipython<wbr>_console_highlighting.pyc<br>
# sphinx_gallery.gen_gallery (unknown version) from /usr/lib64/python2.7/site-pack<wbr>ages/sphinx_gallery/gen_galler<wbr>y.pyc<br>
# sphinx.ext.autodoc (1.6.3) from /usr/lib64/python2.7/site-pack<wbr>ages/sphinx/ext/autodoc.pyc<br>
# sphinx.ext.intersphinx (1.6.3) from /usr/lib64/python2.7/site-pack<wbr>ages/sphinx/ext/intersphinx.<wbr>pyc<br>
# sphinx.ext.doctest (1.6.3) from /usr/lib64/python2.7/site-pack<wbr>ages/sphinx/ext/doctest.pyc<br>
# matplotlib.sphinxext.plot_dir<wbr>ective (unknown version) from /var/tmp/portage/dev-python/ma<wbr>tplotlib-2.1.0/work/matplotlib<wbr>-2.1.0-python2_7/build/lib/<wbr>matplotlib/sphinxext/plot_<wbr>directive.py<br>
# alabaster (0.7.10) from /usr/lib64/python2.7/site-pack<wbr>ages/alabaster/__init__.pyc<br>
# IPython.sphinxext.ipython_dir<wbr>ective (unknown version) from /usr/lib64/python2.7/site-pack<wbr>ages/IPython/sphinxext/ipython<wbr>_directive.pyc<br>
# sphinxext.math_symbol_table (unknown version) from sphinxext/math_symbol_table.py<br>
# sphinxext.github (unknown version) from sphinxext/github.py<br>
# sphinx.ext.graphviz (1.6.3) from /usr/lib64/python2.7/site-pack<wbr>ages/sphinx/ext/graphviz.pyc<br>
# numpydoc (unknown version) from /usr/lib64/python2.7/site-pack<wbr>ages/numpydoc/__init__.pyc<br>
# sphinx.ext.autosummary (1.6.3) from /usr/lib64/python2.7/site-pack<wbr>ages/sphinx/ext/autosummary/__<wbr>init__.pyc<br>
Traceback (most recent call last):<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx/cmdline.py", line 306, in main<br>
app.build(opts.force_all, filenames)<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx/application.py", line 357, in build<br>
self.emit('build-finished', None)<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx/application.py", line 489, in emit<br>
return self.events.emit(event, self, *args)<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx/events.py", line 79, in emit<br>
results.append(callback(*args)<wbr>)<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx_gallery/docs_reso<wbr>lv.py", line 455, in embed_code_links<br>
_embed_code_links(app, gallery_conf, gallery_dir)<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx_gallery/docs_reso<wbr>lv.py", line 388, in _embed_code_links<br>
full_fname)<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx_gallery/docs_reso<wbr>lv.py", line 306, in resolve<br>
link = self._get_link(cobj)<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx_gallery/docs_reso<wbr>lv.py", line 258, in _get_link<br>
html = get_data(link, self.gallery_dir)<br>
File "/usr/lib64/python2.7/site-pac<wbr>kages/sphinx_gallery/docs_reso<wbr>lv.py", line 67, in get_data<br>
search_index = shelve.open(cached_file)<br>
File "/usr/lib64/python2.7/shelve.p<wbr>y", line 243, in open<br>
return DbfilenameShelf(filename, flag, protocol, writeback)<br>
File "/usr/lib64/python2.7/shelve.p<wbr>y", line 227, in __init__<br>
Shelf.__init__(self, anydbm.open(filename, flag), protocol, writeback)<br>
File "/usr/lib64/python2.7/anydbm.p<wbr>y", line 85, in open<br>
return mod.open(file, flag, mode)<br>
error: (11, 'Resource temporarily unavailable')<br>
<br>
Any ideas how to proceed?<br>
<br>
Does anybody check documentation generation before releases?<br>
<br>
Andrey<br>
______________________________<wbr>_________________<br>
Matplotlib-devel mailing list<br>
<a href="mailto:Matplotlib-devel@python.org" target="_blank">Matplotlib-devel@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/matplotlib-devel" rel="noreferrer" target="_blank">https://mail.python.org/mailma<wbr>n/listinfo/matplotlib-devel</a><br>
</blockquote></div><br></div>