Commit Graph

3581 Commits

Author SHA1 Message Date
Scott Rifenbark 4a5f13760b kernel-dev: Swapped out fri2 BSP for emenlow BSP in example.
In the "Using Kernel Metadata in a Recipe" section, the example
called out "fri2" as an example BSP that shares the same KMACHINE.
This was true last release of meta-intel but is no longer true.
I used "emenlow" now as it seems to be like "fri2" was before
the "fido" release.

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:37 +00:00
Scott Rifenbark 82ad008cd2 kernel-dev: Updated "Modifying Source Code" section.
Substituted a more correct build directory path in the
example by providing
"${WORKDIR}/linux-${PACKAGE_ARCH}-${LINUX_KERNEL_TYPE}-build"

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:37 +00:00
Scott Rifenbark 86f4cf8faf yocto-project-qs: Updates to add more explanations and navigation
Added some changes based on input from a new user.  Basically,
added a bit more explanation in a few spots and some suggestions
on where to read or go next after concluding the two basic
quick-use sections.

(From yocto-docs rev: 5381f1202957e171d16d97332b40e8d363828a20)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:36 +00:00
Scott Rifenbark 8951db67fd poky.ent: Changed the code name from "tbd" to "fido".
(From yocto-docs rev: 5d4d945b6454509fcc4cd35ea8d098c2996f91d5)

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 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 e7e533028b kernel-dev: Scrubbed out the 3.4 kernel references.
This kernel is not supported and is ancient.  Many of the examples
were referencing this kernel.  I switched to use the 3.19 version.

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:34 +00:00
Robert P. J. Day 043e02c5d8 kernel-dev: Minor typo fixed and added LTSI link
Fixed a small text issue where a hypen was needed.  Also, provided
a real link to the YP LTSI page.

(From yocto-docs rev: aa8c06b79eef1855c3b5af4c8bfa47a96a86d332)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:34 +00:00
Scott Rifenbark a8f21965eb kernel-dev, ref-manual: Edits to KBRANCH.
Applied some edits to the areas where KBRANCH is discussed.
Clarified that setting it is not optional any longer.

(From yocto-docs rev: 4d0b2d92140d066048d9ff36453c7ea589eebe55)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:33 +00:00
Scott Rifenbark 8ced82e8b2 kernel-dev, ref-manual: Scrubbed out the KBRANCH_DEFAULT variable.
This variable is out.  There were some references to deal with.

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:33 +00:00
Scott Rifenbark fef68d378e ref-manual: Updated the KBRANCH variable description
Removed traces of the deprecated KBRANCH_DEFAULT variable.

(From yocto-docs rev: 8130f0db46be872cd857d8579323e4ad00da6380)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:32 +00:00
Robert P. J. Day b49a5ccc5b kernel-dev: Clarify a couple minor things in kernel manual, ch 2.
Some small changes to clarify how to change the configuration.

(From yocto-docs rev: fce7c97abb69f15142dbadf90a90965a49ec3e0e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:31 +00:00
Scott Rifenbark 8571027be2 ref-manual: Added variable description for FILES_SOLIBSDEV
Fixes [YOCTO #7358]

Added a new variable description.

(From yocto-docs rev: 42ff075319b346f22d2c604c0de249ac3039a992)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-27 07:40:35 +00:00
Scott Rifenbark 4bdaa5c5ba kernel-dev: Small fixes.
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 198ce97a1158237056f035ade555ce04a6031c56)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-27 07:40:34 +00:00
Scott Rifenbark 1a74c797a0 kernel-dev: Updated FILESEXTRAPATHS example in 2.2.3.
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 4d85a363602eeb8c5f52064af9ffa1a47e541470)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-27 07:40:33 +00:00
Scott Rifenbark b77596aad9 ref-manual: Updates to scrub out 3.10 kernel.
Two areas affected by this change.  I updated the KBRANCH and
PREFERRED_VERSION variables in the glossary.  One change in the
KBRANCH	area was getting rid of the deprecated Crown Bay example.
I substituted in the Emenlow BSP.

