diff options
| -rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 37 | ||||
| -rw-r--r-- | documentation/dev-manual/dev-manual-newbie.xml | 5 |
2 files changed, 27 insertions, 15 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 01add16a60..aad8fb7787 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
| @@ -1650,13 +1650,17 @@ | |||
| 1650 | </para> | 1650 | </para> |
| 1651 | 1651 | ||
| 1652 | <para> | 1652 | <para> |
| 1653 | The <filename>do_fetch</filename> task uses the prefix of | 1653 | The |
| 1654 | each entry in the <filename>SRC_URI</filename> variable value | 1654 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-fetch'><filename>do_fetch</filename></ulink> |
| 1655 | to determine what fetcher to use to get your source files. | 1655 | task uses the prefix of each entry in the |
| 1656 | <filename>SRC_URI</filename> variable value to determine what | ||
| 1657 | fetcher to use to get your source files. | ||
| 1656 | It is the <filename>SRC_URI</filename> variable that triggers | 1658 | It is the <filename>SRC_URI</filename> variable that triggers |
| 1657 | the fetcher. | 1659 | the fetcher. |
| 1658 | The <filename>do_patch</filename> task uses the variable after | 1660 | The |
| 1659 | source is fetched to apply patches. | 1661 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-patch'><filename>do_patch</filename></ulink> |
| 1662 | task uses the variable after source is fetched to apply | ||
| 1663 | patches. | ||
| 1660 | The OpenEmbedded build system uses | 1664 | The OpenEmbedded build system uses |
| 1661 | <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESOVERRIDES'><filename>FILESOVERRIDES</filename></ulink> | 1665 | <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESOVERRIDES'><filename>FILESOVERRIDES</filename></ulink> |
| 1662 | for scanning directory locations for local files in | 1666 | for scanning directory locations for local files in |
| @@ -1694,7 +1698,9 @@ | |||
| 1694 | in a typical archive extension (e.g. <filename>.tar</filename>, | 1698 | in a typical archive extension (e.g. <filename>.tar</filename>, |
| 1695 | <filename>.tar.gz</filename>, <filename>.tar.bz2</filename>, | 1699 | <filename>.tar.gz</filename>, <filename>.tar.bz2</filename>, |
| 1696 | <filename>.zip</filename>, and so forth), are automatically | 1700 | <filename>.zip</filename>, and so forth), are automatically |
| 1697 | extracted during the <filename>do_unpack</filename> task. | 1701 | extracted during the |
| 1702 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-unpack'><filename>do_unpack</filename></ulink> | ||
| 1703 | task. | ||
| 1698 | For another example that specifies these types of files, see | 1704 | For another example that specifies these types of files, see |
| 1699 | the | 1705 | the |
| 1700 | "<link linkend='new-recipe-autotooled-package'>Autotooled Package</link>" | 1706 | "<link linkend='new-recipe-autotooled-package'>Autotooled Package</link>" |
| @@ -1811,8 +1817,9 @@ | |||
| 1811 | <title>Unpacking Code</title> | 1817 | <title>Unpacking Code</title> |
| 1812 | 1818 | ||
| 1813 | <para> | 1819 | <para> |
| 1814 | During the build, the <filename>do_unpack</filename> task | 1820 | During the build, the |
| 1815 | unpacks the source with | 1821 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-unpack'><filename>do_unpack</filename></ulink> |
| 1822 | task unpacks the source with | ||
| 1816 | <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-S'><filename>S</filename></ulink><filename>}</filename> | 1823 | <filename>${</filename><ulink url='&YOCTO_DOCS_REF_URL;#var-S'><filename>S</filename></ulink><filename>}</filename> |
| 1817 | pointing to where it is unpacked. | 1824 | pointing to where it is unpacked. |
| 1818 | </para> | 1825 | </para> |
| @@ -1846,8 +1853,9 @@ | |||
| 1846 | Any files mentioned in <filename>SRC_URI</filename> whose | 1853 | Any files mentioned in <filename>SRC_URI</filename> whose |
| 1847 | names end in <filename>.patch</filename> or | 1854 | names end in <filename>.patch</filename> or |
| 1848 | <filename>.diff</filename> are treated as patches. | 1855 | <filename>.diff</filename> are treated as patches. |
| 1849 | The <filename>do_patch</filename> task automatically applies | 1856 | The |
| 1850 | these patches. | 1857 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-patch'><filename>do_patch</filename></ulink> |
| 1858 | task automatically applies these patches. | ||
| 1851 | </para> | 1859 | </para> |
| 1852 | 1860 | ||
| 1853 | <para> | 1861 | <para> |
| @@ -2021,7 +2029,8 @@ | |||
| 2021 | the | 2029 | the |
| 2022 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-autotools'><filename>autotools</filename></ulink> | 2030 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-autotools'><filename>autotools</filename></ulink> |
| 2023 | class and your recipe does not have to contain a | 2031 | class and your recipe does not have to contain a |
| 2024 | <filename>do_configure</filename> task. | 2032 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-configure'><filename>do_configure</filename></ulink> |
| 2033 | task. | ||
| 2025 | However, you might still want to make some adjustments. | 2034 | However, you might still want to make some adjustments. |
| 2026 | For example, you can set | 2035 | For example, you can set |
| 2027 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_OECONF'><filename>EXTRA_OECONF</filename></ulink> | 2036 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_OECONF'><filename>EXTRA_OECONF</filename></ulink> |
| @@ -2037,7 +2046,8 @@ | |||
| 2037 | the | 2046 | the |
| 2038 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-cmake'><filename>cmake</filename></ulink> | 2047 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-cmake'><filename>cmake</filename></ulink> |
| 2039 | class and your recipe does not have to contain a | 2048 | class and your recipe does not have to contain a |
| 2040 | <filename>do_configure</filename> task. | 2049 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-configure'><filename>do_configure</filename></ulink> |
| 2050 | task. | ||
| 2041 | You can make some adjustments by setting | 2051 | You can make some adjustments by setting |
| 2042 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_OECMAKE'><filename>EXTRA_OECMAKE</filename></ulink> | 2052 | <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_OECMAKE'><filename>EXTRA_OECMAKE</filename></ulink> |
| 2043 | to pass any needed configure options that are specific | 2053 | to pass any needed configure options that are specific |
| @@ -2049,7 +2059,8 @@ | |||
| 2049 | software is built using some method other than Autotools | 2059 | software is built using some method other than Autotools |
| 2050 | or CMake. | 2060 | or CMake. |
| 2051 | If this is the case, you normally need to provide a | 2061 | If this is the case, you normally need to provide a |
| 2052 | <filename>do_configure</filename> task in your recipe | 2062 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-configure'><filename>do_configure</filename></ulink> |
| 2063 | task in your recipe | ||
| 2053 | unless, of course, there is nothing to configure. | 2064 | unless, of course, there is nothing to configure. |
| 2054 | </para> | 2065 | </para> |
| 2055 | <para>Even if your software is not being built by | 2066 | <para>Even if your software is not being built by |
diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml index 37fa5afdd5..434a7d15a5 100644 --- a/documentation/dev-manual/dev-manual-newbie.xml +++ b/documentation/dev-manual/dev-manual-newbie.xml | |||
| @@ -804,8 +804,9 @@ | |||
| 804 | section.</para></listitem> | 804 | section.</para></listitem> |
| 805 | <listitem><para><emphasis>Task:</emphasis> | 805 | <listitem><para><emphasis>Task:</emphasis> |
| 806 | A unit of execution for BitBake (e.g. | 806 | A unit of execution for BitBake (e.g. |
| 807 | <filename>do_compile</filename>, | 807 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-compile'><filename>do_compile</filename></ulink>, |
| 808 | <filename>do_fetch</filename>, <filename>do_patch</filename>, | 808 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-fetch'><filename>do_fetch</filename></ulink>, |
| 809 | <ulink url='&YOCTO_DOCS_REF_URL;#ref-tasks-patch'><filename>do_patch</filename></ulink>, | ||
| 809 | and so forth). | 810 | and so forth). |
| 810 | </para></listitem> | 811 | </para></listitem> |
| 811 | <listitem><para><emphasis>Upstream:</emphasis> A reference to source code or repositories | 812 | <listitem><para><emphasis>Upstream:</emphasis> A reference to source code or repositories |
