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>
Re-wrote some stuff to be clearer.
(From yocto-docs rev: 7c8f529d099d1a234be5e5652acdbb63c9d44d42)
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>
STAMPS_DIR was split out of STAMP recently.
Added some specifics about who is doing what.
(From yocto-docs rev: dafb13f4b3c4cf40292d43ea53fe9150d4dfc0ee)
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 some specifics and a bit of a rewrite.
(From yocto-docs rev: 03435b52f9f27729d81d46ec6d87cf73b4bd92cb)
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>
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>
Removed some ambiguous text.
(From yocto-docs rev: cdf5cf7505af9c2c61e7b7d8a7db61ec0baad254)
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>
Broke the long first sentence up.
(From yocto-docs rev: bfccfc6401c3e1dd88e7a965f1df1a68801844fa)
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>
Tightened up the writing for both entries.
(From yocto-docs rev: b6a0679fb74aef4a718e42d20343f5b7ae8e9679)
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 some more specifics for who is doing what.
(From yocto-docs rev: 3156a8f3af24cfd21478f2cf29ca9fdac699c0dd)
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>
Rewrote the description to break it up a bit and flow better.
(From yocto-docs rev: 7f0e8cf693b3b0a77537a15f7962f9e0e05fddfa)
Signed-off-by: Paul Eggleton <paul.eggleton@linux.com>
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Recast the sentence to read better.
(From yocto-docs rev: 522f7b2bb8a8f25e5ce1f4397a581c289beae51f)
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 a consisten introductory sentence before jumping into
how to use the variable.
(From yocto-docs rev: 3e68a345d233ca2fd60e02290547578001b2fa0c)
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>
Tightened up the text.
(From yocto-docs rev: 9b697681e0c2c3658c6552ec0c9951fc987c9b10)
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 some key words to tighten things up.
(From yocto-docs rev: 8da0f8bd5c54c16e62c0f226d7473e32f3fb5928)
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>
A bit of rewriting to tighten things up.
(From yocto-docs rev: a2b30eb3fc6b6ef276f5b95aff0ddb7e2e26c8c3)
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>
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 cross-referenced section title.
Cleaned up some passive voice and future tense.
(From yocto-docs rev: 4ee5834f8262ced5417a63fa76baa6594138e087)
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>
Re-wrote to be active and in present tense.
(From yocto-docs rev: 7fabb25ab15da501ac3aae64a56d41c9cad6bbe7)
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>
Changes to show the best way to use this variable in relation
to the EXTRA_IMAGE_FEATURES variable.
(From yocto-docs rev: 3afa91f8fdecae18320364d9332639e725ecef5a)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Added information suggesting best use is from the
local.conf file.
(From yocto-docs rev: acfe2a58cab3ffbddaa1631e7df37d36f4f1422a)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
A couple sets of review comments from Paul applied here.
1. Added the "read-only-rootfs" item to the EXTRA_IMAGE_FEATURES
variable description and a link to the appropriate section
in the dev-manual.
2. Pulled the how-to-create a package repository section out
of the section on how to customize an image with the
IMAGE_FEATURES and EXTRA_IMAGE_FEATURES section and made
it a stand-alone section in the "Tasks" chapter of the
dev-manual.
3. Integrated the SSH server example into the main topic
because we don't want an isolated sub-section within a
main topic.
4. In the image features section of the ref-manual, I fixed
the link with the "read-only-rootfs" feature to go to
the now-isolated section on how to do that instead of
going to the customizing an image using the IMAGE_FEATURES
and EXTRA_IMAGE_FEATURES variables section.
(From yocto-docs rev: 9c79b5f40d8dc6b37fbe636a2459f89b70bd8ea8)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Scott Rifenbark
Paul Eggleton