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 @@ - The do_fetch task uses the prefix of - each entry in the SRC_URI variable value - to determine what fetcher to use to get your source files. + The + do_fetch + task uses the prefix of each entry in the + SRC_URI variable value to determine what + fetcher to use to get your source files. It is the SRC_URI variable that triggers the fetcher. - The do_patch task uses the variable after - source is fetched to apply patches. + The + do_patch + task uses the variable after source is fetched to apply + patches. The OpenEmbedded build system uses FILESOVERRIDES for scanning directory locations for local files in @@ -1694,7 +1698,9 @@ in a typical archive extension (e.g. .tar, .tar.gz, .tar.bz2, .zip, and so forth), are automatically - extracted during the do_unpack task. + extracted during the + do_unpack + task. For another example that specifies these types of files, see the "Autotooled Package" @@ -1811,8 +1817,9 @@ Unpacking Code - During the build, the do_unpack task - unpacks the source with + During the build, the + do_unpack + task unpacks the source with ${S} pointing to where it is unpacked. @@ -1846,8 +1853,9 @@ Any files mentioned in SRC_URI whose names end in .patch or .diff are treated as patches. - The do_patch task automatically applies - these patches. + The + do_patch + task automatically applies these patches. @@ -2021,7 +2029,8 @@ the autotools class and your recipe does not have to contain a - do_configure task. + do_configure + task. However, you might still want to make some adjustments. For example, you can set EXTRA_OECONF @@ -2037,7 +2046,8 @@ the cmake class and your recipe does not have to contain a - do_configure task. + do_configure + task. You can make some adjustments by setting EXTRA_OECMAKE to pass any needed configure options that are specific @@ -2049,7 +2059,8 @@ software is built using some method other than Autotools or CMake. If this is the case, you normally need to provide a - do_configure task in your recipe + do_configure + task in your recipe unless, of course, there is nothing to configure. 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 @@ section. Task: A unit of execution for BitBake (e.g. - do_compile, - do_fetch, do_patch, + do_compile, + do_fetch, + do_patch, and so forth). Upstream: A reference to source code or repositories