summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-08-21 12:10:09 (GMT)
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-08-26 10:06:30 (GMT)
commitbf91da6c0a7fcd081a4cd70a70f0a545382dc7da (patch)
treea6890094d65150b5cc0e25825367713c7b38de91
parent88705462726892a19dbb3d15a900e6cb04490a3b (diff)
downloadpoky-bf91da6c0a7fcd081a4cd70a70f0a545382dc7da.tar.gz
ref-manual, mega-manual: new section on config/compile for expanded build
Fixes [YOCTO #2808] Added a new section on configuration and compilation for the expanded discussion for the build process. This involved a new figure that had to be added to both the ref-manual and mega-manual figures directories. (From yocto-docs rev: 9ba90c79990b79226d6e95e4a01ddedeccb94b35) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/mega-manual/figures/configuration-compile-autoreconf.pngbin0 -> 48116 bytes
-rw-r--r--documentation/ref-manual/figures/configuration-compile-autoreconf.pngbin0 -> 48116 bytes
-rw-r--r--documentation/ref-manual/technical-details.xml59
3 files changed, 59 insertions, 0 deletions
diff --git a/documentation/mega-manual/figures/configuration-compile-autoreconf.png b/documentation/mega-manual/figures/configuration-compile-autoreconf.png
new file mode 100644
index 0000000..596a894
--- /dev/null
+++ b/documentation/mega-manual/figures/configuration-compile-autoreconf.png
Binary files differ
diff --git a/documentation/ref-manual/figures/configuration-compile-autoreconf.png b/documentation/ref-manual/figures/configuration-compile-autoreconf.png
new file mode 100644
index 0000000..596a894
--- /dev/null
+++ b/documentation/ref-manual/figures/configuration-compile-autoreconf.png
Binary files differ
diff --git a/documentation/ref-manual/technical-details.xml b/documentation/ref-manual/technical-details.xml
index 5ee2615..2607661 100644
--- a/documentation/ref-manual/technical-details.xml
+++ b/documentation/ref-manual/technical-details.xml
@@ -1066,6 +1066,65 @@
1066 section. 1066 section.
1067 </para> 1067 </para>
1068 </section> 1068 </section>
1069
1070 <section id='configuration-and-compilation-dev-environment'>
1071 <title>Configuration and Compilation</title>
1072
1073 <para>
1074 After source code is patched, BitBake executes tasks that
1075 configure and compile the source code:
1076 <imagedata fileref="figures/configuration-compile-autoreconf.png" align="center" width="7in" depth="5in" />
1077 </para>
1078
1079 <para>
1080 This step in the build process consists of three tasks:
1081 <itemizedlist>
1082 <listitem><para><emphasis><filename>do_configure</filename>:</emphasis>
1083 This task configures the source by enabling and
1084 disabling any build-time and configuration options for
1085 the software being built.
1086 Configurations can come from the recipe itself as well
1087 as from an inherited class.
1088 Additionally, the software itself might configure itself
1089 depending on the target for which it is being built.
1090 </para>
1091
1092 <para>The configurations handled by the
1093 <filename>do_configure</filename> task are specific
1094 to source code configuration for the source code
1095 being built by the recipe.</para>
1096
1097 <para>If you are using
1098 <link linkend='ref-classes-autotools'><filename>autotools.bbclass</filename></link>,
1099 you can add additional configuration options by using
1100 the <link linkend='var-EXTRA_OECONF'><filename>EXTRA_OECONF</filename></link>
1101 variable.
1102 For information on how this variable works within
1103 that class, see the
1104 <filename>meta/classes/autotools.bbclass</filename>.
1105 </para></listitem>
1106 <listitem><para><emphasis><filename>do_compile</filename>:</emphasis>
1107 Once a configuration task has been satisfied, BitBake
1108 compiles the source using the
1109 <filename>do_compile</filename> task.
1110 Compilation occurs in the directory pointed to by the
1111 <link linkend='var-B'><filename>B</filename></link>
1112 variable.
1113 Realize that the <filename>B</filename> directory, by
1114 default, is the same as the
1115 <link linkend='var-S'><filename>S</filename></link>
1116 directory.</para></listitem>
1117 <listitem><para><emphasis><filename>do_install</filename>:</emphasis>
1118 Once compilation is done, BitBake executes the
1119 <filename>do_install</filename> task.
1120 This task copies files from the <filename>B</filename>
1121 directory and places them in a holding area pointed to
1122 by the
1123 <link linkend='var-D'><filename>D</filename></link>
1124 variable.</para></listitem>
1125 </itemizedlist>
1126 </para>
1127 </section>
1069 </section> 1128 </section>
1070</section> 1129</section>
1071 1130