anjakefala commented on code in PR #14260: URL: https://github.com/apache/arrow/pull/14260#discussion_r981842463
########## docs/source/developers/python.rst: ########## @@ -636,6 +636,52 @@ Caveats The Plasma component is not supported on Windows. +Deleting stale build artifacts +============================== + +When there have been changes to the structure of the Arrow C++ library or Pyarrow, +a thorough cleaning is recommended as a first attempt to fixing build errors. + +.. note:: + + It is not necessarily intuitive from the error itself that the problem is due to stale artifacts. + Example of a build error from stale artifacts is "Unknown CMake command "arrow_keep_backward_compatibility". + +To delete stale Arrow C++ build artifacts: + +.. code-block:: + + $ rm -rf arrow/cpp/build + +To delete stale PyArrow build artifacts: + +.. code-block:: + + $ pushd python + $ python3 setup.py clean + $ popd + +To delete misc build artifacts that are hidden from ``git``: + +.. code-block:: + + $ git clean -Xfd . + +If using a Conda environment, there are some build artifacts that get installed in +``$ARROW_HOME`` (aka ``$CONDA_PREFIX``). For example, ``$ARROW_HOME/lib/cmake/Arrow*``. Review Comment: That is why I provided that recommendation! It is a bigger thing to remove and reinstall, but it makes for cleaner, simpler advice. -- 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]
