tadeja opened a new issue, #49509: URL: https://github.com/apache/arrow/issues/49509
### Describe the enhancement requested When building html with `sphinx-build -j auto -b html` there are several warnings and docutils warnings/errors logged and for several causes can be eliminated. Examples of CI logs [AMD64 Conda Python 3.11 Sphinx & Numpydoc](https://github.com/apache/arrow/actions/runs/23050423049/job/66949934952#step:6:3962) [AMD64 Debian 12 Complete Documentation](https://github.com/apache/arrow/actions/runs/23047453009/job/66939994537#step:7:5012) [AMD64 Conda Python 3.12 Sphinx Documentation](https://github.com/apache/arrow/actions/runs/22908104584/job/66472440794#step:6:4096) ``` /opt/conda/envs/arrow/lib/python3.12/site-packages/numpydoc/docscrape.py:203: UserWarning: potentially wrong underline length... Example -------- in ... /opt/conda/envs/arrow/lib/python3.12/site-packages/pyarrow/compute.py:docstring of pyarrow.compute.atanh_checked:4: ERROR: Undefined substitution referenced: "x". [docutils] docstring of pyarrow.lib.BaseListArray.flatten:44: ERROR: Unexpected indentation. [docutils] docstring of pyarrow.lib.BaseListArray.flatten:47: WARNING: Definition list ends without a blank line; unexpected unindent. [docutils] ... /build/python/docs/source/cpp/api/cuda.rst:73: WARNING: Error when parsing function declaration ... WARNING: unknown role name: python:mod /build/python/docs/source/cpp/env_vars.rst:96: ERROR: Unknown interpreted text role "python:mod". [docutils] ... /build/python/docs/source/format/Security.rst:62: WARNING: undefined label: '_format_columnar' [ref.ref] /build/python/docs/source/format/Security.rst:173: WARNING: undefined label: '_ipc-message-format' [ref.ref] ... ``` ### Component(s) Documentation, Python -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
