diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-01-09 08:26:25 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-01-21 21:57:58 +0000 |
commit | 814e07159fcc6b30bc66e699a0b153c6eb40e244 (patch) | |
tree | aff6a4eb16881e23112d91a862613af90dd37be3 /documentation/dev-manual | |
parent | 78564304dc23b4312ee4f7a836a26ecdde88e11e (diff) | |
download | ast2050-yocto-poky-814e07159fcc6b30bc66e699a0b153c6eb40e244.zip ast2050-yocto-poky-814e07159fcc6b30bc66e699a0b153c6eb40e244.tar.gz |
dev-manual: Edits to "Configuring the Recipe" section.
Applied review edits from Paul Eggleton for this section that is
part of the "Writing a New Recipe" section. Minor wording issues
only.
(From yocto-docs rev: 8e291826fcb9547c3fc16aa81ccf6867fe2e417d)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 32 |
1 files changed, 18 insertions, 14 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 3ee327c..22209af 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -1749,12 +1749,10 @@ Typically, setting these options is accomplished by running a configure script with some options, or by modifying a build configuration file. - </para> - - <para> - When considering configuration, you should realize that - required build-time or runtime dependencies might or might not - be noted in the software's documentation. + <note> + It is possible that required build-time or runtime dependencies + exist in the software's documentation. + </note> </para> <para> @@ -1798,8 +1796,9 @@ <filename>CMakeLists.txt</filename> file, then your software is built using some method other than Autotools or CMake. - If this is the case, you need to provide a - <filename>do_configure</filename> task in your recipe. + If this is the case, you normally need to provide a + <filename>do_configure</filename> task in your recipe + unless, of course, there is nothing to configure. </para> <para>Even if your software is not being built by Autotools or CMake, you still might not need to deal @@ -1807,11 +1806,10 @@ You need to determine if configuration is even a required step. You might need to modify a Makefile or some configuration file used for the build to specify necessary build options. - Or, perhaps you might need to run a hand-written configuration - script as opposed to something that - <filename>autoconf</filename> would run.</para> - <para>For the case involving a hand-written - configuration script, you would run + Or, perhaps you might need to run a provided, custom + configure script with the appropriate options.</para> + <para>For the case involving a custom configure + script, you would run <filename>./configure --help</filename> and look for the options you need to set.</para></listitem> </itemizedlist> @@ -1820,7 +1818,8 @@ <para> Once configuration succeeds, it is always good practice to look at the <filename>log.do_configure</filename> file to - ensure that nothing needs to be added to + ensure that the appropriate options have been enabled and no + additional build-time dependencies need to be added to <filename>DEPENDS</filename>. For example, if the configure script reports that it found something not mentioned in <filename>DEPENDS</filename>, or @@ -1832,6 +1831,11 @@ that are in <filename>DEPENDS</filename>, in which case you would need to look at passing extra options to the configure script as needed. + For reference information on configure options specific to the + software you are building, you can consult the output of the + <filename>./configure --help</filename> command within + <filename>${S}</filename> or consult the upstream + documentation. </para> </section> |