From patchwork Wed Oct 16 19:54:44 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vivien Didelot X-Patchwork-Id: 1178109 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=fail (p=none dis=none) header.from=gmail.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="rUVWcoPk"; 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 46tjgw4mDJz9sCJ for ; Thu, 17 Oct 2019 06:55:08 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id 02FF086AE8; Wed, 16 Oct 2019 19:55:07 +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 qV3V4pbz79kk; Wed, 16 Oct 2019 19:55:06 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by fraxinus.osuosl.org (Postfix) with ESMTP id 62DA686AE2; Wed, 16 Oct 2019 19:55:06 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from fraxinus.osuosl.org (smtp4.osuosl.org [140.211.166.137]) by ash.osuosl.org (Postfix) with ESMTP id B1E471BF35F for ; Wed, 16 Oct 2019 19:55:05 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id AE92286AE3 for ; Wed, 16 Oct 2019 19:55:05 +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 I2wdcNLJdmt9 for ; Wed, 16 Oct 2019 19:55:04 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-qt1-f195.google.com (mail-qt1-f195.google.com [209.85.160.195]) by fraxinus.osuosl.org (Postfix) with ESMTPS id 622D586AE1 for ; Wed, 16 Oct 2019 19:55:04 +0000 (UTC) Received: by mail-qt1-f195.google.com with SMTP id w14so37932334qto.9 for ; Wed, 16 Oct 2019 12:55:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=YXxGl54mQZ7gl1bqoDSVaJUx+yhHIMuWeW72SQFpm4M=; b=rUVWcoPkUu/0unume3JAFp8A5eJ1lG9AgbSjfIqhUA3CfstHmJQ+CCadd4f0jPpo3t qJE+tfh0YBjb3V7sQCS/wjFGa0qQVP36HEEUJFTtKiw9lFVejLnOSiWY+QlhgufNjWg/ UOCJXvJfolw/BWXNdmhMt/Su+b1kMEtLq9mEU4PeAt19QwOWzpyYSGYr63+Xhs2Onjj1 aLQ+9HhbrG8n/C2+k7AVIt0P0j3LOqa/4XFsPKV0C8DCqvhOAg2FOUXKHqsWSBd292W4 99dgrfZU3C7FRGb+h27RhkR3yXW3CwKXrR7RudtMvdlVOiVxezX3BY7+VNGquFU2F3Fq owNw== 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:mime-version :content-transfer-encoding; bh=YXxGl54mQZ7gl1bqoDSVaJUx+yhHIMuWeW72SQFpm4M=; b=FTst2QbSUy2M69gSZsizIPZB8VrM/A2guCnODfR0vzXzqVB7vLnc4brRlyQ6Aar8SU njefO7u6g1wA2GrizCuKQyNPWRvUac7r6PfkKLBvXDN3d/QM4QvafCmHvStLRjtrUupQ WtKwOqLE5wemOlLwyuxsrBmFPYrT8OYzIOaQKyPCzx0n5IgaqEhxQNkqk+OE73w58d3w D/OhtnEbvHMDnp8UXLKH5u+9qdZFxGbnaUmqOFCE1kAhWPf2KYzZVRqfOba7o0oVmw31 Z+jo62xxS752fQ0cXphhZAjUESxpEdmcsnFWUP6obAeOBnjrQEFvlMyacK+BtbVI2zV/ ui7A== X-Gm-Message-State: APjAAAX47m7qGmqgyhO28mQa5fwO+AQEUcAfD+vVomW8gbQVJOTBTjY5 DGqVRXNaIbO1bAHRuF+2DfMg4als X-Google-Smtp-Source: APXvYqyBUyYd6sxqEJj/gNBSzC2UblFYE2hM6SwSD6vv9L8tqH9OozTBqMPldYfLYws0p4KdI60ulA== X-Received: by 2002:ac8:2247:: with SMTP id p7mr47276750qtp.266.1571255702874; Wed, 16 Oct 2019 12:55:02 -0700 (PDT) Received: from localhost (modemcable249.105-163-184.mc.videotron.ca. [184.163.105.249]) by smtp.gmail.com with ESMTPSA id e4sm11674445qkl.135.2019.10.16.12.55.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 16 Oct 2019 12:55:02 -0700 (PDT) From: Vivien Didelot To: buildroot@buildroot.org Date: Wed, 16 Oct 2019 15:54:44 -0400 Message-Id: <20191016195444.2408065-1-vivien.didelot@gmail.com> X-Mailer: git-send-email 2.23.0 MIME-Version: 1.0 Subject: [Buildroot] [PATCH] docs/manual: clarify the reinstallation of a package 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: Vivien Didelot , Thomas Petazzoni Errors-To: buildroot-bounces@busybox.net Sender: "buildroot" Since -rebuild implies -reinstall and -reconfigure implies -rebuild, it is confusing to mention the make and make commands when describing the restart of the configuration, compilation and installation of the package. Therefore remove the ", followed by +make+ or +make +" portions in the "8.3. Understanding how to rebuild packages" section, and add a new paragraph clarifying how to include the rebuilt package in the filesystem image, if that is necessary. Signed-off-by: Vivien Didelot --- docs/manual/rebuilding-packages.txt | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/docs/manual/rebuilding-packages.txt b/docs/manual/rebuilding-packages.txt index 6faa67adcb..a63c4886ca 100644 --- a/docs/manual/rebuilding-packages.txt +++ b/docs/manual/rebuilding-packages.txt @@ -99,16 +99,20 @@ re-configure, re-compile and re-install this package from scratch. You can ask buildroot to do this with the +make -dirclean+ command. On the other hand, if you only want to restart the build process of a -package from its compilation step, you can run +make --rebuild+, followed by +make+ or +make +. It will -restart the compilation and installation of the package, but not from -scratch: it basically re-executes +make+ and +make install+ -inside the package, so it will only rebuild files that changed. - -If you want to restart the build process of a package from its -configuration step, you can run +make -reconfigure+, followed -by +make+ or +make +. It will restart the configuration, -compilation and installation of the package. +package from its compilation step, you can run +make -rebuild+. It +will restart the compilation and installation of the package, but not from +scratch: it basically re-executes +make+ and +make install+ inside the package, +so it will only rebuild files that changed. + +If you want to restart the build process of a package from its configuration +step, you can run +make -reconfigure+. It will restart the +configuration, compilation and installation of the package. + +While +-rebuild+ implies +-reinstall+ and ++-reconfigure+ implies +-rebuild+, these targets as well +as ++ only act on the said package, and do not trigger re-creating +the root filesystem image. If re-creating the root filesystem in necessary, +one should run +make+ or +make all+. Internally, Buildroot creates so-called _stamp files_ to keep track of which build steps have been completed for each package. They are