From patchwork Fri Jun 12 11:33:17 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Robert P. J. Day" X-Patchwork-Id: 89905 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id EFCACCD8CA8 for ; Fri, 12 Jun 2026 11:33:29 +0000 (UTC) Received: from cpanel10.indieserve.net (cpanel10.indieserve.net [199.212.143.9]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.68372.1781264003447903187 for ; Fri, 12 Jun 2026 04:33:23 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@crashcourse.ca header.s=default header.b=BzNglwcN; spf=pass (domain: crashcourse.ca, ip: 199.212.143.9, mailfrom: rpjday@crashcourse.ca) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=crashcourse.ca; s=default; h=Content-Type:MIME-Version:Message-ID:Subject: To:From:Date:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=hWi6szpFXTMCsBuUjZUlAlytLmToHbRxERzteQN2GoM=; b=BzNglwcNRWE70BiyHO9KrYfYZH PSYJ7kk33g5dO3oq5x1sfUgBC9hBSUF6Pr/OnFlHbDt485tuiNCL2KsKK8wjmIysmMexaQM15V/d0 Emt8avX2uMXzJ2CYurFHen9HcjlOMXjHI4UD5xIvYe/rrzfbTw4mXN43/I5J8y03Pl5alOznD9EX7 Hb3Hym6X+U+9oYhKGuJdx5U2nSRvC/AC4Dbk6xzCfMQRR4+PTbLZxSLzqf6Xz+ndkvhgNYwVK2XFN 7jpG9u0NuPv7QnpNTzfTiOZp3YBbTaTggnoGS8/6QLLcz0KlyaPEVOwUu5OB5ygylTN3QiPEjxI8t HvtkRCBw==; Received: from pool-174-114-114-5.cpe.net.cable.rogers.com ([174.114.114.5]:46242 helo=trixie) by cpanel10.indieserve.net with esmtpsa (TLS1.3) tls TLS_AES_256_GCM_SHA384 (Exim 4.99.4) (envelope-from ) id 1wY08W-0000000E8XZ-2Shw for docs@lists.yoctoproject.org; Fri, 12 Jun 2026 07:33:21 -0400 Date: Fri, 12 Jun 2026 07:33:17 -0400 (EDT) From: "Robert P. J. Day" To: YP docs mailing list Subject: [PATCH] dev-manual: correct which package variables support which backends Message-ID: <063e2bf1-5f48-3ea6-f18a-3d422af03a2f@crashcourse.ca> MIME-Version: 1.0 X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - cpanel10.indieserve.net X-AntiAbuse: Original Domain - lists.yoctoproject.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - crashcourse.ca X-Get-Message-Sender-Via: cpanel10.indieserve.net: authenticated_id: rpjday+crashcourse.ca/only user confirmed/virtual account not confirmed X-Authenticated-Sender: cpanel10.indieserve.net: rpjday@crashcourse.ca X-Source: X-Source-Args: X-Source-Dir: List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Fri, 12 Jun 2026 11:33:29 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/9704 Update the section "Excluding packages from an image" to explain that all packaging backends support all three package exclusion variables, with the single exception that Debian packaging does not support BAD_RECOMMENDATIONS. Signed-off-by: Robert P. J. Day --- i tested with adding "minicom" to an image, then trying to exclude its recommendation of "lrzsz". diff --git a/documentation/dev-manual/packages.rst b/documentation/dev-manual/packages.rst index 500639565..80bcac0ba 100644 --- a/documentation/dev-manual/packages.rst +++ b/documentation/dev-manual/packages.rst @@ -30,13 +30,10 @@ installed into an image. If so, you can use several variables to direct the build system to essentially ignore installing recommended packages or to not install a package at all. -The following list introduces variables you can use to prevent packages -from being installed into your image. Each of these variables only works -with IPK and RPM package types, not for Debian packages. -Also, you can use these variables from your ``local.conf`` file -or attach them to a specific image recipe by using a recipe name -override. For more detail on the variables, see the descriptions in the -Yocto Project Reference Manual's glossary chapter. +There are three variables you can use to avoid installing particular +packages into the final image -- you can either set these variables +appropriately in your ``local.conf`` file, or attach them to a specific +image recipe by using a recipe name override. - :term:`BAD_RECOMMENDATIONS`: Use this variable to specify "recommended-only" packages that you do @@ -53,6 +50,19 @@ Yocto Project Reference Manual's glossary chapter. prevent the installation of a package whose presence is required by an installed package. +.. warning:: + + All three of these package exclusion variables work with all three + packaging backends (DEB, RPM and IPK) with one exception: + Debian packaging does not support the ``BAD_RECOMMENDATIONS`` setting. + If you try that combination, you will get a warning similar to:: + + WARNING: core-image-minimal-1.0-r0 do_rootfs: + Debian package install does not support BAD_RECOMMENDATIONS + + All of the other combinations of packaging backend and exclusion + variable are supported. + Incrementing a Package Version ==============================