diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2013-08-19 17:16:16 +0300 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2013-08-26 11:06:29 +0100 |
commit | 06c124b02dcf792a479ce0d3ee5befa0deb7be47 (patch) | |
tree | aa4408f87ca7882dba99a6513ce4891b62f8e86b /documentation | |
parent | a0eec0d86f12d20e8c0c77f31f68b77f563fe8ff (diff) | |
download | ast2050-yocto-poky-06c124b02dcf792a479ce0d3ee5befa0deb7be47.zip ast2050-yocto-poky-06c124b02dcf792a479ce0d3ee5befa0deb7be47.tar.gz |
ref-manual: New section on patching for expanded build process
Fixes [YOCTO #2808]
Added a new sub-section to the BitBake section that takes a
closer look at the build process. Part of the requirements
was a new figure that had to be added to both the ref-manual
and the mega-manual figures directories.
(From yocto-docs rev: c40476b079cf5765b8228502f0ef33072f8b2b85)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/mega-manual/figures/patching.png | bin | 0 -> 40515 bytes | |||
-rw-r--r-- | documentation/ref-manual/figures/patching.png | bin | 0 -> 40515 bytes | |||
-rw-r--r-- | documentation/ref-manual/technical-details.xml | 35 |
3 files changed, 35 insertions, 0 deletions
diff --git a/documentation/mega-manual/figures/patching.png b/documentation/mega-manual/figures/patching.png Binary files differnew file mode 100644 index 0000000..a26a082 --- /dev/null +++ b/documentation/mega-manual/figures/patching.png diff --git a/documentation/ref-manual/figures/patching.png b/documentation/ref-manual/figures/patching.png Binary files differnew file mode 100644 index 0000000..a26a082 --- /dev/null +++ b/documentation/ref-manual/figures/patching.png diff --git a/documentation/ref-manual/technical-details.xml b/documentation/ref-manual/technical-details.xml index a3dd6f0..5ee2615 100644 --- a/documentation/ref-manual/technical-details.xml +++ b/documentation/ref-manual/technical-details.xml @@ -1031,6 +1031,41 @@ building goes on for a given recipe. </para> </section> + + <section id='patching-dev-environment'> + <title>Patching</title> + + <para> + Once source code is fetched and unpacked, BitBake locates + patch files and applies them to the source files: + <imagedata fileref="figures/patching.png" align="center" width="6in" depth="5in" /> + </para> + + <para> + The <filename>do_patch</filename> task processes recipes by + using the + <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link> + variable to locate applicable patch files, which by default + are <filename>*.patch</filename> or + <filename>*.diff</filename> files, or any file if + "apply=yes" is specified for the file in + <filename>SRC_URI</filename>. + </para> + + <para> + BitBake finds and applies multiple patches for a single recipe + in the order in which it finds the patches. + Patches are applied to the recipe's source files located in the + <link linkend='var-S'><filename>S</filename></link> directory. + </para> + + <para> + For more information on how the source directories are + created, see the + "<link linkend='source-fetching-dev-environment'>Source Fetching</link>" + section. + </para> + </section> </section> </section> |