[PATCH 11/11] ref-manual/kickstart.rst: document the include directive

Antonin Godard <[email protected]> Thu, 25 Jun 2026 11:33:38 +0200
Newsgroups org.yoctoproject.lists.docs
Message-ID <[email protected]>
Including WKS files into others can be useful to avoid duplicating code
for similar images. Add documentation for it.

The example was taken from the meta/files/wic/directdisk-bootloader-config.wks
file in OE-Core.

Signed-off-by: Antonin Godard <[email protected]>
---
 documentation/ref-manual/kickstart.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/documentation/ref-manual/kickstart.rst b/documentation/ref-manual/kickstart.rst
index 692ee2de0..e7cba555a 100644
--- a/documentation/ref-manual/kickstart.rst
+++ b/documentation/ref-manual/kickstart.rst
@@ -232,3 +232,15 @@ supports the following options:
 -  ``--timeout``: Specifies the number of seconds before the
    bootloader times out and boots the default option.
 
+Directive: include
+==================
+
+The ``include`` directive can be used to include a WKS file into another. The
+only argument to this command is the path to the file to include, relative to
+the current file. For example:
+
+.. code-block:: shell
+
+   include common.wks.inc
+
+   bootloader --configfile="directdisk-bootloader-config.cfg"

-- 
2.54.0