From patchwork Mon Aug 2 16:22:43 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arnout Vandecappelle X-Patchwork-Id: 1512520 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=2605:bc80:3010::138; helo=smtp1.osuosl.org; envelope-from=buildroot-bounces@busybox.net; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=mind.be header.i=@mind.be header.a=rsa-sha256 header.s=google header.b=aPogBN8H; dkim-atps=neutral Received: from smtp1.osuosl.org (smtp1.osuosl.org [IPv6:2605:bc80:3010::138]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4GdjwS1Wfjz9s5R for ; Tue, 3 Aug 2021 02:23:02 +1000 (AEST) Received: from localhost (localhost [127.0.0.1]) by smtp1.osuosl.org (Postfix) with ESMTP id 5D52E83A7F; Mon, 2 Aug 2021 16:22:59 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from smtp1.osuosl.org ([127.0.0.1]) by localhost (smtp1.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id wXS9MMh0tA6T; Mon, 2 Aug 2021 16:22:58 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by smtp1.osuosl.org (Postfix) with ESMTP id A7E8783A83; Mon, 2 Aug 2021 16:22:57 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from smtp1.osuosl.org (smtp1.osuosl.org [140.211.166.138]) by ash.osuosl.org (Postfix) with ESMTP id 5FD7B1BF34B for ; Mon, 2 Aug 2021 16:22:56 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp1.osuosl.org (Postfix) with ESMTP id 58F8283A83 for ; Mon, 2 Aug 2021 16:22:56 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from smtp1.osuosl.org ([127.0.0.1]) by localhost (smtp1.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id lhzzCIBNw6s9 for ; Mon, 2 Aug 2021 16:22:55 +0000 (UTC) X-Greylist: whitelisted by SQLgrey-1.8.0 Received: from mail-ej1-x631.google.com (mail-ej1-x631.google.com [IPv6:2a00:1450:4864:20::631]) by smtp1.osuosl.org (Postfix) with ESMTPS id 60E4D83A7F for ; Mon, 2 Aug 2021 16:22:55 +0000 (UTC) Received: by mail-ej1-x631.google.com with SMTP id hw6so17882873ejc.10 for ; Mon, 02 Aug 2021 09:22:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mind.be; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=H1bKh8084VJXmzGB3xu+sPIXcvHqVqqBXTpOMtwP670=; b=aPogBN8Hf/Z1b594isVOzWcUL2Sp1uZgfRKfWLONAonzRN7PfmXu0pln81d16FN5Vs tO5sOzBsW58UZ8v9XuSEkmVcrtcYYLmBYNcDQzB+wjNbp92baUMZnzbkRFgJZtEJ9293 EztA6uYE+59gQowbiEOgRA8Gf5NnbzFENf3tV0MVJZD7LAQVUy+UZkAXBGaY4sj6mNrQ yFm0HJVYT0tnGaEkOyDPiKMnh72IBMMHfKmvjwcC5PFDTfj3lU5Rn0Vlgeyao366ofdK lGDUmFL5CSHwxiLdB1BGshaLu8WvfsSBpm/HHxFbVvhT74Af6/o32LsEDYmxLUATQfn/ +jqw== 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=H1bKh8084VJXmzGB3xu+sPIXcvHqVqqBXTpOMtwP670=; b=KB3/FL2Zgo/XNg6Iobu1u+ZZ59H/JsLDFMotRsZfYWlKDQRL2VUIm4Nma8vklnxf+I Uss+FJO6nmo5HyxKfN5iIUTUcBOIUZgKxooZjkZY8Qus2FrO0OxLdJuTiR4B/XURaJoH a+10jh97xSjfd5hcjcrVZZogIdFtDx8/zksXMPI0uXUqDp5SiOFDXR+e07oOGqrQHgQL WRlvSvVelwV5jb7AOKSavrNFVUttILuY/Ck1mEx54e/x2W1GfgA7xAwiztDIN2q/NXAE vGV43xf7bAtRqG2ZyYUlWaxeU7dE52WAR9meRvlGYX9PO7XUcf0nz74skIxxamNAi0lj F0QA== X-Gm-Message-State: AOAM533nu6fScGCimer9sfmC5xjsC4TZKE6Y7N9dAfrVpD32HjjduS0H yG7cAXAxRqIphTHY+VmkCX91/NUVZprpUEIyHxQ= X-Google-Smtp-Source: ABdhPJxYG05YziDL404yy1mdWPcrcgixI0k0l50xM4Vy9S2AW3K33wN4znkMTcPq9hQeE65X+y+o2A== X-Received: by 2002:a17:906:368e:: with SMTP id a14mr16727155ejc.60.1627921373474; Mon, 02 Aug 2021 09:22:53 -0700 (PDT) Received: from localhost.localdomain (2001-1c01-3101-8300-5100-9bb9-68ea-c9f3.cable.dynamic.v6.ziggo.nl. [2001:1c01:3101:8300:5100:9bb9:68ea:c9f3]) by smtp.gmail.com with ESMTPSA id b25sm6485928edv.9.2021.08.02.09.22.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 02 Aug 2021 09:22:53 -0700 (PDT) From: "Arnout Vandecappelle (Essensium/Mind)" To: buildroot@buildroot.org Date: Mon, 2 Aug 2021 18:22:43 +0200 Message-Id: <20210802162244.620782-1-arnout@mind.be> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 Subject: [Buildroot] [RFC 1/2] docs/manual/migrating.txt: add section with general migrating tips 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: Michael Nosthoff , "Yann E . MORIN" , Thomas Petazzoni Errors-To: buildroot-bounces@busybox.net Sender: "buildroot" This is based on Arnout's experience with migrating Buildroot. Signed-off-by: Arnout Vandecappelle (Essensium/Mind) --- docs/manual/migrating.txt | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/manual/migrating.txt b/docs/manual/migrating.txt index 92e487c71e..9fd7d7e676 100644 --- a/docs/manual/migrating.txt +++ b/docs/manual/migrating.txt @@ -8,6 +8,34 @@ Some versions have introduced backward incompatibilities. This section explains those incompatibilities, and for each explains what to do to complete the migration. +[[migrating-approach]] +=== General approach + +To migrate from an older Buildroot version, take the following steps. + +. For all your configurations, do a build in the old Buildroot + environment. Save the full +.config+ and + +build/packages-file-list.txt+. +. Review the specific migration notes below and make the required + adaptations to external packages and custom build scripts. +. In the new Buildroot environment, run +make menuconfig+ starting from + the existing +.config+. +. If anything is enabled in the Legacy menu, check its help text, + unselect it, and save the configuration. +. Review the CHANGES file to see if any of your packages and features + are affected by the changes. +. Build in the new Buildroot environment. +. Fix build issues in external packages (usually due to updated + dependencies). +. Compare the new +packages-file-list.txt+ with the original one, to + check if no required files have disappeared. +. For configuration (and other) files in a custom overlay that overwrite + files created by Buildroot, check if there are changes in the + Buildroot-generated file that need to be propagated to your custom + file. +. Run +make savedefconfig+ and verify that what is selected really is + what you intended to enable. + [[br2-external-converting]] === Migrating to 2016.11 From patchwork Mon Aug 2 16:22:44 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arnout Vandecappelle X-Patchwork-Id: 1512521 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.136; helo=smtp3.osuosl.org; envelope-from=buildroot-bounces@busybox.net; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=mind.be header.i=@mind.be header.a=rsa-sha256 header.s=google header.b=HXizXi58; dkim-atps=neutral Received: from smtp3.osuosl.org (smtp3.osuosl.org [140.211.166.136]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4Gdjwf0b4hz9s5R for ; Tue, 3 Aug 2021 02:23:14 +1000 (AEST) Received: from localhost (localhost [127.0.0.1]) by smtp3.osuosl.org (Postfix) with ESMTP id 762AB60841; Mon, 2 Aug 2021 16:23:11 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from smtp3.osuosl.org ([127.0.0.1]) by localhost (smtp3.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id s0gyhBirBvwI; Mon, 2 Aug 2021 16:23:10 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by smtp3.osuosl.org (Postfix) with ESMTP id C849D60838; Mon, 2 Aug 2021 16:23:09 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from smtp3.osuosl.org (smtp3.osuosl.org [140.211.166.136]) by ash.osuosl.org (Postfix) with ESMTP id 4FB621BF34B for ; Mon, 2 Aug 2021 16:22:57 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp3.osuosl.org (Postfix) with ESMTP id 3EA8660838 for ; Mon, 2 Aug 2021 16:22:57 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from smtp3.osuosl.org ([127.0.0.1]) by localhost (smtp3.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id vZtHZldhcLXv for ; Mon, 2 Aug 2021 16:22:56 +0000 (UTC) X-Greylist: whitelisted by SQLgrey-1.8.0 Received: from mail-ed1-x534.google.com (mail-ed1-x534.google.com [IPv6:2a00:1450:4864:20::534]) by smtp3.osuosl.org (Postfix) with ESMTPS id F13F66063C for ; Mon, 2 Aug 2021 16:22:55 +0000 (UTC) Received: by mail-ed1-x534.google.com with SMTP id y7so23011873eda.5 for ; Mon, 02 Aug 2021 09:22:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mind.be; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=o8zBHik4P4nKEZQoMllyLLXJO4AFczR8GmjaaSAQ9B4=; b=HXizXi58iWVPz4z6AE/9YAHEZlC6Jwhlz+hZjppbhPf4lhL3m4FromegL7amEmwhVV MiZOFqqT2+Vyz14Uch3vmLfCOpNQgwUc8GqnXgO+K19kllhRbUzj67BRPKaN+BWzSO+e Lkh9FCdDwKwEZA0S/2iJa/fChIVOruqyElfM79vKoEKZteVxORmdOMs4CDBw3AAm7Oa2 wFghdHJNbeixp3YThASNadeqliSQ2GUQHMdvO5Bvm0WguKxjIaEBMTqm893zLztGDZta 04BFLgOrou2ZmrXBWPp6v85AM9U0KhZY35oxfk3iDtI+nPEpwBRVK5tNptqcdbQUf8Vo ZFPg== 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=o8zBHik4P4nKEZQoMllyLLXJO4AFczR8GmjaaSAQ9B4=; b=s+bI6HcDmO4auA5GyuvZA0McILbccNYVXPpfPEjzJJMpE1/MCQCmm4C4Kuxn2O/Wum TpFMQe8KDjnObQyp+cBqjQlMga2fcav8IjX/pzirXMNyY1LxzTX73md8S3jIhimnKZ7H mCGAWcvJ74k5kFdcvO2sNCFco08zQf2UcqUUfbqRhg+mQQtbpOhTTzcs3EwkSLkOe0Ii UjZzHECw08IVX0/PGfFjMMopguG9VkUn12kx3NGxQoyJMpR4B80vdgvurBDlX+1XlhPS vREwJevPOQrkbcJ5eXkZY+rCelcAeYXqJNOWjGyEs8Am3ExDFn9s+7IjKHN7NVh/47MG yE6A== X-Gm-Message-State: AOAM5303tP81eBu/7TVXkNHJq06NymBNQWfZoGS0GaawXyN/m92aVU+u 1KmSoI8ZJAM3TECf4PEMVjtAilhGloFpKjorvkA= X-Google-Smtp-Source: ABdhPJzd3g71nGtsZ46upTd3XI7PyU/oSzC3pN3nLhQVGeoKGL5oT7k3ljdZS1vyYYQfbdmoudBztw== X-Received: by 2002:a50:cdcb:: with SMTP id h11mr20644634edj.366.1627921374184; Mon, 02 Aug 2021 09:22:54 -0700 (PDT) Received: from localhost.localdomain (2001-1c01-3101-8300-5100-9bb9-68ea-c9f3.cable.dynamic.v6.ziggo.nl. [2001:1c01:3101:8300:5100:9bb9:68ea:c9f3]) by smtp.gmail.com with ESMTPSA id b25sm6485928edv.9.2021.08.02.09.22.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 02 Aug 2021 09:22:53 -0700 (PDT) From: "Arnout Vandecappelle (Essensium/Mind)" To: buildroot@buildroot.org Date: Mon, 2 Aug 2021 18:22:44 +0200 Message-Id: <20210802162244.620782-2-arnout@mind.be> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20210802162244.620782-1-arnout@mind.be> References: <20210802162244.620782-1-arnout@mind.be> MIME-Version: 1.0 Subject: [Buildroot] [RFC 2/2] docs/manual/migrating.txt: add "individual packages" section 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: Michael Nosthoff , "Yann E . MORIN" , Thomas Petazzoni Errors-To: buildroot-bounces@busybox.net Sender: "buildroot" Add a section to the migrating documentation to explain what changed in individual packages and how it may affect your build. This section is organised per package, not per Buildroot release, because in general it's easier to check package per package if anything changed than to check release per release for all your packages. The idea is that every time a package is changed in a way that is not immediately obvious (mainly: affects runtime but not build time), it is mentioned in this section. This may include: - a new version of the package got a new name due to API incompatibilities; - the default behaviour or config optoins of the package changed; - the Buildroot integration (e.g. configuration file, init script) of the package changed; - what is installed by the package is changed (e.g. executable is renamed or removed). To start with, add the recent changes of the installation defaults of bluez5_utils. Signed-off-by: Arnout Vandecappelle (Essensium/Mind) --- docs/manual/migrating.txt | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/manual/migrating.txt b/docs/manual/migrating.txt index 9fd7d7e676..36e4aa4724 100644 --- a/docs/manual/migrating.txt +++ b/docs/manual/migrating.txt @@ -22,8 +22,8 @@ To migrate from an older Buildroot version, take the following steps. the existing +.config+. . If anything is enabled in the Legacy menu, check its help text, unselect it, and save the configuration. -. Review the CHANGES file to see if any of your packages and features - are affected by the changes. +. Review the individual packages section below to see if any of your + packages are affected by the changes. . Build in the new Buildroot environment. . Fix build issues in external packages (usually due to updated dependencies). @@ -36,6 +36,17 @@ To migrate from an older Buildroot version, take the following steps. . Run +make savedefconfig+ and verify that what is selected really is what you intended to enable. +[[migrating-packages]] +=== Individual packages + +This section describes changes to individual packages. For all packages +that are built in your configuration, check below if changes are needed. + +==== bluez5_utils + +Since 2021.08, the tools and all plugins are optional and default off. +Make sure to enable the plugins you require. + [[br2-external-converting]] === Migrating to 2016.11