From 0d0e472b8f78c71b11d3c3321376a0e89ca45f09 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mart=C3=AD=20Bol=C3=ADvar?= Date: Sat, 6 Feb 2021 17:23:18 -0800 Subject: [PATCH] doc: improve docs on building without west MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Make it more obvious what needs to happen by spelling out the commands. Signed-off-by: Martí Bolívar --- doc/guides/west/without-west.rst | 27 ++++++++++++++++++++------- 1 file changed, 20 insertions(+), 7 deletions(-) diff --git a/doc/guides/west/without-west.rst b/doc/guides/west/without-west.rst index 0f371c04df2..5a56aa20197 100644 --- a/doc/guides/west/without-west.rst +++ b/doc/guides/west/without-west.rst @@ -46,17 +46,30 @@ As you pull changes in the zephyr repository, you will also need to maintain those additional repositories, adding new ones as necessary and keeping existing ones up to date at the latest revisions. -Specifying Modules ------------------- +Building applications +--------------------- -If you have west installed, the Zephyr build system will use it to set -:ref:`ZEPHYR_MODULES `. If you don't have west -installed and your application does not need any of these -repositories, the build will still work. +You can build a Zephyr application using CMake and Ninja (or make) directly +without west installed if you specify any modules manually. + +.. zephyr-app-commands:: + :zephyr-app: samples/hello_world + :tool: cmake + :goals: build + :gen-args: -DZEPHYR_MODULES=module1;module2;... + :compact: + +When building with west installed, the Zephyr build system will use it to set +:ref:`ZEPHYR_MODULES `. + +If you don't have west installed and your application does not need any of +these repositories, the build will still work. If you don't have west installed and your application *does* need one of these repositories, you must set :makevar:`ZEPHYR_MODULES` -yourself. See :ref:`modules` for details. +yourself as shown above. + +See :ref:`modules` for more details. Flashing and Debugging ----------------------