Commit Graph

1576 Commits

Author SHA1 Message Date
Scott Rifenbark 818e439cf5 ref-manual: Applied review comments to logging mechanism section
Fixes [YOCTO #9950]

I Provided a suggested introductory sentence and a better link to
the logging.class file, which is near the end.

(From yocto-docs rev: 6f296266b35f17792510d6a01f5640ba30818a22)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-08-01 12:14:59 +01:00
Scott Rifenbark aae4c2a629 ref-manual: Updated the "Recipe Logging Mechanisms" section
Fixes [YOCTO #9950]

Added more detail on the functions for logging.

(From yocto-docs rev: b7ed4d84ae5221765201fe661af3741fb01da738)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:52 +01:00
Scott Rifenbark 451334a841 ref-manual: Applied review changes to the DEPENDS variable.
Updated the note with some formatting and grammar changes.

Fixes [YOCTO #9933]

(From yocto-docs rev: afef28ae894c313f85ddbaeef8b0abbc2700ba2c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:52 +01:00
Scott Rifenbark bdf9003cfb ref-manual: Added review changes to BBCLASSEXTEND description
Fixes [YOCTO #9909]

Added some technical clarifications to the existing note to be clear
about what is causing the limitations in this case.  Applied some
formatting fixed to for the use of the include word.

(From yocto-docs rev: cbbd960d8665d9fb6b92698c14728d1c0bcc659f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:51 +01:00
Scott Rifenbark acdfb5f3cc ref-manual: Added notes to the DEPENDS variable description.
Fixes [YOCTO #9933]

Added two notes to help clarify how DEPENDS works with pre-compiled
objects.  There are some details that trip people up.

(From yocto-docs rev: 06917e97adf24816b0aee6fdfdd14aa79d4c6ab2)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:51 +01:00
Scott Rifenbark 640181cce8 ref-manual: Added clarifying note to the BBCLASSEXTEND variable.
Fixes [YOCTO #9909]

Added a note that talks about how the BBCLASSEXTEND mechanism
adds recipe variants.

(From yocto-docs rev: a05990ecb760519a685a1c5ddcf2ce3e048bfbf2)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:51 +01:00
Scott Rifenbark 48336f5139 ref-manual: Added cross-referencing to tasks and dependencies
Fixes [YOCTO #9861]

Placed some section links into the "Tasks" and the "Dependencies"
sections of the BB manual from several areas:

 * The "Normal Recipe Build Tasks" section
 * The variable description for DEPENDS
 * The variable description for RDEPENDS

(From yocto-docs rev: d96347fdb4c3d5a34695f20e995f165c5ba91c32)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:51 +01:00
Scott Rifenbark cf3b80b0c8 ref-manual: Added new glossary entry for REMOVE_PKG_SUPPORT.
Fixes [YOCTO #9899]

New variable description added.

(From yocto-docs rev: 95b740d719a7a6ffe3a06a1f152af4d877ee08c7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:51 +01:00
Scott Rifenbark 444a80a355 ref-manual: Added a new section on setscene task variants
Fixes [YOCTO #9251]

I added a new section on the task variants for setscene, which uses
the shared state cache.  The section describes the BitBake processing
that helps the build system to not have to build everything from scratch.

(From yocto-docs rev: 6aa0e6b837de14dd7d6c5ef34328bbf268dd6d71)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:49 +01:00
Scott Rifenbark 4fb1961acf ref-manual: Fixed typo in the "Shared State" section.
Fixes [YOCTO #9823]

The do_deploy[sstate-inputdirs] string was wrongly
do_deploy[sstate-inputsdirs].

(From yocto-docs rev: 49e7cb239f4f4f70dc5738686f1bca135772bcbe)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:49 +01:00
Scott Rifenbark b67f865e67 ref-manual: Review edits to the PR variable in glossary.
Fixes [YOCTO #9843]

Some minor rewordings and removal of a stray comma.

(From yocto-docs rev: 0b0c8b0b1c4edb86eb2b20c73ffb83d640f6b916)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:49 +01:00
Scott Rifenbark e5fabb90dc ref-manual: Updated the RDEPENDS variable description in the glossary
Fixes [YOCTO #9380]

Updated the shlibdeps description for this variable to try and
satisfy automatically added version restrictions.

(From yocto-docs rev: d94de0b24591206620c83a9022a9d813141a7637)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:49 +01:00
Scott Rifenbark b66e84e19d ref-manual: Updated the PR variable description.
Fixes [YOCTO #9843]

The variable description was very brief.  These changes added some
substance to the description and how the OpenEmbedded build system
uses the variable.

(From yocto-docs rev: cc9117d4e16c56dd54f81804fda94561e61d91a7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:49 +01:00
Scott Rifenbark 77031ba572 ref-manual: Updated the flag descriptions for shared state details
Fixes [YOCTO 9823]

I added more details to the explanations of how shared state is
implemented.  Included a bulleted list of the various statements
of code to help explain flags and settings.

(From yocto-docs rev: 518352f88c8dda16f2915a7bb9901ffd7686d739)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:48 +01:00
Scott Rifenbark fc518b5a48 ref-manual: Updated the DISTRO_FEATURES description of Bluez5
Edits to explain that by default, DISTRO_FEATURES backfills
bluetooth support with Bluez5.  If the user wants to use the
Bluez4 feature, they need to backfill consider Bluez5.

(From yocto-docs rev: 4e8b34c8c5841cdc1cae564decae4689ae4f2b11)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-07-19 15:04:48 +01:00
Scott Rifenbark 11b6dd1e81 ref-manual: Updated SSTATE_MIRRORS examples to match reality
Fixes [YOCTO #9773]

Updated two examples that set SSTATE_MIRRORS so that they match the
changes made by YOCTO #3220.

(From yocto-docs rev: e07674cd0665c485173eaa05c4072c287411b81f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-21 12:59:07 +01:00
Scott Rifenbark fadcb31841 ref-manual: Fixed a typo for installing "python3-git"
Fixes [YOCTO #9712]

(From yocto-docs rev: 0ece224ec34b3b441af7a3a7a8c076d5cdce7c4d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-21 12:59:07 +01:00
Scott Rifenbark 6b3b444c35 ref-manual: Updated the UPSTREAM_CHECK_* variables.
Fixes [YOCTO #9671]

(From yocto-docs rev: 0f7e086e126d210cde0bd0cbe3e56d0808138e28)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-21 12:59:07 +01:00
Scott Rifenbark 52fc567988 ref-manual: Added note about installing Git-Python package
buildhistory-diff tool requires the Git-python package.
I added a note indicating this.

Fixes [YOCTO #9712]

(From yocto-docs rev: 2187df01f784b40608b30f62d19888cf183e67e9)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-21 12:59:07 +01:00
Scott Rifenbark f33db8b6eb ref-manual: Updates to the UPSTREAM_CHECK_* variables
I applied some grammar edits and re-wordings as directed by
technical reviews.

Fixes [YOCTO #9671]

(From yocto-docs rev: b5a5d3d3b311cb83ed61bfd247fbf802027fe5c4)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-21 12:59:07 +01:00
Scott Rifenbark cd7f787174 ref-manual: Edits to UPSTREAM_CHECK_* variables.
Fixes [YOCTO #9671]

Applied some review comments to these three variables.
Edits to be sure to qualify that the variables only to recipes
who inherit the distrodata class.

(From yocto-docs rev: 1b094b0567fa75d1c77da7ec04641d034f29272d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-21 12:59:06 +01:00
Scott Rifenbark c735ade998 ref-manual: Added descriptions for three UPSTREAM* variables.
Fixes [YOCTO #9671]

Put in descriptions for the following variables:

 * UPSTREAM_CHECK_GITTAGREGEX_pn
 * UPSTREAM_CHECK_URI_pn
 * UPSTREAM_CHECK_URI_pn

(From yocto-docs rev: e00470cbf98714236f3197dd538371488d8f03fb)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-21 12:59:06 +01:00
Scott Rifenbark 44f29bf89a ref-manual: Updated the INHIBIT_PACKAGE_STRIP variable
Fixes [YOCTO #9553]

Added detail to this variable description.

(From yocto-docs rev: 35407b9db582ebc23be89a6f9bc7b0ad9ab90979)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-21 12:59:06 +01:00
Scott Rifenbark ceb7c51746 ref-manual: Fixed *[doc] string for INHIBIT_PACKAGE_DEBUG_SPLIT
The string was a copy paste error.  It was using the string
for INHIBIT_PACKAGE_STRIP.

(From yocto-docs rev: d2efc36a7bc39b3fb596286dcde5efa1b8fead7c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-06 22:53:35 +01:00
Scott Rifenbark 6c5fea2171 documentation: Prepared manuals for a 2.2 release.
* Updated poky.ent to have the appropriate 2.2 variables
* Updated all manual revision tables to have a new entry for
  2.2 - used "Sometime in 2016" for the date.
* Updated the mega-manual.sed file to process internal links
  for 2.2.

(From yocto-docs rev: 2acd49ee197e3e3e725f4cb8cc432437afd8646b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-06 22:53:35 +01:00
Scott Rifenbark 8fc310c90f ref-manual: Added BlueZ version 5 feature to distro feature section.
(From yocto-docs rev: c7055f313a127bc8ed65a93ed7bea21775518567)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-06-06 22:53:35 +01:00
Scott Rifenbark a1d67b2418 ref-manual: Added GObject Introspection to 2.1 migration section.
(From yocto-docs rev: 0b9ee8da66ff81e0724465f18b0323f1216cb9fa)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-29 07:48:22 +01:00
Scott Rifenbark ab3147e995 ref-manual: Added new 2.1 migration misc. Change
Lists packages removed if package-management was not in
IMAGE_FEATURES.

(From yocto-docs rev: 45768d661b800782e32b76b4fa7efa0f70cb7e47)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-29 07:48:22 +01:00
Scott Rifenbark d4c4b2f7b8 ref-manual: Applied 2.1 Migration section review edits.
(From yocto-docs rev: d641e8404d13aa96f23c537045d1ce165a0fe119)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-29 07:48:22 +01:00
Scott Rifenbark 3f55657134 ref-manual: Fixed a grammar consistency error
Referring to multiple options that function the same as
two separate options.  I had two successive sentences that were
inconsistent.

(From yocto-docs rev: 291fa846dba2bfcffae9d0538eba65df71c1092b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-29 07:48:22 +01:00
Scott Rifenbark 01df6a7c77 ref-manual: Applied review edit comments to the 2.1 migration section.
(From yocto-docs rev: 50eb2e0bcd4afaa2c097b4fa121051920cf21053)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-29 07:48:22 +01:00
Scott Rifenbark 9f970b6bc1 dev-manual, profile-manual, ref-manual: Purging Oprofile stuff
Fixes [YOCTO #9264]

Several occurrences of tools-profile and the like had to be dealt
with.

(From yocto-docs rev: 62f45579970f47d22dabe921a51c663059a04576)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:25 +01:00
Scott Rifenbark 1d93104d0e ref-manual: Added description for the testsdk.bbclass.
(From yocto-docs rev: 3eed6f3e244303de02cc52c16a0745b808d79e39)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:25 +01:00
Scott Rifenbark db47094be5 ref-manual: Updated the remove-libtool.bbclass description.
(From yocto-docs rev: de35e72836ebc75aa1f9614fa034631dd7d2a611)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:25 +01:00
Scott Rifenbark a16eecac5b ref-manual: Added gobject-introspection.bbclass description.
(From yocto-docs rev: e6c40815c2a6ea3c94126ef43e586a01cb721ea8)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:25 +01:00
Scott Rifenbark 3e761b443f ref-manual: Added reference for npm.bbclass.
(From yocto-docs rev: 7bf6401ad16ad83743d82a3b7592f77237c453f8)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:25 +01:00
Scott Rifenbark 5e50157034 ref-manual: Fixed typo in the nopackages.bbclass description
(From yocto-docs rev: c73d36e01b501471d24a174a8be77f1798d0ea5e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:24 +01:00
Scott Rifenbark f7b68c7102 ref-manual: Added description for bash-completion.bbclass
(From yocto-docs rev: a3b29e84b5d521d70585b8a2a7bd989c643cd310)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:24 +01:00
Scott Rifenbark ece900a6e8 ref-manual: Added nopackages.bbclass description. Fixed stray typo.
(From yocto-docs rev: aa34f219237d6490fc0061ecd0644d4093957729)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:24 +01:00
Scott Rifenbark 9143e9ea25 ref-manual: Added description for the INSTALL_TIMEZONE_FILE variable.
(From yocto-docs rev: 768935078510bcf4300ff5e05e87c9bed10a0cde)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:24 +01:00
Scott Rifenbark 6391dbfe48 ref-manual: Updated the PREFERRED_PROVIDER variable with a note.
(From yocto-docs rev: 5d3a3e9ea8670f784f9c06cb244a9d5981bb1e76)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:24 +01:00
Scott Rifenbark 6d86f7a0a3 ref-manual: Dropped references to the autotools_stage class
(From yocto-docs rev: f13f1925f1ea47a87730844109ed224b16c1f587)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:24 +01:00
Scott Rifenbark 4d5ff5e075 ref-manual, dev-manual: Scrubbed boot-directdisk and bootimg classes
These classes have been removed.  The bootimg class was sucked
into the image-live class.  I removed the reference sections to
both classes and fixed the references throughout the manual set
as needed.

(From yocto-docs rev: 649d56b54987580039cbd52f54642112f810ffad)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:24 +01:00
Scott Rifenbark cd2aaaa310 ref-manual: Updated the uninative.bbclass description.
Dropped the "experimental" verbiage and added real detail.

(From yocto-docs rev: ca63ab4bac2885037741afdc78ee307233159a2e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:24 +01:00
Scott Rifenbark e975d26e84 documentation: Converted "meta-yocto" to "meta-poky"
Occurrences in many manuals and one figure.

(From yocto-docs rev: 26d30cd162083c62216fb4ab526d0b231f453de1)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:24 +01:00
Scott Rifenbark e00a62c905 ref-manual: Added the migration section for 2.1
(From yocto-docs rev: ed1eec9139d8a9caf32f0cc896f651cafecece4f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:23 +01:00
Scott Rifenbark 02db9e6031 yocto-project-qs, ref-manual: Upgraded minimum Git requirement
This minimum Git requirement is now version 1.8.3.1.

(From yocto-docs rev: c68aa31442f7ac58a6f597f3074416afaab95882)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:23 +01:00
Scott Rifenbark 989841f794 ref-manual: Added rootfs-postcommands class description.
(From yocto-docs rev: 237f8c8fbefc0ad753d47d891b24a49e0e0c6b5e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:23 +01:00
Scott Rifenbark d06b34333c ref-manual: Updated the EXTRA_OEMAKE variable description.
Provided information about the new default "".

(From yocto-docs rev: 75ab9805614fc9501191eef0000c7a9214765392)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-18 16:28:23 +01:00
Scott Rifenbark 3831ca0dee documentation: Updated release date in manual history tables.
Updated to "April 2016" for all manuals that use this table.

(From yocto-docs rev: 4d3753cc92c446668b0c383736c2071e24e53dd2)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-06 23:11:59 +01:00
Scott Rifenbark b590fab4a1 dev-manual, ref-manual, sdk-manual: Removing oprofile references.
Fixes [YOCTO #9264]

I handled the occurrences of "oprofile" and "tools-profile" throughout
as I could.  They are not all done yet.  These in this commit have
been removed.

(From yocto-docs rev: d76e264ea210846ad8080134bacd56462ba69d24)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-06 23:11:59 +01:00
Scott Rifenbark d57fe7c98c ref-manual: Updated the PREFERRED_VERSION variable description.
Fixes [YOCTO #8595]

Applied some wording changes as part of the review process from
Richard Purdie.

(From yocto-docs rev: 3c4fc3cbdecb7e3c8287a915b82bc5469288d5db)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-06 23:11:58 +01:00
Scott Rifenbark 763ae4e191 ref-manual: Updated verbiage on proxy handling
Fixes [YOCTO #9313]

Update the DL_DIR variable description to add a cross-reference
to the wiki page that talks about working behind a firewall.

Updated the 14.12 FAQ entry with new information about working
behind the firewall.

(From yocto-docs rev: 056e6881951023e62a7363ba60fe73cd6d2932b6)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-06 23:11:58 +01:00
Scott Rifenbark a1295ed80f ref-manual: Updated PREFERRED_VERSION variable description
Fixes [YOCTO #8595]

Added some examples on how to force the version.

(From yocto-docs rev: 4a98ce1ed623cd9763731453316f2ff8d8b8b82a)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-06 23:11:57 +01:00
Scott Rifenbark 879eec203b ref-manual: Updated debugging tips and tricks
Fixes [YOCTO #9336]

I updated the "Debugging" section within the "Tips and Tricks"
section.  The list of items did not provide detail on two
BitBake command-line options you could use to dump out
signature data into .sigdata files.  Also, the .sigdata files
were incorrectly referred to as .siginfo files.

(From yocto-docs rev: 7836c386f4f7c011de710b6ec9f6be13045dc559)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-04-06 23:11:57 +01:00
Scott Rifenbark b44d9e553a ref-manual: Created distrodata and checkpkg tasks, updated distrodata class
Fixes [YOCTO #7894]

I created two new task reference sections: distrodata and
checkpkg.  Also, updated the distrodata class description to
reflect the presence of these new tasks.

(From yocto-docs rev: 3896cbf640d296dafb5eda37f89bba31a47ca8a5)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-23 21:56:10 +00:00
Scott Rifenbark c3946bcaa6 dev-manual, profile-manual, ref-manual: Updates to remove meta-toolchain
The term "meta-toolchain" is legacy now.  I went through and removed
its use except for where it appears still as output from the
oe-init-build-env script.

(From yocto-docs rev: 1cc134060459278997d57f1293f54091c5404d85)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-23 21:56:09 +00:00
Scott Rifenbark b31bf7c68b ref-manual, sdk-manual: Changed section heading.
Changed the heading for "Optionally Building a Toolchain
Installer" to "Building an SDK Installer".  This changes the
heading and many references to that heading.

(From yocto-docs rev: 97d8cd34d0dd0993b1b1135bb75f2212bb46878a)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-23 21:56:09 +00:00
Scott Rifenbark 670735e392 ref-manual: Added some SDK manual support to introduction
(From yocto-docs rev: 6021a1024b51ab65659e132870eb75d1bf53aedb)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-23 21:56:09 +00:00
Scott Rifenbark 4c5157f7dc ref-manual: Resolving a conflict
(From yocto-docs rev: b364516928d04da38ef3188f07f190ffac64762b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-23 21:56:08 +00:00
Belen Barros Pena d06c7b8ce6 documentation: remove all references to Hob
Hob and the packageinfo class have now been removed from the
code base. This patch removes all references to:

* Hob
* meta-hob
* packageinfo and
* BBLAYERS_NON_REMOVABLE

from the documentation.

So long, Hob, and thanks for all the fish.

(From yocto-docs rev: 6a1ba2761d5c2ec1072616ce3d791787f1b1b2a7)

Signed-off-by: Belen Barros Pena <belen.barros.pena@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-23 21:56:06 +00:00
Scott Rifenbark be8af376b1 ref-manual: Updated COREBASE_FILES variable.
Applied review comments.  Fixed some wording.

(From yocto-docs rev: 0d1ccaf3dadf890498b3f2b090ece276a537b43c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-23 21:56:05 +00:00
Scott Rifenbark 01554725f5 ref-manual: Updated "Application Development SDK" section.
Applied review comments to the section.

(From yocto-docs rev: 83871d0f6cd996be2d3476bdfc0f2adef9ff52a7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:07 +00:00
Scott Rifenbark 443846088a ref-manual: Applied review edits to several SDK variables.
(From yocto-docs rev: 3d198bc298e6c88ba229f10b96a8e5faf0727897)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:06 +00:00
Scott Rifenbark 3c727ff843 ref-manual: Updated "Cross-Development Toolchain Development" section.
Updated the note to have a bit better wording regarding
extensible SDK specifics.  These changes were in response to
a review of the section.

(From yocto-docs rev: 0209292cafbbe4918ec7ecdf1f48fc8ef2703b9b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:06 +00:00
Scott Rifenbark af1517cbfe ref-manual: Updated "Build History SDK Information" section.
Applied review edits to adjust this section for the
extensible SDK stuff.

(From yocto-docs rev: d386fca0b4e54ae2d5e610b37089fb058d80a746)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:06 +00:00
Scott Rifenbark d9fc04b47c dev-manual, mega-manual: Updated "Application Development SDK" section.
I updated the figure for this section to include some stuff
for the extensible SDK.  I updated the text supporting the
figure to cover the different SDKs and the different SDK
variable sets.

(From yocto-docs rev: 5aafab3e2e841293ddba45dfd8683cbdc223ed7c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:06 +00:00
Scott Rifenbark 357aa3322e ref-manual, mega-manual: Updated "SDK Generation" section.
Updated the figure used to show SDK generation.  I added a block
to cover the extensible SDK stuff.  This affected the figures
folder in both the ref-manual and the mega-manual.

Updated the text section to support the new figure.

(From yocto-docs rev: b9fd7c2b0ea0e2fe1805a1bb1eb1bcb82c807b66)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:06 +00:00
Scott Rifenbark 54490c06c6 ref-manual: Added several extensible SDK variables to glossary.
SDK_EXT_TYPE
SDK_RECRDEP_TASKS
SDK_LOCAL_CONF_WHITELIST
SDK_LOCAL_CONF_BLACKLIST
SDK_INHERIT_BLACKLIST
SDK_UPDATE_URL
SDK_TARGETS
OE_INIT_ENV_SCRIPT
COREBASE_FILES
SDK_TITLE
SDK_INCLUDE_PKGDATA

(From yocto-docs rev: c057b9c7027460fa6e53beb3431bf6aa1518b3aa)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:06 +00:00
Scott Rifenbark 6dfd441d08 ref-manual: Updated IMAGE_PKGTYPE variable.
Fixed the text to a link to the populate_sdk_* class.
The link was good but the text was old.

(From yocto-docs rev: dc892cdf618c008a9ce615c31ef643987dfcca13)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:06 +00:00
Scott Rifenbark 77f002ca64 ref-manual: Updated "Cross-Development Toolchain Generation"
I added a note about the extensible SDK not including gcc-canadian-cross.

(From yocto-docs rev: 53866854af53e97c9d8ca8d0771e12a7744ad6bd)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:06 +00:00
Scott Rifenbark ee90cc6bf0 ref-manual: Updated the "Build History SDK Information" section.
Added some new files to the list of files highlighted for this
directory with "sdk".

(From yocto-docs rev: 213371bc5c5eb00d37ace5f2b330a87e1f10b73e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-11 23:06:05 +00:00
Scott Rifenbark f54fe56fed ref-manual: Updates for nativesdk clarifications.
Fixes [YOCTO #8620]

Added a couple more clarifications for some nativesdk term
uses.  Minor edits to help make things clearer.

(From yocto-docs rev: 38082e1120861332674f97f67966b1f5cec7dc03)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:14 +00:00
Scott Rifenbark 3b410498fe ref-manual, dev-manual: Clarifying "native" and "sdknative"
Fixes [YOCTO #8620]

I applied some review comments for the changes made to several
areas in both these manuals.  Minor wording fixes and the
dropping of some changes as directed by Joshua Lock.

(From yocto-docs rev: 71af89da612c37162ba27844c297879d643caf65)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:11 +00:00
Scott Rifenbark c5b4f69821 ref-manual, dev-manual: Clarification of "native" and "sdknative"
Fixes [YOCTO #8620]

I went through and made some judgement calls on the use of
"native" and "sdknative".  I tried to make sure that the reader
understood the real meaning of these terms.

(From yocto-docs rev: d711e8c6dfb32a4ad79e9d11dbf44fbc759d0245)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:11 +00:00
Scott Rifenbark 34c75fadbd ref-manual: Updated the S variable description with feedback
Applied wording feedback.

Fixes [YOCTO #8542]

(From yocto-docs rev: 847d8bad345728c4a1c95766a127ec6ddb8ad33c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:11 +00:00
Scott Rifenbark 2b2ced01f7 ref-manual: Updated the staging.bbclass description
Fixes [YOCTO #8800]

Provided better wording.

(From yocto-docs rev: 4a419e22f1ec3623db45393422ca6287d2a73563)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:11 +00:00
Scott Rifenbark b9dddd511e ref-manual: Updated the S variable description.
Fixes [YOCTO #8542]

I updated the description with a new example specific to Git.
When you use Git, you have to specifically set the S directory
for things to work.

(From yocto-docs rev: 10d71ccda461098fd8c94677d91fd261f6edf508)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:11 +00:00
Scott Rifenbark 41e9f7cdac dev-manual, ref-manual: Updated licensing text information.
Fixes [YOCTO #8634]

To clear up the behavior the COPY_LIC_DIRS, COPY_LIC_MANIFEST,
and LICENSE_CREATE_PACKAGE variable behaviors, I updated the
glossary descriptions of the variables.  Also, added more info
to the "Providing License Text" section in the dev-manual.  Tied
everything together with good referencing.

(From yocto-docs rev: e7b2a1ed29dcd9d572b71f756e7705e6499a05ac)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:10 +00:00
Scott Rifenbark 5066fbcfb4 ref-manual: Added order information for conf file parsing.
I included a new paragraph at the end of the section describing
configuration in the "Closer Look" chapter.  Cases exist when
two configuration files set the same variable.  Depending on the
order, the last configuration file parsed is the one that actually
sets the variable.

Fixes [YOCTO #8914]

(From yocto-docs rev: 260e7dea7879846bcd3f3475cef001e512c657f0)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:10 +00:00
Scott Rifenbark c8c533ec62 ref-manual: Updated the do_populate_sysroot task.
Fixes [YOCTO #8800]

(From yocto-docs rev: 582fc36e9c7157ca9457cad5c8bc6824163feede)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:10 +00:00
Scott Rifenbark 77b3d06758 ref-manual: Updated the S variable entry in the glossary.
Fixes [YOCTO #8542]

I did a bit of re-wording based on the suggested stuff in the
bug.

(From yocto-docs rev: 8ab2ae205f79429c2986a9ba86bcba07f5e05cd8)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-03-03 17:40:10 +00:00
Scott Rifenbark e8860f77a2 ref-manual: Fixed typo in FAQ 14.15 section.
Found the word "Ebedded". Fixed to "Embedded".

(From yocto-docs rev: 65815012cd70b52b7558e6402f0eec946eb3d445)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-02-04 23:22:50 +00:00
Scott Rifenbark 9d2925eb81 ref-manual: Updated FAQ entry regarding Proxy for SOCKS
Fixes [YOCTO #8637]

Added an example to the section for https_proxy.

Also added a small example section for SOCKS proxy.

Reported-by: Liam R. Howlett <liam.howlett@windriver.com>
(From yocto-docs rev: e17510f1209660b934e27f52a3e5c01a1f213453)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-02-04 23:22:49 +00:00
Scott Rifenbark 29a44da99b ref-manual: Fixed type in LICENSE_CREATE_PACKAGE variable description
Pathname was wrong.

Fixes [YOCTO #8633]

(From yocto-docs rev: 017dd699e68bb600931b271010fbb905a3a25775)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-02-04 23:22:49 +00:00
Scott Rifenbark 4181e58d90 ref-manual: Updated warning regarding libexecdir
Fixes [YOCTO #6398]

Fixed the text according to Ross such that the specified
package contains files in /usr/libexec when the distro
configuration uses a different path for <libexecdir>.
By default libexecdir is $prefix/libexec but this can
be changed, for example to ${libdir}.

(From yocto-docs rev: 6ffe6728994c615abe2689a63f9f055425d08d7e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-02-04 23:22:49 +00:00
Scott Rifenbark 0d8bd7d6ba ref-manual: Added description for LICENSE_CREATE_PACKAGE variable.
Fixes [YOCTO #8633]

Added a new variable description for LICENSE_CREATE_PACKAGE.

(From yocto-docs rev: 49a2f8384e67a90d5b3227ab0de3d12eb311bd20)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-02-04 23:22:49 +00:00
Scott Rifenbark 6aca5b82c9 ref-manual: Added remove-libtool class
I added this new class to the ref-manual classes section.

(From yocto-docs rev: aedb3f54c5874e9cd9d8e5592959410db6f02ec7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-02-04 23:22:49 +00:00
Scott Rifenbark 4f3ef90ae1 ref-manual: Updated the BBMASK variable description.
(From yocto-docs rev: 0ae8d79993eef08c659e609af7e0afa09dcb9158)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-29 17:04:48 +00:00
Scott Rifenbark d484e58cfe ref-manual: Removed obsolete do_deploy statement from "Shared State"
The do_deploy[sstate-name] = "deploy" statement in the "Shared
State" section was obsolete.  I removed it.

Fixes [YOCTO #8995]

(From yocto-docs rev: e1836a405fcc89cd964e2e71597091161c53224b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-29 17:04:47 +00:00
Scott Rifenbark 4b4a8a6c15 ref-manual: Updated the SDK figure.
Added the SDKPATH variable to figure.  It was missing.
Also, had to adjust the display parameters to get it to
display decently.

(From yocto-docs rev: 4862288ab4675051ec6fc93927839da7eb3634b6)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-29 17:04:47 +00:00
Scott Rifenbark d7481ceb9e ref-manual: Added do_image and do_image_complete tasks
(From yocto-docs rev: 7b6eb076adc24a6f290e73db93aa831f982817b3)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-29 17:04:47 +00:00
Scott Rifenbark d39e9d1451 ref-manual: Rewrite of "Image Generation" and devtool text.
Rewrite of devtool reference section. This was a separate commit
but got squashed wrong so it ended up with this commit.

The changes to "Image Generation" section reflect the new, more
detailed image generation figure

(From yocto-docs rev: 827c6872b88c17d2d0c8d44b1024fff19076e505)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-29 17:04:47 +00:00
Scott Rifenbark 1e7735e290 ref-manual, mega-manual: Updated the Image Creation figure
The old version was off schematically.  Moved some boxes around
and created more detail to reflect technical correctness.

(From yocto-docs rev: 7793101e6866c0c58d0f1202fb04769a21f2f882)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-29 17:04:47 +00:00
Scott Rifenbark fded4fa2d2 ref-manual: Updated configuration of auto.conf in closer look
Fixes [YOCTO #8941]

Confusing wording existed surrounding how the auto.conf file
needs to be created.  Early in the section indicates that you
must hand create the file.  Then later, it indicates to not
hand-create it.  In reality, this file is not auto-created by
any script but is really usually created by an autobuilder.
I updated the verbiage to better explain this.

(From yocto-docs rev: 2dd8f60251009038d6bc61e2257876baebe8e0be)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-29 17:04:47 +00:00
Scott Rifenbark 57ddbe8473 ref-manual: Removed all variables related to "QMAKE"
* Removed the EXTRA_QMAKEVARS_POST variable description
 * Removed the EXTRA_QMAKEVARS_PRE variable description
 * Removed the QMAKE_PROFILES variable description

(From yocto-docs rev: 19ee6646123f26903d25fb888b23576f7fa75d87)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-15 16:31:17 +00:00
Scott Rifenbark 7814b33b56 ref-manual: Updates to cull out qt4 stuff.
Several areas changed throughout the ref-manual to remove qt4
referencing.

(From yocto-docs rev: 9ee721034ceb2bb7b7a9e64f6a6a7a2b3bfd1c82)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-15 16:31:17 +00:00
Ed Bartosh 908bbff879 ref-manual: Updated the list of supported image types.
The list in the IMAGE_TYPES variable description has been
updated to add and remove several image types.

(From yocto-docs rev: d363d4d2dcf1760c5a392b443b52965ca7177984)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-07 12:13:46 +00:00
Scott Rifenbark ccc830df1d documentation: Prepare for 2.1 builds
The changes are for the poky.ent file and the mega-manual.sed
file to take care of variables.  Also, entries added for the
manual revision table.

(From yocto-docs rev: 60da39f85165e2d4aef55d456f8203183e089433)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2016-01-07 12:13:45 +00:00
Scott Rifenbark 1b25a70991 yocto-project-qs, ref-manual, poky.ent: CentOS Package updates
Fixes [YOCTO #8696]

Turns out the 'dnf' command is not yet supported for CentOS
as it is for Fedora, I changed the 'dnf' command back to
'yum'.  Also, there were some essential packages that needed
to be added to CentOS.  Finally, there was a slight
inconsistency in the Fedora list of essential packages and the
ones for supporting Graphics.  I had a redundant listing of
one of the packages.  I took that out of the Graphics area and
left it only in the essentials area.

(From yocto-docs rev: dde72542ca87bfdd82d713f90938a41c83ac8a4d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-11-18 16:42:22 +00:00
Scott Rifenbark c674cd701c ref-manual: Updated list of supported distros.
(From yocto-docs rev: b91a39de1fac9ab2e0896d3124c6e359da9165ee)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-11-18 16:42:22 +00:00
Scott Rifenbark 33d8cff7ac ref-manual: Updated the GCC 5 migration section for 2.0
Added another link to Josh's porting guide.

(From yocto-docs rev: a1860811628aeddd579f92844f3e6bfcbded2936)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-11-18 16:42:22 +00:00
Scott Rifenbark 1630dbbe7a ref-manual: Applied a correction to the GCC 5 migration 2.0 section.
Added an exception and link to a patch the user should use if they
are using GCC 5 for specific ARM machine.

(From yocto-docs rev: 4f43b683cf4a078c6df4b8c6be59e6fb8702d265)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-29 22:05:36 +00:00
Juro Bystricky 37677d691a ref-manual: Updated ADT Installer Extras
opkg 0.3.0 requires also libarchive.

[YOCTO#8308]

(From yocto-docs rev: 9bf99020ab993ec497134921dd3e22414e65de95)

Signed-off-by: Juro Bystricky <juro.bystricky@intel.com>
Signed-off-by: Ross Burton <ross.burton@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-29 22:05:36 +00:00
Scott Rifenbark e03b19b463 ref-manual: Applied review updates to 2.0 migration section.
Some minor rewordings

(From yocto-docs rev: c62d39ad684c6be3321d711bd7935799e4269fa3)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-29 22:05:36 +00:00
Scott Rifenbark f19b52c90c ref-manual: Updates to the 1.8 to 2.0 Migration section.
Applied review comments from Paul Eggleton.

(From yocto-docs rev: 5b41ef810fdae04a722253676edd9d5803cb50f4)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-27 07:28:22 +00:00
Scott Rifenbark 947e15658f ref-manual: Updated the rootfs*.bbclass description.
Fixes [YOCTO #8298]

Added "rootfsdebugfile" class to the list of classes in this
general class description.

(From yocto-docs rev: ad2f6e1d22c9453b0d28cdc0b53558efa1dcc212)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-27 07:28:22 +00:00
Andre Draszik 7d30d67b26 ref-manual: Updated the allarch class description.
Added a patch to include a note from Andre.

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:11:12 +01:00
California Sullivan a8674ae642 ref-manual: Updated the MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS variable
MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS won't always grab your
out-of-tree module recipe since the kernel recipe's
PACKAGES_DYNAMIC variable provides kernel-module-*.  This
patch documents that your out-of-tree module needs to explicitly
set its PACKAGES variable to avoid this behavior.

(From yocto-docs rev: 2c51eae23b634cdace5a119ee1a6c8e8ba76dc45)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:35 +01:00
Scott Rifenbark e7c8c79f13 ref-manual: Added the 1.8 to 2.0 migration section.
(From yocto-docs rev: 494fc31bbaee6b0c1912d00d3249cc7044e43988)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:35 +01:00
Scott Rifenbark dc9e4cbfe6 ref-manual: Added correct class name as part of pkgconfig description
I was refering to the class as "pkg-config".  This was incorrect.
I fixed it in the opening sentence to use "pkgconfig".

(From yocto-docs rev: c8400b362704093d4c2c891f521c11818eb506a8)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:35 +01:00
Scott Rifenbark 5bc8fa6887 ref-manual: Fixed typo in 1.6 migration section for BitBake
In Section 5.5.3.2 bb.fetch.encodeurl: Use bb.fetch.encodeurl

changed to

bb.encodeurl: Use bb.fetch.encodeurl

Reported-by: Olivier Dugas <dugaso@sonatest.com>
(From yocto-docs rev: bec0f98f2383b231a1d453932a14b07038febd36)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:35 +01:00
Scott Rifenbark 2fe3809465 ref-manual, dev-manual: Applied feedback to edit several classes
Fixes [YOCTO #8298]

Updated several classes with feedback from Jose Lamego of Intel.
The feedback fixed some class groupings so that previously isolated
classes could be bundled under common classes (e.g.
autotools*.bbclass).

I scrubbed the cross-references for cases where a particular
class became "undocumented."  The cross-references now point to
the bundled class entry in the ref-manual.

(From yocto-docs rev: 07a533cb41ad26d202f4e303f2dbc7d7bf26e076)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:34 +01:00
Scott Rifenbark 359b7fb639 ref-manual: Added three PACKAGE_FEED_* variable descriptions
Fixes [YOCOT #8301]

Added descriptions for PACKAGE_FEED_ARCHS,
PACKAGE_FEED_BASE_PATHS, and PACKAGE_FEED_URIS variables.
The build system uses these three variables to construct a
set of final package feed URIs.

(From yocto-docs rev: 53447af460932caa5b2b7637894657eb9fd2e84d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:34 +01:00
John Maxin 66653cba91 ref-manual: Updated the image-swab.bbclass description
Fixes [YOCTO #8439]

The "image-swab" class depends on "strace" package being on
the build host.  I added that fact to the note where we say
the class is not maintained.

(From yocto-docs rev: 503f4199b3c0bcfcd333dbab025b40f9508a6820)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:34 +01:00
Scott Rifenbark 4b9daa8aa1 ref-manual: Added many new class descriptions.
Fixes [YOCTO #8298]

(From yocto-docs rev: bff0119d2e13922cdd7b0772f6ed4ff74afe3c26)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:34 +01:00
Scott Rifenbark 2e7d650a2a ref-manual: Updates to clarify Fetcher URL directory parameters
Updated the SRC_URI variable description to cross-reference
the "Fetchers" section in the BitBake User Manual and added
some more Fetcher URL parameters specific to certain fetchers.
This was done to help clarify how to put fetched code into
specific directories.

Also updated the bin_packages.bbclass description to have a
better example.  Used a git:// fetcher example and provided

some specific URL parameters.

(From yocto-docs rev: 7133b49092096c253ffce99f39d4fa6db7810061)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:33 +01:00
Scott Rifenbark acacf6ba73 ref-manual: Added linuxloader.bbclass reference description.
(From yocto-docs rev: f33dbbd740ddd9dc88154373dc824e63d832ca0c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:32 +01:00
Scott Rifenbark 1944d28000 documentation: Updated files to support 2.0 release.
These updates included editing the poky.ent file so that
DISTRO and related variables are now 2.0.  Also updated all
the title pages to have the manual revision table correct.
Finally, used my email for the manuals.

(From yocto-docs rev: deae61bfbb528ea0ced82399a78260a7f34a7a11)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:32 +01:00
Scott Rifenbark 3bff581146 ref-manual: Added descriptions for 5 new variables and 2 tasks.
Fixes [YOCTO #8019]

Added new descriptions for five kernel variables and two tasks.

(From yocto-docs rev: 834aebb75dce1c905b1e0f142d0d7de6bb44e7d4)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:32 +01:00
Scott Rifenbark 1c7f462f91 ref-manual: Added oe-seltest package requirements sections.
Running oe-selftest requires some Python packages for all
the supported distros.  I added new sections in there to cover
these requirements.

Fixes [YOCTO #8290]

(From yocto-docs rev: a8654267405df9ffb2f4d59d3de4a7eb3653893e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:22 +01:00
Scott Rifenbark 3930f04e0a ref-manual: Updated the EXCLUDE_FROM_SHLIBS description
Fixes [YOCTO #8066]

Applied some review comments to the variable's description.

(From yocto-docs rev: 35b28f3b86cdb76ae3dc431b5f538b4d078b694f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:22 +01:00
Scott Rifenbark 0d1c86b558 ref-manual: Updated EXCLUDE_FROM_SHLIBS description.
Fixes [YOCTO #8066]

Applied some review edits to the variable's description in the
glossary.  Also, changed the name of the variable to be correct.

(From yocto-docs rev: f3ab503301db9d22cb85da0f7518d266f230bd3d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:21 +01:00
Scott Rifenbark eea7521f59 ref-manual: Updated distrodata.bbclass example
Fixes [YOCTO #8237]

The use of this class no longer requires including the laundry
list of files that was provided in the section.  It just needs
the INHERIT statement now.  Removed the include statements.

(From yocto-docs rev: c31a5a3a78d265dea68c1c72c4eea6c2f80c839a)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:21 +01:00
Scott Rifenbark 2eaf843f48 ref-manual: Added new description for PACKAGE_EXCLUDE_COMPLEMENTARY
Fixes [YOCTO #7906]

I added a new description for the variable.

(From yocto-docs rev: 2a99b80abeee05a11aba9ab339d989a7d616b597)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:21 +01:00
Scott Rifenbark 05d8101990 ref-manual: Added new EXCLUDE_FROM_SHLIB variable
Fixes [YOCTO #8066]

Added a new description to the variable glossary.

(From yocto-docs rev: ccb23c5a318f1640718ed41dc7ea2fd1bb8a43a1)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:06:21 +01:00
Scott Rifenbark 316d432642 ref-manual: Added new variable description for SKIP_FILEDEPS
Fixes [YOCTO #8067]

Added a new file description.

(From yocto-docs rev: 9c60c6157660be6557732bbdc2398e2783ac68d2)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:05:28 +01:00
Scott Rifenbark a1b25e60ca yocto-project-qs, ref-manual: Replaced "yum" with "dnf"
Fixes [YOCTO #8159]

Fedora and CentOS have deprecated "yum" and have come up with
"dnf" as the package manager.  This happened at the end of
2014.  I have replaced the occurrences in the manual
appropritely.

(From yocto-docs rev: 14c80ecc8d6a4f9bf355dd84657d339782da83f0)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:05:28 +01:00
Scott Rifenbark d284fbae8e ref-manual: Added cross-reference phrase to some variables
Fixes [YOCTO #8233]

The IMAGE_POSTPROCESS_COMMAND and IMAGE_PREPROCESS_COMMAND
variables were missing a linked cross-reference to the
IMAGE_ROOTFS variable.  I added the linked references.

(From yocto-docs rev: a36b447ca105b3d63b7cfd085c77b071275e0dab)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-10-21 23:05:28 +01:00
Ross Burton 798fc18ef7 ref-manual: New description for KERNEL_CLASSES variable.
(From yocto-docs rev: 9bb5b40cdcb2f41f59758fb29fddba9103109934)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:32 +01:00
Scott Rifenbark cb19478b0b ref-manual: Added glossary description for BB_ALLOWED_NETWORKS.
Added a new description.

(From yocto-docs rev: e17fe8da8a9d2cbca54dd45451b35103d7d89fa0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:32 +01:00
Scott Rifenbark ab23dd967e yocto-project-qs and others: Rewrite of the QS
This was a complete re-write of the YP Quick Start in an attempt
to streamline it, remove unecessary detail, and make it flow better
with the examples.  In doing so, many manuals were affected due to
section headings being renamed, information being moved, etc.  Here
is a list of the changes by manual:

Makefile - Removed two figures from TARFILE list for the
           yocto-project-qs.

           Added building-an-image.png to the ref-manual TARFILE list.

           Added using-a-pre-build-image.png to the adt-manual TARFILE
           list.

           Repositioned 'eclipse' in the adt-manual TARFILE list.

adt-manual: Fixed a cross-reference so that it goes to the new
            'Building Images' section that is within the YP QS.

            Added new section 'Example Using Pre-Build Binaries and
            QEMU' to hold the information that was formerly in YP QS.

dev-manual: Removed a cross-reference into the YP QS that promised how
            to configure the most efficent build.

            Changed a cross-reference into the YP QS from 'The Packages'
            to 'The Build System Packages'.

            Changed a cross-reference into the YP QS from 'Building an
            Image' to 'Building Images'.

            Changed a text reference from the YP QS to the adt-manual.

            Moved the bit about getting YP files by using the YP website
            from the YP QS to the dev-manual.

            Changed a cross-reference into the YP QS from 'Using Pre-Built
            Binaries and QEMU' to 'Example Using Pre-built Binaries and
            QEMU', which was moved to the adt-manual.

ref-manual: Changed a cross-reference into the YP QS from 'What You
            Need and How You Get It' to 'Setting Up to Use the Yocto Project'.

            Moved the note about if your system has oss4-dev in the
            packages area in the YP QS to the appropriate area in the
            ref-manual.

            Moved the introduction information regarding building an image
            along with the figure from YP QS to the ref-manual's section on
            building images.

toaster-manual: Changed a cross-reference into the YP QS from 'What You
                Need and How You Get It' to 'Setting Up to Use the Yocto
                Project'.

yocto-project-qs: Complete rewrite that changed many section headings and
                  removed much detail, which was placed in other manuals.

(From yocto-docs rev: da4ed8147b04963a700caa784bda709c57b4eb6e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:32 +01:00
Scott Rifenbark add1f737b8 ref-manual: Fix to QA error message.
Fixed wording in section 7.78 to use "nativesdk-myrecipe.bb".

Fixed message to say "non-dev/-dbg/nativesdk- package contains symlink..."

Reported-by: Rene Fichter <rene@fichter.se>
(From yocto-docs rev: 80a5b51a0416dc610edf1526079102fee661375b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:31 +01:00
Scott Rifenbark 3cd876d9ab ref-manual: Updated the IMAGE_TYPES glossary description.
Fixes [YOCTO #7374]

Added "vdi" as an image type.

(From yocto-docs rev: 7c1ed8e01fd227b4b6de7b055517d8e8f6754892)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:31 +01:00
Scott Rifenbark 68620d528d ref-manual: Fixed grammar issue in the oelint.bbclass section.
(From yocto-docs rev: ec29b817cd426a1214100b583557c6a4a1aae03c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:31 +01:00
Scott Rifenbark 282fe35518 ref-manual: Updated UNKNOW_CONFIGURE_WHITELIST variable
Fixes [YOCTO #7755]

Applied some review edits to the wording from Ross Burton.

(From yocto-docs rev: 4cb0d0f463cb6c9b103d01b7c5e800e7b1a04a3e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:31 +01:00
Scott Rifenbark 9325599603 ref-manual: Updated the UNKNOWN_CONFIGURE_WHITELIST variable.
Added information to note when it is used (insane.bbclass) and only
if the recipe inherits the autotools.bbclass.

Fixes [YOCTO #7755]

(From yocto-docs rev: eeb3006e0a440464af89e336b9eff0ea60702601)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:31 +01:00
Scott Rifenbark 4764062664 ref-manual: Updated ARCHIVER_MODE and archiver.bbclass
Added information in about the various varflags the user can
use to define the type of archive.

(From yocto-docs rev: 9035c415d4453750f016fe4ea2fa8179549330ca)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:30 +01:00
Scott Rifenbark 4ec8e88a9a documentation: Updated customization layers to point to XSL mirrors
The customization layers were pointing to Sourceforge site for the
XSl files needed to build the manuals.  Throuhgout time, this site
has failed me enough to warrent trying to get these XSL files from
some other source.  Rather than ship the XSL files with the YP release,
we decided to create some mirrors and point the customization files
there.

(From yocto-docs rev: 4fd1703870694dff1f593b421f90aad0803d9e65)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:30 +01:00
Scott Rifenbark 2de3283ca6 ref-manual: Fixed "TBD" section cross-reference in KBUILD_DEFCONFIG
Fixes [YOCTO #7474]

There was a TBD section here that needed filling out.

(From yocto-docs rev: 84efce1622dec2782aadfb9cc9338c3f7aab1472)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:30 +01:00
Scott Rifenbark 7baadd86ee ref-manual: Removed PRINC entry from the glossary
This variable has been deprecated a while and Paul Eggleton suggested
we finally remove it from the glossary.  I removed it and also
took away the two links from where the variable was referenced
in a couple spots in the migration section.

(From yocto-docs rev: 2b3c762428bd9ca64087ba6359c4eb5fb5a3db84)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:30 +01:00
Scott Rifenbark ec068fe582 ref-manual: Added new variable description UNKNOWN_CONFIGURE_WHITELIST
Fixes [YOCTO #7755]

Added a new description for this variable.  Based it on information
given to me by Paul Eggleton.

(From yocto-docs rev: eb0101027ed18b6bae2d80166b73b41ee1ebeb9f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:29 +01:00
Scott Rifenbark 744893b5d2 ref-manual: Updated EXTRA_IMAGE_FEATURES variable
Added better wording to show that you use spaces to separate
multiple features.

(From yocto-docs rev: b21d73acb23e0e3b78cff332fdc4a09166eb7392)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:29 +01:00
Scott Rifenbark 72169b2928 ref-manual: Added new glossary description for KBUILD_DEFCONFIG.
(From yocto-docs rev: 4ec945a5567df4f561bc8bed679becbd3f2b9def)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:29 +01:00
Scott Rifenbark d9cf5753df ref-manual: Added and updated variables to support calling functions
Fixed [YOCTO #7632]

Looked for, updated, and added (if necessary) the following
variables:

 * ROOTFS_PREPROCESS_COMMAND
 * ROOTFS_POSTPROCESS_COMMAND
 * SDK_POSTPROCESS_COMMAND
 * POPULATE_SDK_POST_TARGET_COMMAND
 * POPULATE_SDK_POST_HOST_COMMAND,
 * IMAGE_POSTPROCESS_COMMAND
 * IMAGE_PREPROCESS_COMMAND
 * ROOTFS_POSTUNINSTALL_COMMAND
 * ROOTFS_POSTINSTALL_COMMAND

Each of these variables no longer accepts arbitrary shell commands but
rather functions.  The wordings now support that behavior.

Also, updated the migration section for going to 1.6 release to note
this change.

(From yocto-docs rev: e1ab48f7def9d1eb080e007b88f75172470b8007)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:28 +01:00
Scott Rifenbark fb82bcb989 ref-manual: Added 'ptest' to the list of Distro Features
Reported-by: Paul Eggleton <paul.eggleton@intel.com>
(From yocto-docs rev: a6ae91468a67779c796712794656a72f701aea25)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:28 +01:00
Scott Rifenbark 26f9777c64 ref-manual: Updates to the "Speeding Up the Build" section
I applied a little more information to this section to help
round out the variable explanations.  Part of the change involved
adding PARALLEL_MAKEINST to the list of scaled variables.
I had left that variable off.  Also added a new trade-off.

(From yocto-docs rev: 3d85d5385c03841c17dd33afb94c110edc12170f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:28 +01:00
Scott Rifenbark e05c636bc8 ref-manual, dev-manual: Added info about make race work-around
I updated both the PARALLEL_MAKE and PARALLEL_MAKEINST variables
by expanding the note to indicate how to prohibit parallel make
threads.  Also, added a cross-referencing link to the
"Debugging Parallel Make Races" section.

I added a short note to the start of the "Debugging Parallel Make
Races" section noting that if they can't properly fix the condition,
they can always do a work-around to set the PARALLEL_MAKE or
PARALLEL_MAKEINST variables to null.

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:28 +01:00
Scott Rifenbark 8c9fb71226 ref-manual: Formatting fixes and tag fix.
(From yocto-docs rev: d4dcfbb36c19e6aed62fc9c4a3bced3496cfbb8e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:28 +01:00
Scott Rifenbark 935f5d7684 ref-manual: Updates to BB_NUMBER_THREADS and PARALLEL_MAKE
I added some more detail to these two variables.  The system sets
them according to the perceived number of cores.  These default
setting are cool for single socket systems.  However, if you
have some big system with a lot of physical CPUs, you might want
to cap off the values at 20.  This is according to Darren Hart.

I also put in some cross-references to the "Speeding Up the Build"
section.

(From yocto-docs rev: 20eafc8290f46d8deea84dd6ff721b65cb8a1463)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:28 +01:00
Scott Rifenbark 113c4279e7 ref-manual: Added descriptions for four new variables
Fixes [YOCTO #7665]

Added descriptions in the glossary for the following variables:

 * SDK_HOST_MANIFEST
 * SDK_TARGET_MANIFEST
 * SDK_VERSION
 * TOOLCHAIN_OUTPUTNAME

(From yocto-docs rev: d8a7e3443d33d02d88e9d603dcff917a5508ae17)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:28 +01:00
Scott Rifenbark d0531dbf0e ref-manual: Added new variable description for ARCHIVER_MODE
Also, added a cross-reference link from the archiver.bbclass section
to the new description.

(From yocto-docs rev: f825ba932970e9d62d335f249365a34b2992b6cd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 18:02:27 +01:00
André Draszik 46f86497d5 ref-manual: clarify allarch wrt RDPENDS and TUNE_PKGARCH
See e.g.
http://permalink.gmane.org/gmane.comp.handhelds.openembedded/64067

(From yocto-docs rev: 5ad5f90edc5aefc95049f36afa2792dd7a9fba3d)

Signed-off-by: André Draszik <git@andred.net>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 13:59:09 +01:00
Paul Eggleton a894da0dfe ref-manual: fix example of setting root password using extrausers
We need to use usermod here not useradd.

(From yocto-docs rev: 7f4a5523c14304985ab8b277fd5010fd22903dea)

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-07-28 13:59:09 +01:00
Scott Rifenbark b72cb0dbbe ref-manual: Updated the "Image Features" section
Removed the requirement that debug-tweaks is needed in order to
individually use the allow-empty-passowrk, empty-root-password,
and post-install-logging features.  These three features can be
individually turned on an off regardless of debug-tweaks.

(From yocto-docs rev: ea33b98c0a7ceb80adb15bf63eee8d6872099235)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-05-03 11:49:35 +01:00
Scott Rifenbark 6192753e9d ref-manual; mega-manual: Edits to further define packaging process
In response to community input where developers were attempting to
locate information on how to write packages out to a directory
other than ${DEPLOY_DIR}/<package_type>, I updated the "Package
Feeds" section, added several new DEPLOY_DIR_* variables, updated
four classes, and updated four tasks.  Here are some details:

 * Made changes to the "Package Feeds" section to provide more
   accurate information in the package feeds directory structure
   used by the build system in build/tmp.  These changes included
   updating the figure itself and some explanatory text.

 * Updated the DEPLOY_DIR variable description.

 * Added new variable descriptions for DEPLOY_DIR_DEB, DEPLOY_DIR_IPK,
   DEPLOY_DIR_RPM, and DEPLOY_DIR_TAR.

 * Updated the related classes: package_deb, package_ipk, package_rpm,
   and package_tar.

 * Updated the related tasks: do_package_write_deb, do_package_write_ipk,
   do_package_write_rpm, and do_package_write_tar.

Reported-by: Trieu Nguyen <trieu.t.nguyen@intel.com>
(From yocto-docs rev: e8742267506bf9359346cfcd3965f762ed2c7d6f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-05-03 11:49:34 +01:00
Scott Rifenbark 515a8b790e ref-manual: Updated the ELF Binary QA warning message
Fixes [YOCTO #7630]

I applied some feedback from Laszlo Papp suggesting that the user
can also use '-fpic' as well as '-fPIC' for a command-line option.

(From yocto-docs rev: ec79c9a39955b22cb2b8cec44ffcaab22aba479b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-28 16:30:46 +01:00
Scott Rifenbark 6e4a1a0936 dev-manual; ref-manual: Fixed &dash; issue
Fixes [YOCTO #7386]

Apparently the "&dash;" ENTITY used throughout the YP manual set to
get literal "-" characters in example commands renders into a unicode
that is not a dash.  This results in users getting errors if they
attempt to cut-and-paste a sample command that uses a "-" character
from the manual into a shell.  I have universally replaced all the
"&dash;" strings in the YP manual set to "-" strings.

(From yocto-docs rev: ef6dbf591eee70866f163e3c98454b6145f4fa3a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-28 16:30:46 +01:00
Scott Rifenbark 92d9a299cb ref-manual: Removed FAQ question for GNOME Mobile.
(From yocto-docs rev: d214db03da1802ca9a42eaed64b51daa8f7f5682)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:34 +01:00
Scott Rifenbark ee19ce07ac ref-manual: Fixed some dashes in the user input examples.
I typically try to use the underscore character to string together
multi-word user-input descriptors in examples.  I fixed a bunche
here.

(From yocto-docs rev: 68474b5a8b5c96b0fc19fda29e667369f4606e31)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:34 +01:00
Scott Rifenbark 5c27b8bbd6 ref-manual: Fixed some formatting on a user-input example.
(From yocto-docs rev: 0a2abec012ad3af4af9ab41bd9e679ca26903062)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:34 +01:00
Scott Rifenbark bed39bb69e ref-manual: Removed tag from profile-manual cross-ref
In the introduction, the ref-manual references several other YP
manuals.  If the manual is build separately, these references resolve
to the appropriate manuals.  When the mega-manual is built, the
same references are designed to not become links.  In otherwords,
mega-manual.sed processes those links out.  This is by design.

I found a #profile-manual tag on one of the links in the introduction.
This resulted in a link in the mega-manual that would go nowhere.  I
removed the tag.

(From yocto-docs rev: fdaf114ece20994ec55061612ab53e9334afde26)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:34 +01:00
Scott Rifenbark 031aba2f4e ref-manual: Removed "Intel Corporation" from the "Links" section.
In an attempt to keep the project as much open source as possible,
I removed the link to Intel from this list of resources.  We don't
list Linux, OpenedHand, Wind River, etc.

(From yocto-docs rev: 5efe375a94a14d4a70aa2c3ff9ab39d6c7362526)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:33 +01:00
Scott Rifenbark 447a3519af ref-manual: Updates to ELF binary QA warning - review changes
Applied some review edits from Paul.

Fixes [YOCTO #7630]

(From yocto-docs rev: 064fa763686f5ddaccba4a7201757f2a6fc8636c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:33 +01:00
Scott Rifenbark 7634512ecf ref-manual: Updates to the TCLIBC variable description
An old note still existed in this entry that stated we don't support
glibc.  This is not true.  I deleted the note.

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:32 +01:00
Scott Rifenbark 2eb48c227e ref-manual: Updates to ELF binary QA warning
Fixes [YOCTO #7630]

Apparently the text relocation being done here can cause runtime
performance issues.  I documented a potential work-around for the
issue and provided a cross-reference link to an external site for
more general information about text relocation at runtime.

Reported-by: Laszlo Papp <lpapp@kde.org>
(From yocto-docs rev: f7ba2fd03ee40c5dbe6a07a24a63d9147857ed78)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:32 +01:00
Scott Rifenbark f06cd40f08 ref-manual: Added glossary entry for EXTERNAL_KERNEL_TOOLS
(From yocto-docs rev: 23caeb53eaed68135e4dbf7adbb5c0c16ef70cf0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:32 +01:00
Scott Rifenbark ddafde3b14 ref-manual: Fixed style sheet
Style sheet was not spacing after the first paragraph for glossary
entries.

(From yocto-docs rev: fb08aec5303ed21315839c55b413873569497f23)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-24 11:07:32 +01:00
Scott Rifenbark 02881a8d0b documentation: Preparation for 1.9 builds
This involves the following:

 * Inserting a new row for all manual revision history tables
   to have "October 2015" and 1.9 as the release information.

 * Updating the mega-manual.sed file to process links for 1.9

 * Updating variables in poky.ent to deal with the 1.9 release
   variables.

(From yocto-docs rev: 1ed55c08b96cf0fded38833635111a5c6da86781)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-15 15:57:18 +01:00
Scott Rifenbark 941910f47f ref-manual: Updated the section on oe-init-build-env-memres
Fixes [YOCTO #7559]

Added some explanation on the syntax.  As it was, the positionally
dependent nature of the script's parameters was not accounted
for.  This is now explained.  Also, talked a bit about the
bitbake-cookerdaemon.log file.

(From yocto-docs rev: fcf52a15acea2d75df9c84550d7e73c988ffb4bb)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-15 15:57:17 +01:00
Scott Rifenbark 9d72edd0e6 ref-manual: Fixed two spelling errors.
(From yocto-docs rev: 2725c01a396a877cfa70471238d8195673ed53ff)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-15 15:57:17 +01:00
Scott Rifenbark 6bd0df0555 ref-manual: Corrected the "package_rpm.bbclass" section.
A cut-and-paste error had left a "package_deb" string in the
first sentence of the section.  Replaced with "package_rpm."

Reported-by: Geoffroy VanCutsem <geoffroy.vancutsem@intel.com>
(From yocto-docs rev: 38b20d775ba41cb14d86177dddd85ada32fb3f86)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-10 14:47:11 +01:00
Scott Rifenbark fa398ae99f ref-manual: Update to oe-init-build-env-memres description.
Fixes [YOCTO #7559]

Removed the information stating that the port address 12345 is used.
Really what happens is a random port address is used.

(From yocto-docs rev: f469c2431b26593a762e348e9c5d0e84c582eab8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-10 14:47:11 +01:00
Scott Rifenbark be1e1824cb ref-manual: Updates to "Kernel Build Changes" in the 1.8 migration section.
Updated this according to some changes Richard and Paul wanted to
see make it into the 1.8 release.

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

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-10 14:47:11 +01:00
Scott Rifenbark cd0800fe49 ref-manual: Edits to the 1.8 migration section.
(From yocto-docs rev: 9509c22e6e9fb1dfaabe634cb554f1f68d8ea434)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-02 17:42:13 +01:00
Scott Rifenbark 079d6c95ce ref-manual: Added new migration section for going to 1.8
(From yocto-docs rev: b8c7fad5404eb111c0d6a39fae6e9ffcb4a615ba)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-02 12:04:44 +01:00
Scott Rifenbark 9f08067532 ref-manual: Added new bluetooth class.
(From yocto-docs rev: 536117974fb08c1c6739af9c8200b228a59b7f6d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-02 12:04:44 +01:00
Scott Rifenbark 723c64b83d ref-manual: Updates to doc packages and reference links
I added xlstproc to Fedora and CentOS package lists for building out
the docs.

I abbreviated the list of references in the end chapter by leaving
just the main URLs for bigger areas such as Intel, OE, etc.  Then
I put in a link that goes back to the dev-manual list of other
informations as that is much more comprehensive.

(From yocto-docs rev: 81667b85cd8c639dd32cd5a8f614b4c890eb4dde)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-01 17:35:35 +01:00
Scott Rifenbark 937c709536 ref-manual: Updated the OE_TERMINAL variable description
Removed an out-dated note near the bottom regarding a distro
we don't support

(From yocto-docs rev: 4211914f16d4ab01182633785068b56a258c0d04)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-01 17:35:32 +01:00
Scott Rifenbark 575d464bae ref-manual: Updated the supported distros list.
(From yocto-docs rev: 41a835409a912e55b37a64492ad2fe99fd412214)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-01 17:35:31 +01:00
Scott Rifenbark d08320567c ref-manual: Backed out the bits for the context PNG images.
We did not have time to do this for 1.8.  So, I restored the look
of the glossary pre-images.  I did leave commented code in both
the glossary chapter and the style sheet for later.

(From yocto-docs rev: 9f1472b7d4cd86545e7927b0f693aafc88ae2791)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-01 12:59:18 +01:00
Scott Rifenbark 70ddcce446 ref-manual: Downplayed the BBLAYERS_NON_REMOVABLE variable.
Applied some suggestions from Paul Eggleton to downplay the role
of this variable.  It is basically ignored now in all parts of the
manual set except for the descriptions of the variable itself
and the BBLAYERS variable.  I added some text reinforcing the fact
that BBLAYERS_NON_REMOVABLE is ignored by the build system and only
matters if you are using Hob.

(From yocto-docs rev: 98112751aaec6e25de48d9e3ee56592be3f53a07)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-01 12:59:16 +01:00
Scott Rifenbark 2b822400f4 documentation: Updates to try to fix CentOS docs build errors
The docs are not building on CentOS and we think it is due to the
XSL templates being called for the Eclipse parts.  I located all
the "current" templates and switched them out for "1.76.1" version
as are used by the mainstream doc builds.

(From yocto-docs rev: afbddde6524630433dfec973bbe886de32395bc8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-04-01 12:59:13 +01:00
Scott Rifenbark 1345195137 documentation: Updated Manual revision tables with "April 2015"
(From yocto-docs rev: a012e34956b8ac2fa7610e264f460bc27bdd66d8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-19 12:38:18 +00:00
Scott Rifenbark 7727a1608a ref-manual: Updated the KMACHINE variable description.
The example was ancient so I consulted Bruce Ashfield for a better
example and implemented it.

(From yocto-docs rev: e737f380ca5bb36c0095f11182cd3e3a93791e61)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-10 11:08:34 +00:00
Scott Rifenbark c504276d26 dev-manual, ref-manual: Replaced &dash;&dash; with "--"
Fixes [YOCTO #7386]

Apparently, copying HTML displayed commands that have a
double dash created through "&dash;&dash;" in the docbook source
causes some issues in the shell.  I have scrubbed the manual set
to replace any "&dash;&dash;" 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
Robert P. J. Day a79cdb51b8 bsp-guide, kernel-dev, ref-manual: KERNEL_FEATURES should refer to .scc files.
Tweak a number of doc lines so that the KERNEL_FEATURES variable
refers directory to .scc files, and does not take advantage of
potentially confusing shortcuts.

(From yocto-docs rev: 6236fb098fc2d518f6f4f63e16b19a06a775d2d6)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2015-03-06 10:44:41 +00:00
Robert P. J. Day 62e4d4571c ref-manual: Updated the MACHINE variable description.
Fill out missing machines for the MACHINE variable.

(From yocto-docs rev: 2b8179cfb7e3a25d95c43f9160d284ebd5deefc7)

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 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
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 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 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 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 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 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 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 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
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 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 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 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 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 2d54b1d72f ref-manual: Added CentOS 7.x to list of supported distros.
(From yocto-docs rev: 49bcfd52ee94c79c04e779f2f81421ea7a40c9f1)

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 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
Scott Rifenbark 0e0a19a7ff ref-manual: Added a cross-reference from the USE_DEVFS variable
Placed a reference for more information on the variable into the
section of the dev-manual that explains how to choose a device
manager.

(From yocto-docs rev: 3f9b1329fe4794af03d673323d11558e85d9b097)

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 b273c25857 ref-manual: Added USE_DEVFS variable description
(From yocto-docs rev: 0999c2811d3bf5a2e5998f81da91960ee4c9c855)

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 8bb0ffb09a ref-manual: Re-ordered the UPDATERCPN variable.
I had it out of order alphabetically.

(From yocto-docs rev: d766cc58dfe2581599815b76729c742034c910ef)

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 48559ff1de ref-manual: Review edits to several glossary variables.
I updated the following variables based on slight review changes
from Paul Eggleton:

 EXTRA_AUTORECONF - changed autoconf class to autotools
 KERNEL_IMAGE_MAXSIZE - Wording tweak
 AUTO_LIBNAME_PKGS - Wording tweak
 DEBIANNAME - [doc] string updated
 TCLIBCAPPEND - Second clarifying sentence in first para added
 PACKAGEGROUP_DISABLE_COMPLEMENTARY - [doc] string updated

(From yocto-docs rev: ff5c765ffab1cdf6fc8a007cebdf7114432f65ef)

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 7d480c304a ref-manual: 13 new variables added to the glossary.
Added descriptions for the following variables:

 EXTRA_AUTORECONF
 KERNEL_IMAGE_MAXSIZE
 UPDATERCPN
 AUTO_LIBNAME_PKGS
 DEBIANNAME
 DEBIAN_NOAUTONAME
 TCLIBCAPPEND
 PACKAGEGROUP_DISABLE_COMPLEMENTARY
 CLEANBROKEN
 DISTRO_CODENAME
 BASE_WORKDIR
 DISTRO_FEATURES_DEFAULT
 DISTRO_FEATURES_LIBC

Part of adding new variables is checking to see if a previously
undocumented variable is used elsewhere in the manual.  One
occurrence was spotted and turned into a link for this list.

(From yocto-docs rev: bb75387b7aa4fcb0b594d300772952d81a651644)

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 e3180323f9 ref-manual: Updated the supported distro list.
Covering CentOs to 6.x and the debian stuff to 7.x

(From yocto-docs rev: fa7d6f138506b90330c52c1dbe3a56e40a34a97e)

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 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 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
Maciej Borzecki 88528a128f ref-manual: Update to the BOOT_IMAGE_FILES variable in the glossary
Update entry for IMAGE_BOOT_FILES with information on glob
patterns.

(From yocto-docs rev: ad3fc0061e3f4dc3ecc6b0a101685c301c5690e9)

Signed-off-by: Maciej Borzecki <maciej.borzecki@open-rnd.pl>
Signed-off-by: Maciek Borzecki <maciek.borzecki@gmail.com>
Signed-off-by: Ross Burton <ross.burton@intel.com>
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-12-19 22:36:14 +00:00
Scott Rifenbark 99bd2c41c6 ref-manual: Updates to some tuning variables in the glossary:
Fixes [YOCTO #5463]

Updated the notes in the TUNE_ASARGS, TUNE_CCARGS, and
TUNE_LDARGS to indicate that the BSPs select the tune and then
selected tun affects the tun variables themselves.

Also combined the TUNE_PKGARCH and the TUNE_PKGARCH_tune variable.
We really don't need the TUNE_PKGARCH_tune variable as it is simply
the TUNE_PKGARCH variable with the override.

(From yocto-docs rev: dabc624272a9bb4cf5e62dee664ba729a9887208)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-12-19 22:36:14 +00:00