summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/ref-manual/migration.xml144
1 files changed, 88 insertions, 56 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 0e297b5..d072ecf 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -1701,6 +1701,45 @@
1701 Yocto Project 1.7 Release from the prior release. 1701 Yocto Project 1.7 Release from the prior release.
1702 </para> 1702 </para>
1703 1703
1704 <section id='migration-1.7-changes-to-setting-qemu-packageconfig-options'>
1705 <title>Changes to Setting QEMU <filename>PACKAGECONFIG</filename> Options in <filename>local.conf</filename></title>
1706
1707 <para>
1708 The QEMU recipe now uses a number of
1709 <link linkend='var-PACKAGECONFIG'><filename>PACKAGECONFIG</filename></link>
1710 options to enable various optional features.
1711 The method used to set defaults for these options means that
1712 existing
1713 <filename>local.conf</filename> files will need to be be
1714 modified to append to <filename>PACKAGECONFIG</filename> for
1715 <filename>qemu-native</filename> and
1716 <filename>nativesdk-qemu</filename> instead of setting it.
1717 In other words, to enable graphical output for QEMU, you should
1718 now have these lines in <filename>local.conf</filename>:
1719 <literallayout class='monospaced'>
1720 PACKAGECONFIG_append_pn-qemu-native = " sdl"
1721 PACKAGECONFIG_append_pn-nativesdk-qemu = " sdl"
1722 </literallayout>
1723 </para>
1724 </section>
1725
1726 <section id='migration-1.7-minimum-git-version'>
1727 <title>Minimum Git version</title>
1728
1729 <para>
1730 The minimum
1731 <ulink url='&YOCTO_DOCS_DEV_URL;#git'>Git</ulink> version required
1732 on the build host is now 1.7.8 because the
1733 <filename>&dash;&dash;list</filename> option is now required by
1734 BitBake's Git fetcher.
1735 As always, if your host distribution does not provide a version of
1736 Git that meets this requirement, you can use the
1737 <filename>buildtools-tarball</filename> that does.
1738 See the
1739 "<link linkend='required-git-tar-and-python-versions'>Required Git, tar, and Python Versions</link>"
1740 section for more information.
1741 </para>
1742 </section>
1704 1743
1705 <section id='migration-1.7-autotools-class-changes'> 1744 <section id='migration-1.7-autotools-class-changes'>
1706 <title>Autotools Class Changes</title> 1745 <title>Autotools Class Changes</title>
@@ -1859,61 +1898,6 @@
1859 </para> 1898 </para>
1860 </section> 1899 </section>
1861 1900
1862 <section id='migration-1.7-removed-recipes'>
1863 <title>Removed Recipes</title>
1864
1865 <para>
1866 The following recipes have been removed:
1867 <itemizedlist>
1868 <listitem><para>
1869 <filename>x-load</filename>:
1870 This recipe has been superseded by
1871 U-boot SPL for all Cortex-based TI SoCs.
1872 For legacy boards, the <filename>meta-ti</filename>
1873 layer, which contains a maintained recipe, should be used
1874 instead.
1875 </para></listitem>
1876 <listitem><para>
1877 <filename>ubootchart</filename>:
1878 This recipe is obsolete.
1879 A <filename>bootchart2</filename> recipe has been added
1880 to functionally replace it.
1881 </para></listitem>
1882 <listitem><para>
1883 <filename>linux-yocto 3.4</filename>:
1884 Support for the linux-yocto 3.4 kernel has been dropped.
1885 Support for the 3.10 and 3.14 kernels remains, while
1886 support for version 3.17 has been added.
1887 </para></listitem>
1888 <listitem><para>
1889 <filename>eglibc</filename> has been removed in favor of
1890 <filename>glibc</filename>.
1891 See the
1892 "<link linkend='migration-1.7-glibc-replaces-eglibc'><filename>eglibc 2.19</filename> Replaced with <filename>glibc 2.20</filename></link>"
1893 section for more information.
1894 </para></listitem>
1895 </itemizedlist>
1896 </para>
1897 </section>
1898
1899 <section id='migration-1.7-minimum-git-version'>
1900 <title>Minimum Git version</title>
1901
1902 <para>
1903 The minimum
1904 <ulink url='&YOCTO_DOCS_DEV_URL;#git'>Git</ulink> version required
1905 on the build host is now 1.7.8 because the
1906 <filename>&dash;&dash;list</filename> option is now required by
1907 BitBake's Git fetcher.
1908 As always, if your host distribution does not provide a version of
1909 Git that meets this requirement, you can use the
1910 <filename>buildtools-tarball</filename> that does.
1911 See the
1912 "<link linkend='required-git-tar-and-python-versions'>Required Git, tar, and Python Versions</link>"
1913 section for more information.
1914 </para>
1915 </section>
1916
1917 <section id='migration-1.7-qa-check-changes'> 1901 <section id='migration-1.7-qa-check-changes'>
1918 <title>QA Check Changes</title> 1902 <title>QA Check Changes</title>
1919 1903
@@ -1951,7 +1935,55 @@
1951 Recipes should not be overwriting files written to the 1935 Recipes should not be overwriting files written to the
1952 sysroot by other recipes. 1936 sysroot by other recipes.
1953 If you have these types of recipes, you need to alter them 1937 If you have these types of recipes, you need to alter them
1954 so that they do not overwrite these files. 1938 so that they do not overwrite these files.</para>
1939 <para>You might now receive this error after changes in
1940 configuration or metadata resulting in orphaned files
1941 being left in the sysroot.
1942 If you do receive this error, the way to resolve the issue
1943 is to delete your
1944 <link linkend='var-TMPDIR'><filename>TMPDIR</filename></link>
1945 or to move it out of the way and then re-start the build.
1946 Anything that has been fully built up to that point and
1947 does not need rebuilding will be restored from the shared
1948 state cache and the rest of the build will be able to
1949 proceed as normal.
1950 </para></listitem>
1951 </itemizedlist>
1952 </para>
1953 </section>
1954
1955 <section id='migration-1.7-removed-recipes'>
1956 <title>Removed Recipes</title>
1957
1958 <para>
1959 The following recipes have been removed:
1960 <itemizedlist>
1961 <listitem><para>
1962 <filename>x-load</filename>:
1963 This recipe has been superseded by
1964 U-boot SPL for all Cortex-based TI SoCs.
1965 For legacy boards, the <filename>meta-ti</filename>
1966 layer, which contains a maintained recipe, should be used
1967 instead.
1968 </para></listitem>
1969 <listitem><para>
1970 <filename>ubootchart</filename>:
1971 This recipe is obsolete.
1972 A <filename>bootchart2</filename> recipe has been added
1973 to functionally replace it.
1974 </para></listitem>
1975 <listitem><para>
1976 <filename>linux-yocto 3.4</filename>:
1977 Support for the linux-yocto 3.4 kernel has been dropped.
1978 Support for the 3.10 and 3.14 kernels remains, while
1979 support for version 3.17 has been added.
1980 </para></listitem>
1981 <listitem><para>
1982 <filename>eglibc</filename> has been removed in favor of
1983 <filename>glibc</filename>.
1984 See the
1985 "<link linkend='migration-1.7-glibc-replaces-eglibc'><filename>eglibc 2.19</filename> Replaced with <filename>glibc 2.20</filename></link>"
1986 section for more information.
1955 </para></listitem> 1987 </para></listitem>
1956 </itemizedlist> 1988 </itemizedlist>
1957 </para> 1989 </para>