Fixes [YOCTO #2808]
Applied minor wording changes as directed by Paul Eggleton's
review of the sections and related variable descriptions.
(From yocto-docs rev: cf30c3dd78d5e55356bb73f43f10e0093a9aa084)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Fixes [YOCTO #2808]
Applied review comments to the "Images" and SDK sections that
are part of the "A Closer Look at the Yocto Project Development
Environment" section. Comments from Paul. They resulted
in a single figure being removed and split into two new
figures - one for the image part and one for the sdk part.
Some terminology issues were cleaned up in the main sections
as well as the documented variables sections.
Makefile changes involved adding the two new figures and
removing the old combined one.
(From yocto-docs rev: a32908fa68b9786e295097c16f70a5a9c3cc4c1e)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Added entries for DEPLOY_DIR, TOOLCHAIN_HOSTS_TASKS, and
TOOLCHAIN_TARGET_TASKS.
(From yocto-docs rev: b239c41871f8c833cd33f4c5c875d51fa1bdf9eb)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
I updated some of the explanation to be more specific about
the default paths the build system uses and just exactly how
a user should use FILESEXTRAPATHS.
(From yocto-docs rev: 5eba1437fb07300d0b42011eb82200215201c8ac)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
1. Added a new glossary entry for the THISDIR variable.
2. Inserted a link in the note of the FILESEXTRAPATHS variable
to the new THISDIR glossary entry.
(From yocto-docs rev: a4e704ff165959fab9c1e6f7d28906e8f15c6d27)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Added a bit more clarification (different wording) on why to
use the immediate expansion operator and on why to include
the trailing separating colon character.
(From yocto-docs rev: d5789c98fe570f48de8546d1fc218b4d5c577d0e)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Some discussion about this variable indicated that the importance
of the immediate expansion operator was not being called out
enough. I added further information to the existing note that
states to be sure to use ":=" when using the variable.
(From yocto-docs rev: b97d3fa714a7c71356cd00548d3d01280034afc2)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Applied some review comments from Paul. Took the warning formatting
out because it sucks.
(From yocto-docs rev: 6c4162777cb686c8b24b15ded2594f4f4a6acba6)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Added some more clarity about how this variable works and the
implications for using the default setting from the base.bbclass
file. Namely, if you are going to have the build system look
for files in your layer and your layer uses an append file,
then you need to also use the FILESEXTRAPATHS variable to
extend FILESPATHS.
(From yocto-docs rev: 2826fa6f9286efb1d5ca6cf85f65266a35bb8cfc)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
I found it confusing due to not specifically accounting for
.bb and .bbappend files. I added some wording to clearly
specify use given the two types of "recipes". Specifically,
if you are going to use a SRC_URI statment from an append
file, the user really should be aware that they will need
to extend the FILESPATH variable by also using FILESEXTRAPATHS
from within that append file.
(From yocto-docs rev: 8fd0047bd5c4598532afc6f0803f6ae23fa213b2)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Paul gave this a review and we found some issues.
Slight changes.
(From yocto-docs rev: 1e64fe277a6daaf484e56c3e9117fd72bb107614)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Paul Eggleton provided quite a series of patches that I previously
applied. These changes represent the edits from an interactive
review he conducted with me. The series of changes represents
his review for the entire set of changes in the original patch
series.
(From yocto-docs rev: e26f615a01de2b101e97eb6fd7175b813f74295e)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Performed some spelling checks against the files associated
with a large number of patches sent by Paul Eggleton.
(From yocto-docs rev: 8b16924aa1da161271cbfce5410344d94c840fa6)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Took out the clause in the parantheses set and replaced
with better structure.
* Ensure we mention what kind of files go into T
* We're talking about recipes here, not packages
(From yocto-docs rev: 8783bb7beb10e0fdfca22648f1dff4a85b760cd7)
Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This variable must be set to 1 in order to inhibit stripping, so specify
this.
(From yocto-docs rev: 35c4a025b68857495f252b35bb50288e308dc5c3)
Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
The existing definition was sparse and not quite correct.
I did some rewriting for active voice and present tense.
(From yocto-docs rev: da1eb14573e2050dc03046311d9f2621f5dcc825)
Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This also necessitated adding HOST_SYS so we can point to it being
matched against by COMPATIBLE_HOST; similarly MACHINEOVERRIDES and
SOC_FAMILY needed to be added for COMPATIBLE_MACHINE (and while we're
at it, let's add DISTROOVERRIDES; however I've drawn the line at
OVERRIDES since that ought to be covered by the BitBake manual).
Quite a bit of rewriting here to clear up some ambiguity created
through article use not specifically associated with subject matter.
Also, some recasting to active voice and present tense.
(From yocto-docs rev: 4090073899e3dfd0e0e6a17aea8210546f08a942)
Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Added quotes around the section head for the cross
reference. Made some sentences present tense rather
than future tense. Shortened a sentence.
(From yocto-docs rev: 77f8a2778e5880928cc79e56636a12a39f25492a)
Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Just a couple of examples that didn't use quotes around the value, which
is mandatory, so correct these.
(From yocto-docs rev: 2903ce2b232536c566bd8c29a8772823b44c19df)
Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Fixes YOCTO #3662.
Per comments from Paul Eggleton, I updated the description to
include best practices of prepending and from using within
append files.
(From yocto-docs rev: 368055bc046277fe601ff3a64913044be0a15e6d)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
1. Applied changes from Paul to the read-only-rootfs section.
2. Applied changes form Paul to the customizing images by using
IMAGE_FEATURES and EXTRA_IMAGE_FEATURES variables. This
was a simple rewrite of a sentence.
3. Updated the note in both the IMAGE_FEATURES and
EXTRA_IMAGE_FEATURES glossary entries to specify inside
of an image recipe (more specific).
(From yocto-docs rev: 762b9e4d3b45a9602284cf4dd1ac281dcbbed7f5)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Comments from Paul Eggleton applied. Basically, reinforcing
enabling features from inside and outside of the image. Changed
the wording of the respective notes.
(From yocto-docs rev: 23897c6ebc56dde63803293c0992b2d5c6ff7345)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* BBFILES should be appended to with +=
* BBPATH should be appended to with .=
* Immediate expansion is not necessary for BBFILE_PRIORITY
* Immediate expansion is not necessary for references in layer.conf
to LAYERDIR since these are automatically expanded at the end of
parsing the file (and have been for some time).
* Add collection name override to BBFILE_PRIORITY example
* Fix comments referring to old structure ("packages directory" or
"recipes directory")
(From yocto-docs rev: 0aaac8f5ad97c802ebe1d4f3ffb7987050533292)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Inserted parallel wording so the description is more similiar
to IMAGE_FEATURES description.
(From yocto-docs rev: 535a9676ac9d2a5778fb6978027f018e83460157)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
