Commit Graph

1266 Commits

Author SHA1 Message Date
Scott Rifenbark c504276d26 dev-manual, ref-manual: Replaced ‐‐ with "--"
Fixes [YOCTO #7386]

Apparently, copying HTML displayed commands that have a
double dash created through "‐‐" in the docbook source
causes some issues in the shell.  I have scrubbed the manual set
to replace any "‐‐" strings with "--".

Reported-by: Paul Eggleton <paul.eggleton@intel.com>
(From yocto-docs rev: e88b813b71d7d6d8acd8a8638f2db71265145b64)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:43 +00:00
Scott Rifenbark 42f5b116da dev-manual: Updates to the "Working Within Eclipse" section.
First edits to update this section to support the Luna version of
Eclipse.  I weeded out Juno, which leaves Luna as the preferred
version and Kepler as a second version if they don't want to update
to Luna.

(From yocto-docs rev: 4f2dc237aa3498402cdf637ac2e85fdf0c3bf8a0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:38 +00:00
Scott Rifenbark 0a2091376e dev-manual: Updates to Eclipse section
Modified the area from which the Eclipse Git repository is located.
This has changed.

(From yocto-docs rev: ec2bf4125877b28dae0681c8b578c7bebec5a5b6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:35 +00:00
Scott Rifenbark f94b6298d8 dev-manual: Adjusted text for deprecated 3.10 and 3.17 kernels.
These kernels are unsupported for the 1.8 release.  They will still
show up in the YP source repos but the recipes are removed from the
poky area.  Updated all references appropriately.

(From yocto-docs rev: a9adc071409fd31dabc3affec12350c300312600)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-24 23:36:13 +00:00
Scott Rifenbark 46614dab87 dev-manual: Edit to wording in "Avoid Duplicating Include Files"
Changed wording to be more accurate.

(From yocto-docs rev: 1acb7ce94a4f4b02cc50d1e098f04a77d9a53ab3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:00 +00:00
Scott Rifenbark f3410bfc75 dev-manual: Updates to "Avoiding Duplicating Include Files" section.
I removed the last paragraph example as it is not a good example.
Unfortunately, there is not a good example so I replaced it with
a minor suggestive work-around at the end of the first paragraph.

Also, used some <replaceable></replaceable> formatting for the
first paragraph.

(From yocto-docs rev: 6c3989fd4fe41a6434d70208d59747060e62a366)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:59 +00:00
Claudius Heine b83bed6a3a dev-manual: Fixed reference to TEST_SERIALCONTROL link
Fixes [YOCTO #7256]

In the "Serial Console Connection" section there was a link to
TEST_POWERCONTROL_CMD when it should have been to the
TEST_SERIALCONTROL_CMD variable.

(From yocto-docs rev: 9ec64c86bd4171a017898daa332d2a98fea0358a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:56 +00:00
Claudius Heine 3c7ad6e41f dev-manual: Fixed tc attribute description
The description for "tc" was described as "the called text context..."
rather than "the called test context...".  Updated the description.

Fixes [YOCTO #7269]

(From yocto-docs rev: 0da4437c26225ce0302f10f7ba3c012f1f990c74)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:56 +00:00
Scott Rifenbark 5d19f2bf27 dev-manual: First draft of recipetool section.
(From yocto-docs rev: 3220f98c756291d95da0d9d7cff4aa09e8670ff2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:56 +00:00
Scott Rifenbark b2a68067f5 dev-manual: Edits to Quilt and finding temporary source code sections
These edits help place the two sections within the new organization
that basically splits out the devtool and quilt methods as ways
of modifying your source code.

(From yocto-docs rev: 1dc2e8783d9774bb98a30e06d114f1c9bfb85b71)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:56 +00:00
Scott Rifenbark be7e182140 documentation: Reverted back to the 1.76.1 XSL stylesheet
Using the 1.76.1 version in all the customization layers so
the manual revision tables will build with boxes.

(From yocto-docs rev: 85a31ef53a59d17bed23ebf57a14db507eb21338)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:56 +00:00
Scott Rifenbark 4a1ea28ce9 documentation: First draft devtools.
Completed draft of the new devtool material.  This commit affects
some linking and figures across the YP doc set.

* Added the build-workspace-directory.png file to both the
  dev-manual and the mega-manual.

* Updated the Makefile to include the new figure in the TARFILE
  for dev-manual and mega-manual.

* Re-did the section organization to pull the quilt and finding
  source file out of the "Modifying Source Files" section.

(From yocto-docs rev: 4585b9fbb1636ae3c65e2e3ad2d1d6baca636e59)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:55 +00:00
Scott Rifenbark db030b19a2 dev-manual: Updated the OpenEmbedded build system term.
Added text to note how this term is used, what makes up the
OE BS, and how the term "build system" is used in general.

(From yocto-docs rev: 2af0a59a84fd1cf6d23db29f470cb5644f962746)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:54 +00:00
Scott Rifenbark 7ca1a51cd3 dev-manual: Added OpenEmbedded build system term, dumped build system
The list of terms had a "build system" term that basically
described the OpenEmbedded build system.  I dumped this entry
in favor of "OpenEmbedded build system."  I updated the term's
description to cover the generic term "build system" for no
confusion.

(From yocto-docs rev: 0ada8348a2ace6ce99e640d1c1f21812188151d5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:54 +00:00
Scott Rifenbark ee80485443 dev-manual: Removed #!/bin/sh -e from the base script form
This start to the script is not really necessary and is in fact
the rare case.  I have removed two occurrences of it in the
"Post-Installation Scripts" section where it was used in code
as the best form to create a script.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: f7c1a1e135e8a9d76005bb6ae7b9cc2810f0af90)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:53 +00:00
Scott Rifenbark f50e412d84 dev-manual: Updated the QEMUARCH option in the runqemu command.
Found a typo in this list.  The "qemux86-64" should be "qemux86_64".

(From yocto-docs rev: 32f62f51c1574f3a479c12b67aeba7ebcb743a02)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:53 +00:00
Scott Rifenbark 44ddc355ef ref-manual, dev-manual: Removed information about package name alias.
The section on "Handling a Package Name Alias" was confusing and
wrong.  We decided to eliminate it.  The section was removed from
the dev-manual.  The corresponding variable DISTRO_PN_ALIAS
remains for now but without the cross-reference link to the
now missing section.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 9938cdcc8488baffa4252288bf45243055e76fed)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:53 +00:00
Scott Rifenbark db874ed595 ref-manual, dev-manual, adt-manual, yocto-project-qs: scrub eglibc
Scrubbed out the occurrences of eglibc and replaced them with
glibc.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 868ceda79b1c738349e512e523c850b24f9232ca)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:53 +00:00
Scott Rifenbark 4ab132a20d dev-manual, ref-manual, yocto-project-qs: Updates to parallelism variables
The way the old manual set had worded the use of the
BB_NUMBER_THREADS, PARALLEL_MAKE, and BB_NUMBER_PARSE_THREADS
had become depricated.  It suggested a lot of user intervention
to get these variables set to have the build system utilize
optimal parallelism.  The change a while back to the build system
where the variables are set to the number of build host cores
now makes the variables automatically be set to their best
values.  I have gone through the manual set and changed wordings
appropriately to reflect this.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 3a27b1792c92a2f22173315e2732f672cdad2c78)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:51 +00:00
Scott Rifenbark d1bd81ed0e dev-manual: Updated examples in "Splitting an Application into Multiple Packages"
The example was out of date.  Updated accordingly.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: b95535fca149abbbe4fee7e74ebc13d2bb376c27)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:51 +00:00
Scott Rifenbark 281c4728d6 dev-manual: Edits to add more detail to where patch files are
Updated some text to indicate that you should put patch files
in $BP, $BPN, or "files."  Also, added more on how the patch
files suffix is (i.e. accounting for compressed suffix names
like diff.bz).

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: d9e23da24e9d86ec5e2b9d4067667478f3e56ba1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:51 +00:00
Scott Rifenbark 6a6687d6d5 dev-manual: Updated text to indicate patch files can end differently
Patch files can end with compressed suffixes such as
diff.gz and patch.bz2.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 69993710d1466dddc804c33c1d76f46d0982d28f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:51 +00:00
Scott Rifenbark 3cd8d861ab dev-manual: Removed unwanted characters from text.
Reported-by: Pascal Bach <pascal.bach@siemens.com>
(From yocto-docs rev: 3ffbebd6c638e9f5b334dfef1d4e0bcc698ae810)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:51 +00:00
Scott Rifenbark f8245d98ea dev-manual: Updated section on how checksums are dealt with
In the "Fetching Code" section, some loose description of how the
build system reacts to the two checksums in a recipe existed.
Robert asked some questions about how the behavior would be if
just a single, correct checksum existed and if the two existed but
only one proved correct.  Turns out, if you supply a single one then
the build will not throw an error or warning.  If you supply two
but one is incorrect, then the build will throw an error or
warning.  I updated the text to be technically correct without
going into huge details.

(From yocto-docs rev: f49a744821d9326314803d5003158bd402e74e0d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:50 +00:00
Robert P. J. Day 4492b37a06 dev-manual: Replaced lttng-control and lttng-viewer with lttng-tools.
Replace references to these deleted items.

Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:50 +00:00
Scott Rifenbark bc4858fe99 dev-manual, ref-manual: Edits to dev manager section and USE_DEVFS var.
Some minor edits to the original patch.  These edits were caught by
Robert P. J. Day.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: b50a2e44eccd50166351611f17c643cbbc60f8b8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:50 +00:00
Pascal Bach da47cb736b dev-manual: New section on choosing a device manager added.
This patch was modified to fit in with the style of the book.

(From yocto-docs rev: 7c6c7ac573f92bfc844977e0d7a97ca4aac9bc70)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:50 +00:00
Scott Rifenbark a23e76dbce dev-manual: repaired cross-line link for a <ulink></ulink> pair.
These can't split lines.

Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:49 +00:00
Scott Rifenbark f972db3a04 dev-manual: Updates to the "Locate a Base Recipe" section.
Bob Cochran pointed out that the skeleton recipe shown in the
example is not really what is created by newbb.vim.  I updated the
example to match.

(From yocto-docs rev: 2dfa712522aec5204b9e739b6060109090280011)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:49 +00:00
Scott Rifenbark c037dd7b4c dev-manual: Updates to the "Using .bbappend Files" section.
This section was a bit confusing on the use of "_prepend" as associated
with the FILESEXTRAPATHS statement.  Especially in the final note
where it indicated you don't need "_prepend" if your append file
is not adding any new files.  I updated the note to be more specific.

Another small change I made was to replace the Crown Bay BSP referenced
in the section with the Emenlow BSP, which has a longer life span than
CB.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 35bdc8031bc4ecf1ea321b0cafade97eeaa56513)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:49 +00:00
Scott Rifenbark 1e0797adfe documentation: Removed redundant ID tags that were throwing warnings
When you "make" the mega-manual, there were four tags across the
various manuals where the same string "id='intro'" occurred.  This
causes warnings during the make process.  I updated the strings to
be unique.  There are no cross-references to these so no collateral
issues were caused.

(From yocto-docs rev: d0e770e0ad797031a75e2373a41723408b4b051c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:49 +00:00
Scott Rifenbark 63750d8c11 dev-manual: Updates to using IMAGE_FEATURES and EXTRA_IMAGE_FEATURES
The section "Customizing Images Using Custom IMAGE_FEATURES
and EXTRA_IMAGE_FEATURES" needed a bit more clarification on
the image features.  The text pretty much passed off image
features as all mapping into package groups, which is not true.
Some, like "debug-tweaks for example, are more like general
configurations.  I updated the section accordingly.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 7dd55ff0bd6f7923e22695ed7323df5cfe17d1d4)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:48 +00:00
Scott Rifenbark 73588fa725 dev-manual: Updated sysroot location for Eclipse examples.
Fixes [YOCTO #7029]

I was missing the "sysroots" part of the path.  I added this
to the pathname.

(From yocto-docs rev: 077efc8063ed01ef4067f7e71912dd52c1f6a4a6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:48 +00:00
Scott Rifenbark d250d38974 documentation: Changed back to the "current" XSL style sheet.
I need to get back to how it was working and then fix the table
box issue from there.  Using the 1.76.1 stylesheets makes the
build too long for the manuals and sometimes the XSL sheets do
not load.

(From yocto-docs rev: 7bc502fa069fdc4aebf5705513bb82127716859f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:47 +00:00
Scott Rifenbark 66ad91bd54 dev-manual: Rewrite of the section on customizing images with packagegroups
This section was pointing to a poor example in meta.  I substituted
in a better example and rewrote the section to flow better around
that example and the final fabricated one.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: c7f07a2993d5c1b8e0c8b7da0e9d4c28242a5e26)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:47 +00:00
Robert P. J. Day c8691a2d44 dev-manual, mega-manual: Updated kernel-overview-2-generic.png file.
There was a sample string in this tree that ended in "ro" when it
should have been "r0" (as in release 0). Anytime you update a figure,
the modified file must go in both the "figures" directory of both
the manual (dev-manual in this case) and in the mega-manual.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 8e75cc23fbf03f355fade416a12b7c8fe1e656a5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:47 +00:00
Robert P. J. Day 0cec924324 dev-manual: Applied wording to warn reader that wikis have dated info.
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: ea4489f856417d70b54a7e38da32e068cbd54cbf)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:46 +00:00
Robert P. J. Day cd37517f97 dev-manual: Add ref to bitbake-layers "add-layer" and "remove-layer"
(From yocto-docs rev: aafc8f1da396a1838ce541706a8162a1493382b3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:46 +00:00
Pascal Bach b7020b0bb8 dev-manual: Added missing ending quotation to code snippet.
(From yocto-docs rev: 7bf228dbf54e227a06dc69d701b9c83f9c6a2f3a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:46 +00:00
Robert P. J. Day 2674ddb4b0 dev-manual: Some minor fixes to some text.
I applied (in spirit) the changes here... Some literal and some
with changes.

(From yocto-docs rev: 0ccf8a43264981accbe42f729c723804e5b69b72)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-01-06 14:27:03 +00:00
Robert P. J. Day cf17b6cb72 dev-manual: Minor hyphenation fix.
(From yocto-docs rev: 7a88f5f3a3f826ff4c2a6415c279d1fc4a8cc5f8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-01-06 14:27:03 +00:00
Scott Rifenbark 46f120c85c documentation: Updated all XSL style sheet imports to use 1.76.1 version
This fixes the issue where the lines for the manual revision table
are not appearing.  For some reason they do not appear when building
the docs using Ubuntu 14.10 and the "current" XSL transformation
files.  So, I backed up to the 1.76.1 version, which is the nearest
version where the issue does not surface.

(From yocto-docs rev: 82b15986b97b9ed082b652b562eaaf843572fdff)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-01-06 14:26:59 +00:00
Scott Rifenbark 3a17209e12 dev-manual: Added link to ptest wiki page into Ptest section.
(From yocto-docs rev: 2a9cd5948cd17ce9f7eb5381b27c25f97963578e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-12-09 15:09:06 +00:00
Scott Rifenbark 6a57cb10b7 dev-manual: Added more info to mulit-machine builds section.
Fixes [YOCTO #5400]

Per Martin Jansa, added some information in the bullet item that
talks about the tools and the cases that can cause issues when
tuning things by machine or architecture.

(From yocto-docs rev: e8e47828df65abdc18bbd681c47719a7df77b00f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-12-09 15:09:06 +00:00
Scott Rifenbark 117c9b4a64 dev-manual: Edits to the multi-machine builds section.
Fixes [YOCTO #5400]

I applied some review edits to this section as suggested by
Richard Purdie.

(From yocto-docs rev: a1898cf65537e732e0e42605bb28d636077e7f56)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-12-09 15:09:06 +00:00
Scott Rifenbark 5f4050f73d dev-manual: First draft of "multi-builds" section.
Fixes [YOCTO #5400]

This is the first draft of a new section on multi-machine builds.

(From yocto-docs rev: a47fd17295d943bff482a0747f3b2e69831aa985)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-12-09 15:09:05 +00:00
Scott Rifenbark 9104c1c29c dev-manual: Fixed broken link to the allarch class.
(From yocto-docs rev: 3ec771dffdaf7d42b98371516bbb33f915dfe572)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-11-08 11:15:12 +00:00
Scott Rifenbark 1484e62e5f documentation: Updated the manual revision history tables.
Added an entry for the 1.8 release stating that the release
is slated for sometime in 2015.

(From yocto-docs rev: 9799a7848f24024048eae0cbed470a2be4b4b879)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-11-04 10:28:30 +00:00
Scott Rifenbark a0aeeff2c6 dev-manual: Updates to "Performing Automated Runtime Testing"
Updated the section to account for some new variables and
several more ways to run tests against expanded targets.  Also
added power control section.

(From yocto-docs rev: a0f08466c00ae51a99d790fa6c9dccef2e0f1518)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-10-28 22:31:18 +00:00
Scott Rifenbark e9ecf3fc24 dev-manual, ref-manual: Updated 1.7 migration section with review comments
Applied the second round of review edits from Paul Eggleton.
Minor fixes.

(From yocto-docs rev: 2c7c45c8f09b724e92e8b59fe47834226b44b4fb)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-10-18 16:15:28 +02:00
Scott Rifenbark 8eb706a41b ref-manual, dev-manual: Applied migration review edits.
Applied the full set of first draft revision edits for the
new migration section for 1.7.  Comments from Paul Eggleton.

(From yocto-docs rev: 90586addbc719ecaf7c768b267adf0e988e27b74)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-10-18 16:15:28 +02:00
Scott Rifenbark ba0483c9ed dev-manual: Updated the list of linux-yocto kernels
I removed the linux-yocto 3.4 kernel from the list in the
section describing which kernels we support.  Also, added
the 3.17 linux-yocto kernel to the list.

(From yocto-docs rev: 41f57a9abe1201ed2fb657f8441c97f86f75200a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-10-18 16:15:27 +02:00
Scott Rifenbark 6c3d1192c7 documentation: Updated release date for manual rev tables.
Added "October 2014" to table for all manuals that have the
table.

(From yocto-docs rev: 3f9ceb4dd2397fe907bf701c842277eb65d11a56)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-10-03 14:41:30 +01:00
Scott Rifenbark 609c216b60 dev-manual: Updated the supported BSP bullet item.
The bulleted item on supported BSPs was very centric on meta-intel.
I rewrote the section to not be so exclusive.

(From yocto-docs rev: d8118bb6124fbbb2340ae8720cd6187fd5546967)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-30 21:37:42 +01:00
Scott Rifenbark 4995908b97 dev-manual: Added reference to the meta-selinux layer.
Fixes [YOCTO #5482]

Added a cross-reference to the meta-selinux layer in the section
that describes how to make images more secure.

(From yocto-docs rev: 0c96273ee857808046c5a76517c1eda4aa703c81)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-23 21:41:55 +01:00
Scott Rifenbark bff185f625 dev-manual: Added a note to the EXTERNALSRC example about the class
Added a short note after the example that shows how to set up
the EXTERNALSRC variables stating that the externalsrc class
needs to be either globally or locally inherited.

(From yocto-docs rev: db935135c0b060e06f6a63530df995d286002598)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-22 13:04:44 +01:00
Scott Rifenbark 2acf47b6e6 dev-manual: Fixed typo in the make races section header.
(From yocto-docs rev: 26ffb2e47f3caa8a0ab0f2a9cd83af8cdf893cfd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-22 13:04:43 +01:00
Scott Rifenbark ab7f117b09 dev-manual: Added a second EXTERNALSRC example.
Added a new example on how to set this from the recipe or the
recipe's bbappend file.

(From yocto-docs rev: bc0d9de3378f3462729301e74419b7dede17558b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-22 13:04:43 +01:00
Scott Rifenbark 79fd7f1b25 dev-manual: Updated another EXTERNALSRC example.
Found another occurrance of where I needed to add a <replaceable>
tag set in an example.

(From yocto-docs rev: 586e5a590bb5382a28fde4670fdcd6cbb75f6c32)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-22 13:04:43 +01:00
Scott Rifenbark 018c498d0f dev-manual: Updated EXTERNALSRC example for user-input formatting.
I missed a <replaceable> tag set on the example.  Adding it
clears up confusion for how to use the variable.

(From yocto-docs rev: 8bbf2a012e580d82aaf9c9a98ad5dab1aea64f7b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-22 13:04:43 +01:00
Scott Rifenbark b4c03a7c28 dev-manual: Added some formatting for user-supplied input.
(From yocto-docs rev: 0b586d27a647d7afcaff0623919dff33a9206632)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-22 13:04:42 +01:00
Scott Rifenbark f819f3d7b1 dev-manual: General edits to "Common Tasks" chapter.
* Found and fixed several areas with issues.

* Scrubbed for user-supplied input to make it use the
  <replaceable></replaceable> tags.

(From yocto-docs rev: 0e1c7ad31921ee7d4ee0d7d4ece01303a25a5d60)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-22 13:04:42 +01:00
Scott Rifenbark c2e5449f96 dev-manual: Review edits for GDB without source
Fixes [YOCTO #6621]

Applied a few review edits for this fix.

(From yocto-docs rev: 99511bbcfa1de2f7bf691da1a002913f3a7f6034)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-09-22 13:04:42 +01:00
Scott Rifenbark 010d19ec2c dev-manual: Misc edits to the model chapter (Chapter 4).
I replaced user-supplied variables with <replaceable></replaceable>
tags to get proper formatting.  I inserted several references
to the new QEMU chapter for help using QEMU.  I updated a note
on the BSP available so that it is a bit more generic and not so
dependent on an exact list within meta-intel and the source
repositories.

(From yocto-docs rev: daef4406e7c3e45dd5d98d565e519d91939f6965)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:32 +01:00
Scott Rifenbark 1ab0c8fb8c dev-manual: Various small edits to Chapter 3.
Replaced angled bracket items for user-supplied variables
with the <replaceable></replaceable> tags.

(From yocto-docs rev: 393af6c0cfbfc0f3921bc1eb1fdbd3dd734f51ae)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:32 +01:00
Scott Rifenbark 4cc5cb151b dev-manual, mega-manual: Updated the downloads picture.
(From yocto-docs rev: 67c71f5a51749e4f15987ce7cb3ae8f22436bb93)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:32 +01:00
Scott Rifenbark 32b508e7ce dev-manual: Misc edits to Chapter 2.
Added some links and fixed up some replaceable items.

(From yocto-docs rev: 5c9ce934f13c68c2efbd952f399a8b88e87eb761)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:31 +01:00
Scott Rifenbark d677a6839d dev-manual: Added Toaster to the list of other resources.
(From yocto-docs rev: 14652c5aeb7ae54d079f6360c1fa650638f280ab)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:31 +01:00
Scott Rifenbark 5370b58892 dev-manual: Updated section on launching remote GDB.
Fixes [YOCTO #6620]

I altered the path name of the .gdbinit file in the text to prepend
~/ to it to reinforce what file the user must modify.  I also removed
the /home/jzhang string in favor of ~ to make it more general.

(From yocto-docs rev: ff09d3a5666c97598adf385f63dee4b30b0f1792)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:31 +01:00
Scott Rifenbark 932b956b4c dev-manual: Minor edits to the section to add binaries to an image.
Review edits from Paul.

(From yocto-docs rev: 088410d607418531d6ab8a40fdc9d77495b132c9)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:30 +01:00
Scott Rifenbark a20e75f45b dev-manual: Review edits to how to find checksum values.
Edits from Paul to better word this section.

(From yocto-docs rev: 51425ab506050ee5ba30d5c3c10639d5a1b8cc8e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:30 +01:00
Robert P. J. Day 0467e3addf dev-manual: Minor edits via patch to "common tasks" chapter.
(From yocto-docs rev: b1516fb6e6d40e7668ca5a4d5804d1a09c7ed6f8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:30 +01:00
Robert P. J. Day 93f0d03a8d dev-manual: Technical and text edits applied as patch.
(From yocto-docs rev: 703cbe5c037334b3fbf08123b7cc501d36e1e8f0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:29 +01:00
Robert P. J. Day 99a3c1911c dev-manual: Edits to several examples and some typos.
These catches are from Robert P. J. Day and applied as a
patch.

(From yocto-docs rev: b805795e9bf68286aa5b79a94792e2fefd293b92)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:29 +01:00
Robert P. J. Day 034640585f dev-manaul: Small edits to various examples.
(From yocto-docs rev: 6ef54d31664b097b8ceeb5da1b8c48cdc6f673a3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-12 13:50:29 +01:00
Scott Rifenbark 4a226369b7 dev-manual: Updates for checksums and wic
Accidentally put in a couple different things in this one commit.
Oh well.

1. New wording for how the user needs to figure out some checksums
   for a recipe.

2. Fixed up some note placement in the wic reference section.

(From yocto-docs rev: 6c13f49c265c99ddd6dcd4ec3c3c8e66b78824e0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:26 +01:00
Robert P. J. Day d283686dc3 dev-manual: Minor fixes.
(From yocto-docs rev: 71c9e378c86d03e5fb7f4e459e677ad8a9965f52)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:26 +01:00
Scott Rifenbark 152d307767 dev-manual: Updated manual overview to include new QEMU chapter
Fixes [YOCTO #641]

Added a new bullet to the list that overviews what the manual
covers.

(From yocto-docs rev: 54bdb50df3951346a2e926700681db55bd59a2e1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:26 +01:00
Scott Rifenbark fb4649297b dev-manual: Edits to the wic reference section.
Pulled a note about future support of commands and options from
the bootloader section and got it up in the higher level intro
section for that part of the manual.

(From yocto-docs rev: f8d677301abcd0d549ea9ad4cca79f43cb2db7f0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:26 +01:00
Robert P. J. Day f937e05b44 dev-manual: Miscellaneous fixes in the newbie chapter.
(From yocto-docs rev: 34d6bd814e813591631b336f6247c300381fd309)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:26 +01:00
Scott Rifenbark 3152e69383 dev-manual: Created new chapter on QEMU.
Fixes [YOCTO #641]

New chapter added that covers the YP instance of QEMU.

(From yocto-docs rev: 7ca17d02364af7e5924e23df6c138ab4dd2203d6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:26 +01:00
Scott Rifenbark 5f31e281ec dev-manual: Added support for new QEMU chapter.
(From yocto-docs rev: d8a852e244f1c0f4d5ef33f50844bb1cb479cb92)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:25 +01:00
Scott Rifenbark 25d7b0df2a dev-manual: Modified how to find checksums in the recipes
The section on wrting a new recipe suggested using a "build-fail"
method to get bitbake to return exact checksums for code.  It
was pointed out that this could be a middle-security risk and
that we should not do that but instead get the signatures from
the upstream website.  However, many times those sites don't
provide that information.  I re-worded the text to note the
ideal method (upstream checksums) and then resorted to the
"build-fail" method as a "way" to also get them when the upstream
location does not have them.

(From yocto-docs rev: b06699de2f512b01600bf952a8ee928c2a4c358a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:25 +01:00
Scott Rifenbark 3be4af9cf3 dev-manual: Applied review edits to the 'wic' section.
I made some small edits to the section based on Tom Zanussi's
review.

(From yocto-docs rev: 560ea7b0eb131e59b190a34cadbe77729e76d61c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:25 +01:00
Scott Rifenbark 73abcb0b16 dev-manual: Fixed up the list of other references.
There was a bogus link in there to the Build Appliance page.
I also noted many links that use the <ulink> tag that crossed
multiple lines.  That is not good.  I cleaned all that up.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: a39cea47cae29d7efb8e12495e8eefb484d464c4)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:25 +01:00
Scott Rifenbark 231fde5b16 dev-manual: Replaced "--" with &dash;&dash; throughout.
(From yocto-docs rev: 79fb4973909ff3a2ba5da8cad8c3d7bdb4206003)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:25 +01:00
Tom Zanussi 7ef076cd9e dev-manual: Miscellaneous wic edits.
This is a set of fixes for miscellaneous dev-manual updates noticed
while transcribing wic help for the dev manual.

(From yocto-docs rev: fd2205e2778e2cef86561025fd904f303d64586a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:25 +01:00
Tom Zanussi e0aa8f04e9 dev-manual: Miscellaneous updates from the wic help text.
(From yocto-docs rev: 99b04623aa47d07970f91e2bdf648f25ab54c59b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:25 +01:00
Tom Zanussi b8a836c0c9 dev-manual: Added --fsoptions to wic
--fsoptions support was recently added to wic, so document it.

(From yocto-docs rev: 91efb698eea438083474c1e905dbaad3fffdbd81)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:25 +01:00
Tom Zanussi 537e965cc7 dev-manual: squashfs support added to wic section.
squashfs support was recently added to wic, so document it.

(From yocto-docs rev: 22ca1141953b4fae92e15126da296d3d95e80c25)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:25 +01:00
Tom Zanussi 2a11e9d294 dev-manual: Created new "Plugins" section in the wic section.
Add a new section discussing plugins, taken directly from the
corresponding wic help section.

(From yocto-docs rev: c1b4c378a496413f2dde8ad2f043a537cba24b6e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:24 +01:00
Scott Rifenbark 1a825210d8 dev-manual: Updates to the creating partitioned images section.
Fixes [YOCTO #6511]

Added a new example to this section that shows how to package
up binaries so that you can add them to an image.

(From yocto-docs rev: e52acc444c8f142d0469d7274fb936b5242306ec)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:24 +01:00
Robert P. J. Day 4560e2fc92 dev-manual: Added note and fixed a grammar spot.
(From yocto-docs rev: 934dbe2faff2a553bf281d55edcd6b8de9c31c06)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:24 +01:00
Robert P. J. Day b1a9074744 dev-manual: Patch to fix some links and references.
Add in a few links to member orgs, and update the BitBake link.

(From yocto-docs rev: 481c89e9b8e219358db8bfdfff0b5b0150247c07)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:24 +01:00
Scott Rifenbark 6ebbf038ab dev-manual: Updated example "foo" recipe name used in examples.
The recipe should be named "foo_1.3.0.bb" instead of
"foo_1.3.0-r0.bb".

(From yocto-docs rev: c34c3ea05d550fc85ab04036856704a7c04fd64c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-08-02 10:00:24 +01:00
Scott Rifenbark 5ba68f32a8 dev-manual: Added the section on "Creating Partitioned Images"
This is the section on 'wic'.  I have dropped in the same exact
section from the 1.5.3 (dora branch) release as a starting point
for Tom Zanussi to scrub and update for the master branch.

(From yocto-docs rev: e189992bff4249664ba959b1c440541e0b84e03d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-07-23 10:02:13 +01:00
Scott Rifenbark ed3cd02d4c dev-manual: Removed not to the PTEST_ENABLED variable.
The note did not need to be there.

(From yocto-docs rev: 5ff94a1a412447c1ed1cda64e985b52545ccd9e7)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-07-21 19:06:53 +01:00
Scott Rifenbark 08d68e5bc8 ref-manual, dev-manual: Updates to support PTEST_ENABLED.
In the ref-manual, I added a new variable description for the
PTEST_ENABLED variable.

In the dev-manual, I added a note to the "Adding ptest to Your
Build" section to mention that the OpenEmbedded system uses
PTEST_ENABLED to enable or disable building ptests and that
the user does not set this variable directly.

(From yocto-docs rev: 52d6608caaa25378b873e41e1ddd05356ff8629a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-07-03 13:57:10 +01:00
Scott Rifenbark 11bf70bba1 dev-manual: Fixed a couple typos in the Template section.
(From yocto-docs rev: 9285eee037022ed29a0bdc2c9ecc628c63b47e2b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-07-03 13:57:10 +01:00
Scott Rifenbark 9eb3e85557 documentation: Added permalink display styles to CSS files.
Fixes [YOCTO #5772]

Updated each manual's CSS style sheet to contain a style for
how the permalink symbol looks on its own and how it looks
when a user hovers over it with the mouse.

(From yocto-docs rev: c8d4afa0b83a40ac2de0c47c191a11b3e7d241e5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-07-03 13:57:09 +01:00
Scott Rifenbark 01af798187 dev-manual: Fixed a mult-line <ulink> cross-reference
These types of references cannot span multiple lines.  If they
do then mega-manual.sed will not process the link in the
mega-manual.html file.

(From yocto-docs rev: 8a06542c0f1fee503eda12052adddaaf9c94ca91)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-07-03 13:57:07 +01:00
Scott Rifenbark d785a16dff dev-manual, yocto-project-qs: New section on working with source files.
Fixes [YOCTO #5566]

For the dev-manual, I created a new section called "Working
with Source Files."  In the section, I cover how to set up mirrors
and also how to pre-fetch source using the bitbake -c fetchall
<target> command.

For the yocto-project-qs, I removed the mirror information in the
"Super User" section, which became redundant with the new section
now in the dev-manual.  I also, removed the fetchall variation of
the bitbake command.  Both areas reference into the new section of
the dev-manual now.

(From yocto-docs rev: f314061e3e752d35ea85ed16a60f7f9292180921)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:50 +01:00
Scott Rifenbark 5112dbd23d dev-manual: Edits to "Creating a Custom Template Configuration Directory"
Fixes [YOCTO #5895]

Some minor edits to the section.  I found a grammar error and a
mis-wording.

(From yocto-docs rev: 86e85512279a1379d9b30825d6af3e508faa320a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:50 +01:00
Scott Rifenbark ac6bdb4d41 dev-manual, kernel-dev: Provides some cross-reference to "clean" stuff.
I scrubbed the manual set for appropriate places to reference into the
do_clean* type tasks.  Found and added several occurrences.

(From yocto-docs rev: 01594823b1d556bc70e928af1838039cc15a816d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:49 +01:00
Scott Rifenbark a92fcf1c62 documentation: Updated style sheets to remove unused .PNG files.
Fixes [YOCTO #6430]

The style sheets were carrying over old .PNG files that are not
part of the manuals.  I have removed the statements that were
using them.

(From yocto-docs rev: 6e4fa419b9367ab5e34b9aa8010a24980416dc7d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:49 +01:00
Scott Rifenbark ad76aa0a94 dev-manual: Small edit to locating the race failure.
Failure occurs during make, not do_compile as I previously
noted.

(From yocto-docs rev: 467ea8aa43fac14e3092a30ae15d1ace7a6558ab)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:48 +01:00
Scott Rifenbark 7755de2532 dev-manual: Second draft of make race section.
Fixes [YOCTO #6390]

Edits to the "Debugging Parallel Make Races" section.  Changes
originating from trying the procedure.

(From yocto-docs rev: 537f5bd8918450e30ea87465025f0069232cb229)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:48 +01:00
Scott Rifenbark 1daa2c0e9e dev-manual: First draft of new section on debugging race conditions.
Fixes [YOCTO #6390]

This is a section on parallel make race situations.  The draft
is the first cut at the section.

(From yocto-docs rev: c225d7fe121270a6f82b9fbffa78c7e3914b113d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:48 +01:00
Scott Rifenbark a19f575cde dev-manual, kernel-dev, ref-manual: Updated task name usage.
There was inconsistency on how we refer to a task name throughout
the YP manual set.  The proper way is "do_<taskname>".  Some
occurrences did not include the "do_" prefix.  These have been
fixed.

(From yocto-docs rev: b32821bb0d3e6de7bca68b25c662a023526a10c4)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:48 +01:00
Scott Rifenbark 3c22ec98a6 dev-manual: Added XSL templates to support permalinks.
Fixes [YOCTO #5772]

(From yocto-docs rev: 54f7fab50c8ddf9b4ee233610b8fab5b9776e419)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:47 +01:00
Scott Rifenbark d9ce6c748c dev-manual: Edit to "Package Archtiture" section.
Added a bit more to the ending of the sentence to qualify
its meaning.

(From yocto-docs rev: 40b309a43d948d5800cfe908e72f6202c095a166)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:44 +01:00
Scott Rifenbark 3cb04638b4 dev-manual: Edits to "Writing a New Recipe"
Received and implemented some feedback from Paul Eggleton
on this section.  These were unsolicited observations.

Reported-by: Paul Eggleton <paul.eggleton@intel.com>
(From yocto-docs rev: 48ecc543d9f614b5258ab2573f0406aa3c778647)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:44 +01:00
Scott Rifenbark 59b50ea598 dev-manual: Edits to "Creating a Custom Template Configuration Directory"
Fixes [YOCTO #5895]

I applied some review comments from Paul to tighten up this section.

(From yocto-docs rev: 9f17ad00e9e707fcd6f2419762b4281d64f4ed0f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:44 +01:00
Scott Rifenbark 95a5fadc15 dev-manual: Edits to the "Understanding Recipe Syntax" section.
Added a new "Overrides" bullet item and fixed some minor issues
pointed out by Paul Eggleton.

(From yocto-docs rev: 44ff3d82985fa304c5641570fe72cf6a8ddabaa3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:44 +01:00
Scott Rifenbark a456afa06c dev-manual: Updates to the "Understanding Recipe Syntax" section.
Paul Eggleton sent me some feedback on this section.  I implemented
his suggestions.  Changes were minor.  One included a cross-link
to the BitBake User Manual.

(From yocto-docs rev: e9b5f252a1368b8c231dd659428a18eacf9757af)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:44 +01:00
Scott Rifenbark 84ee8c653a ref-manual, dev-manual: Updates for custom template configuration directory.
Fixes [YOCTO #5895]

I created a new section in the dev-manual titles
"Creating a Custom Template Configuration Directory" that describes
how the build system uses the template local.conf and bblayers.conf
and conf-notes.txt files as a basis when creating the real
deals in the build directory's conf folder.  The context of this
is so that the user can create their own directory with their own
template files for repeated configurations and to create a custom
conf-notes.txt file should they want the setup scripts to display
some custom list of targets.

I also modified the two script references in the ref-manual for
oe-init-build-env and oe-init-build-env-memres.  I needed to
link to the "how-to" section and added a bit in there about how
the scripts go about forming the conf files in the build directory.

(From yocto-docs rev: c07fb7082fe08387bbc546b2a23620dedc7127b8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark fae1d7d567 dev-manual: Added reference to QA checks in the "Packaging" section.
The "Writing a New Recipe" section has a subsection named
"Packaging."  We needed a cross-reference here to the QA checks
performed for packaging.

(From yocto-docs rev: 34952ee1b56a84e0ee0edd142c7c8c68b122a3e3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark a3b8282d25 dev-manual: Edits to the "Making Images More Secure" section.
Fixes [YOCTO #5482]

I applied some review edits as directed by Paul Eggleton. The
main feature was to merge the information on setting root
and extra user's passwords.  Also, permanently removed the
reference to the wiki that showed the less optimal way of
setting a root password.

(From yocto-docs rev: fef0e17cd3835580abed175ef4a7baf22b9b7673)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark 5d14f3c03a dev-manual: Updates to the "Making Images More Secure" section.
Fixes [YOCTO #5482]

Applied extensive review edist from Paul Eggleton throughout
this section.

(From yocto-docs rev: aa0bcd9199c83b43bad2390ff2292a8c2abe7455)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:19 +01:00
Scott Rifenbark 57bd61eabb ref-manual: Edits to the "Making Images More Secure" section.
Fixes [YOCTO #5482]

I added some key references to the section on considerations
specific to the OpenEmbedded build system.  In particular, I
provided some cross-linking back to the extrausers.bbclass
section to reference an example of adding a user account.  I
also split out the topics of adding an extra user and setting
a password on the image in the bulleted list.

(From yocto-docs rev: 19dcd70b9b5aba1bd5e7ce090d5449afcef726bf)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark 28d5925bdf dev-manual: Updated the "Making Images More Secure" section.
Fixes [YOCTO #5482]

I did some significant re-writing and re-organization of this
section.  It now includes a bit about securing an image in general,
provides general considerations, considerations specific to the
OpenEmbedded build system, pointers to some tools in meta-security
layer, and some other items.

(From yocto-docs rev: a900286992e781f451b3c180726965f5c7172bb9)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark 8e90933d3d dev-manual: Added links to new do_* sections.
With the creation of the new chapter that documents the 51 tasks
defined by the OpenEmbedded build system, the dev-manual had
many first-instance occurrences of do_* task names that could
be cross-referenced to the new sections. I have added these links.

(From yocto-docs rev: 78f91987b0ad9906571ec7888334301492361822)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-13 07:50:58 +01:00
Scott Rifenbark ab864d71fb dev-manual: Edits to the "Understanding Recipe Syntax" section.
(From yocto-docs rev: 97e5025ccff55efd077fdaf9b2d65eae5b59bc2b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-13 07:50:58 +01:00
Scott Rifenbark 1744a1e5b9 dev-manual: Edits to the "Understanding Recipe Syntax" section.
(From yocto-docs rev: 9808ea79a1e219df794948bd42bc086ab4d56d9f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-13 07:50:57 +01:00
Scott Rifenbark f7a161253f dev-manual: Added new "Understanding Recipe Syntax" section.
(From yocto-docs rev: d637ba317b22de50e25750e6031defcb707b36e5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-13 07:50:57 +01:00
Scott Rifenbark d1594eacf7 dev-manual: Added "Properly Versioning Pre-Release Recipes" section.
Fixes [YOCTO #6243]

This section addresses situations when working with recipe
file names of recipes that have not been released (e.g.
recipe-name_1.0.3.rc1).  When the recipe is released the system
has difficulty recognizing the new recipe name as a later version.
So the work-around is to use PV to set the recipe version in
the recipe.  The section describes this.

(From yocto-docs rev: 612379f44e772cfc381e31171ae18af24a9e44fe)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-13 07:50:57 +01:00
Scott Rifenbark 95c6c26fba documentation: Updated the manual revision history tables for 1.7
(From yocto-docs rev: 9014fe95b9607a15c0e72ef1b6df14f250a3d241)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-13 07:50:57 +01:00
Scott Rifenbark 601d5f1af0 dev-manual: Fixed some "systemd" capitalization issues.
I was using this term inconsistently.  I have cleaned it up so
that no initial capital is used.

(From yocto-docs rev: 7dea2c5ef067d81b8350cd54ba4082c35d7077b1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-21 22:47:11 +01:00
Scott Rifenbark 0403353623 documentation: Updated all the manual revision history tables.
Set the release date to April 2014.

(From yocto-docs rev: 2592bc968edeea941a92e6bdd321dd872745b78c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-21 22:47:10 +01:00
Scott Rifenbark 2648f5d972 dev-manual: Updates to "Performing Automated Runtime Testing"
Fixes [YOCTO #5554]

I worked with Stefan here to update the section on running tests.
We are good now with it all.

(From yocto-docs rev: 806a89f1ddd3efc39d15d3f7e1a01e8fd69af7c1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-19 16:25:02 +01:00
Scott Rifenbark ac054daa36 dev-manual: Changed GummiBootTarget to GummibootTarget.
(From yocto-docs rev: 0d870778d87dcbb38d1ce577f38b84c8fca0e464)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-19 16:25:02 +01:00
Scott Rifenbark c4fec0d7ac dev-manual: Edits to "Using the Error Reporting Tool"
Created some sub-section structure to better organize this
section.

(From yocto-docs rev: 61b15f579c4c21378277051bb5905baa4e9741b5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-19 16:25:01 +01:00
Scott Rifenbark 15f128c3b4 dev-manual: Edits to "Using the Error Reporting Tool"
Added Information about setting up your own server.  Paul
Eggleton provided the information.

(From yocto-docs rev: 655bba9b91283dac502658dd72d866a7af4eacce)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-19 16:25:01 +01:00
Scott Rifenbark 583ce2ce46 dev-manual: Fixed typo for AUTOREV.
(From yocto-docs rev: a1fd83f0aeaab95693335150f330bbc7c5af18f8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-19 16:25:01 +01:00
Scott Rifenbark ce9fb83aa9 dev-manual, ref-manual: Removed VIRTUAL-RUNTIME note from most places.
Fixes [YOCTO #5159]

Edits to fix the occurrences of VIRTUAL-RUNTIME_initscripts = "".
I removed it from all places in the manuals except under
"Selecting an Initialization Manager".  Note that it still
needed removed from "Using Systemd for the Main Image and
Using SysVinit for the Rescue Image".

Also, in the "Using Systemd Exclusively" section I made some
edits as suggested by Paul Eggleton's review.

(From yocto-docs rev: 28b2e3eba3acff17f165899a7f4a65c98263e201)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-19 16:25:01 +01:00
Scott Rifenbark 43de868668 dev-manual: typo fixed.
(From yocto-docs rev: 1bae90e7eb4d53cb0899b2a7b701d525587863d4)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-13 12:03:52 +01:00
Scott Rifenbark f3dccea14a ref-manual, dev-manual: Edits to running tests on hardware
Fixes [YOCTO #5554]

Applied edits to the section in the dev-manual on running tests
on hardware.

Edited the TEST_TARGET and TEST_IMAGE variables.

(From yocto-docs rev: a26ba11c739aabab4009a944d9b622e2814c7fca)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-13 12:03:52 +01:00
Scott Rifenbark 9659789223 dev-manual: Grammar fix to the Toaster section.
(From yocto-docs rev: 36e7ec1a7e01e9f57d670527f6889ea1aa3099cf)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-11 18:22:49 +01:00
Scott Rifenbark ad3553be2e dev-manual: Applied Toaster section review edits.
(From yocto-docs rev: 362ac25d3fc98268d49f71aae9d477a2a2256c8a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-11 18:22:49 +01:00
Scott Rifenbark f0e3476705 dev-manual: Added new "Exporting Tests" section.
Fixes [YOCTO #5554]

New section added on exporting tests.

(From yocto-docs rev: b4a818e769acca5559a8e174414c4e214379e292)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-11 18:22:49 +01:00
Scott Rifenbark ea11a0c770 dev-manual: Added new "Hardware" section for running tests.
Fixes [YOCTO #5554]

This is the section that describes how to enable tests for
actual hardware.

(From yocto-docs rev: fd33b19e7fa32797ab2abd2b506b0d63209fbfc6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-11 18:22:48 +01:00
Scott Rifenbark cc80d05141 dev-manual: Moved list of qemu-specific run information
Fixes [YOCTO #5554]

The list of items that described what happens when you run
tests is really specific to qemu.  Consequently, it is better
located in the section describing how to enable and get
set up for those tests.

(From yocto-docs rev: 1f0606f1c5c03c873a295819adcfb6fb51c196bd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-11 18:22:48 +01:00
Scott Rifenbark 7406f93121 dev-manual: Updates to the "target" class attribute
Fixes [YOCTO #5554]

In the "Class Attributes" section I updated several items.

(From yocto-docs rev: 8f97671319c4751885e5ec89423a061dd45c6684)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-11 18:22:48 +01:00
Scott Rifenbark 285ffd8307 dev-manual: Updated the "Class Methods" section.
Fixes [YOCTO #5554]

Removed the final bulleted item.  Changed the wording on the
first to account for the manifest file.

(From yocto-docs rev: 50e7557032a0dbf4bc2144e9d4f9a4e1a1726d6d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-11 18:22:48 +01:00
Scott Rifenbark eb578b09bd dev-manual: Removed note about rm_work
Fixes [YOCTO #5554]

Removed the (second) note  about rm_work builds, that bug
was fixed. (#5072)

(From yocto-docs rev: f1223a67caae17db1abfd6b7465bfc71d295ab7f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-11 18:22:48 +01:00
Scott Rifenbark 9f1c18e22a dev-manual, kernel-dev: Replaced routerstationpro with edgerouter.
Fixes [YOCTO #2444]

Replaced a couple instances where routerstationpro was found.  This
reference BSP is no longer there and has been replaced by
edgerouter.

(From yocto-docs rev: 7ba629cc677310f04a17636e140142695242c5d2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-08 14:20:15 +01:00
Scott Rifenbark 7f6d83a895 documentation: Beagleboard replaced with Beaglebone
Fixes [YOCTO #2444]

Several areas affected by the reference BSP "beagleboard"
being replaced by "beaglebone".

(From yocto-docs rev: 2f02b570e1ebcf0469871b67a029b65fa8b285f2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-08 14:20:15 +01:00
Scott Rifenbark 9814bdfd6d dev-manual: Updates to the Toaster section.
Applied some feedback from Belen and Paul for the section in
light of the 1.6 release.

(From yocto-docs rev: 88bbc526446970c66642c2ae10ad3eba01f74eb3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-08 14:20:15 +01:00
Scott Rifenbark b02932eb72 dev-manual: Edits to "Providing the Source Code" section.
Fixed some links to the arichiver class.  Also updated the example
to use the new ARCHIVER_MODE variable.

(From yocto-docs rev: 0774ddd2f83586c61f71f1b251fd559ccca45f50)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-08 14:20:14 +01:00
Scott Rifenbark 5d6dcdb837 dev-manual, ref-manual: Added notes for Systemd-based images.
Fixes [YOCTO #5159]

In the dev-manual, I located instances where a note about using
VIRTURAL-RUNTIME_initscripts = "" in the local.conf file would
be appropriate.  Three areas updated.

In the ref-manual, I located the note in the systemd.bbclass
section and the variable descriptions for SYSTEM_AUTO_ENABLE,
SYSTEM_PACKAGES, and SYSTEMD_SERVICE.

(From yocto-docs rev: 57b0acf2f3f8159b635b42dcffa129f7d945eb81)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-04 15:20:17 +01:00
Scott Rifenbark 6ff92a6966 dev-manual, ref-manual: Additions for making an image more secure.
Fixes [YOCTO #3686]

In the dev-manual, I created a new section called
"Making Images More Secure."  The section explains in general
how to enable the security flags.

In the ref-manual, I updated the CFLAGS variable to point to the
new section.

(From yocto-docs rev: 3ed91a46eaf5c1fdf84369ea69951775d87a42da)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-04 15:20:17 +01:00
Scott Rifenbark d5a0a6b676 documentation: Updates to get rid of PRINC variable.
I did not eliminate this variable but rather changed the description
to indicate that it has been deprecated and that the user should now
use a PR Service to do this stuff.  There were several areas in the
YP manual set that used the variable in code.  I just deleted those
lines from the code.

(From yocto-docs rev: 88a075e6306349e5f8c0d53b5288ef1e64956cd3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-01 10:23:02 +01:00
Scott Rifenbark e81d0bd961 dev-manual, ref-manual: Removed meta-hob layer from docs.
Hob no longer uses this layer so I removed the two instances in
the YP set where it appeared.

(From yocto-docs rev: 37e3f261bd61a96a2929a525f9896c39658d26f8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-04-01 10:23:02 +01:00
Scott Rifenbark df02dd8c65 dev-manual: WIP for YOCTO #5554.
(From yocto-docs rev: 00ecee108d87b5c1044e7b6df702e59f0332035f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-30 10:18:37 +01:00
Scott Rifenbark f1e9e335ee dev-manual, ref-manual: Added error reporting tool information
Fixes [YOCTO #1562]

In the dev-manual, I created a new section called "Using the
Error Reporting Tool" that describes how to use this feature.
The text was based on information I received from Andreea Proca.

In the ref-manual, I added a new variable entry for ERR_REPORT_DIR
in the glossary and a new report-error class in the class chapter.

(From yocto-docs rev: 70a5538fefcc1b77958fe4b2f29be00354f4137a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-30 10:18:37 +01:00
Scott Rifenbark aa73618df5 dev-manual, ref-manual: Noting TMPDIR cannot be on NFS
Fixes [YOCTO #5442]

Updated the TMPDIR variable to call out the scenario where a user
might want to separtely set TMPDIR to a local drive and thus be
able to have the Build Directory on NFS.

Updated the "Build Directory" term with a note indicating that by
default, TMPDIR is inside the Build Directory and thus cannot be
on NFS.  However, the user is able to by-pass that per setting
TMPDIR separately outside of the Build Directory.

(From yocto-docs rev: a5a308c512a3f4285bce16f17974dbf6b67432b2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-30 10:18:37 +01:00
Scott Rifenbark ff5b58e612 ref-manual, dev-manual: Point out "xterm" needed for eclipse use.
Fixes [YOCTO #5766]

In the ref-manual, I added "Eclipse" use in the title for the
"Graphics Support" packages because the "xterm" package is required
for graphics support across all distributions.

In the dev-manual, I specifically called out the need for "xterm"
as a host package at the top of the section describing workflow
with Eclipse.  I also updated the cross-reference links to the
host package and Linux distro requirements to point into the
ref-manual, which is more comprehensive, than into the QS.

(From yocto-docs rev: d3405be506fcb113f01d4fcba4631db80a1ed5dc)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-30 10:18:37 +01:00
Scott Rifenbark b80943fc47 dev-manual: Added notes saying you need to work from same branches
Fixes [YOCTO #4601]

Added a couple notes saying that you need to be in matching
branches for meta-intel and poky.

(From yocto-docs rev: 02bd63829b1d98f21183a10707753e9767bfe68e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:45 +00:00
Scott Rifenbark 20a17fd0f9 dev-manual: Added more detail for using an external SCM.
Provided more information based on an IRC conversation that
Richard Purdies saw on #yocto.

Reported-by: Richard Purdie <richard.purdie@linuxfoundation.org>
(From yocto-docs rev: ec28d9f8f01a6e58ade2954e4e6f2ff1c11aa198)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:45 +00:00
Scott Rifenbark c441f5f005 dev-manual, ref-manual: Changed core-image-basic to core-image-full-cmdline
Fixes [YOCTO #2424]

Some imgage names were cleaned up to have more meaningful names.
These doc changes here take care of changing "core-image-basic"
to "core-image-full-cmdline".

Five instances changed.

(From yocto-docs rev: b758f9645e66867b5728da1dd989bae70a216fcc)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:44 +00:00
Scott Rifenbark 97cfb8c453 dev-manual: Added new summary parameter to do_split_packages list.
Fixes [YOCTO #5406]

In the "Making Sure the Packaging is Done" section, I added the
Summary parameter the laundry list of parameters for the
do_split_packages list in the section.  Paul Eggleton reviewed
the change and approved it.

(From yocto-docs rev: 4c4f60ee611921d9f0f835a081b449565382ab90)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:44 +00:00
Scott Rifenbark e8c60977c6 dev-manual: Read-thru edits for "Maintaining Open Source License..."
A few minor edits.

(From yocto-docs rev: 6051ad964bda3ba78ea3a75199fda87133cc08fd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:44 +00:00
Scott Rifenbark c70b6e8a42 dev-manual: Read-thru edits to "Profiling with OProfile"
Minor edits.

(From yocto-docs rev: 551127f3afa65f36bf9baf21d0ca3e53a2fbb3c1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:43 +00:00
Scott Rifenbark 46330cd0bc dev-manual: Read-thru edits to "Examining Builds Using the Toaster API"
Minor edits.  Needed to add a few cross-reference links.

(From yocto-docs rev: 47d7c408984a552a6c5d25ac880b50634c576cc5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:43 +00:00
Scott Rifenbark eb0a5d5b3b dev-manual: Read-thru edits to "Debugging with the GNU..." section.
Minor edits here.

(From yocto-docs rev: f2d8dfa11af30699f912853814e3dce37b335d34)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:43 +00:00
Scott Rifenbark 914b3e061b dev-manual: Read-thru edits for "Performing Automated Runtime Testing"
Minor edits.

(From yocto-docs rev: 29b999f259bc9c87ad0b2e3c1d54f5473b66edbc)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:43 +00:00
Scott Rifenbark 128cdcf85d dev-manual: Read-thru edits to "Creating a Read-Only Root Filesystem"
I changed the way I referenced the read-only-rootfs feature. Since
it is something on the right side of a variable equation, I decided
to not render it in a Courier font.  I have quoted it.

(From yocto-docs rev: 90804e71e43cddd3ac7c194a677acaab0c866ed6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:43 +00:00
Scott Rifenbark 46a4fb250e dev-manual: Read-thru edits for "Using an External SCM"
(From yocto-docs rev: 37a53af6448f10e8b8f7104295c4e927480312c5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:43 +00:00
Scott Rifenbark d8b69fb4de dev-manual: Read-thru edits for "Selecting an Initialization Manager"
Mainly changed the way I referred to Systemd and SysVinit.  I was
rendering them in a courier font, which was not correct.

(From yocto-docs rev: 179ae65ffdfcf59c36e4a3d315855d50722ad890)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:43 +00:00
Scott Rifenbark 80e7223d89 dev-manual: Fixed a reference to the systemd class.
I try not to use <class>.bbclass when referencing a class in
text unless specifically noting the .class file itself.

(From yocto-docs rev: 92c010a198b5c2e1da2ad979e6ca41cb7cd96e7e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:43 +00:00
Scott Rifenbark e462a1f32c dev-manual: Read-thru edits for "Building Software from an External Source"
Changed a reference to a class to conform to how it is done in the
books.

(From yocto-docs rev: df925b87e4b4962aca913677d8ea01b60b8f99dc)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:43 +00:00
Scott Rifenbark fd2846c5e1 dev-manual: Read-thru edits to "Working With Packages"
Mostly minor edits.

(From yocto-docs rev: 4076cf666a3161c5b816bdc56ff0a4edca5ada32)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:42 +00:00
Scott Rifenbark a4103b804d dev-manual: Read-thru edits for "Building a Tiny System"
Minor edits.  Created some links at the top for organizational
purposes.  Clarified what the linux yocto Git repositories are.

(From yocto-docs rev: adbb8ecb0bce5775153d43bec4b70b2439bc8846)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:42 +00:00
Scott Rifenbark 432138a30a dev-manual: Read-thru edits to "Creating Your Own Distribution"
Eliminated the redundant [required] and [optional] side-notes
for some variables.

Minor fix to re-word use of "append files".

(From yocto-docs rev: 9db7059c9b95871cf876d6d75f8377de943bff85)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:42 +00:00
Scott Rifenbark 24ee5fa913 dev-manual: Added yocto-layer script note and updated kernel version
I added a bit about the layer creation in the patching the kernel
section.  The example does it by hand and now you could obviously
use the yocto-layer create script.  I made a note of saying the
example does it by hand.

Also, in the menuconfig example.  I updated the kernel version from
3.4 to 3.14.  It was very old.

(From yocto-docs rev: 2696d4e45bccbb910c3d721e3f1d46d48309ee6d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:42 +00:00
Scott Rifenbark fceba79bf7 dev-manual: Typo fixed.
(From yocto-docs rev: 89199f983669ff0b6f02314753f2015fd88509ae)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:42 +00:00
Scott Rifenbark 43d93f3426 dev-manual: Read-thru edits to two sections - new machine and libs
Edits to "Adding a New Machine" and "Working With Libraries".
Minor corrections.

I did do a significant rewrite of the first two sections of the
"Adding a New Machine" section as it was very poor.

(From yocto-docs rev: 0a030e44f0f1bf2bb204f24b63b4ddfc0cde8252)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:42 +00:00
Scott Rifenbark 58a7688afb dev-manual: Read-thru edits to "Writing a New Recipe"
Minor edits.

(From yocto-docs rev: 8e0de3f767af4b2ca182d9f321bd3c8286773913)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:42 +00:00
Scott Rifenbark aca4b48cc6 dev-manual: Read-through edits to "Customizing Images".
Minor items fixed.

(From yocto-docs rev: a57772d157a3340d6ae707990d6076e344e15c75)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:42 +00:00
Scott Rifenbark 23da05febb dev-manual: Read-through edits to "Understanding and Creating Layers".
Some minor edits applied.

(From yocto-docs rev: 1897997ad3ef3ada76de77c7fb886fb624dcdfdb)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:42 +00:00
Scott Rifenbark c7fb9a6147 dev-manual: Read-through edits applied to "Models" chapter.
Several items taken care of here.  Of note are the retiring
of three BSPs (Chief River, N450, and sys9* stuff).

Also of note is that Kepler recommended version is now 4.3.2 and
not 4.3.  The interface changed a bit as well in the section
for installing that stuff.

(From yocto-docs rev: 61bf82c1e68156d32a81e4c76dbb29db14665ffb)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:41 +00:00
Scott Rifenbark ccd0e24bf3 dev-manual: WIP - Some edits to Chapter 4 from the read-through.
(From yocto-docs rev: 8c38d549b490aa847e7a9ebefe93ddeb79dbc5f9)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:41 +00:00
Scott Rifenbark 4032e1aab6 dev-manual: Added Haswell BSP to list of BSPs in meta-intel.
(From yocto-docs rev: 0a5a05030b7b1bb309f90d55f58de91dd008813f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:41 +00:00
Scott Rifenbark dd72756230 dev-manual: Read-through edits to Chapter 3.
The changes are a result of a detailed read-through prior to
releasing YP 1.6.  The changes are varied and random.

(From yocto-docs rev: 04c09abf96a04c3ffeea8cdf7be8e1bb1b9055c6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:41 +00:00
Scott Rifenbark cee847acf0 dev-manual, mega-manual: Updated the Git Workflow figure.
The figure had a wrong box label in the right-bottom box.
I changed it to be like a local Git repository area as it should
be.

(From yocto-docs rev: 2963152decb2d3983180a0af9896e822c865f5cd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:41 +00:00
Scott Rifenbark 90dfac064f dev-manual: General edits to the getting started chapter.
Did a read-through of this chapter in preparation for the YP
1.6 release.  Found several little areas that needed attention.

(From yocto-docs rev: 73d56a4c948c675afd4cde0e3321a944a02013cf)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:41 +00:00
Scott Rifenbark 2e56389e56 dev-manual, yocto-project-qs: Recommending 50Gbytes of free space now.
(From yocto-docs rev: 08581479fe38105afd2879742ac9531ef76e1eaa)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:41 +00:00
Scott Rifenbark 68943bc40a dev-manual: Added a cross-reference link to BitBake term.
(From yocto-docs rev: aab031fcb44b92bdfc1a240e095dc634e0aa0cde)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:40 +00:00
Scott Rifenbark 4a6d886ad5 dev-manual: Added cross-reference to the build system.
Had to add a cross-reference anchor tag to the term in Chapter
3 and then the link itself.

(From yocto-docs rev: 227c8ce85f4a8e81f14582cdc7c54b5b832d3aa0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:40 +00:00
Scott Rifenbark bda6b1a3ad dev-manual: Minor edits to the "Introduction" chapter.
I fixed a few things as part of the read through prior to the
1.6 release.  In particular, I added the link for the BitBake
User Manual, which is now published alongside the YP manuals.

(From yocto-docs rev: af779a5a70790d9c15584e1a463e1f0a5c79987f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:40 +00:00
Scott Rifenbark 81f7ff34b1 documentation: Fixed "Relased date" for the 1.5.1 entry
Fixes [YOCTO #5857]

I had missed replacing the release date in the manual revision
history tables for the 1.5.1 release.  It was still an estimate.
I have replaced with the actual date of "January 2014"

(From yocto-docs rev: fb9abe0df33a9b551d797ac1b72577931f5f8ce6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:36 +00:00
Scott Rifenbark 57c0dd6017 dev-manual: Added note about Project names in Eclipse.
Fixes [YOCTO #5814]

I placed a brief note in the section where it talks about adding
a project to an Eclipse project that states you can't use special
characters in the project name.

(From yocto-docs rev: a03b5849394a6ca3a787b444d95fa49b9db36dd5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-03-25 12:29:36 +00:00
Scott Rifenbark ac499f0b9f dev-manual: Fixed code block example for ARCHIVER.
There was an incorrect wrapping of code in the source
example.

Reported-by: Ross Burton <ross.burton@intel.com>
(From yocto-docs rev: 478c3bba9e4b1b72dd11b58ebf9eb7ed54e80081)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-02-17 15:39:46 +00:00
Scott Rifenbark 0fa214421a dev-manual: Updated the section that describes finding source code.
I changed the description to match that which is used in the
WORKDIR variable.

(From yocto-docs rev: 7d9071c2bb99e7c3f3eeae9ddf0abc34563c6725)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:03 +00:00
Scott Rifenbark 0829757cf4 dev-manual: Another small fix to the EXTENDPE definition.
Better wording as it is described in the "Writing a New Recipe"
section.

(From yocto-docs rev: 88b039ccd0aa825220de091ea7225ada3d212553)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:02 +00:00
Scott Rifenbark f477d2725d dev-manual: Small fix to EXTENDPE definition in "Writing a New Recipe"
(From yocto-docs rev: 1d020cd87e5b843622422db79f09b564da526376)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:02 +00:00
Scott Rifenbark 3528ab3760 dev-manual: Review edits to "Writing a New Recipe" section.
Final review comments from Paul Eggleton implemented here.
This should be it for the new section.

(From yocto-docs rev: 5307b471c73f46103e0a031172df3174c1880806)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:02 +00:00
Scott Rifenbark b27a930866 dev-manual: Added review comments to "Writing a New Recipe" section.
These changes are Paul Eggleton's fourth review change.

(From yocto-docs rev: 8470c1b516f7799148b4e2eae28534730e93b58b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:02 +00:00
Scott Rifenbark 52a17c7efe mega-manual, dev-manual: Updated the recipe flow figure.
(From yocto-docs rev: 746eacaf4256c2b28182ca69f4d393025f854a68)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:01 +00:00
Scott Rifenbark ff4d94975b dev-manual: Minor re-wording to introduce recipe flow diagram.
(From yocto-docs rev: e8f169a3547cff5da0e4811f706f2cef5eb3be4d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:01 +00:00
Scott Rifenbark ad5409229a dev-manual: Edits to the "Writing a New Recipe" section.
Completed applying the revision comments from Paul Eggleton
for the third revision of this new section.

(From yocto-docs rev: d641aa6318cb87e9d41dda39cc4747c44888aa4d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:01 +00:00
Scott Rifenbark e987fa8e48 dev-manual: Edits to the "Writing a New Recipe" section.
Implemented some third review feedback from Paul Eggleton.

(From yocto-docs rev: 3fd9c3cc4cf2aba876f0ad2ab36660ec32ea4c08)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:00 +00:00
Scott Rifenbark f0dff1123b dev-manual: Edits to "Examples" and "Post-Installation" sections.
Applied review comments to these sections, which are part of the
"Writing a New Recipe" section.  Moved the Post-installation section
out of the examples area into its own, higher-level section as
it was not really an example.  Other edits were direct result of
Paul Eggleton's review.

(From yocto-docs rev: c147a8bedf79d0be42d7b338e10b7e42d7c0b080)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:58:00 +00:00
Scott Rifenbark b0fd1c3ec5 dev-manual: Edits to "Testing" section.
Applied review comments from Paul Eggleton to this section, which
is a part of the "Writing a New Recipe" section.  Very minor
fix to remove a sentence that was somewhat isolated and unecessary.

(From yocto-docs rev: fd2a0eac1bc4b9e6af0bc8ce9a30802dbea35873)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:59 +00:00
Scott Rifenbark 0d9959a273 dev-manual: Edits to "Packaging" section.
Applied some self-edits to this section that is part of the
"Writing a New Recipe" section.  There was no feedback from the
second review but I noticed a few issues.  Also, I added that
reference on how to add a post-installation script from the
"Enabling System Services" section as noted by Paul Eggleton.

(From yocto-docs rev: 6be835637cb1dc232d6d6dd1dfe1bc803efecfd3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:59 +00:00
Scott Rifenbark a3224b8dd7 dev-manual: Edits to "Enabling System Services" section.
Applied review comments from Paul Eggleton to the section that is
part of the "Writing a New Recipe" section.  I changed the title
of the section and applied some rewordings to better reprepresent
exactly what sysvinit and systemd really are (managers).

(From yocto-docs rev: 95c3ed5b7d1ace08828baacc8401e1ea5d96a06e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:59 +00:00
Scott Rifenbark ab001ceb65 dev-manual: Edits to "Installing" section.
Applied review comments from Paul Eggleton to this section that is
part of the new "Writing a New Recipe" section.  Minor edits.

(From yocto-docs rev: a5116900ca42377c3dc19433b2f6046828ad2dcc)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:59 +00:00
Scott Rifenbark b6c0bae0aa dev-manual: Edits to "Compilation" section.
Added review comments to the section inside the new "Writing
a New Recipe" section.  Minor word fixes.  I did add a new
common compilation failure scenario.  All input from Paul
Eggleton.

(From yocto-docs rev: 5818a8882ff55fc27c5dc77233854465b8c2245b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:59 +00:00
Scott Rifenbark 814e07159f 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>
2014-01-21 21:57:58 +00:00
Scott Rifenbark 78564304dc dev-manual: Edits to the "Licensing" section.
Applied review comments to this section per Paul Eggleton.
Minor word changes.

(From yocto-docs rev: 5130559003778e3b613d3d480350d041dfd10fcd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:58 +00:00
Scott Rifenbark 6d65a98fa9 dev-manual: Edits to "Unpacking Code" section.
Applied review comments to this section.

(From yocto-docs rev: f4075f61ca081df6c87abd876207da968450a8f3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:58 +00:00
Scott Rifenbark a1cb6dbc36 dev-manual: Edits to "Fetching Code" section.
Applied review comments to this section.  Specifically, I addressed
the organization and got rid of the bullet list.  I integrated this
information into the examples used for the various SRC_URI snippits.

Also, part of the feedback including separating out the patching
information into an isolated section.  I set up the section and
moved minimal information into it.

(From yocto-docs rev: 0a16977c2125402cdd04e24ad5bce074859eb28a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:58 +00:00
Scott Rifenbark 32d69605c6 dev-manual: Edits to "Running a Build on the Recipe"
Corrective edits to this section based on Paul's feedback.  Several
items addressed.

(From yocto-docs rev: a09ebe38e0ad22ad4ab12eab3d5a73166e4c56f8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:57 +00:00
Scott Rifenbark 0e03166f26 dev-manual: Edits to "Storing and Naming the Recipe"
Re-ordered this such that the storage of the recipe comes first
and that is followed by naming it.  Also, formatted into a list
to give a better sense of the suggested order.

(From yocto-docs rev: aead82f034a097cbdfe38b3b1f09a60cc411d6ea)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:57 +00:00
Scott Rifenbark 8657f00cfa dev-manual: Edits to "Locate a Base Recipe" section.
Updated the introductory paragraph to be more general about where
a user might locate an existing recipe as a base.

(From yocto-docs rev: d6147d19785824cde29e82aa32916dcec5ae2276)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:57 +00:00
Scott Rifenbark 8eb6e7fcbf dev-manual: Edits to "Locate a Base Recipe" section.
I removed the note structure for the information about BitBake
parcing curly braces.  The note was to prominent.  I added a
leading sentence to better integrate the information into the
section.

(From yocto-docs rev: 21dd7ceced2c9867e4fefc2aab81a4ab3da3bc7d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-21 21:57:57 +00:00
Scott Rifenbark 3517a76512 dev-manual: Edits to the "Post-Installation Scripts" section.
There was some confusion to this section as to just when post-install
scripts were being executed.  I looked it over and the section really
is focusing more on the situations when you are creating a read-only
root filesystem.  So I went through and did a small amount of
editing to just clean up some loose text.

(From yocto-docs rev: 1b3674a5d123e74748bce5de61722079d4740908)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-08 13:02:03 +00:00
Scott Rifenbark 1cd9f2c415 dev-manual: Updated the LIC_FILES_CHKSUM example.
The LIC_FILES_CHKSUM was out of date due to a merge in poky.
I updated the single instance in the manual set to use the new
hash.

Reported-by: Richard Purdie <richard.purdie@intel.com>
(From yocto-docs rev: 4cfdf391326f2c5750404a8d7f31999f75bc26fe)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-08 13:02:02 +00:00
Scott Rifenbark ee0d303ae3 dev-manual, mega-manual: Updated the recipe creation figure.
(From yocto-docs rev: 87058ae7ff4451bddc53ecfbe5e6d5b11aee11f2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:14 +00:00
Scott Rifenbark 9cf69793a8 dev-manual: Removed left-over notes from "Unpacking Code" section.
(From yocto-docs rev: 0b082a87d4e7d4ee627e1b014269bd1946addcee)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:14 +00:00
Scott Rifenbark 05adf62115 dev-manual: Changed "Compiling the Recipe" section to "Compilation"
You really are not compiling the recipe.

(From yocto-docs rev: 82ca9176375c34f3c5b6694b0f205794684a2f01)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:13 +00:00
Scott Rifenbark 34c65471cf dev-manual: Removed section on excluding a package from the build.
I commented this out based on Paul Eggleton's suggestion that
we should not be presenting this information.

(From yocto-docs rev: fe2ee21e42134f0ffc9347f8c0336169f8f52aa6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:13 +00:00
Scott Rifenbark daa6066456 dev-manual: Final merging of recipe stuff.
Merged the concepts in the old "Adding a Package to your Software"
section into the new "Writing a New Recipe" section.  This completes
the feedback from Paul, which was extensive for this new section.

(From yocto-docs rev: 522673e1aa068b8d089dfefb5b234a48062da3fb)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:13 +00:00
Scott Rifenbark 71460e5fc2 dev-manual: Integrated Hello World section into new writing recipe section
This change merged in the Hello World section as a summarizing
example section to the new "Writing a New Recipe" section.

(From yocto-docs rev: 79c858e1590e5ab4c56b19dc51b03e0e570b6209)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:12 +00:00
Scott Rifenbark 3ad993da10 dev-manual: Completed first pass of review feedback.
(From yocto-docs rev: 5c2679b334e2130bd82bee7491d39b6cff56b0a9)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:12 +00:00
Scott Rifenbark 9f51f11ca6 dev-manual: Completed the "Fetching" and "Configuration" sections.
This involved a first draft and implementation of Paul's review
comments. Also worked on the "Configuration" section.

(From yocto-docs rev: 0e168dbaf5f4949c4c5f79fe7da406ca91390e22)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:12 +00:00
Scott Rifenbark fac99a49df dev-manual: First complete draft of the "Writing a New Recipe" section.
(From yocto-docs rev: fe5ca883364c1edbbcd13aacfa972ebdfc3122b9)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:12 +00:00
Scott Rifenbark 3b908ee6a8 dev-manual: Re-wrote the installation part of "Writing a Recipe"
(From yocto-docs rev: 7d99f9346a0747d2d1cb978ea10d1a681e70a98f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:11 +00:00
Scott Rifenbark b55ffe7356 dev-manual: Updates to "Writing a Recipe" section.
Updated the recipe creation figure.  I had to re-order the flow
and also generalize the supporting services installation part of the
diagram.

Fleshed out the "Fecthing" section with SRC_URI examples and much
more detail.

(From yocto-docs rev: 6a23ab2beb90376c11c426ac8bf5618994585a9d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:11 +00:00
Scott Rifenbark 4abc384f25 dev-manual: Some review edits to the new writing a recipe section.
(From yocto-docs rev: 06287769f9a1fc0beb1a867ceb22922e35452589)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:11 +00:00
Scott Rifenbark 1e83889242 dev-manual: Some development text for fetching source
I have added some stuff to the section on fetching source in the
new "Writing a Recipe" section.

(From yocto-docs rev: a4b340d58888927bf648be34402670f8a7d87d8b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:11 +00:00
Scott Rifenbark 5a3296cf25 dev-manual: Put into place a rough draft of the "Writing Recipe" section
This draft has the structure with text from Paul's email.  It
needs further work.

(From yocto-docs rev: 08025edc34995f7436786e9ed3abdfa155db47af)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:10 +00:00
Scott Rifenbark 1bd23c8679 dev-manual, mega-manual, Makefile: Added new recipe creation flow figure.
(From yocto-docs rev: c031c014bae6d6e4a239a4bcd1e8b9d5d272f851)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>

Created a new figure for the flow.  This involved putting the figure
into the "Figures" directory of both the dev-manual and the mega-manual
and then updating Makefile to include the figure in the TARBALL
variable.

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-01-02 13:16:10 +00:00
Scott Rifenbark 31b5f4933a dev-manual: Updated the "Working with a PR Service" section.
I added a link to the PRSERV_HOST variable.  That variable is
now defined in the ref-manual variable glossary.

(From yocto-docs rev: 7166fe94107cd379081fd81b7351ec081aa2c6ae)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-11 14:18:51 +00:00
Robert P. J. Day 63b20910df dev-manual: ksize.py and dirsize.py live in scripts/tiny
(From yocto-docs rev: 1842f4a1d157dfc1559fda5b7cb5a075c1902d95)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:21 +00:00
Robert P. J. Day 4cbf28cc94 dev-manual: Add a reference to poky-bleeding distro
As an actual example of using AUTOREV, refer the reader to the
Yocto-supplied poky-bleeding distribution.

Also cleaned up some wording and added a Caution statement
about the distro not being regularly tested - Scott

(From yocto-docs rev: 2a74573af702c905274e377304a946fd335a0182)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:21 +00:00
Robert P. J. Day 053d78d43c dev-manual: Documentation: More minor tweaks to dev manual for clarity
i'm still looking at the dev manual for more changes but those would
be more substantive changes, so i'll pass along just this collection
of minor stuff.

(From yocto-docs rev: 94e2422d6e6e408e2dd76b15e1231814b123800d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:21 +00:00
Scott Rifenbark 5156a38f89 dev-manual: Updated how to remove package management requirements
This now involves only making sure that "packag-management" is not
part of your IMAGE_FEATURES statement for the image.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 9cb66c40677adc43088d22900fef58166ee8b508)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:21 +00:00
Scott Rifenbark 19e6f3f28b dev-manual: Changed wording of BBMASK example
I changed the intro text for this one-line example so that it
would not imply that the example is the only syntax that can
get the job done.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 5d0151b692bef9ef67a6237f3e4e4387e6f00c63)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:20 +00:00
Scott Rifenbark b288fa475a dev-manual: Added note about naming your distribution
Added a small note in the section where you create your own
distribution to be clear about where the name is set.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: a2ce7d82eb7f3edbaebce65c73e6ae3c0c921152)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:20 +00:00
Scott Rifenbark 134c76e481 dev-manual: Re-worded menuconfig preparation
Rather than saying menuconfig is "built", I changed the text to say
it is "run."

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 74b7a193e8356931e5a0db2ea76b4543880ed2ec)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:20 +00:00
Scott Rifenbark fe154e494b dev-manual: Re-ordered sections for customizing an image.
The four sub-sections describing how to customize an image seemed
to be backwards as they progressed from most complex to easiest.
I switched up the order and provided better transitional
introductory wording for the four sub-sections.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 1e8d178c401d3020621fc90af5cdd0bb3e37be87)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:19 +00:00
Robert P. J. Day 47e7abc519 dev-manual: Number of minor tweaks to Dev Manual, Chapter 5.
(From yocto-docs rev: 1027c4aefa0ba9f341c56eda7ee672d26c5e6813)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:19 +00:00
Scott Rifenbark d85638820b dev-manual, ref-manual: Updated some section titles.
I noticed that chapter 10 of the ref-manual still had
"Reference: Features" as the title.  This is left over from way
back.  I changed that chapter title to "Features."  Next, I
noticed an inconsistency with some sub-section titles.
I changed the "Images" title into "Image Features."  This affected
several links across the doc set so I had to update those
cross-references as well so they have the latest section title
as part of the reference.

(From yocto-docs rev: b68f009a92e0e24802e367d98cf66e15ba1cd364)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:16 +00:00
Scott Rifenbark 21dde6f3fc dev-manual: Updated EXTRA_IMAGE_FEATURES operater for read-only-rootfs example
The operator used was "=" which was inconsistent in light of
previous uses of the variable in the ptest section.  I changed the
operator to "+=" to be consistent.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: d6b7c7e15290e64f4baac25544224788e92ad309)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:12 +00:00
Scott Rifenbark 0e65e7916c dev-manual: Added "Task" term.
After adding "Package Group" definition as the original "Task"
definition, we needed to create a new definition for the term
"Task".

(From yocto-docs rev: b6eae9242bf488d3f086e496b52d8422ad31feb6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:11 +00:00
Scott Rifenbark 85e4bb6670 dev-manual: Changed "Tasks" term into "Package Groups" term.
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: faa7206b2f67a26c1366fe997cd092aed7e9f85e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:11 +00:00
Scott Rifenbark 17ac9ee194 dev-manual: updated the ptest section
Removed the note indicating that three specific recipes were
"ptest-enabled" for the release.  I substituted in wording that
tells the user to see if a a recipe inherits ptest as a way
of determining if the receipe is ptest-enabled.

(From yocto-docs rev: 9136617575eb7a0a08f0b81f75ae6cdede62219f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:11 +00:00
Scott Rifenbark 755e23e852 dev-manual: Re-worded the "Customizing Images Using Custom .bb Files"
Changed the wording so that it reflects better what is actually
going on when use IMAGE_INSTALL to afect an image.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 243588460fb76a0c333772e3dce566cf664397ee)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:10 +00:00
Robert P. J. Day f4d8358c04 dev-manual: More minor tweaks to development manual.
(From yocto-docs rev: 6862b1fd71ae1e311730ef2794b737314cf935a1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-12-03 12:53:08 +00:00