BUG: "python make.py html" for documentation is giving error

[Swati-Sneha]

Pandas version checks

• I have checked that this issue has not already been reported.

• I have confirmed this bug exists on the latest version of pandas.

• I have confirmed this bug exists on the main branch of pandas.

Reproducible Example

python make.py html

Issue Description

While trying to build documentation for pandas-dev, the build fails with Sphinx parallel build error

Stackoverflow Issue Reference

Expected Behavior

The build should be successful and the docs should be built in local

Installed Versions

INSTALLED VERSIONS

commit : 2a10e04
python : 3.10.15
python-bits : 64
OS : Darwin
OS-release : 23.6.0
Version : Darwin Kernel Version 23.6.0: Fri Jul 5 17:56:39 PDT 2024; root:xnu-10063.141.1~2/RELEASE_ARM64_T8122
machine : arm64
processor : arm
byteorder : little
LC_ALL : None
LANG : en_US.UTF-8
LOCALE : en_US.UTF-8

pandas : 0+untagged.35606.g2a10e04
numpy : 1.26.4
dateutil : 2.9.0
pip : 24.2
Cython : 3.0.11
sphinx : 8.1.1
IPython : 8.28.0
adbc-driver-postgresql: None
adbc-driver-sqlite : None
bs4 : 4.12.3
blosc : None
bottleneck : 1.4.0
fastparquet : 2024.5.0
fsspec : 2024.9.0
html5lib : 1.1
hypothesis : 6.114.1
gcsfs : 2024.9.0post1
jinja2 : 3.1.4
lxml.etree : 5.3.0
matplotlib : 3.9.2
numba : 0.60.0
numexpr : 2.10.1
odfpy : None
openpyxl : 3.1.5
psycopg2 : 2.9.9
pymysql : 1.4.6
pyarrow : 17.0.0
pyreadstat : 1.2.7
pytest : 8.3.3
python-calamine : None
pytz : 2024.2
pyxlsb : 1.0.10
s3fs : 2024.9.0
scipy : 1.14.1
sqlalchemy : 2.0.35
tables : 3.10.1
tabulate : 0.9.0
xarray : 2024.9.0
xlrd : 2.0.1
xlsxwriter : 3.2.0
zstandard : 0.23.0
tzdata : 2024.2
qtpy : None
pyqt5 : None

[vamsi-verma-s]

@Swati-Sneha - Pls try deleting build directory and build again.

[Swati-Sneha]

@vamsi-verma-s I have done that already.

I also asked this in the slack channel, seems I am not the only one facing it.

[rhshadrach]

I can build the docs locally and the CI has been successful. But neither of these are on arm64.

The line count is off because there are some lines injected into the rst files in order to do e.g. import pandas as pd. My guess is the issue is from this code block:

pandas/doc/source/whatsnew/v1.5.0.rst

Lines 39 to 52 in 68d9dca

	.. ipython:: python
	import pyarrow as pa
	ser_float = pd.Series([1.0, 2.0, None], dtype="float32[pyarrow]")
	ser_float
	list_of_int_type = pd.ArrowDtype(pa.list_(pa.int64()))
	ser_list = pd.Series([[1, 2], [3, None]], dtype=list_of_int_type)
	ser_list
	ser_list.take([1, 0])
	ser_float * 5
	ser_float.mean()
	ser_float.dropna()

What happens when you run that?

[Swati-Sneha]

What do you mean @rhshadrach ? When I run what? The command: python make.py html or are you refering to something else?

[rhshadrach]

The code in the code-block in my comment.

[Swati-Sneha]

This is what I get when I run it from my terminal, seems okay to me.

[rhshadrach]

Can you try python make.py html --num-jobs=1. Hopefully that should give you a stack trace.

[loicdiridollou]

FYI I was bumping into the same issue (on Mac arm m1).
The parallel build bumps on different point, always in the whatsnew files but since it is parallel it is not always the same one.
However running in linear as recommended by @rhshadrach enables the process to complete without issues.