OK, TVM status update and a question.
I have packaged
libbacktrace
rang
and updated dlpack to >0.4
which gets tvm base libraries to build.
Then I packaged
tlcpack-sphinx-addon
autodocsumm
which allows the documentation to (start to) build (without all the samples,
which are described as 'needing a CI environment to build').
However the doc build described in docs/REDAME.txt is not just a
simple doxygen run and starts trying to download things off the net
(see log below). My question is, what is an intersphinx inventory,
and do we really need one to build the docs? Is anyone familiar with
what's going on here, or do I just need to investigate?
On the other hand the top-level 'make doc' just runs doxygen
docs/Doxyfile (and doesn't need any of the sphinx stuff, but does need
some obsolete stuff in the Doxyfile updating). This works.
I have no idea how useful this is in comparison to whatever the fancy sphinx-based docs.
I'm not quite sure which doc-build is the 'right' one. Or if both or right for different purposes?
Is anyone familia enough with this package to know?
doc-build log:
$ (cd docs; TVM_TUTORIAL_EXEC_PATTERN=none make html)
# Prepare the staging directory. Sphinx gallery automatically
# writes new .rst files into the current directory. This can
# cause issues when switching branches. By sequestering the
# auto-generated files into the staging directory, they can be
# removed without knowing the exact directory.
mkdir -p _staging
# Remove any symlinks that currently exist
find _staging -type l -exec rm {} \;
# Reproduce the directory structure
find . \
-path ./_build -prune -o -path ./_staging -prune -o \
-name "*.rst" \
-printf "_staging/%h\n" \
| sort | uniq | xargs mkdir -p
# Symlink all .rst files into the staging directory
find . \
-path ./_build -prune -o -path ./_staging -prune -o \
-name "*.rst" \
-exec ln -s /home/wookey/packages/tvm/debian/tvm-0.8.0/docs/{} _staging/{} \;
ln -s /home/wookey/packages/tvm/debian/tvm-0.8.0/docs/conf.py _staging/conf.py
ln -s /home/wookey/packages/tvm/debian/tvm-0.8.0/docs/_static _staging/_static
cd _staging && python3 -m sphinx -b html -d /home/wookey/packages/tvm/debian/tvm-0.8.0/docs/_build/doctrees . /home/wookey/packages/tvm/debian/tvm-0.8.0/docs/_build/html
Running Sphinx v4.3.2
making output directory... done
[autosummary] generating autosummary for: arch/benchmark.rst, arch/convert_layout.rst, arch/debugger.rst, arch/device_target_interactions.rst, arch/frontend/tensorflow.rst, arch/hybrid_script.rst, arch/index.rst, arch/inferbound.rst, arch/introduction_to_module_serialization.rst, arch/microtvm_design.rst, ..., reference/langref/relay_op.rst, reference/langref/relay_pattern.rst, reference/langref/relay_type.rst, reference/publications.rst, topic/microtvm/index.rst, topic/vta/dev/config.rst, topic/vta/dev/hardware.rst, topic/vta/dev/index.rst, topic/vta/index.rst, topic/vta/install.rst
Failed to import 'tvm.micro': no module named tvm.micro
Failed to import 'vta': no module named vta
loading intersphinx inventory from https://docs.python.org/3/objects.inv...
loading intersphinx inventory from https://numpy.org/doc/stable/objects.inv...
loading intersphinx inventory from https://docs.scipy.org/doc/scipy/objects.inv...
loading intersphinx inventory from https://matplotlib.org/objects.inv...
WARNING: failed to reach any of the inventories with the following issues:
intersphinx inventory 'https://matplotlib.org/objects.inv' not fetchable due to <class 'requests.exceptions.ConnectionError'>: HTTPSConnectionPool(host='matplotlib.org', port=443): Max retries exceeded with url: /objects.inv (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7fb545d13340>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))
WARNING: failed to reach any of the inventories with the following issues:
intersphinx inventory 'https://docs.scipy.org/doc/scipy/objects.inv' not fetchable due to <class 'requests.exceptions.ConnectionError'>: HTTPSConnectionPool(host='docs.scipy.org', port=443): Max retries exceeded with url: /doc/scipy/objects.inv (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7fb545d13220>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))
WARNING: failed to reach any of the inventories with the following issues:
intersphinx inventory 'https://numpy.org/doc/stable/objects.inv' not fetchable due to <class 'requests.exceptions.ConnectionError'>: HTTPSConnectionPool(host='numpy.org', port=443): Max retries exceeded with url: /doc/stable/objects.inv (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7fb545d13be0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))
WARNING: failed to reach any of the inventories with the following issues:
intersphinx inventory 'https://docs.python.org/3/objects.inv' not fetchable due to <class 'requests.exceptions.ConnectionError'>: HTTPSConnectionPool(host='docs.python.org', port=443): Max retries exceeded with url: /3/objects.inv (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7fb545d133a0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))
generating gallery...
Configuration error:
Unknown key(s) in sphinx_gallery_conf:
'find_mayavi_figures'
make: *** [Makefile:110: html] Error 2
Assuming we ignore the above complication and take the basic doxygen docs, then I have a working package for
libtvm0
libtvm-dev
tvm-doc
I guess we need a python3-tvm too and it's good enough for now.
Wookey
--
Principal hats: Debian, Wookware, ARM
http://wookware.org/
Attachment:
signature.asc
Description: PGP signature