[llvm] 4af3be7 - [docs] Add note on using cmake to perform the build
Evandro Menezes via llvm-commits
llvm-commits at lists.llvm.org
Fri Feb 14 11:46:29 PST 2020
Author: Evandro Menezes
Date: 2020-02-14T13:44:56-06:00
New Revision: 4af3be7b044ee67e33c8177c0c634c16dec12716
URL: https://github.com/llvm/llvm-project/commit/4af3be7b044ee67e33c8177c0c634c16dec12716
DIFF: https://github.com/llvm/llvm-project/commit/4af3be7b044ee67e33c8177c0c634c16dec12716.diff
LOG: [docs] Add note on using cmake to perform the build
Repeat the build instructions from the top level README in the Getting
Started guide.
Added:
Modified:
llvm/docs/GettingStarted.rst
Removed:
################################################################################
diff --git a/llvm/docs/GettingStarted.rst b/llvm/docs/GettingStarted.rst
index 5bf9f37384ab..48d561349108 100644
--- a/llvm/docs/GettingStarted.rst
+++ b/llvm/docs/GettingStarted.rst
@@ -46,7 +46,7 @@ This is an example workflow and configuration to get and build the LLVM source:
* ``cd build``
* ``cmake -G <generator> [options] ../llvm``
- Some common generators are:
+ Some common build system generators are:
* ``Ninja`` --- for generating `Ninja <https://ninja-build.org>`_
build files. Most llvm developers use Ninja.
@@ -75,9 +75,11 @@ This is an example workflow and configuration to get and build the LLVM source:
* ``-DLLVM_ENABLE_ASSERTIONS=On`` --- Compile with assertion checks enabled
(default is Yes for Debug builds, No for all other build types).
- * Run your build tool of choice!
+ * ``cmake --build . [--target <target>]`` or the build system specified
+ above directly.
- * The default target (i.e. ``ninja`` or ``make``) will build all of LLVM.
+ * The default target (i.e. ``cmake --build .`` or ``make``) will build all of
+ LLVM.
* The ``check-all`` target (i.e. ``ninja check-all``) will run the
regression tests to ensure everything is in working order.
@@ -85,10 +87,10 @@ This is an example workflow and configuration to get and build the LLVM source:
* CMake will generate build targets for each tool and library, and most
LLVM sub-projects generate their own ``check-<project>`` target.
- * Running a serial build will be *slow*. To improve speed, try running a
- parallel build. That's done by default in Ninja; for ``make``, use
- ``make -j NNN`` (NNN is the number of parallel jobs, use e.g. number of
- CPUs you have.)
+ * Running a serial build will be **slow**. To improve speed, try running a
+ parallel build. That's done by default in Ninja; for ``make``, use the
+ option ``-j NN``, where ``NN`` is the number of parallel jobs, e.g. the
+ number of available CPUs.
* For more information see `CMake <CMake.html>`__
More information about the llvm-commits
mailing list