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 |