Hi,

I’d like to ask about how the documentation is built. I have followed the 
instructions to build and install the C++ and Python libraries in my virtual 
environment and then followed the instructions for building the documentation. 
However unfortunately it failed. Moreover manually adding to sys.path in 
conf.py to help it find the packages doesn’t help either. In case people 
wonder, the development version of pyarrow has been installed in the virtual 
environment.

(pyarrow-dev) karlkatzen@chloes docs % make html
sphinx-build -b html -d _build/doctrees  -j8 source _build/html
Running Sphinx v4.4.0
[autosummary] generating autosummary for: c_glib/index.rst, cpp/api.rst, 
cpp/api/array.rst, cpp/api/async.rst, cpp/api/builder.rst, cpp/api/c_abi.rst, 
cpp/api/compute.rst, cpp/api/cuda.rst, cpp/api/dataset.rst, 
cpp/api/datatype.rst, ..., python/json.rst, python/memory.rst, 
python/numpy.rst, python/orc.rst, python/pandas.rst, python/parquet.rst, 
python/plasma.rst, python/timestamps.rst, r/index.rst, status.rst
WARNING: [autosummary] failed to import pyarrow.dataset.CsvFileFormat.
Possible hints:
* AttributeError: module 'pyarrow' has no attribute 'dataset'
* ImportError: no module named pyarrow.dataset
* ModuleNotFoundError: No module named 'pyarrow._dataset'
WARNING: [autosummary] failed to import pyarrow.dataset.CsvFragmentScanOptions.
Possible hints:
* AttributeError: module 'pyarrow' has no attribute 'dataset'
* ImportError: no module named pyarrow.dataset
* ModuleNotFoundError: No module named 'pyarrow._dataset'
WARNING: [autosummary] failed to import pyarrow.dataset.Dataset.
Possible hints:
* AttributeError: module 'pyarrow' has no attribute 'dataset'
* ImportError: no module named pyarrow.dataset
* ModuleNotFoundError: No module named 'pyarrow._dataset'

There is also another issue, namely sphinx-tabs not being installable with 
conda so using ci/conda_env_sphinx.txt only is not adequate in making docs 
building possible. This is not exactly documented in 
developers/documentation.rst. I wonder whether this is a temporary situation or 
we should actually change the docs to remind people to install it. If we decide 
to change it I will file a PR to fix that.

Ian

Reply via email to