wjones127 commented on a change in pull request #11820: URL: https://github.com/apache/arrow/pull/11820#discussion_r761657687
########## File path: docs/source/developers/guide/step_by_step/building.rst ########## @@ -35,17 +35,83 @@ Building Arrow's libraries 🏋🏿♀️ ********************************* +If you decide to contribute to Arrow you will meet the topic of +compiling source code and use of CMake. You may have some +experience with it or not. If not, it is good to read through +this part so you understand what is happening in the process of +building Arrow better. +If you feel comfortable with compiling then feel free to proceed +to the :ref:`C++ <building-arrow-cpp>`, :ref:`PyArrow <build_pyarrow>` or +`R package build section <https://arrow.apache.org/docs/r/articles/developing.html>`_. Building C++ ============ +Why build C++ from source? +-------------------------- + +The core of Arrow is written in C++ and all bindings in other +languages (Python, R, ..) are wrapping underlying +C++ functions. Even if you want to work on PyArrow or R package +the source code of C++ may have to be edited also. + +About CMake +----------- + +CMake is a cross platform build system generator and it uses make +for the actual build. In the compiling process of Arrow what will +most probably be needed is some tweaking of the flags that are added +to cmake in the compiling process of Arrow. + + +Optional flags and why might we use them +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +.. TODO short description of the use of flags Review comment: Two things worth mentioning here: 1. R and Python have specific lists of flags in their respective building docs that can be referenced. 2. We now have [CMake Presets](https://github.com/apache/arrow/blob/master/docs/source/developers/cpp/building.rst#cmake-presets) which are useful starting points. -- 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]
