summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-08-19 17:16:16 +0300
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-08-26 11:06:29 +0100
commit06c124b02dcf792a479ce0d3ee5befa0deb7be47 (patch)
treeaa4408f87ca7882dba99a6513ce4891b62f8e86b /documentation/ref-manual
parenta0eec0d86f12d20e8c0c77f31f68b77f563fe8ff (diff)
downloadpoky-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/ref-manual')
-rw-r--r--documentation/ref-manual/figures/patching.pngbin0 -> 40515 bytes
-rw-r--r--documentation/ref-manual/technical-details.xml35
2 files changed, 35 insertions, 0 deletions
diff --git a/documentation/ref-manual/figures/patching.png b/documentation/ref-manual/figures/patching.png
new file mode 100644
index 0000000000..a26a082bee
--- /dev/null
+++ b/documentation/ref-manual/figures/patching.png
Binary files differ
diff --git a/documentation/ref-manual/technical-details.xml b/documentation/ref-manual/technical-details.xml
index a3dd6f0cb0..5ee2615e5c 100644
--- a/documentation/ref-manual/technical-details.xml
+++ b/documentation/ref-manual/technical-details.xml
@@ -1031,6 +1031,41 @@
1031 building goes on for a given recipe. 1031 building goes on for a given recipe.
1032 </para> 1032 </para>
1033 </section> 1033 </section>
1034
1035 <section id='patching-dev-environment'>
1036 <title>Patching</title>
1037
1038 <para>
1039 Once source code is fetched and unpacked, BitBake locates
1040 patch files and applies them to the source files:
1041 <imagedata fileref="figures/patching.png" align="center" width="6in" depth="5in" />
1042 </para>
1043
1044 <para>
1045 The <filename>do_patch</filename> task processes recipes by
1046 using the
1047 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>
1048 variable to locate applicable patch files, which by default
1049 are <filename>*.patch</filename> or
1050 <filename>*.diff</filename> files, or any file if
1051 "apply=yes" is specified for the file in
1052 <filename>SRC_URI</filename>.
1053 </para>
1054
1055 <para>
1056 BitBake finds and applies multiple patches for a single recipe
1057 in the order in which it finds the patches.
1058 Patches are applied to the recipe's source files located in the
1059 <link linkend='var-S'><filename>S</filename></link> directory.
1060 </para>
1061
1062 <para>
1063 For more information on how the source directories are
1064 created, see the
1065 "<link linkend='source-fetching-dev-environment'>Source Fetching</link>"
1066 section.
1067 </para>
1068 </section>
1034 </section> 1069 </section>
1035</section> 1070</section>
1036 1071