summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorAlexander Kanavin <alex@linutronix.de>2025-06-23 14:42:57 +0200
committerRichard Purdie <richard.purdie@linuxfoundation.org>2025-06-30 17:44:22 +0100
commit3b41841b274739e9fdee7b885487f876f81f93f3 (patch)
treee4ce5d159c2b5ed342601faf3853ff1542418def /documentation
parent73ecebe8a65159b32017789f5d676577bce2031e (diff)
downloadpoky-3b41841b274739e9fdee7b885487f876f81f93f3.tar.gz
migration-guides/migration-5.1.rst: correct S/UNPACKDIR patterns for file-only recipes
It is not necessary to set both; just setting S to UNPACKDIR is enough. This has already been done across oe-core master, and correct advice should be given for those who need to adjust recipes during migration. (From yocto-docs rev: e69144a2420cf412ff62a394583acc3f82413c69) Signed-off-by: Alexander Kanavin <alex@linutronix.de> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/migration-guides/migration-5.1.rst6
1 files changed, 2 insertions, 4 deletions
diff --git a/documentation/migration-guides/migration-5.1.rst b/documentation/migration-guides/migration-5.1.rst
index c9bb38699b..94b527bdcb 100644
--- a/documentation/migration-guides/migration-5.1.rst
+++ b/documentation/migration-guides/migration-5.1.rst
@@ -20,8 +20,7 @@ S = ${WORKDIR} no longer supported
20If a recipe has :term:`S` set to be :term:`WORKDIR`, this is no longer 20If a recipe has :term:`S` set to be :term:`WORKDIR`, this is no longer
21supported, and an error will be issued. The recipe should be changed to:: 21supported, and an error will be issued. The recipe should be changed to::
22 22
23 S = "${WORKDIR}/sources" 23 S = "${UNPACKDIR}"
24 UNPACKDIR = "${S}"
25 24
26Any :term:`WORKDIR` references where files from :term:`SRC_URI` are referenced 25Any :term:`WORKDIR` references where files from :term:`SRC_URI` are referenced
27should be changed to :term:`S`. These are commonly in :ref:`ref-tasks-compile`, 26should be changed to :term:`S`. These are commonly in :ref:`ref-tasks-compile`,
@@ -62,8 +61,7 @@ require to add an :term:`S` definition to a recipe that only uses
62``file://`` :term:`SRC_URI` entries. To be consistent, the following pattern is 61``file://`` :term:`SRC_URI` entries. To be consistent, the following pattern is
63recommended:: 62recommended::
64 63
65 S = "${WORKDIR}/sources" 64 S = "${UNPACKDIR}"
66 UNPACKDIR = "${S}"
67 65
68Building C files from :term:`UNPACKDIR` without setting :term:`S` to point at 66Building C files from :term:`UNPACKDIR` without setting :term:`S` to point at
69it does not work as the debug prefix mapping doesn't handle that. 67it does not work as the debug prefix mapping doesn't handle that.