Received: from mail-pg1-f194.google.com (mail-pg1-f194.google.com [209.85.215.194])
by mx.groups.io with SMTP id smtpd.web10.224.1586990368587206413
for ;
Wed, 15 Apr 2020 15:39:28 -0700
Authentication-Results: mx.groups.io;
dkim=pass header.i=@gmail.com header.s=20161025 header.b=fZa/SQ+L;
spf=pass (domain: gmail.com, ip: 209.85.215.194, mailfrom: akuster808@gmail.com)
Received: by mail-pg1-f194.google.com with SMTP id n16so646015pgb.7
for ; Wed, 15 Apr 2020 15:39:28 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=20161025;
h=subject:to:references:from:autocrypt:cc:message-id:date:user-agent
:mime-version:in-reply-to:content-language;
bh=VkZY6ivpKX83X0G3u+jmfvPQOW36EKG9dRiUi92r6YE=;
b=fZa/SQ+LGrAq6TOIq/wWPveUN/Sr+gKC9sHYpUtOxLedzkONiZ6zawfv1DrMFoLkys
3cTqs+0z6gdDDemk2/oXX/Qd2BAgP6aUH05kPlx4XMIq8E8UsFgtn6TPmEzSCSzbWV45
rjWDzY42a3clI1h0Do2GAoSscWkdaHzp7KmKMGNmhjM86RNNCJQmb7aApqtN8/b+oMBd
I3L8biTziKFXxdkWjbzLLCLO5Wtavp7hpLXQ+2FbEFEOwUZa0TfV316YnABJHeHkdTdB
Y3XLHF5AS/+BiDgWsHceCpWbXgq+Jum9f5n0pJjD0nmJxMJ2/KV/b+Zk4SvoNOE3u8CH
Qocg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20161025;
h=x-gm-message-state:subject:to:references:from:autocrypt:cc
:message-id:date:user-agent:mime-version:in-reply-to
:content-language;
bh=VkZY6ivpKX83X0G3u+jmfvPQOW36EKG9dRiUi92r6YE=;
b=eMNViZ3U3MzPebITWqiHOYRuepHnerxDs5fvbPy3Ssc1+0Yh/wBZN7NxdjJGy0+KuC
9fyDom+qXIl8udtLht1FJD8ZY+iXaVGiuztn3yJ9ypooVfOfoCaAcrNL2Eo4WUnPb0aB
O3Mg1em6BuVWB3ja0Wvyt+NR4zKoh16KSZJxWVzgvc4sx5KghmxZGMoMghc/4Ly5c7p1
oMhB+M0mibWQ6fSXQZvdZVoUObVoJlbshWApNcvhfCRXvTGbgRd7/wkV8ZITRSpgJHQU
G+6Sv3ny8cCrJg3ah//iM6dfNYZ1F+OqJFWScj07NOfVwsrOExOVtOjPDPbO9WgsdqHH
0nrg==
X-Gm-Message-State: AGi0PuZJ+X0cDOt5+ZT7s3BhKox74hbPuV3PsBje+gA+OF3h4YO+ouU8
NsTBXy7YBissyGL7ezqA+yttdL6xLkMxsQ==
X-Google-Smtp-Source: APiQypIFBDx9azWiPp3yANirGMVUXJj85gM7UlKFtNolUBzAy4W9MnUxUyLSzbOlQI8Z6OtaewqOIw==
X-Received: by 2002:aa7:8696:: with SMTP id d22mr29686506pfo.54.1586990367513;
Wed, 15 Apr 2020 15:39:27 -0700 (PDT)
Return-Path:
Received: from ?IPv6:2601:202:4180:a5c0:c885:40f8:b7ee:f5bd? ([2601:202:4180:a5c0:c885:40f8:b7ee:f5bd])
by smtp.gmail.com with ESMTPSA id a12sm8358453pfr.28.2020.04.15.15.39.26
(version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128);
Wed, 15 Apr 2020 15:39:26 -0700 (PDT)
Subject: Re: [docs] [PATCH 2/2] ref-manual: add migration section for 3.1
To: "bluelightning@bluelightning.org"
References:
<387de38945c4514c58edf915474a2ec474539746.1586987359.git.bluelightning@bluelightning.org>
From: "akuster"
Autocrypt: addr=akuster808@gmail.com; prefer-encrypt=mutual; keydata=
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
8CS2NxU=
Cc: docs@lists.yoctoproject.org
Message-ID:
Date: Wed, 15 Apr 2020 15:39:26 -0700
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101
Thunderbird/68.4.1
MIME-Version: 1.0
In-Reply-To: <387de38945c4514c58edf915474a2ec474539746.1586987359.git.bluelightning@bluelightning.org>
Content-Type: multipart/alternative;
boundary="------------B926DF67F3382D27575A5BD5"
Content-Language: en-US
--------------B926DF67F3382D27575A5BD5
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Paul,
On 4/15/20 2:49 PM, Paul Eggleton wrote:
> From: Paul Eggleton
>
> Migration information for the 3.1 release.
Thanks for pulling this together. I have in-lined a few questions below.
>
> Signed-off-by: Paul Eggleton
> ---
> documentation/ref-manual/migration.xml | 201 +++++++++++++++++++++++++
> 1 file changed, 201 insertions(+)
>
> diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-=
manual/migration.xml
> index 03efc7be2..9422b5a27 100644
> --- a/documentation/ref-manual/migration.xml
> +++ b/documentation/ref-manual/migration.xml
> @@ -7095,6 +7095,207 @@ id=3Df4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>c=
ommit message.
>
>
>
> +
> +
> + Moving to the Yocto Project 3.1 Release
> +
> +
> + This section provides migration information for moving to the
> + Yocto Project 3.1 Release from the prior release.
> +
> +
> +
> + Minimum system requirements
> +
> +
> + The following versions / requirements of build host compone=
nts have been updated:
> +
> + gcc 5.0
> + python 3.5
> + tar 1.28
> + rpcgen is now requ=
ired on the host (part of the libc-dev-bin package on =
Ubuntu, Debian and related distributions, and the glibc package on RPM-based distributions).
> +
> +
> + Additionally, the makeinfo and pod2man
> + tools are no longer required on the ho=
st.
> +
> +
> +
> +
> + mpc8315e-rdb machine removed
> +
> +
> + The MPC8315E-RDB machine is old/obsolete and unobtainable, =
thus given the maintenance burden
> + the mpc8315e-rdb machine configuration=
that supported it has been removed
> + in this release. The removal does leave a gap in official P=
owerPC reference hardware
> + support; this may change in future if a suitable machine wi=
th accompanying support resources
> + is found.
> +
> +
> +
> +
> + Python 2 removed
> +
> +
> + Due to the expiration of upstream support in January 2020, =
support for Python 2 has now been removed; it is recommended that you use P=
ython 3 instead. If absolutely needed there is a meta-python2 community lay=
er containing Python 2, related classes and various Python 2-based modules,=
however it should not be considered as supported.
> +
> +
> +
> +
> + Reproducible builds now enabled by default
> +
> +
> + In order to avoid unnecessary differences in output files (=
aiding binary reproducibility), the Poky distribution configuration (DISTRO =3D "poky") now i=
nherits the reproducible_build class by default.
> +
> +
AK] I think the l hash equivalence server is also enabled by default:
commit 1fb4aa42f9c3b9738d78d198ad695fe4fcb6dc2f
Author: Richard Purdie
Date:=C2=A0=C2=A0 Wed Aug 7 21:56:01 2019 +0100
=C2=A0=C2=A0=C2=A0 poky: Default to enabling a local hash equivalence serv=
er
=C2=A0=C2=A0=C2=A0
> +
> +
> + Impact of ptest feature is now more significant
> +
> +
> + The Poky distribution configuration (DISTRO =3D "poky") enables ptests by def=
ault to enable runtime testing of various components. In this release, a de=
pendency needed to be added that has resulted in a significant increase in =
the number of components that will be built just when building a simple ima=
ge such as core-image-minimal. If you do not need runtime tests enabled for=
core components, then it is recommended that you remove "ptest" from DISTRO_FEATURES to save a significant amount of build time e.g. by adding the following i=
n your configuration:
> +
> +
> + DISTRO_FEATURES_remove =3D "ptest"
> +
> +
> +
> +
> +
> + Removed recipes
> +
> +
> + The following recipes have been removed:
> +
> +
> + chkconfig: obsolet=
e
> + console-tools: obs=
olete
> + enchant: replaced =
by enchant2
> + foomatic-filters: =
obsolete
> + libidn: no longer =
needed, moved to meta-oe
> + libmodulemd: repla=
ced by libmodulemd-v1
> + linux-yocto: drop =
4.19, 5.2 version recipes (5.4 now provided)
> + nspr: no longer ne=
eded, moved to meta-oe
> + nss: no longer nee=
ded, moved to meta-oe
> + python: Python 2 r=
emoved (Python 3 preferred)
> + python-setuptools:=
Python 2 version removed (python3-setuptools preferred)
> + sysprof: no longer=
needed, moved to meta-oe
> + texi2html: obsolet=
e
> + u-boot-fw-utils: f=
unctionally replaced by libubootenv
> +
> +
> +
> +
> +
> + features_check class replaces distro_features_check
> +
> +
> + The distro_features_check class has ha=
d its functionality expanded, now supporting ANY_OF_MACHINE_FEATU=
RES, REQUIRED_MACHINE_FEATURES, C=
ONFLICT_MACHINE_FEATURES, ANY_OF_COMBINED_FEATURES, REQUIRED_COMBINED_FEATURES, CONFLIC=
T_COMBINED_FEATURES. As a result the class has now been renamed =
to features_check; the distro_features_check=
class still exists but generates a warning and redirects to the=
new class. In preparation for a future removal of the old class it is reco=
mmended that you update recipes currently inheriting distro_featu=
res_check to inherit features_check instead=
.
> +
> +
> +
> +
> + Removed classes
> +
> +
> + The following classes have been removed:
> +
> +
> + distutils-base: mo=
ved to meta-python2
> + distutils: moved t=
o meta-python2
> + libc-common: merge=
d into the glibc recipe as nothing else used it.
> + python-dir: moved =
to meta-python2
> + pythonnative: move=
d to meta-python2
> + setuptools: moved =
to meta-python2
> + tinderclient: drop=
ped as it was obsolete.
> +
> +
> +
> +
> +
> + SRC_URI checksum behaviour
> +
> +
> + Previously, recipes by tradition included both SHA256 and M=
D5 checksums for remotely fetched files in SRC_URI, even though only one is actually mandate=
d. However, the MD5 checksum does not add much given its inherent weakness;=
thus when a checksum fails only the SHA256 sum will now be printed. The md=
5sum will still be verified if it is specified.
AK] If I am not mistaken, we can support all these in a recipe:=C2=A0 "md5=
",
"sha256", "sha1", "sha384", "sha512"
ref: bitbake/lib/bb/fetch2/__init__.py ; CHECKSUM_LIST
Not sure if we want to mention that too??? not saying it has to include
this.
> +
> +
> +
> +
> +
> + npm fetcher changes
> +
> +
> + The npm fetcher has been completely reworked in this releas=
e. The npm fetcher now only fetches the package source itself and no longer=
the dependencies; there is now also an npmsw fetcher which explicitly fetc=
hes the shrinkwrap file and the dependencies. This removes the slightly awk=
ward NPM_LOCKDOWN and NPM_SHRINKWRAP variables which pointed to local files; the lockdown file is no longer =
needed at all. Additionally, the package name in npm:// entries in SRC_URI is now specified using a package parameter instead=
of the earlier name which overlapped with the generic=
name parameter. All recipes using the npm fetcher wil=
l need to be changed as a result.=20
> +
> +
> + An example of the new scheme:
> +
> +SRC_URI =3D "npm://registry.npmjs.org;package=3Darray-flatten;version=
=3D1.1.1 \
> + npmsw://${THISDIR}/npm-shrinkwrap.json"
> +
> + Another example where the sources are fetched from git rath=
er than an npm repository:
> +
> +SRC_URI =3D "git://github.com/foo/bar.git;protocol=3Dhttps \
> + npmsw://${THISDIR}/npm-shrinkwrap.json"
> +
> +
> +
> + devtool and recipetool have also been updated to match with=
the npm fetcher changes. Other than producing working and more complete re=
cipes for npm sources, there is also a minor change to the command line for=
devtool: the --fetch-dev option has been renamed to <=
filename>--npm-dev as it is npm-specific.
> +
> +
> +
> +
> +
> + Packaging changes
> +
> +
> +
> + intltool has been =
removed from packagegroup-core-sdk as it is rarely nee=
ded to build modern software - gettext can do most of the things it used to=
be needed for. intltool has also been removed from packagegroup-core-self-hosted as it is not needed to for=
standard builds.
> + git: git-am, git-difftool, git-submodule, and git-request-pull are no longer perl-based, so are now insta=
lled with the main git package instead of within git-perltools.
> + The ldconfig binar=
y built as part of glibc has now been moved to its own ldconfig=
filename> package (note no glibc- prefix). This packag=
e is in the RRECOMMENDS of the main glibc package if ldco=
nfig is present in DISTRO_FEATURES.
> + libevent now split=
s each shared library into its own package (as Debian does). Since these ar=
e shared libraries and will be pulled in through the normal shared library =
dependency handling, there should be no impact to existing configurations o=
ther than less unnecessary libraries being installed in some cases.<=
/listitem>
> + linux-firmware now has a new package fo=
r bcm4366c and includes available NVRAM config files i=
nto the bcm43340, bcm43362, bcm43430 and bcm4356-pcie packages.
> + harfbuzz now split=
s the new libharfbuzz-subset.so library into its own p=
ackage to reduce the main package size in cases where libharfbuzz=
-subset.so is not needed.
> +
> +
> +
> +
> +
> + Additional warnings
> +
> +
> + Warnings will now be shown at do_package_qa time in the following circumstances:
> +
> +
> + A recipe installs .desktop files containing MimeType keys but does not i=
nherit the new mime-xdg class
> + A recipe installs .xml files into ${datadir}/mime/packages but does not =
inherit the mime class
> +
> +
> +
> +
> +
> + wic image type now used instead of =
live by default for x86
> +
> +
> + conf/machine/include/x86-base.inc (inh=
erited by most x86 machine configurations) now specifies wic instead of live by default in IMAGE_FSTYPES. The live image type will likely be removed in a future release so i=
t is recommended that you use wic instead.
> +
> +
> +
> +
> + Miscellaneous changes
> +
> +
> +
> + The undocumented SRC_DISTRIBU=
TE_LICENSES variable has now been removed in favour of a new AVAILABLE_LICENSES variable which is dynamically set base=
d upon license files found in ${COMMON_LICENSE_DIR} an=
d ${LICENSE_PATH}.
> + The tune definition for big-endian micr=
oblaze machines is now microblaze instead of microblazeeb.
> + newlib no longer h=
as built-in syscalls. libgloss should then provide the=
syscalls, crt0.o and other functions that are no long=
er part of newlib itself. If you are using T=
CLIBC =3D "newlib" this now means that you must link application=
s with both newlib and libgloss, =
whereas before newlib would run in many configurations=
by itself.
> +
> +
> +
> +
> +
> +
> +
>
>