From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6596267782580469760 X-Received: by 2002:ac2:4314:: with SMTP id l20-v6mr468476lfh.21.1535813274176; Sat, 01 Sep 2018 07:47:54 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a2e:421c:: with SMTP id p28-v6ls1430276lja.2.gmail; Sat, 01 Sep 2018 07:47:53 -0700 (PDT) X-Google-Smtp-Source: ANB0VdYlXTZ4qrgd0t3KCNwTL9aLeX5ppD1SomCKsR0AX9zyMXjJ49LlfwfWLhb/K5OTOSarNzmX X-Received: by 2002:a2e:7a17:: with SMTP id v23-v6mr920703ljc.18.1535813273586; Sat, 01 Sep 2018 07:47:53 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1535813273; cv=none; d=google.com; s=arc-20160816; b=HbGmLRMOWc/ECjKCuTZHFcEpAvAHZcAqvxiFIQ/thtViV5AWxgMeWMTibw5aaWN0ak N3DwGqSPzSqet6/ttfjUgGvZz861Ng1wkXWGaWmwgYVZaPGpQkC+5ABwtXcenQoM+lzx 14kHRNXKA6Mpnc9Z+I39yVYTXooGcAPKXDHi56LszQ5gMeuCHfxYcl/G39ezHL8QHyiM KoMEFIBUiE24nGAUXUyPEiOyiqQj8uN5DIhFL5cm4piSoCocMuQVWsio0KJbKL6DDAWU 9ror8qsxHQWkQ80BvtUTsLmKOMr+hWLsStKIkCBHUodXNXOwqf1LFYFrJpNGPCz90Vag vF4Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=references:in-reply-to:references:in-reply-to:message-id:date :subject:to:from:arc-authentication-results; bh=hjlVKTo71///Omx1ysl9jJLo2aJJRycgn3Ogz0Ubg5Q=; b=pp7yDLqITHgpJNiJjd46Pz3EFdG4fwQ/DF+v5lzdR7nWRnywhRsoxiMLHPoS1urlhK Vizw5ElTPxnnqsavzN9ZmeC3YcIcBq33Yw4n4qm7Qd//zIr9QOIvqAfDjll2F4i4KDYq Gi9KDsoEi1X99gRK4bZr3g9vmge1vU9DbVt9skqPXUIyHcOXKJKRZzjZkO4gFtNlmpMV jqRvMe1TYL8FaUgRlEPVUxmN85AItGhzw5oCrbnWhajnx1+dI+zbvlawcHAM3Yt1oKQL 7+ez1Y3t35tzkVUW9wk6Vbfw8G1xNIq7xjHApY7txfz3UY872TOJRKAWAF82zl5HJzDz lwjQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of jan.kiszka@siemens.com designates 192.35.17.28 as permitted sender) smtp.mailfrom=jan.kiszka@siemens.com Return-Path: Received: from goliath.siemens.de (goliath.siemens.de. [192.35.17.28]) by gmr-mx.google.com with ESMTPS id q4-v6si358421ljj.5.2018.09.01.07.47.53 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 01 Sep 2018 07:47:53 -0700 (PDT) Received-SPF: pass (google.com: domain of jan.kiszka@siemens.com designates 192.35.17.28 as permitted sender) client-ip=192.35.17.28; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of jan.kiszka@siemens.com designates 192.35.17.28 as permitted sender) smtp.mailfrom=jan.kiszka@siemens.com Received: from mail2.sbs.de (mail2.sbs.de [192.129.41.66]) by goliath.siemens.de (8.15.2/8.15.2) with ESMTPS id w81Elqj3028472 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 1 Sep 2018 16:47:52 +0200 Received: from md1f2u6c.ad001.siemens.net ([139.22.35.9]) by mail2.sbs.de (8.15.2/8.15.2) with ESMTP id w81EloWg011101 for ; Sat, 1 Sep 2018 16:47:51 +0200 From: Jan Kiszka To: isar-users Subject: [PATCH 4/4] Add changelog for the recipe API Date: Sat, 1 Sep 2018 16:47:50 +0200 Message-Id: <62ba455b39f5270f29b0663b38415f9784c31420.1535813270.git.jan.kiszka@siemens.com> X-Mailer: git-send-email 2.16.4 In-Reply-To: References: In-Reply-To: References: X-TUID: 6DZes4SoAG26 From: Jan Kiszka This uses the last release v0.5 as baseline and documents changes that affect own recipes and layers using Isar. Hopefully, this caught all of them since v0.5. Signed-off-by: Jan Kiszka --- RECIPE-API-CHANGELOG.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 RECIPE-API-CHANGELOG.md diff --git a/RECIPE-API-CHANGELOG.md b/RECIPE-API-CHANGELOG.md new file mode 100644 index 0000000..601fc6b --- /dev/null +++ b/RECIPE-API-CHANGELOG.md @@ -0,0 +1,59 @@ +Recipe API Changelog +==================== + +Baseline: Release v0.5 + +Changes in v0.6 +--------------- + +### Separate do_prepare_build task + +All Debianizations of source trees and any further programmatic patching has to +be moved from the dpkg_runbuild() task to this new task. + +### ISAR_CROSS_COMPILE support + +Isar now supports cross-compilation. When enabled via `ISAR_CROSS_COMPILE = "1"` +in a global configuration file, all recipes that do not overwrite this variable +will build cross-compiled. + +If a recipe is not cross-compatible, it should set `ISAR_CROSS_COMPILE = "0"`. +Then also all its dependencies that are built by Isar must opt out from +cross-building. + +### wic image type, removal of manual wic invocation + +Images that are described by wic files are now generated during the build by +setting `IMAGE_TYPE = "wic-img"`. The manual invocation of wic after the +bitbake run is no longer needed nor supported. + +### Optional kernel installation + +The installation of a Linux kernel into the isar-image-base can be skipped by +setting `KERNEL_NAME = ""`. + +### Corrected semantic of `S` + +The `S` variable is now defined as NOT including `WORKDIR`, like in OE, Gentoo +and others. If it was set to, e.g., `S = "sources"` in a recipe so far, it must +be defined as `S = ${WORKDIR}/sources` from now on. + +### DISTRO and DISTRO_ARCH are available as OVERRIDES + +Bitbake variables can now also refer to the DISTRO as well as the DISTRO_ARCH +for overrides. + +### Set ISAR_RELEASE_CMD in own top-layer + +Isar now populates /etc/os-release with information about the image. In order +to identify the revision of the top layer that controlled the image build with +all its dependencies, set ISAR_RELEASE_CMD so that it picks up the required +information. + +If the top-layer is managed in git, set `LAYERDIR_mylayer = "${LAYERDIR}"` in +`conf/layer.conf` and add something along + + ISAR_RELEASE_CMD = "git -C ${LAYERDIR_mylayer} describe --tags --dirty \ + --match 'v[0-9].[0-9]*'" + +in the image recipe (or `isar-image-base.bbappend`) of that layer. -- 2.16.4