summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/migration.xml90
1 files changed, 43 insertions, 47 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index b0e8eae1e0..dcfcb168c3 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -4742,7 +4742,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4742 (in seconds) and BitBake's server stays resident for that 4742 (in seconds) and BitBake's server stays resident for that
4743 amount of time between invocations. 4743 amount of time between invocations.
4744 The <filename>oe-init-build-env-memres</filename> script has been 4744 The <filename>oe-init-build-env-memres</filename> script has been
4745 removed which means a separate environment setup script is no longer 4745 removed since a separate environment setup script is no longer
4746 needed. 4746 needed.
4747 </para> 4747 </para>
4748 </section> 4748 </section>
@@ -4759,7 +4759,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4759 <itemizedlist> 4759 <itemizedlist>
4760 <listitem><para> 4760 <listitem><para>
4761 The main "python3" package now brings in all of the 4761 The main "python3" package now brings in all of the
4762 standard Python 3 distributions rather than a subset. 4762 standard Python 3 distribution rather than a subset.
4763 This behavior matches what is expected based on 4763 This behavior matches what is expected based on
4764 traditional Linux distributions. 4764 traditional Linux distributions.
4765 If you wish to install a subset of Python 3, specify 4765 If you wish to install a subset of Python 3, specify
@@ -4779,7 +4779,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4779 </para></listitem> 4779 </para></listitem>
4780 <listitem><para> 4780 <listitem><para>
4781 <emphasis><filename>binutils</filename>:</emphasis> 4781 <emphasis><filename>binutils</filename>:</emphasis>
4782 The <filename>libbfd</filename> package is now packaged in 4782 The <filename>libbfd</filename> library is now packaged in
4783 a separate "libbfd" package. 4783 a separate "libbfd" package.
4784 This packaging saves space when certain tools 4784 This packaging saves space when certain tools
4785 (e.g. <filename>perf</filename>) are installed. 4785 (e.g. <filename>perf</filename>) are installed.
@@ -4791,7 +4791,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4791 <emphasis><filename>util-linux</filename> Changes:</emphasis> 4791 <emphasis><filename>util-linux</filename> Changes:</emphasis>
4792 <itemizedlist> 4792 <itemizedlist>
4793 <listitem><para> 4793 <listitem><para>
4794 The <filename>su</filename> package is now packaged 4794 The <filename>su</filename> program is now packaged
4795 in a separate "util-linux-su" package, which is only 4795 in a separate "util-linux-su" package, which is only
4796 built when "pam" is listed in the 4796 built when "pam" is listed in the
4797 <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link> 4797 <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link>
@@ -4803,12 +4803,12 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4803 The main <filename>util-linux</filename> package has 4803 The main <filename>util-linux</filename> package has
4804 runtime dependencies (i.e. 4804 runtime dependencies (i.e.
4805 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>) 4805 <link linkend='var-RDEPENDS'><filename>RDEPENDS</filename></link>)
4806 on the <filename>util-linux</filename> package when 4806 on the <filename>util-linux-su</filename> package
4807 "pam" is in 4807 when "pam" is in
4808 <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link>. 4808 <link linkend='var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></link>.
4809 </para></listitem> 4809 </para></listitem>
4810 <listitem><para> 4810 <listitem><para>
4811 The <filename>switch_root</filename> package is now 4811 The <filename>switch_root</filename> program is now
4812 packaged in a separate "util-linux-switch-root" 4812 packaged in a separate "util-linux-switch-root"
4813 package for small initramfs images that do not need 4813 package for small initramfs images that do not need
4814 the whole <filename>util-linux</filename> package or 4814 the whole <filename>util-linux</filename> package or
@@ -4817,21 +4817,21 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4817 The main <filename>util-linux</filename> package has 4817 The main <filename>util-linux</filename> package has
4818 a recommended runtime dependency (i.e. 4818 a recommended runtime dependency (i.e.
4819 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>) 4819 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>)
4820 on the <filename>switch_root</filename> package. 4820 on the <filename>util-linux-switch-root</filename> package.
4821 </para></listitem> 4821 </para></listitem>
4822 <listitem><para> 4822 <listitem><para>
4823 The <filename>ionice</filename> package is now 4823 The <filename>ionice</filename> program is now
4824 packaged in a separate "util-linux-ionice" package. 4824 packaged in a separate "util-linux-ionice" package.
4825 The main <filename>util-linux</filename> package has 4825 The main <filename>util-linux</filename> package has
4826 a recommended runtime dependency (i.e. 4826 a recommended runtime dependency (i.e.
4827 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>) 4827 <link linkend='var-RRECOMMENDS'><filename>RRECOMMENDS</filename></link>)
4828 on the <filename>ionice</filename> package. 4828 on the <filename>util-linux-ionice</filename> package.
4829 </para></listitem> 4829 </para></listitem>
4830 </itemizedlist> 4830 </itemizedlist>
4831 </para></listitem> 4831 </para></listitem>
4832 <listitem><para> 4832 <listitem><para>
4833 <emphasis><filename>initscripts</filename>:</emphasis> 4833 <emphasis><filename>initscripts</filename>:</emphasis>
4834 The <filename>sushell</filename> package is now packaged in 4834 The <filename>sushell</filename> program is now packaged in
4835 a separate "initscripts-sushell" package. 4835 a separate "initscripts-sushell" package.
4836 This packaging change allows systems to pull 4836 This packaging change allows systems to pull
4837 <filename>sushell</filename> in when 4837 <filename>sushell</filename> in when
@@ -4859,7 +4859,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4859 large and is not required. 4859 large and is not required.
4860 </para></listitem> 4860 </para></listitem>
4861 <listitem><para> 4861 <listitem><para>
4862 <emphasis><filename>Go Standard Runtime</filename>:</emphasis> 4862 <emphasis>Go Standard Runtime:</emphasis>
4863 The Go standard runtime has been split out from the main 4863 The Go standard runtime has been split out from the main
4864 <filename>go</filename> recipe into a separate 4864 <filename>go</filename> recipe into a separate
4865 <filename>go-runtime</filename> recipe. 4865 <filename>go-runtime</filename> recipe.
@@ -4880,18 +4880,17 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4880 </para></listitem> 4880 </para></listitem>
4881 <listitem><para> 4881 <listitem><para>
4882 <emphasis><filename>autogen-native</filename>:</emphasis> 4882 <emphasis><filename>autogen-native</filename>:</emphasis>
4883 No longer required by Grub, <filename>oe-core</filename>, or 4883 No longer required by Grub, oe-core, or meta-oe.
4884 <filename>meta-oe</filename>.
4885 </para></listitem> 4884 </para></listitem>
4886 <listitem><para> 4885 <listitem><para>
4887 <emphasis><filename>bdwgc</filename>:</emphasis> 4886 <emphasis><filename>bdwgc</filename>:</emphasis>
4888 Nothing in OpenEmbedded-Core requires this recipe. 4887 Nothing in OpenEmbedded-Core requires this recipe.
4889 It has moved to <filename>meta-oe</filename> 4888 It has moved to meta-oe.
4890 </para></listitem> 4889 </para></listitem>
4891 <listitem><para> 4890 <listitem><para>
4892 <emphasis><filename>byacc</filename>:</emphasis> 4891 <emphasis><filename>byacc</filename>:</emphasis>
4893 This recipe was only needed by rpm 5.x and has moved to 4892 This recipe was only needed by rpm 5.x and has moved to
4894 <filename>meta-oe</filename>. 4893 meta-oe.
4895 </para></listitem> 4894 </para></listitem>
4896 <listitem><para> 4895 <listitem><para>
4897 <emphasis><filename>gcc (5.4)</filename>:</emphasis> 4896 <emphasis><filename>gcc (5.4)</filename>:</emphasis>
@@ -4911,32 +4910,32 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4911 This recipe was only needed by 4910 This recipe was only needed by
4912 <filename>autogen-native</filename> and 4911 <filename>autogen-native</filename> and
4913 <filename>remake</filename>. 4912 <filename>remake</filename>.
4914 It is no longer needed by either of these programs. 4913 The recipe is no longer needed by either of these programs.
4915 </para></listitem> 4914 </para></listitem>
4916 <listitem><para> 4915 <listitem><para>
4917 <emphasis><filename>libclass-isa-perl</filename>:</emphasis> 4916 <emphasis><filename>libclass-isa-perl</filename>:</emphasis>
4918 This recipe was previously needed for LSB 4, which no longer 4917 This recipe was previously needed for LSB 4, no longer
4919 requires the recipe. 4918 needed.
4920 </para></listitem> 4919 </para></listitem>
4921 <listitem><para> 4920 <listitem><para>
4922 <emphasis><filename>libdumpvalue-perl</filename>:</emphasis> 4921 <emphasis><filename>libdumpvalue-perl</filename>:</emphasis>
4923 This recipe was previously needed for LSB 4, which no longer 4922 This recipe was previously needed for LSB 4, no longer
4924 requires the recipe. 4923 needed.
4925 </para></listitem> 4924 </para></listitem>
4926 <listitem><para> 4925 <listitem><para>
4927 <emphasis><filename>libenv-perl</filename>:</emphasis> 4926 <emphasis><filename>libenv-perl</filename>:</emphasis>
4928 This recipe was previously needed for LSB 4, which no longer 4927 This recipe was previously needed for LSB 4, no longer
4929 requires the recipe. 4928 needed.
4930 </para></listitem> 4929 </para></listitem>
4931 <listitem><para> 4930 <listitem><para>
4932 <emphasis><filename>libfile-checktree-perl</filename>:</emphasis> 4931 <emphasis><filename>libfile-checktree-perl</filename>:</emphasis>
4933 This recipe was previously needed for LSB 4, which no longer 4932 This recipe was previously needed for LSB 4, no longer
4934 requires the recipe. 4933 needed.
4935 </para></listitem> 4934 </para></listitem>
4936 <listitem><para> 4935 <listitem><para>
4937 <emphasis><filename>libi18n-collate-perl</filename>:</emphasis> 4936 <emphasis><filename>libi18n-collate-perl</filename>:</emphasis>
4938 This recipe was previously needed for LSB 4, which no longer 4937 This recipe was previously needed for LSB 4, no longer
4939 requires the recipe. 4938 needed.
4940 </para></listitem> 4939 </para></listitem>
4941 <listitem><para> 4940 <listitem><para>
4942 <emphasis><filename>libiconv</filename>:</emphasis> 4941 <emphasis><filename>libiconv</filename>:</emphasis>
@@ -4955,8 +4954,8 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4955 </para></listitem> 4954 </para></listitem>
4956 <listitem><para> 4955 <listitem><para>
4957 <emphasis><filename>libpod-plainer-perl</filename>:</emphasis> 4956 <emphasis><filename>libpod-plainer-perl</filename>:</emphasis>
4958 This recipe was previously needed for LSB 4, which no longer 4957 This recipe was previously needed for LSB 4, no longer
4959 requires the recipe. 4958 needed.
4960 </para></listitem> 4959 </para></listitem>
4961 <listitem><para> 4960 <listitem><para>
4962 <emphasis><filename>linux-yocto (4.1)</filename>:</emphasis> 4961 <emphasis><filename>linux-yocto (4.1)</filename>:</emphasis>
@@ -4969,11 +4968,13 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
4969 </para></listitem> 4968 </para></listitem>
4970 <listitem><para> 4969 <listitem><para>
4971 <emphasis><filename>mesa (git version only)</filename>:</emphasis> 4970 <emphasis><filename>mesa (git version only)</filename>:</emphasis>
4972 This recipe is stale with respect to the release version. 4971 The git version recipe was stale with respect to the release
4972 version.
4973 </para></listitem> 4973 </para></listitem>
4974 <listitem><para> 4974 <listitem><para>
4975 <emphasis><filename>ofono (git version only)</filename>:</emphasis> 4975 <emphasis><filename>ofono (git version only)</filename>:</emphasis>
4976 This recipe is stale with respect to the release version. 4976 The git version recipe was stale with respect to the release
4977 version.
4977 </para></listitem> 4978 </para></listitem>
4978 <listitem><para> 4979 <listitem><para>
4979 <emphasis><filename>portmap</filename>:</emphasis> 4980 <emphasis><filename>portmap</filename>:</emphasis>
@@ -5041,7 +5042,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
5041 <title>Kernel Device Tree Move</title> 5042 <title>Kernel Device Tree Move</title>
5042 5043
5043 <para> 5044 <para>
5044 Kernel Device Tree support is easy to enable in a kernel 5045 Kernel Device Tree support is now easier to enable in a kernel
5045 recipe. 5046 recipe.
5046 The Device Tree code has moved to a 5047 The Device Tree code has moved to a
5047 <filename>kernel-devicetree</filename> class. 5048 <filename>kernel-devicetree</filename> class.
@@ -5074,11 +5075,6 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
5074 <listitem><para> 5075 <listitem><para>
5075 The "unsafe-references-in-scripts" QA check has been 5076 The "unsafe-references-in-scripts" QA check has been
5076 removed. 5077 removed.
5077 Previously, this check ensured
5078 that the backslash character (i.e.
5079 <filename>/</filename>) and <filename>/usr</filename>
5080 could be on different filesystems and that
5081 <filename>/usr</filename> is no longer actively supported.
5082 </para></listitem> 5078 </para></listitem>
5083 <listitem><para> 5079 <listitem><para>
5084 If you refer to <filename>${COREBASE}/LICENSE</filename> 5080 If you refer to <filename>${COREBASE}/LICENSE</filename>
@@ -5164,7 +5160,6 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
5164 one commit per subdirectory in the repository in order to 5160 one commit per subdirectory in the repository in order to
5165 make it easier to see the changes for a particular 5161 make it easier to see the changes for a particular
5166 subdirectory. 5162 subdirectory.
5167 Now Git can filter these changes itself when viewed.
5168 To view a particular change, specify that subdirectory as 5163 To view a particular change, specify that subdirectory as
5169 the last parameter on the <filename>git show</filename> 5164 the last parameter on the <filename>git show</filename>
5170 or <filename>git diff</filename> commands. 5165 or <filename>git diff</filename> commands.
@@ -5179,8 +5174,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
5179 </para></listitem> 5174 </para></listitem>
5180 <listitem><para> 5175 <listitem><para>
5181 BitBake fires multiple "BuildStarted" events when 5176 BitBake fires multiple "BuildStarted" events when
5182 <filename>multiconfig</filename> is enabled. 5177 multiconfig is enabled (one per configuration).
5183 This is limited to one per configuration.
5184 For more information, see the 5178 For more information, see the
5185 "<ulink url='&YOCTO_DOCS_BB_URL;#events'>Events</ulink>" 5179 "<ulink url='&YOCTO_DOCS_BB_URL;#events'>Events</ulink>"
5186 in the BitBake User Manual. 5180 in the BitBake User Manual.
@@ -5222,19 +5216,21 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
5222 However, the default is still 1.0.x through the 5216 However, the default is still 1.0.x through the
5223 <link linkend='var-PREFERRED_VERSION'><filename>PREFERRED_VERSION</filename></link> 5217 <link linkend='var-PREFERRED_VERSION'><filename>PREFERRED_VERSION</filename></link>
5224 variable. 5218 variable.
5225 This change is due to the remaining compatibility issues 5219 This preference is set is due to the remaining compatibility
5226 with other software. 5220 issues with other software.
5227 The 5221 The
5228 <link linkend='var-PROVIDES'><filename>PROVIDES</filename></link> 5222 <link linkend='var-PROVIDES'><filename>PROVIDES</filename></link>
5229 variable includes "openssl10" as a marker for recipes that 5223 variable in the openssl 1.0 recipe now includes "openssl10"
5230 still depend on OpenSSL 1.0. 5224 as a marker that can be used in
5225 <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>
5226 within recipes that build software that still depend on
5227 OpenSSL 1.0.
5231 </para></listitem> 5228 </para></listitem>
5232 <listitem><para> 5229 <listitem><para>
5233 To ensure consistent behavior, BitBake's "-r" and "-R" 5230 To ensure consistent behavior, BitBake's "-r" and "-R"
5234 options (i.e. prefile and postfile), which are used to 5231 options (i.e. prefile and postfile), which are used to
5235 <filename>read</filename> or <filename>post-read</filename> 5232 read or post-read additional configuration files from the
5236 additional configuration files from the command line, now 5233 command line, now only affect the current BitBake command.
5237 only affect the current BitBake command.
5238 Before this change these options would "stick" for 5234 Before this change these options would "stick" for
5239 future executions. 5235 future executions.
5240 <note> 5236 <note>