jorisvandenbossche commented on code in PR #49259:
URL: https://github.com/apache/arrow/pull/49259#discussion_r2895908744
##########
docs/source/developers/python/building.rst:
##########
@@ -576,12 +572,28 @@ PyArrow are:
* - ``PYARROW_BUNDLE_CYTHON_CPP``
- Bundle the C++ files generated by Cython
- ``0`` (``OFF``)
- * - ``PYARROW_BUILD_VERBOSE``
- - Enable verbose output from Makefile builds
- - ``0`` (``OFF``)
- * - ``PYARROW_PARALLEL``
- - Number of processes used to compile PyArrow’s C++/Cython components
- - ``''``
+
+To set the build type (e.g. ``Debug``, ``Release``, ``RelWithDebInfo``), pass
+``-C cmake.build-type=Debug`` to ``pip install`` or to ``python -m build``.
+
+For extra CMake arguments you can use the ``-C cmake.args=``
+argument when building PyArrow. For example, to build a version of PyArrow
+with ``ARROW_SIMD_LEVEL=NONE``, you can run
+``pip install --no-build-isolation -vv -C cmake.args="-DARROW_SIMD_LEVEL=NONE"
.``.
+
+On PyArrow 24.0.0 we migrated our Python build backend from setuptools to
+scikit-build-core, which is a CMake-based build system. Previous versions used
+``PYARROW_CMAKE_OPTIONS`` environment variable to pass CMake options in the
form of
+``-D<OPTION>=<VALUE>``. This is no longer supported.
+Instead, use the ``-C cmake.args=-D<OPTION>=<VALUE>`` option as described
above.
Review Comment:
```suggestion
On PyArrow 24.0.0 we migrated our Python build backend from setuptools to
scikit-build-core, which is a CMake-based build system. Previous versions
used
``PYARROW_BUILD_TYPE`` and ``PYARROW_CMAKE_OPTIONS`` environment variables
to customize the CMake invocation. This is no longer supported.
Instead, use the ``-C cmake.build-type=<build_type>`` and ``-C
cmake.args=-D<OPTION>=<VALUE>`` option as described above.
```
Small suggestion to include ``PYARROW_BUILD_TYPE`` as well (for my local
setup, that is the main one I have to update)
--
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]
