From fdb4a2615c1559c11c99467bad0618cc55ed6aca Mon Sep 17 00:00:00 2001
From: Abin Joseph <abinjose@qti.qualcomm.com>
Date: Fri, 24 Apr 2026 16:39:09 +0530
Subject: [PATCH] how/to: add guide for creating debug builds

Copy section on creating debug builds from Yocto guide
for better visibility on the topic.

Picked from
https://docs.qualcomm.com/doc/80-80020-27/topic/debug.html?product=895724676033554725&version=2.0rc1

Signed-off-by: Abin Joseph <abinjose@qti.qualcomm.com>
---
 .../build_from_source_github.rst               |  1 +
 topic/k2c-qli-build-ga/howto_build.rst         | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/topic/k2c-qli-build-ga/build_from_source_github.rst b/topic/k2c-qli-build-ga/build_from_source_github.rst
index 14e7c86..e386400 100644
--- a/topic/k2c-qli-build-ga/build_from_source_github.rst
+++ b/topic/k2c-qli-build-ga/build_from_source_github.rst
@@ -106,6 +106,7 @@ Create and build a Yocto image:
    * The machine configurations have either UFS or EMMC storage enabled by default. To change the default storage, see :ref:`Set storage <set_storage>`.
    * To build meta-qcom tip, see :ref:`Build meta-qcom tip <build_tip>`.
    * For repo manifest based builds, see :ref:`Alternative build instructions using Manifest <build_manifest>`.
+   * For enabling debug configuration for builds, see :ref:`Create a build for debugging <debug_build>`.
 
 Flash
 -----
diff --git a/topic/k2c-qli-build-ga/howto_build.rst b/topic/k2c-qli-build-ga/howto_build.rst
index e74fec0..1b87722 100644
--- a/topic/k2c-qli-build-ga/howto_build.rst
+++ b/topic/k2c-qli-build-ga/howto_build.rst
@@ -37,6 +37,24 @@ tag for ``meta-qcom``. The milestone release provides locked revisions for the w
 
    For various ``<machine>`` and ``<distro>`` combinations, see `Release Notes <https://docs.qualcomm.com/doc/80-80022-300/>`__.
 
+.. _debug_build:
+
+Creating a build for debugging
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To generate a debug build, add ``debug.yml`` kas configuration fragment to your build command.
+To understand which kernel defconfig and config fragments are used when DEBUG_BUILD is set to 1, see Kernel recipe, under `Kernel recipes <https://docs.qualcomm.com/doc/80-80020-27/topic/meta_qcom.html?product=895724676033554725&version=2.0rc1#kernel-recipes>`__.
+
+#. Build the software image with debug configuration.
+
+   .. container:: nohighlight
+      
+      ::
+
+         kas build meta-qcom/ci/<machine.yml>:meta-qcom/ci/<distro.yml>:meta-qcom/ci/linux-qcom-6.18.yml:meta-qcom/ci/debug.yml
+
+         # Example, kas build meta-qcom/ci/iq-9075-evk.yml:meta-qcom/ci/qcom-distro.yml:meta-qcom/ci/linux-qcom-6.18.yml:meta-qcom/ci/debug.yml
+
 .. _build_manifest:
 
 Alternative build instructions using Manifest