From 8fc967d0c7dbe64424c92fbe2ced736d4b1e0423 Mon Sep 17 00:00:00 2001 From: Yoann Congal Date: Tue, 28 May 2024 19:52:07 +0200 Subject: migration-5.1: add the recommended pattern for S/UNPACKDIR definition (From yocto-docs rev: 9fb708986cb9019062078f8a34288c44f2667dbd) Signed-off-by: Yoann Congal Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/migration-guides/migration-5.1.rst | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) (limited to 'documentation') diff --git a/documentation/migration-guides/migration-5.1.rst b/documentation/migration-guides/migration-5.1.rst index c1cc711a42..b43fecc2dd 100644 --- a/documentation/migration-guides/migration-5.1.rst +++ b/documentation/migration-guides/migration-5.1.rst @@ -59,9 +59,14 @@ Previously, :term:`S` was always created but after the recent changes it is no longer the case. This means the check in ``do_unpack_qa`` triggers where :term:`S` is not created by a recipe while it didn't happen before. This can require to add an :term:`S` definition to a recipe that only uses -``file://`` :term:`SRC_URI` entries. Building C files from :term:`UNPACKDIR` -without setting :term:`S` to point at it does not work as the debug prefix -mapping doesn't handle that. +``file://`` :term:`SRC_URI` entries. To be consistent, the following pattern is +recommended:: + + S = "${WORKDIR}/sources" + UNPACKDIR = "${S}" + +Building C files from :term:`UNPACKDIR` without setting :term:`S` to point at +it does not work as the debug prefix mapping doesn't handle that. ``devtool`` and ``recipetool`` have been updated to handle this and their support for ``S = WORKDIR`` and ``oe-local-files`` has been removed. -- cgit v1.2.3-54-g00ecf