[PATCH 1/2] manuals: update disk space requirements

michael.opdenacker
2023-03-16T20:48:14Z

From: Michael Opdenacker <michael.opdenacker@bootlin.com>

Tests made on Poky master on March 16, 2023.

Add a "Free Disk Space" section to the "System Requirements" document.

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
---
documentation/brief-yoctoprojectqs/index.rst | 2 +-
documentation/poky.yaml.in | 2 ++
documentation/ref-manual/system-requirements.rst | 9 +++++++++
3 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst
index 7b8baf233a..5410036a30 100644
--- a/documentation/brief-yoctoprojectqs/index.rst
+++ b/documentation/brief-yoctoprojectqs/index.rst
@@ -40,7 +40,7 @@ Compatible Linux Distribution
Make sure your :term:`Build Host` meets the
following requirements:

-- 50 Gbytes of free disk space
+- &MIN_DISK_SPACE; Gbytes of free disk space

- Runs a supported Linux distribution (i.e. recent releases of Fedora,
openSUSE, CentOS, Debian, or Ubuntu). For a list of Linux
diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
index 30e1050824..7810b8d2a5 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -41,3 +41,5 @@ MIN_TAR_VERSION : "1.28"
MIN_GIT_VERSION : "1.8.3.1"
MIN_GCC_VERSION : "7.5"
MIN_MAKE_VERSION : "4.0"
+# Disk space (Gbytes) needed to generate qemux86-64 core-image-sato on Ubuntu 22.04 (x86-64), rounded up from 87
+MIN_DISK_SPACE : "90"
diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst
index 0fbe3f12c8..1add92e85d 100644
--- a/documentation/ref-manual/system-requirements.rst
+++ b/documentation/ref-manual/system-requirements.rst
@@ -31,6 +31,15 @@ and conceptual information in the :doc:`/overview-manual/index`.

.. _detailed-supported-distros:

+Free Disk Space
+===============
+
+To build an image such as ``core-image-sato``, you need a system with at least
+&MIN_DISK_SPACE; Gbytes of free disk space.
+
+If you have a shortage of disk space, see the ":doc:`/dev-manual/disk-space`"
+section of the Development Tasks Manual.
+
Supported Linux Distributions
=============================

--
2.34.1