1
0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 12:29:55 +00:00

dev-manual: Applied more review comments to the section.

Closing in on the devtool add and devtool modify sections.

(From yocto-docs rev: 202b688c03cc1801576bbed3b771bb329f6b8520)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2016-02-16 17:29:22 -08:00
committed by Richard Purdie
parent fe70eb29b3
commit f33ffaa3d4
+21 -17
View File
@@ -2051,10 +2051,9 @@
</para> </para>
<para>The following command identifies the recipe <para>The following command identifies the recipe
and instructs <filename>devtool</filename> to and by default extracts the source files:
extract the source files using the "-x" option:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ devtool modify -x <replaceable>recipe</replaceable> $ devtool modify <replaceable>recipe</replaceable>
</literallayout> </literallayout>
Once <filename>devtool</filename>locates the recipe, Once <filename>devtool</filename>locates the recipe,
it uses the it uses the
@@ -2069,10 +2068,11 @@
</note> </note>
With this scenario, however, since no With this scenario, however, since no
<replaceable>srctree</replaceable> argument exists, the <replaceable>srctree</replaceable> argument exists, the
<filename>devtool modify</filename> command extracts the <filename>devtool modify</filename> command by default
source files to a Git structure using the default extracts the source files to a Git structure.
location within the workspace. Furthermore, the location for the extracted source is the
The result is that the command set up both the source default area within the workspace.
The result is that the command sets up both the source
code and an append file within the workspace with the code and an append file within the workspace with the
recipe remaining in its original location. recipe remaining in its original location.
</para></listitem> </para></listitem>
@@ -2087,18 +2087,20 @@
<para>The following command tells <para>The following command tells
<filename>devtool</filename> what recipe with <filename>devtool</filename> what recipe with
which to work and also uses the "-x" option to which to work and, in this case, identifies a local
instruct <filename>devtool</filename> to locate and area for the extracted source files that is outside
extract the source code: of the default workspace:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ devtool modify -x <replaceable>recipe srctree</replaceable> $ devtool modify <replaceable>recipe srctree</replaceable>
</literallayout> </literallayout>
As with all extractions, the command uses As with all extractions, the command uses
the recipe's <filename>SRC_URI</filename> to locate the the recipe's <filename>SRC_URI</filename> to locate the
source files. source files.
Once the files are located, the command extracts Once the files are located, the command by default
them to the location specified by extracts them.
<replaceable>srctree</replaceable>.</para> Providing the <replaceable>srctree</replaceable>
argument instructs <filename>devtool</filename> where
place the extracted source.</para>
<para>Within workspace, <filename>devtool</filename> <para>Within workspace, <filename>devtool</filename>
creates an append file for the recipe. creates an append file for the recipe.
@@ -2108,7 +2110,8 @@
</para></listitem> </para></listitem>
<listitem><para><emphasis>Right</emphasis>: <listitem><para><emphasis>Right</emphasis>:
The right scenario represents a situation The right scenario represents a situation
where the source tree (srctree) exists as a where the source tree
(<replaceable>srctree</replaceable>) exists as a
previously extracted Git structure outside of previously extracted Git structure outside of
the <filename>devtool</filename> workspace. the <filename>devtool</filename> workspace.
In this example, the recipe also exists In this example, the recipe also exists
@@ -2117,11 +2120,12 @@
<para>The following command tells <para>The following command tells
<filename>devtool</filename> the recipe <filename>devtool</filename> the recipe
with which to work and uses with which to work, uses the "-n" option to indicate
source does not need to be extracted, and uses
<replaceable>srctree</replaceable> to point to the <replaceable>srctree</replaceable> to point to the
previously extracted source files: previously extracted source files:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ devtool modify <replaceable>recipe srctree</replaceable> $ devtool modify -n <replaceable>recipe srctree</replaceable>
</literallayout> </literallayout>
</para> </para>