From patchwork Sun Nov 11 13:14:46 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Samuel Martin X-Patchwork-Id: 198267 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from silver.osuosl.org (silver.osuosl.org [140.211.166.136]) by ozlabs.org (Postfix) with ESMTP id 2B9272C0040 for ; Mon, 12 Nov 2012 00:16:35 +1100 (EST) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id C077530D59; Sun, 11 Nov 2012 13:16:32 +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 S3T5LgEBoCSy; Sun, 11 Nov 2012 13:16:25 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by silver.osuosl.org (Postfix) with ESMTP id 0EF193106A; Sun, 11 Nov 2012 13:16:00 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from whitealder.osuosl.org (whitealder.osuosl.org [140.211.166.138]) by ash.osuosl.org (Postfix) with ESMTP id 201F98F753 for ; Sun, 11 Nov 2012 13:15:37 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id E774E8C2D7 for ; Sun, 11 Nov 2012 13:15:32 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id GISjx3i6wN-f for ; Sun, 11 Nov 2012 13:15:32 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-wg0-f53.google.com (mail-wg0-f53.google.com [74.125.82.53]) by whitealder.osuosl.org (Postfix) with ESMTPS id DA8848C2A6 for ; Sun, 11 Nov 2012 13:15:31 +0000 (UTC) Received: by mail-wg0-f53.google.com with SMTP id dr1so2897126wgb.10 for ; Sun, 11 Nov 2012 05:15:31 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:x-mailer:in-reply-to:references; bh=W6nddEX/IcsQ0u3xnm84gJhrNptFCBYwggNuUlBypfo=; b=L7b6x2xxg82+MRNBnePCqZECLWIlyh7ieAbzgejiQZwMkjGRfIFxB2RLfZ3oURcEqp TybVhF1621N1EG5z1PZpttmjbxIQcsSm+DeOMoWnxtUaHC73FNKJEFrE7Vca33wj9p9w WxOXIuTbNzYkmD7+FnJ5MUyquFGRlWDsv6oNmFk8N0zmND5j8g0QpgxmoHX1j+7t6+TN wzNTCcyF+iuSSyhDYAreZwr+CeJXUCLO0EtDPwuVHfG1aWpTMTbAvvGo27uJ7cvUBLf7 So7+ZDn1w3CTc5VOnEdhWLRPxnDB3ssocA3ps9neOxIcTQT5dF8H8BNaO+3OX3uQzogJ VSiw== Received: by 10.180.8.100 with SMTP id q4mr10782889wia.16.1352639731600; Sun, 11 Nov 2012 05:15:31 -0800 (PST) Received: from localhost.localdomain (ivr94-4-82-229-165-48.fbx.proxad.net. [82.229.165.48]) by mx.google.com with ESMTPS id hv4sm10262550wib.0.2012.11.11.05.15.30 (version=SSLv3 cipher=OTHER); Sun, 11 Nov 2012 05:15:30 -0800 (PST) From: Samuel Martin To: buildroot@busybox.net Date: Sun, 11 Nov 2012 14:14:46 +0100 Message-Id: <1352639701-27829-9-git-send-email-s.martin49@gmail.com> X-Mailer: git-send-email 1.8.0 In-Reply-To: <1352639701-27829-1-git-send-email-s.martin49@gmail.com> References: <1352639701-27829-1-git-send-email-s.martin49@gmail.com> Subject: [Buildroot] [PATCH 08/23] manual: update rebuilding-packages.txt X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.14 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: buildroot-bounces@busybox.net Sender: buildroot-bounces@busybox.net - update "Understanding how to rebuild packages" section - add "Understanding when a full rebuild is necessary" section Signed-off-by: Samuel Martin diff --git a/docs/manual/rebuilding-packages.txt b/docs/manual/rebuilding-packages.txt index 824b35c..2225200 100644 --- a/docs/manual/rebuilding-packages.txt +++ b/docs/manual/rebuilding-packages.txt @@ -1,5 +1,39 @@ // -*- mode:doc -*- ; +[[full-rebuild]] +Understanding when a full rebuild is necessary +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +A full rebuild is achieved by running: + +--------------- +$ make clean all +--------------- + +In what cases, a full rebuild is mandatory: + +* each time the toolchain properties are changed, this includes: + +** after changing some toolchain option under the _Toolchain_ menu (if + the internal Buildroot backend is used); +** after running +make ctng-menuconfig+ (if the crosstool-NG backend + is used); +** after running +make uclibc-menuconfig+. + +* after removing some libraries from the package selection. + +In what cases, a full rebuild is recommended: + +* after adding some libraries to the package selection (otherwise, + some packages that can be optionally linked against those libraries + won't be rebuilt, so they won't support those new available + features). + +In other cases, it is up to you to decide if you should or not run a +full rebuild, but you should know what is impacted and understand what +you are doing anyway. + +[[rebuild-pkg]] Understanding how to rebuild packages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -42,27 +76,10 @@ files are relevant: Buildroot will trigger the recompilation of the package from the compilation step (execution of +make+). -For other packages, an analysis of the specific 'package.mk' file is -needed. For example, the zlib Makefile used to look like this (before -it was converted to the generic package infrastructure): - ------------------ -$(ZLIB_DIR)/.configured: $(ZLIB_DIR)/.patched - (cd $(ZLIB_DIR); rm -rf config.cache; \ - [...] - ) - touch $@ - -$(ZLIB_DIR)/libz.a: $(ZLIB_DIR)/.configured - $(MAKE) -C $(ZLIB_DIR) all libz.a - touch -c $@ ------------------ - -If you want to trigger the reconfiguration, you need to remove -+output/build/zlib-version/.configured+. If you want to trigger only -the recompilation, you need to remove -+output/build/zlib-version/libz.a+. - -Note that most packages, if not all, will progressively be ported over -to the generic or autotools infrastructure, making it much easier to -rebuild individual packages. +.Notes +- Since the _Buildroot-2012.11_ release, all packages rely on the +Buildroot infrastructures. +- Only toolchain packages remain using custom makefiles (i.e. do not +use any Buildroot infrastructure). +- Most packages and toolchain packages, if not all, will progressively +be ported over to the generic, autotools or CMake infrastructure,