ref-manual: Edits to the "Maintaining Build Output Quality" section.
Removed the bit about isolating SDK information. Also removed the workaround and text regarding the limitation that caused adding and removing INHERIT += "buildhistory" to re-execute tasks. Added a few links to some newly documented variables. (From yocto-docs rev: 7d13bea6d9f0c2bdc9aa58c2933998d6d10ac810) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
89de0baf9c
commit
9953555002
|
@ -475,7 +475,10 @@
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
Build history is disabled by default.
|
Build history is disabled by default.
|
||||||
To enable it, add the following statements to the end of your
|
To enable it, add the following <filename>INHERIT</filename>
|
||||||
|
statement and set the
|
||||||
|
<link linkend='var-BUILDHISTORY_COMMIT'><filename>BUILDHISTORY_COMMIT</filename></link>
|
||||||
|
variable to "1" at the end of your
|
||||||
<filename>conf/local.conf</filename> file found in the
|
<filename>conf/local.conf</filename> file found in the
|
||||||
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>:
|
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>:
|
||||||
<literallayout class='monospaced'>
|
<literallayout class='monospaced'>
|
||||||
|
@ -496,25 +499,6 @@
|
||||||
<para>
|
<para>
|
||||||
You can disable build history by removing the previous statements
|
You can disable build history by removing the previous statements
|
||||||
from your <filename>conf/local.conf</filename> file.
|
from your <filename>conf/local.conf</filename> file.
|
||||||
However, you should realize that enabling and disabling
|
|
||||||
build history in this manner can change the
|
|
||||||
<filename>do_package</filename> task checksums which, if you
|
|
||||||
are using the OEBasicHash signature generator (the default
|
|
||||||
for many current distro configurations including
|
|
||||||
<filename>DISTRO = "poky"</filename> and
|
|
||||||
<filename>DISTRO = ""</filename>) will result in the packaging
|
|
||||||
tasks being re-run during the subsequent build.
|
|
||||||
</para>
|
|
||||||
|
|
||||||
<para>
|
|
||||||
To disable the build history functionality without causing the
|
|
||||||
packaging tasks to be re-run, set the
|
|
||||||
<link linkend='var-BUILDHISTORY_FEATURES'><filename>BUILDHISTORY_FEATURES</filename></link>
|
|
||||||
variable as follows in your <filename>conf/local.conf</filename>
|
|
||||||
file:
|
|
||||||
<literallayout class='monospaced'>
|
|
||||||
BUILDHISTORY_FEATURES = ""
|
|
||||||
</literallayout>
|
|
||||||
</para>
|
</para>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
@ -660,7 +644,7 @@
|
||||||
A directory containing selected files from the root
|
A directory containing selected files from the root
|
||||||
filesystem.
|
filesystem.
|
||||||
The files are defined by
|
The files are defined by
|
||||||
<filename>BUILDHISTORY_IMAGE_FILES</filename>.
|
<link linkend='var-BUILDHISTORY_IMAGE_FILES'><filename>BUILDHISTORY_IMAGE_FILES</filename></link>.
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
<listitem><para><filename>build-id:</filename>
|
<listitem><para><filename>build-id:</filename>
|
||||||
Human-readable information about the build configuration
|
Human-readable information about the build configuration
|
||||||
|
@ -747,20 +731,9 @@
|
||||||
<title>Build History SDK Information</title>
|
<title>Build History SDK Information</title>
|
||||||
<para>
|
<para>
|
||||||
Build history collects similar information on the contents
|
Build history collects similar information on the contents
|
||||||
of SDKs (e.g., <filename>meta-toolchain</filename>
|
of SDKs (e.g. <filename>meta-toolchain</filename>
|
||||||
or <filename>bitbake -c populate_sdk imagename</filename>)
|
or <filename>bitbake -c populate_sdk imagename</filename>)
|
||||||
as compared to information it collects for images.
|
as compared to information it collects for images.
|
||||||
If you want information on the SDK, you need to list that
|
|
||||||
feature using the
|
|
||||||
<link linkend='var-BUILDHISTORY_FEATURES'><filename>BUILDHISTORY_FEATURES</filename></link>
|
|
||||||
variable as follows in your <filename>conf/local.conf</filename>
|
|
||||||
file found in the
|
|
||||||
<ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>:
|
|
||||||
<literallayout class='monospaced'>
|
|
||||||
INHERIT += "buildhistory"
|
|
||||||
BUILDHISTORY_COMMIT = "0"
|
|
||||||
BUILDHISTORY_FEATURES = "sdk"
|
|
||||||
</literallayout>:
|
|
||||||
The following list shows the files produced for each SDK:
|
The following list shows the files produced for each SDK:
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para><filename>files-in-sdk.txt:</filename>
|
<listitem><para><filename>files-in-sdk.txt:</filename>
|
||||||
|
@ -830,7 +803,8 @@
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
To see any changes that have occurred (assuming you have
|
To see any changes that have occurred (assuming you have
|
||||||
<filename>BUILDHISTORY_COMMIT = "1"</filename>), you can simply
|
<link linkend='var-BUILDHISTORY_COMMIT'><filename>BUILDHISTORY_COMMIT = "1"</filename></link>),
|
||||||
|
you can simply
|
||||||
use any Git command that allows you to view the history of
|
use any Git command that allows you to view the history of
|
||||||
a repository.
|
a repository.
|
||||||
Here is one method:
|
Here is one method:
|
||||||
|
|
Loading…
Reference in New Issue