From 55bc165b9a021373f7eacfe7aae887993c4fb54e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?=
 <2031761+viniciusferrao@users.noreply.github.com>
Date: Wed, 26 Aug 2026 17:03:22 -0300
Subject: [PATCH] docs(builds): describe the source-only build mode

---
 docs/source/developers/guides/code/builds.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/source/developers/guides/code/builds.rst b/docs/source/developers/guides/code/builds.rst
index 8ffb9eef9..9f7f5cbe3 100644
--- a/docs/source/developers/guides/code/builds.rst
+++ b/docs/source/developers/guides/code/builds.rst
@@ -9,6 +9,17 @@ Clone the xCAT project from `GitHub <https://github.com/xcat2/xcat-core>`_::
     cd xcat-core
     ./buildcore.sh
 
+To build the source rpms and no binary rpms, set ``SRCONLY``::
+
+    cd xcat-core
+    ./buildcore.sh SRCONLY=1
+
+A source rpm is the input that a build service such as mock, koji, COPR or OBS
+takes, and it lets one machine make the source rpms while another makes the
+binary rpms for each architecture. ``rpmbuild`` does not need the packages named
+in ``BuildRequires`` to make a source rpm, so this also builds on a machine that
+cannot complete a full build. ``SRCONLY`` is not supported on AIX.
+
 xcat-deps
 ---------