(From yocto-docs rev: d7ed727ab5828dc257361c558a86a298bc537748)

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 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 a438aa3545 bsp-guide: Removed 3.10 and 3.17 kernel references.
Version 1.8 drops support of the 3.10 and 3.17 kernels.  The
emenlow example was using the 3.10 kernel recipe as a showcase
and it also listed the recipe in the directory structure.  I
removed it.  Additionally, the yocto-bsp create command was
prompting for the user to accept the default 3.17 kernel.  I changed
that to 3.19.

(From yocto-docs rev: 03bf66e961400b27b7e31d4a25776a11ce5719fd)

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 a0a1f173df ref-manual: Repositioned PNG files for context image.
I moved the PNG file for the context to be the first item displayed
for a given glossary term.  The PNG file must be negatively indented
though to look decent.

Fixes [YOCTO #5601]

These reformatting changes were needed because of brower incompatibilities
discovered with the existing solution for displaying these PNG files
with glossary terms.

(From yocto-docs rev: 06aeb6540c1343825369dd02006cb19e5a318d48)

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 0a8c08ed31 ref-style.css: Added a new style to support glossary hanging indent
I moved the PNG file for the context to be the first item displayed
for a given glossary term.  The PNG file must be negatively indented
though to look decent.

Fixes [YOCTO #5601]

These reformatting changes were needed because of brower incompatibilities
discovered with the existing solution for displaying these PNG files
with glossary terms.

(From yocto-docs rev: c84c4bc91b10e1443dc5aefc3a987a370d25432b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-24 23:36:12 +00:00
Scott Rifenbark 51bdf3ba5f ref-manual: Review edits to the AUTOREV variable.
Fixes [YOCTO #7306]

Some review updates to have better wording.

(From yocto-docs rev: 6f2d10c87128934958295111d10e038689fd94d3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:03 +00:00
Scott Rifenbark f03c8374a9 ref-manual: Updates to AUTOREV and SRCREV variable descriptions
Fixes [YOCTO #7306]

Added an example for when the user tries to inherit the most recent
version of software through use of the SRCREV variable.  When using
SRCREV = "${AUTOREV}" PV does not always get ${SRCPV}, which it need
in order to fetch the latest software.  I added a clarifying example
to explain this situation.

This commit also has a small change to fix a broken link to
EXTERNAL_TOOLCHAIN.  We do not documentat that variable so I removed
the link.

(From yocto-docs rev: 82f66a7193d0e40ffd65547223d4d9b10fdcf9bd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:03 +00:00
Scott Rifenbark 586992d24e toaster-manual: 2nd draft for review.
Fixes [YOCTO #6901]

This is the 2nd review draft of the manual.

(From yocto-docs rev: 9f541e4421e0e74e59e3b3da1896b6c1254daf08)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:03 +00:00
Scott Rifenbark 3dad9aee73 adt-manual, ref-manual: Detail on using an external toolchain.
Fixes [YOCTO #4907]

I created a new section in the toolchain chapter of the adt-manual
called "optionally Using an External Toolchain".  This provides
some fundamental information for the user that wants to use
an external toolchain.  Additionally, it references Mentor
Graphics Sourcery toolchain as an example.

In the ref-manual, I updated the TCMODE variable description to
better integrate the MGC Sourcery toolchain as the overriding
example.

(From yocto-docs rev: 51e9c3b88f7e5a16da2aa101589b0f2612fff11d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:03 +00:00
Scott Rifenbark 6d17aa00f9 ref-manual: Added 'debug-tweaks' fragmentation.
The image feature 'debug-tweaks' has been fragmented into three
separate areas of functionality that deals with handling empty
passwords and post-installation logging.  I updated the list of
image features appropriately and the description of 'debug-tweaks'
in the EXTRA_IMAGE_FEATURES variable.

Fixes [YOCTO #5344]

(From yocto-docs rev: ce0ab20472a75049298287cd05109f6e091b80bd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:03 +00:00
Scott Rifenbark f63a3b65fb ref-manual: Updates to some variables per review comments.
Updates to the following:

  BUILD_ARCH
  SOURCE_MIRROR_FETCH
  TARGET_PREFIX
  SDK_PREFIX
  SDK_SYS (I added this one new).

(From yocto-docs rev: ad5f9b56dc912783b415b30604456bd5071f9721)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:02 +00:00
Scott Rifenbark da3a4890d1 ref-manual, mega-manual: Adjustments to variable context images
Fixes [YOCTO #5601]

Discovered that the solution I had to display a small PNG file
to indicate the context a variable is used in the build system
was not displaying properly in the ref-manual variable glossary
when using the Chrome browser.  The solution was to adjust some
settings in the CSS file and place the image after the term.
This allowed me to dump the webkit stuff that I had inserted
into the CSS file styles to make it work in Mozilla, which
ended up not working in Chrome.

Additionally, I needed to update the 'define-generic.png' file to
have less white space on top as part of the figure.  Note that
this commit adds the figure to Git for tracking as well.

(From yocto-docs rev: 59a1295aeb1c866f330634907ad28642a997cd63)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:02 +00:00
Scott Rifenbark 26a3df450e ref-manual: Updated the ASSUME_SHLIB variable.
Applied a different example from Paul.

(From yocto-docs rev: b21ef6a792361eb0893ee17524794fba3bed885c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:02 +00:00
Scott Rifenbark 57270588f8 ref-manual: Added new variable description for BUILD_VENDOR.
(From yocto-docs rev: d38bf6819c5a2c4e7aea0ba3a741c18365c760ff)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:01 +00:00
Scott Rifenbark 3c3e856094 ref-manual: Added variable description for BUILD_PREFIX.
(From yocto-docs rev: d4ab1886cb5c4b65afa2c0e8e2e1b2ce567b4d2e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:01 +00:00
Scott Rifenbark d089b7c7f2 ref-manual: Added new description for SDK_VENDOR.
(From yocto-docs rev: 20d1d9145926b459dff39bfe39d71b78a25cd387)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:01 +00:00
Scott Rifenbark b0ed0bc630 ref-manual: Edits to the SDK_SYS variable.
(From yocto-docs rev: 520ded3e50a0299164b3b941cca99b677fa83dad)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:01 +00:00
Scott Rifenbark 95253222d0 ref-manual: Added new variable description for SDK_SYS.
(From yocto-docs rev: cc5d9a1a090023f79440f6c1d60efab53b1aef21)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:01 +00:00
Scott Rifenbark d8acb872c5 ref-manual: Added new description for SDK_OS.
(From yocto-docs rev: f71c032bb51608ab2fe8e5735c423a8a86e6d37e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:01 +00:00
Scott Rifenbark 35612bfd32 ref-manual: Created new SDK_PREFIX glossary entry.
(From yocto-docs rev: c72b97ec58e609d63920c431b5948c8dd09d2595)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:17:01 +00:00
Scott Rifenbark 0410f36860 ref-manual: Updates to TARGET_PREFIX and STAGING_DIR_HOST variables.
Small typo fix for STAGING_DIR_HOST.  Some re-wordings for
TARGET_PREFIX.

(From yocto-docs rev: 919a13436de6ea150f685a50b6ecc8154b75da86)

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 32f6b13293 ref-manual: Updated the SOURCE_MIRROR_FETCH variable description.
Did a significant re-write on this description as I had the
meaning pretty far off.

(From yocto-docs rev: 6bcc63ac83f0aeb3d3d06db33c7a8f010c737312)

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 022f5af654 ref-manual: Updated the Date variable description.
Re-worded the way you say the date.

(From yocto-docs rev: 3c6b51fb474628954654f2f1290509a78a48a1fb)

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 a7f992eddc ref-manual: Updated the BUILD_OS variable description.
Fixed the meaning up.

(From yocto-docs rev: 1b057475acd2bf33bb6fa3bd03e85a415697873f)

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 a89f895a79 ref-manual: Updated the BUILD_ARCH variable description.
Better wording.

(From yocto-docs rev: f048485fb69c4355d01ad1299f5d9187d767806a)

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 0ba32a62ae ref-manual: Updated the ASSUME_SHLIBS variable.
Added an example.

(From yocto-docs rev: 7a22c2941618f29ad89087c186ae2af6f0c07323)

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 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 8e8d961527 ref-manual: Updated the following variables based on review comments:
ASSUME_SHLIBS
  BBINCLUDELOGS_LINES
  BUILD_ARCH
  BUILD_OS
  CACHE
  DATE
  PACKAGE_INSTALL_ATTEMPTONLY
  PRIORITY
  SOURCE_MIRROR_FETCH
  TARGET_PREFIX
  TARGET_SYS
  TIME
  CROSS_COMPILE

(From yocto-docs rev: c55ab3cb5ef9d517ea5f29d2be8999cc1dc7e085)

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
Scott Rifenbark 21fcd57042 ref-manual: Updates to SDKTARGETSYSROOT and PKG_CONFIG_PATH variables.
Applied some review edits to these two variable descriptions.

(From yocto-docs rev: fb1eb903b9bcc8b0bb67e72c795a1dd602143589)

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
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
Scott Rifenbark ef959e61c4 ref-manual: Added "leakage" FAQ entry.
Fixes [YOCTO #6852]

I added a new FAQ entry to address situations where during a
native build, the build fails due to previously installed stuff
on the system from /usr/local/include and /opt.  The entry
tries to cover "leakage" issues in general but calls out the
specific case involving libiconv and iconv.h.

(From yocto-docs rev: 2c09c7ee0970189953bfbbdcaac49a1ebe8482fe)

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
Scott Rifenbark a0999ab4df toaster-manual: Updated tar contents to not include the PDF file.
(From yocto-docs rev: b80931a3930ac4eda8daec37dc3de0f1d4d3844e)

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
Scott Rifenbark 481c1788bc mega-manual: Edits to fix titling
The way the mega-manual used 'xinclude' to suck in the other
YP manuals was to suck in the root XML file.  The problem with
this was that the root XML file for each subsequent book would
include front-matter information.  The front-matter information
included an .authorgroup style, which caused the new mega-manual
title displayed at the very top to be also re-displayed with
a subsequent manual's title.  These changes altered the strategy
for using 'xinclude' to pull in the various YP manuals.  Rather
than pull in the root XML file for a given manual, individual
chapters are pulled in that comprise a given manual.  A slight
side-effect is that chapter numbering is sequential from top to
bottom in the mega-manual, which I suppose is better as it is
being presented as an entire manual anyway.

(From yocto-docs rev: 61cc9f2f92900894ef09ff13e1e92ebe30a17be3)

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
Scott Rifenbark 0c4e31cef1 mega-manual: Fixed reference to style sheet.
the customization layer for some reason was referencing the
ref-style.css file instead of the mega-style.css.  I changed this
over.

(From yocto-docs rev: f47e14c27cde0a436a9ffbf26ca425951eae5d4e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:58 +00:00
Scott Rifenbark 1b719fa724 toaster-manual: Cleaned up the intro chapter
Fixes [YOCTO #6901]

I removed some left over stuff from the intro that should not
have been in there.

(From yocto-docs rev: 91d1ee2b4433312e0f94e1ac99f8ec0e14ef6ac7)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:58 +00:00
Scott Rifenbark 6d512bd691 mega-manual: Updated sed file to include the toaster manual.
Added logic to string search and fix links in the Toaster Manual
part of the mega-manual.  This keeps the links correct for the
mega-manual.

(From yocto-docs rev: f93b5a187984949129db16b638935b678fd344a1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:58 +00:00
Scott Rifenbark dd62d577be mega-manual: Added toaster-title.png and code to include toaster-manual
Fixes [YOCTO #6901]

Added the toaster-title.png file to the mega-manual/figures
folder so the Toaster title would show up in the mega-manual.

Added lines so that the mega-manual would include the Toaster
manual file to the mega-manual.

(From yocto-docs rev: 5a4a67e4f140802da133b7bcb480c84b4a8edb63)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:58 +00:00
Scott Rifenbark ab2007dc4e Makefile: Removed default PDF creation of Toaster Manual.
(From yocto-docs rev: 7cceb7b0a0f53a4207070ff369bec8a3a6ceb135)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:58 +00:00
Scott Rifenbark 9d033d83cc toaster-manual: Added two chapter files.
Fixes [YOCTO #6901]

These are the second and third chapters of the Toaster Manual.

(From yocto-docs rev: 6ff4e3dfff391efdbb0f36dc6800bf115abcfc92)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:58 +00:00
Scott Rifenbark e2f004faa3 toaster-manual: Changed from "current" to "1.76.1" XSL templates
Fixes [YOCTO #6901]

Makes it so the boxes appear around the manual revision table.

(From yocto-docs rev: f3ee2bc1ef957a585d0f814b91451a8460dec8c1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:58 +00:00
Scott Rifenbark 7fe19fcb94 toaster-manual: Edits to the intro chapter
Fixes [YOCTO #6901]

(From yocto-docs rev: 633368738e244313168edab86e843b8895e818e3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:57 +00:00
Scott Rifenbark 464c1d9f92 toaster-manual: Added two chapters to the manual's book file.
Added both chapters that follow the intro chapter to the root
file so they will build as part of the book.

Fixes [YOCTO #6901]

(From yocto-docs rev: 37967896f12471d34188cd532e00211ca665910b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:57 +00:00
Scott Rifenbark 0e3cb25ad7 toaster-manual: WIP - Some placeholder introductory text.
(From yocto-docs rev: 50af668137ec11105f08398bf92649217f75aad3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:57 +00:00
Scott Rifenbark cd31b931e3 documentation: Support files to build Toaster Manual.
Changes to the files that support building out and publishing
the Toaster User Manual:

 * poky.ent - Added a new variable YOCTO_DOCS_TOAST_URL that can
   be used in other manuals to link to sections with the Toaster
   User Manual.

 * Makefile - Added a section of code to build out the Toaster
   User Manual.  Currently, no eclipse support is added as I don't
   think we want to cross into that development environment with
   Toaster.

(From yocto-docs rev: 35ea6656265d61024d5db36a534a7250f783956a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:57 +00:00
Scott Rifenbark 430237631e toaster-manual: Initial file structure for new Toaster User Manual.
For this commit, the manual only has a single "intro" file with
placeholder text only.  Graphic for title page is in place,
stylesheet is in place, all files needed for a successful, initial
build of the new manual.

(From yocto-docs rev: 99416caa943fe6af13292b18bda53522ce3576d6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:57 +00:00
Scott Rifenbark 75206ccfd2 ref-manual: WIP - test for YOCTO #5600
(From yocto-docs rev: 3cd7d367d7ccb8314fea422303701f275d21d87a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:57 +00:00
Scott Rifenbark d8e2874916 mega-manual: New PNG file for mega-manual title page.
(From yocto-docs rev: e3d8af0c6cd88e76f7cf2bcff82e1fffd7a46589)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:57 +00:00
Scott Rifenbark f1bb814d50 ref-manual: Fixed icecc example code
Fixes [YOCTO #6912]

The example used to make sure builders use the same sstate
signatures regardless if they use icecc or not was incorrect.
I updated the INHERIT_DISTRO line of the example to use the
append part in the name so it appends the icecc as suggested
by the bug submitter.

Reported-by: Peter Bergin <petan679@gmail.com>
(From yocto-docs rev: 1f6b2f152202ab6e0be3026af3275f67bdb40d16)

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 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 0a54446d2f mega-manual, Makefile, poky.ent: Added front matter to mega-manual
Put in proper front matter for the mega-manual.  This effectively
creates a real title for the manual as well as a brief abstract
that explains why this behemoth exists.

(From yocto-docs rev: 26c78f0b00762846a839fbfc9ba969b7aa5d5b58)

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 b876909269 adt-manual, ref-manual: Review edits for xcross-toolchain additions.
Mark Hatle reviewed the section and I updated some things based
off his input.  A rewrite to the "Makefile-Based Projects" section
to get it technically correct.  Also, removed all SDKROOT
documentation from both the adt-manual and ref-manual.

Fixes [YOCTO #7133]

(From yocto-docs rev: dd785777834611d94868a3774f2eb21ffc081b1a)

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 93052c9900 adt-manual: Remaining mods to clarify xtoolchain env use
Fixes [YOCTO #7133]

Edits to add more clarification for use and role of the
cross-toolchain environment variables established when a user
runs the cross-toolchain environment setup script.

(From yocto-docs rev: 2c3fa3a838a3a8970cd112935e903c96552ed06b)

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 05feb9679e adt-manual: Added file name for reference to the config file.
(From yocto-docs rev: 080af576473f886a9325cfb7514e0cc7740dec35)

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 ce8ead36bb adt-manual, ref-manual: Added missing variables and cross-links
I added the ADKROOT, GDB, CROSS_COMPILE, and CONFIGURE_FLAGS
variables to the glossary.  Also added appropriate cross-reference
links from the adt-manual to those new variables.

(From yocto-docs rev: 812367e3b915b99d900b7934c4d5d409f393e814)

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 9c27a91d61 adt-manual: Added a list of variables defined for ADT setup
Fixes [YOCTO #7133] partially

At the end of the section that first mentions running the
environment setup script for the cross-toolchain, I added a list
of environment variables that are defined as a result of running
the script.

(From yocto-docs rev: f1b66a09676d1b5c055e7ae7e7cc9a7f45cb9b67)

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 4d12f8dd83 adt-manual: Expanded note with a user configuration reference.
The note in the "Getting the ADT Installer Tarball" section has
a note that warns the user to be sure they have local.conf
properly configured before baking out the adt-installer.  I
provided a linked cross-reference into the section of the
ref-manual that takes a closer look at user configuration.

(From yocto-docs rev: d13c044b65543a2f15fbda0266d2e30a14cfd19f)

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 77a62835d2 adt-manual: Added missing period.
(From yocto-docs rev: 8a47c17cecf023c3eb021108a1830394cb8bf103)

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 9dff02bc21 adt-manual: Added some reasoning behind sourcing the xtoolchain env script
The intro to the "installing the ADT and Toolchains" section notes
that the user must source the cross-toolchain environment setup
script.  I added a clause stating that this establishes environment
variables.

Fixes [YOCTO #7133] partially.

(From yocto-docs rev: e9777012d935ced8fd82209543569aaa70ab1832)

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 cc06786545 adt-manual: Reword for how user-space tools are provided.
The "User-Space Tools" section incorrectly stated that user-space
tools are provided as part of the distribution.  The Yocto
Project is not a distribution.  So I changed to say that they
are provided as part of the Yocto Project.

(From yocto-docs rev: 03dd97b68a1900959aa51ad6a17547822e8392fc)

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 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 b0639bc8ae adt-manual: Added cross-reference to OE build system term
First occurrence cross-reference added.

(From yocto-docs rev: 91db235e935e799c2d4cc301ef799cb581704020)

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 568224beef adt-manual: Fixed hyphenation issue.
(From yocto-docs rev: a0b11ddf7ce4d12f330fcddd21ee127b11bf0ace)

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 3ac28906ba ref-manual: Removed the DISTRO_PN_ALIAS variable.
(From yocto-docs rev: 102a41d94c22266b7209b29e2a6dd7cd11647e8a)

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 e0dbcbf056 ref-manual: Edits to SOURCE_MIRROR_FETCH variable and typo fix
Updated the description for the SOURCE_MIRROR_FETCH variable
so that it actually made sense.  The [doc] string was also
updated.

Found a typo elsewhere that was fixed when I spell-checked the
file.

(From yocto-docs rev: 609f09231815f80ea3fd800e0b5d9a4fbad110cc)

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 9a47967a18 ref-manual, mega-manual: Updated buildhistory example figure
Scrubbed the eglibc from the buildhistory directory and
also replaced with an i586 example.

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:52 +00:00
Scott Rifenbark 84647d586e ref-manual: scrubbed eglibc
Removed the references to eglibc and replaced them with glibc.
This involved updating the example buildhistory output with
current examples as well

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:52 +00:00
Scott Rifenbark 84ee65aef0 ref-manual: Edits to the TCLIBCAPPEND variable.
(From yocto-docs rev: da3327f5fb5a89ff94c90bd6260b8e6f8adbcd1a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:52 +00:00
Scott Rifenbark 328b3bdbfd ref-manual: Added 21 new variable to glossary.
I added the following:

 ASSUME_SHLIBS
 BBINCLUDELOGS_LINES
 BUILD_ARCH
 BUILD_OS
 CACHE
 CONF_VERSION
 CVSDIR
 DATE
 FONT_EXTRA_RDEPENDS
 GITDIR
 HOST_ARCH
 HOST_OS
 HOST_PREFIX
 HOST_VENDOR
 PACKAGE_INSTALL_ATTEMPTONLY
 PRIORITY
 SOURCE_MIRROR_FETCH
 SVNDIR
 TARGET_PREFIX
 TARGET_SYS
 TIME

(From yocto-docs rev: 76e5f7ca78db63b63ac6357218ef153e064e605f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:52 +00:00
Scott Rifenbark 70a2007b67 ref-manual: New variables added to the variable glossary
Fixes [YOCTO #7133]

This goes toward fixing the bug but not completing it.  I have
added the following variables to the variable glossary:

 SDKTARGETSYSROOT
 PKG_CONFIG_PATH
 CC
 CXX
 CPP
 AS
 LD
 TARGET_PREFIX
 AR
 STRIP
 OBJCOPY
 OBJDUMP
 RANLIB
 NM

(From yocto-docs rev: c9d9e422684dad7cdc81db309235d0d1751ac88a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:52 +00:00
Scott Rifenbark eafdfbfb37 tools: Added new file update-documentation-conf
This is a Python script that a developer can run to create a .patch
file that when submitted to oe-core will update the documentation.conf
file.  The update will bring the [doc] file variable descriptions
in line with what is in the ref-manual variables file.

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:52 +00:00
Scott Rifenbark 10b2504613 ref-manual: Updated the [doc] string to include the & character.
(From yocto-docs rev: 71bc09c2c424d5c4a901a4b8889d83f7d6d3d76f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:52 +00:00
Scott Rifenbark c9b7007f27 ref-manual: Added warnings about using package_tar
This option to the PACKAGE_CLASSES variable is broken and not
supported.  I added several warnings saying such.  We opted to
keep the documentation rather than eliminating it completely to
prevent questions should someone find the code and wonder why
it is not documented.

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-02-17 15:16:52 +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 0a367c514b ref-manual: Updated text for speeding up builds.
The "Speeding Up the Build" section presents a list of items the
user can consider when they want to tweak the build speed.  One of
the items is the three variables BB_NUMBER_THREADS, BB_NUMBER_PARSE_THREADS,
and PARALLEL_MAKE.  It was noted that the system figures out
the optimal settings for these now and it is pretty useless to
override the settings.  However, the introducing sentence to the
list is still valid due to other considerations that go beyond these
three variables.  So, to update the text, I have re-emphasized the
role of these three variables for quickening the build time.

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

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