From: Eric Engestrom <eric@igalia.com>
Date: Wed, 22 Mar 2023 18:48:02 +0000 (+0000)
Subject: ci/docs: start documenting ci_run_n_monitor.py
X-Git-Tag: upstream/23.3.3~11254
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=8af8c5bd075776da251aee8fdab9c98894eccada;p=platform%2Fupstream%2Fmesa.git

ci/docs: start documenting ci_run_n_monitor.py

Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22079>
---

diff --git a/docs/ci/index.rst b/docs/ci/index.rst
index a2b72fd..6d44a3e 100644
--- a/docs/ci/index.rst
+++ b/docs/ci/index.rst
@@ -248,6 +248,18 @@ directory.  You can hack on mesa and iterate testing the build with:
 
     sudo docker run --rm -v `pwd`:/mesa $IMAGE ninja -C /mesa/_build
 
+Running specific CI jobs
+------------------------
+
+You can use ``bin/ci/ci_run_n_monitor.py`` to run specific CI jobs. It
+will automatically take care of running all the jobs yours depends on,
+and cancel the rest to avoid wasting resources.
+
+See ``bin/ci/ci_run_n_monitor.py --help`` for all the options.
+
+The ``--target`` argument takes a regex that you can use to select the
+jobs names you want to run, eg. ``--target 'zink.*'`` will run all the
+zink jobs, leaving the other drivers' jobs free for others to use.
 
 Conformance Tests
 -----------------