From dc5cf7b76c2ea95f2de3d64757e397e005b4285d Mon Sep 17 00:00:00 2001 From: Marti Bolivar Date: Thu, 19 Jan 2023 16:42:41 -0800 Subject: [PATCH] doc: west: improve 'manifest --validate' section I got a couple of questions about what this command's purpose is and how to debug 'valid' manifests that aren't working as desired. Add some information to address this. Signed-off-by: Marti Bolivar --- doc/develop/west/manifest.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/develop/west/manifest.rst b/doc/develop/west/manifest.rst index e5518213d5e..d94e87e8d2a 100644 --- a/doc/develop/west/manifest.rst +++ b/doc/develop/west/manifest.rst @@ -2114,6 +2114,17 @@ or fails with an error: The error message can help diagnose errors. +Here, "invalid" means that the syntax of the manifest file doesn't follow the +rules documented on this page. + +If your manifest is valid but it's not working the way you want it to, turning +up the verbosity with ``-v`` is a good way to get detailed information about +what decisions west made about your manifest, and why: + +.. code-block:: none + + west -v manifest --validate + .. _west-manifest-path: Get the manifest path