From patchwork Wed Oct 16 17:55:45 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dan Walkes X-Patchwork-Id: 1178064 Return-Path: X-Original-To: incoming-buildroot@patchwork.ozlabs.org Delivered-To: patchwork-incoming-buildroot@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=busybox.net (client-ip=140.211.166.137; helo=fraxinus.osuosl.org; envelope-from=buildroot-bounces@busybox.net; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=trellis-logic.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=trellis-logic-com.20150623.gappssmtp.com header.i=@trellis-logic-com.20150623.gappssmtp.com header.b="V6bOcNLy"; dkim-atps=neutral Received: from fraxinus.osuosl.org (smtp4.osuosl.org [140.211.166.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 46tgZS6cjTz9sPZ for ; Thu, 17 Oct 2019 05:20:16 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id 35F4886940; Wed, 16 Oct 2019 18:20:13 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from fraxinus.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id kZFdUfabbQVL; Wed, 16 Oct 2019 18:20:09 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by fraxinus.osuosl.org (Postfix) with ESMTP id C7D468625B; Wed, 16 Oct 2019 18:20:09 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136]) by ash.osuosl.org (Postfix) with ESMTP id E7FC61BF2FC for ; Wed, 16 Oct 2019 18:20:08 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id E48362343B for ; Wed, 16 Oct 2019 18:20:08 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id aOTpjVRhaTvZ for ; Wed, 16 Oct 2019 18:20:08 +0000 (UTC) X-Greylist: delayed 00:24:11 by SQLgrey-1.7.6 Received: from mail-io1-f66.google.com (mail-io1-f66.google.com [209.85.166.66]) by silver.osuosl.org (Postfix) with ESMTPS id 17DC522C1A for ; Wed, 16 Oct 2019 18:20:08 +0000 (UTC) Received: by mail-io1-f66.google.com with SMTP id a1so55104496ioc.6 for ; Wed, 16 Oct 2019 11:20:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=trellis-logic-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id; bh=HThvikyS16sqotlUNRQM19HGQCcF42rl6W2S7UppLo0=; b=V6bOcNLyFt1tA5+FSSjkfp48Bmx3cmYN/mLsD3OlMTRfGgeLqHWqiRbijj+liwueKO SaHa0TT0iTEhlUaSBs/DkXBXDsz/wFaJ49e4DY2p+sflpaxLxSkJn4Y5GHDB0+EVWktu mbzU3jruBKlpT06OnYPGIsi1SLhJJYrLxD5LrJwjx7eVeff9RP9knxQUCwQ2jth8hIsM P8ewv7tzCMXZ9oiE3Nsb3IXrSuUENlHNJEefP52cGQOXNPqP8lxP146gLMLIyg0JjPw7 BKdgsCsrygPBAr5chiBBSmSM4OuSfDOKslHaSRRH+OMBjGO44H5zdK70uqH2wvhsQybF NyuA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=HThvikyS16sqotlUNRQM19HGQCcF42rl6W2S7UppLo0=; b=T6pN1cVls0VpM4uqIha+R4uxVVcxQKdYYpqVXcrxuME5BLCiMf5dlx9RC4uH/h0ohu Xa0j+H0KHtCFpOwPQOR20rofRxhm9WkM3UpWlVk0PAdaUcRvLtZhUVAUpZACfHkN51KS TGiNzepNDuBymG+lEVNzHnRDB2fpbQbiZ2RLl/6iBqBbmv1SjlE9vKr1OQCwMQ9h9jzu kNoCtutUOH5uk10tq6Eg9QoR3bLuBm0Q2ByXYl3qa57rIU8VSy56Uq900ZE0Du+uBMpq sKk/32I3E8O4x/1bDpeIxTvtZsk6n8lINea1oivakfJu5PS/XxsjVq6qirZJawsIvo1q lXsA== X-Gm-Message-State: APjAAAXYr+/agZ9bX1z3AsFIK2emQcxvc67Ef1ZSn8zx3cTU8lD3y7o3 YI1MCrCyX8cCSHbh6WvCQp6qVD4b0g8cNA== X-Google-Smtp-Source: APXvYqzGD2rQFU0+sECsqVKPJ+y9Ihd/IB20NeeX5+Bogt5gAiTzyqyuIIdWyfzwS49hypCgX+rmSw== X-Received: by 2002:a02:ce2b:: with SMTP id v11mr49275758jar.31.1571248555860; Wed, 16 Oct 2019 10:55:55 -0700 (PDT) Received: from dan-ubuntu.hsd1.co.comcast.net ([2601:285:8280:d250:39de:70ee:4c31:4e8]) by smtp.gmail.com with ESMTPSA id s11sm16208832ioc.79.2019.10.16.10.55.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 16 Oct 2019 10:55:55 -0700 (PDT) From: Dan Walkes To: buildroot@buildroot.org Date: Wed, 16 Oct 2019 11:55:45 -0600 Message-Id: <20191016175545.12855-1-danwalkes@trellis-logic.com> X-Mailer: git-send-email 2.17.1 Subject: [Buildroot] [PATCH 1/1] docs/manual: dependency documentation updates X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Dan Walkes , Thomas De Schampheleire MIME-Version: 1.0 Errors-To: buildroot-bounces@busybox.net Sender: "buildroot" Update dependency documentation to detail the order-only relationship associated with the DEPENDENCIES variable. See the thread at [1] for details. [1] http://lists.busybox.net/pipermail/buildroot/2019-October/262685.html Signed-off-by: Dan Walkes --- docs/manual/adding-packages-generic.txt | 8 +++++--- docs/manual/rebuilding-packages.txt | 10 ++++++++++ 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/docs/manual/adding-packages-generic.txt b/docs/manual/adding-packages-generic.txt index b402767b05..af94f5b1ec 100644 --- a/docs/manual/adding-packages-generic.txt +++ b/docs/manual/adding-packages-generic.txt @@ -358,9 +358,11 @@ not and can not work as people would expect it should: * +LIBFOO_DEPENDENCIES+ lists the dependencies (in terms of package name) that are required for the current target package to compile. These dependencies are guaranteed to be compiled and - installed before the configuration of the current package starts. In - a similar way, +HOST_LIBFOO_DEPENDENCIES+ lists the dependencies for - the current host package. + installed before the configuration of the current package starts. + However, modifications to configuration of these dependencies will + not force a rebuild of the current package. In a similar way, + +HOST_LIBFOO_DEPENDENCIES+ lists the dependencies for the current + host package. * +LIBFOO_EXTRACT_DEPENDENCIES+ lists the dependencies (in terms of package name) that are required for the current target package to be diff --git a/docs/manual/rebuilding-packages.txt b/docs/manual/rebuilding-packages.txt index 6faa67adcb..326cd1fe82 100644 --- a/docs/manual/rebuilding-packages.txt +++ b/docs/manual/rebuilding-packages.txt @@ -65,6 +65,16 @@ can help you understand how to work with Buildroot: there is no need for a full rebuild: a simple +make+ invocation will take the changes into account. + * When a +FOO_DEPENDENCIES+ package is rebuilt or removed, the package ++foo+ is not automatically rebuilt. For example, if a package +bar+ is +listed in +FOO_DEPENDENCIES+ with +FOO_DEPENDENCIES = bar+ and the +configuration of the +bar+ package is changed, the configuration +change would not result in a rebuild of package +foo+ automatically. +In this scenario, you may need to either rebuild any packages in your +build which reference +bar+ in their +DEPENDENCIES+, or perform a +full rebuild to ensure any +bar+ dependent packages are +up to date. + Generally speaking, when you're facing a build error and you're unsure of the potential consequences of the configuration changes you've made, do a full rebuild. If you get the same build error, then you are