summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/migration.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-10-14 06:57:45 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-10-18 16:15:28 +0200
commit8eb706a41b040cf1397c2ebe5517c40031f4d1fb (patch)
treee712abfb9878b9ab803b7c862799b769b682f631 /documentation/ref-manual/migration.xml
parent323929d1ee5d18da7aebf1e536706f00f65f4f35 (diff)
downloadpoky-8eb706a41b040cf1397c2ebe5517c40031f4d1fb.tar.gz
ref-manual, dev-manual: Applied migration review edits.
Applied the full set of first draft revision edits for the new migration section for 1.7. Comments from Paul Eggleton. (From yocto-docs rev: 90586addbc719ecaf7c768b267adf0e988e27b74) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/migration.xml')
-rw-r--r--documentation/ref-manual/migration.xml85
1 files changed, 38 insertions, 47 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 864c489251..dd8c3e00cc 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -1710,17 +1710,19 @@
1710 class changes occurred: 1710 class changes occurred:
1711 <itemizedlist> 1711 <itemizedlist>
1712 <listitem><para><emphasis> 1712 <listitem><para><emphasis>
1713 A separate build directory in Autotools recipes is 1713 A separate build directory is now used by default:</emphasis>
1714 handled:</emphasis>
1715 The <filename>autotools</filename> class has been changed 1714 The <filename>autotools</filename> class has been changed
1716 to use a directory for building 1715 to use a directory for building
1717 (<link linkend='var-B'><filename>B</filename></link>), 1716 (<link linkend='var-B'><filename>B</filename></link>),
1718 which is separate from the source directory 1717 which is separate from the source directory
1719 (<link linkend='var-S'><filename>S</filename></link>). 1718 (<link linkend='var-S'><filename>S</filename></link>).
1720 If the software being built is already capable of 1719 This is commonly referred to as
1720 <filename>B != S</filename>, or an out-of-tree build.</para>
1721 <para>If the software being built is already capable of
1721 building in a directory separate from the source, you 1722 building in a directory separate from the source, you
1722 do not need to do anything. 1723 do not need to do anything.
1723 However, if this capability does not exist, you will 1724 However, if the software is not capable of being built
1725 in this manner, you will
1724 need to either patch the software so that it can build 1726 need to either patch the software so that it can build
1725 separately, or you will need to change the recipe to 1727 separately, or you will need to change the recipe to
1726 inherit the 1728 inherit the
@@ -1728,25 +1730,24 @@
1728 class instead of the <filename>autotools</filename> class. 1730 class instead of the <filename>autotools</filename> class.
1729 </para></listitem> 1731 </para></listitem>
1730 <listitem><para><emphasis> 1732 <listitem><para><emphasis>
1731 Handle "foreign":</emphasis> 1733 The <filename>&dash;&dash;foreign</filename> option is
1732 The <filename>--foreign</filename> option is no longer 1734 no longer passed to <filename>automake</filename> when
1733 passed to <filename>automake</filename> when running 1735 running <filename>autoconf</filename>:</emphasis>
1734 <filename>autoreconf</filename>.
1735 This option tells <filename>automake</filename> that a 1736 This option tells <filename>automake</filename> that a
1736 particular software package does not follow the GNU 1737 particular software package does not follow the GNU
1737 standards and therefore should not be expected 1738 standards and therefore should not be expected
1738 to distribute certain files such as 1739 to distribute certain files such as
1739 <filename>ChangeLog</filename>, 1740 <filename>ChangeLog</filename>,
1740 <filename>AUTHORS</filename>, and so forth. 1741 <filename>AUTHORS</filename>, and so forth.
1741 The majority of upstream software packages already tell 1742 Because the majority of upstream software packages already
1742 <filename>automake</filename> these packages are foreign 1743 tell <filename>automake</filename> to enable foreign mode
1743 and thus this option is mostly superfluous. 1744 themselves, the option is mostly superfluous.
1744 However, some recipes will need patches for this change. 1745 However, some recipes will need patches for this change.
1745 You can easily make the change by patching 1746 You can easily make the change by patching
1746 <filename>configure.ac</filename> so that it passes 1747 <filename>configure.ac</filename> so that it passes
1747 "foreign" to <filename>AM_INIT_AUTOMAKE()</filename>. 1748 "foreign" to <filename>AM_INIT_AUTOMAKE()</filename>.
1748 See 1749 See
1749 <ulink url='http://cgit.openembedded.org/openembedded-core/commit/?id=01943188f85ce6411717fb5bf702d609f55813f2'></ulink> 1750 <ulink url='http://cgit.openembedded.org/openembedded-core/commit/?id=01943188f85ce6411717fb5bf702d609f55813f2'>this commit</ulink>
1750 for an example showing how to make the patch. 1751 for an example showing how to make the patch.
1751 </para></listitem> 1752 </para></listitem>
1752 </itemizedlist> 1753 </itemizedlist>
@@ -1757,12 +1758,12 @@
1757 <title>Binary Configuration Scripts Disabled</title> 1758 <title>Binary Configuration Scripts Disabled</title>
1758 1759
1759 <para> 1760 <para>
1760 Some of the core recipes that previously packaged binary 1761 Some of the core recipes that package binary configuration scripts
1761 configuration scripts now disable the scripts instead due to the 1762 now disable the scripts instead due to the
1762 scripts previously requiring error-prone path substitution. 1763 scripts previously requiring error-prone path substitution.
1763 Software that links against these libraries using these scripts 1764 Software that links against these libraries using these scripts
1764 should use the much more robust 1765 should use the much more robust <filename>pkg-config</filename>
1765 <filename>pkg-config</filename> instead. 1766 instead.
1766 The list of recipes changed in this version (and their 1767 The list of recipes changed in this version (and their
1767 configuration scripts) is as follows: 1768 configuration scripts) is as follows:
1768 <literallayout class='monospaced'> 1769 <literallayout class='monospaced'>
@@ -1787,12 +1788,10 @@
1787 pth (pth-config) 1788 pth (pth-config)
1788 taglib (taglib-config) 1789 taglib (taglib-config)
1789 </literallayout> 1790 </literallayout>
1790 <note> 1791 Additionally, support for <filename>pkg-config</filename> has been
1791 Support for <filename>pkg-config</filename> has been added to 1792 added to some recipes in the previous list in the rare cases
1792 some recipes in the previous list in the rare cases 1793 where the upstream software package does not already provide
1793 where the upstream software package does not already provide 1794 it.
1794 it.
1795 </note>
1796 </para> 1795 </para>
1797 </section> 1796 </section>
1798 1797
@@ -1811,15 +1810,15 @@
1811 </para> 1810 </para>
1812 1811
1813 <para> 1812 <para>
1814 <filename>glibc 2.20</filename> also minimally requires version 1813 <filename>glibc 2.20</filename> requires version 2.6.32 or greater
1815 2.6.32 of the Linux kernel. 1814 of the Linux kernel.
1816 Thus, older kernels will no longer be usable in conjunction with it. 1815 Thus, older kernels will no longer be usable in conjunction with it.
1817 </para> 1816 </para>
1818 1817
1819 <para> 1818 <para>
1820 For full details on the changes in <filename>glibc 2.20</filename>, 1819 For full details on the changes in <filename>glibc 2.20</filename>,
1821 see the upstream release notes at 1820 see the upstream release notes
1822 <ulink url='https://sourceware.org/ml/libc-alpha/2014-09/msg00088.html'></ulink>. 1821 <ulink url='https://sourceware.org/ml/libc-alpha/2014-09/msg00088.html'>here</ulink>.
1823 </para> 1822 </para>
1824 </section> 1823 </section>
1825 1824
@@ -1829,33 +1828,25 @@
1829 <para> 1828 <para>
1830 The 1829 The
1831 <link linkend='var-module_autoload'><filename>module_autoload_*</filename></link> 1830 <link linkend='var-module_autoload'><filename>module_autoload_*</filename></link>
1832 and 1831 variable is now deprecated and a new
1833 <link linkend='var-module_conf'><filename>module_conf_*</filename></link>
1834 variables have been replaced with the variables
1835 <link linkend='var-KERNEL_MODULE_AUTOLOAD'><filename>KERNEL_MODULE_AUTOLOAD</filename></link> 1832 <link linkend='var-KERNEL_MODULE_AUTOLOAD'><filename>KERNEL_MODULE_AUTOLOAD</filename></link>
1836 and 1833 variable should be used instead.
1837 <link linkend='var-KERNEL_MODULE_PROBECONF'><filename>KERNEL_MODULE_PROBECONF</filename></link>, 1834 Also,
1838 respectively. 1835 <link linkend='var-module_conf'><filename>module_conf_*</filename></link>
1839 These variables no longer require you to specify the module name 1836 must now be used in conjunction with a new
1837 <link linkend='var-KERNEL_MODULE_PROBECONF'><filename>KERNEL_MODULE_PROBECONF</filename></link>
1838 variable.
1839 The new variables no longer require you to specify the module name
1840 as part of the variable name. 1840 as part of the variable name.
1841 This change not only simplifies usage but also allows the values 1841 This change not only simplifies usage but also allows the values
1842 of these variables to be appropriately incorporated into task 1842 of these variables to be appropriately incorporated into task
1843 signatures and thus trigger the appropriate tasks to re-execute 1843 signatures and thus trigger the appropriate tasks to re-execute
1844 when changed. 1844 when changed.
1845 You should replace any references to 1845 You should replace any references to
1846 <filename>module_autoload_*</filename> or 1846 <filename>module_autoload_*</filename> with
1847 <filename>module_conf_*</filename> with the new variables. 1847 <filename>KERNEL_MODULE_AUTOLOAD</filename>, and add any modules
1848 <note> 1848 for which <filename>module_conf_*</filename> is specified to
1849 While it is recommended that you replace occurrences of the 1849 <filename>KERNEL_MODULE_PROBECONF</filename>.
1850 <filename>module_conf_*</filename> variable with the
1851 <filename>KERNEL_MODULE_PROBECONF</filename> variable, the
1852 OpenEmbedded build system still recognizes the
1853 <filename>module_conf_*</filename> variable.
1854 However, you must be sure that any module name used in the
1855 override with the <filename>module_conf</filename> variable
1856 is included in the <filename>KERNEL_MODULE_PROBECONF</filename>
1857 variable.
1858 </note>
1859 </para> 1850 </para>
1860 1851
1861 <para> 1852 <para>
@@ -1863,7 +1854,7 @@
1863 <link linkend='var-KERNEL_MODULE_AUTOLOAD'><filename>KERNEL_MODULE_AUTOLOAD</filename></link> 1854 <link linkend='var-KERNEL_MODULE_AUTOLOAD'><filename>KERNEL_MODULE_AUTOLOAD</filename></link>
1864 and 1855 and
1865 <link linkend='var-KERNEL_MODULE_PROBECONF'><filename>KERNEL_MODULE_PROBECONF</filename></link> 1856 <link linkend='var-KERNEL_MODULE_PROBECONF'><filename>KERNEL_MODULE_PROBECONF</filename></link>
1866 descriptions in the variable's glossary. 1857 variables.
1867 </para> 1858 </para>
1868 </section> 1859 </section>
1869 1860