Commit Graph

4971 Commits

Author SHA1 Message Date
Scott Rifenbark
bb4ab5a653 ref-manual: Updated PREFERRED_PROVIDER variable
Provided more details in the explanation and fixed a link to the
section on using virtual providers.

(From yocto-docs rev: ace74e24f001b83c9177266b0a6f15ce96dd04b0)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:25 +00:00
Kristi Rifenbark
e701fdeeba ref-manual: Updated partition command options
Fixed [YOCTO #11525]

Created a note for more explanation for how the
mount program understands the PARTUUID syntax
used with --use-uuid. Added four missing options.

(From yocto-docs rev: d8adf537d305dd55e841dd993c36ee60b5896adb)

Signed-off-by: Kristi Rifenbark <kristi@buzzcollectivemarketing.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:25 +00:00
Scott Rifenbark
35549a7a45 dev-manual, concepts-manual: Moved x32 section
I had split up the section on x32 into a concept piece and a "how-to"
piece earlier in order to satisfy outside pressure to isolate all
"how-to" stuff in the dev-manual.  Doing this put a "conceptual" blurb
about x32 in the new concepts-manual.  It has been decided that x32
is not a concept.  It really does not fit into the ref-manual either.
So, I have re-combined the intro blurb of the x32 stuff back as the
beginning piece of the "Usingt x32 psABI" section in the dev-manual.

(From yocto-docs rev: 6e8240cc1a90a8d78ff456d3138c525eceea3ee3)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:25 +00:00
Scott Rifenbark
505a31c1a1 dev-manual: Updated Bmaptool section.
Provided a better flow and a bit more explanation of what Bmaptool
provides.

(From yocto-docs rev: 9a02cd7281038031fc4cdea98f114b9c318947a7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:25 +00:00
Scott Rifenbark
01658a83d7 dev-manual: Updated oe-run-native and dd examples for Wic
I changed the path to not list "build/" as the example assumes
the user is already in that directory.

(From yocto-docs rev: c3ab6a9e53f48005de73977238c8af3e2061db8b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:25 +00:00
Scott Rifenbark
422c6488d3 getting-started: Updated front matter that introduces manual.
(From yocto-docs rev: 6809363f7596938e40f2685c68c0537857fa055b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:25 +00:00
Scott Rifenbark
52331ef4d0 getting-started: Edits to the Git section.
(From yocto-docs rev: d1512e2f9e17be58dcd8c64ce7911d6ee1ebc12c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:25 +00:00
Scott Rifenbark
30ad0a8896 getting-started: Applied some minor edits to the Git workflow section.
(From yocto-docs rev: 15eb983db02b352fd70de6cb3ef2c63e82fa4420)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:25 +00:00
Scott Rifenbark
841458c70c getting-started: Added Host Development Section
Section to describe the key nature of the host development system
and its role and preparation requirements for use in the Yocto
Project development environment.

(From yocto-docs rev: 379659af343ba84f9c8fc2f47474659e06219c53)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Scott Rifenbark
e21faa4a9c dev-manual: Updated Wic example using existing kickstart file.
(From yocto-docs rev: a1f25bd6aae35e4c052e348949bea332b9203c20)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Scott Rifenbark
3461d890d3 getting-started: Created "Some Basic Terms" section.
This section contains some fundamental terms people decided were
important enough to have in this getting-started manual.

(From yocto-docs rev: 42bfa0d8fc0a61c26f6b2f4b9e285c06255e8b8d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Scott Rifenbark
6f488928cb ref-manual: Updated some terms in the "Terms" chapter.
(From yocto-docs rev: c00be16a858ece1d3b02d554ec202088f78a2d1d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Scott Rifenbark
189851f9d6 getting-started: Added section on BB workflow
New section called "The OpenEmbedded Build System Workflow".
This section presents the tried and true flow block figure
that shows what happens when you fire off a build.

(From yocto-docs rev: 5b4313ba87a2ccd139f2b980f4cf097700421cf4)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Scott Rifenbark
68823387c3 getting-started, mega-manual: Added reference distro poky section
Added the new section "Reference Embedded Distribution (Poky)"
section to the getting-started manual.  The new section required
a new figure.  I had to add the figure to the figures folder of
both the getting-started and mega-manual books.  Updates to the
Makefile to include the new figure as part the tarfiles created
for each book.

(From yocto-docs rev: e5f44e17d4c1e55b6f229cc3745727e439b5bcb7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Kristi Rifenbark
a70b32c5a0 ref-manual, dev-manual: Removed fetchall and checkuriall tasks
Fixed [YOCTO #12547]

ref-manual:
Removed fetchall and checkuriall tasks.

dev-manual:
Replaced "bitbake -c fetchall target" command with
'bitbake -c target --runall="fetch"'.

(From yocto-docs rev: 6d5cad8755e8817d50a9f88cb18115f43bb0b54a)

Signed-off-by: Kristi Rifenbark <kristi@buzzcollectivemarketing.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Scott Rifenbark
2c0d16904d ref-manual: Updated phonetic pronounciation of Poky.
It is Pock-ee with the emphasis on Pock.

(From yocto-docs rev: fd0accf40a9324060562b75ba9d3b078daf458f6)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Scott Rifenbark
c46b027622 getting-started: Added "Development Methods" section
This section introduces the ways a developer can use the Yocto
Project.  They can use BitBake from a Linux shell, they can
got through CROPS, they can use Toaster, and they can use the
Eclipse IDE.  The section overviews these possibilities.

(From yocto-docs rev: 95af6303364f94f91c94fd0bd1890b4e6351048e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Kristi Rifenbark
afb5009c3b sdk-manual: Replaced eclipse-poky repo name to eclipse-yocto
Fixed [YOCTO #12546]

(From yocto-docs rev: 6fa7fb663d8a9067ddec783424cf0da81e875669)

Signed-off-by: Kristi Rifenbark <kristi@buzzcollectivemarketing.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Scott Rifenbark
324da65885 getting-started: Created Components and Tools section
New content that leverages off the same information from the new
website.

(From yocto-docs rev: 1d5bf1501a1d0efe388dc5f4a7f741a272c6301c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-03-03 08:35:24 +00:00
Kristi Rifenbark
1a78cdaea6 dev-manual: Fixed variable link to DEFAULTTUNE variable
Fixed [YOCTO #12458]

(From yocto-docs rev: 161d7ec7c81db93120af11b07162b36785614302)

Signed-off-by: Kristi Rifenbark <kristi@buzzcollectivemarketing.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:32 +00:00
Kristi Rifenbark
30a206f8da ref-manual: Added 16.04 as the LTS for Ubuntu
Fixed [YOCTO #12537]

(From yocto-docs rev: 20a80210eeefddff91a6ea669a63c417144a529c)

Signed-off-by: Kristi Rifenbark <kristi@buzzcollectivemarketing.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:32 +00:00
Scott Rifenbark
cfdf4c78eb getting-started, dev-manual: Created Layer Model section
This involved removing the general information about layers from
the dev-manual and incorporating it into the new section of the
getting-started manual.

(From yocto-docs rev: 26438b03751948661f48fb0c023e393101b80e19)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:32 +00:00
Scott Rifenbark
4b3ebf00dc getting-started, mega-manual: New content for intro chapter
Created content for "What is the Yocto Project" section.
Involved a new figure that had to be shared in the mega-manual
figures folder.

(From yocto-docs rev: 72c18abd11587f4d78848afb8a71ff7f4a0e76d0)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:32 +00:00
Scott Rifenbark
31f0dda70b getting-started, mega-manual: Added new GS chapter
I have added a chapter to the getting-started manual that will
introduce the YP.  Just the framework exists at this point.
Changes to the mega-manual.xml file were made to include the
new chapter in that manual as well.

(From yocto-docs rev: 8a52156ac02d9a9a97c5f0cd8dce5f70d2be68d0)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:32 +00:00
Scott Rifenbark
64b1736114 getting-started: Chapter title change
Updated the manual introduction chapter's title.

(From yocto-docs rev: db067668a6202318bbbcc62cc455c34e099182de)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:32 +00:00
Kristi Rifenbark
da0973642d ref-manual: Removed Ubuntu 14.04 from Supported Linux Distribution
Fixes [YOCTO #12537]

(From yocto-docs rev: 1bfa46614a93320c44ddc31fa8866e82c5349293)

Signed-off-by: Kristi Rifenbark <kristi@buzzcollectivemarketing.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
813772451f documentation: Moved the detailed build section to concepts-manual.
The section that provides a closer look into the build system has
moved from the getting-started manaul to the concepts-manual.
I fixed all the links, provided some coded formatting of the
entire section, and made general updates.

The other manuals had links that needed fixed due to the move.

(From yocto-docs rev: b83a5619f56ebd9879fdcadcf474859e68b26d58)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
b509d336c7 Makefile: Updated tarball lists for figures
The list of *.png files included in the TARBALL variable setting
changed due to figures moving from the getting-started manual to
the concepts-manual.

(From yocto-docs rev: 1439fa9f22a2b2746aa8e8303205f5ec33c7f67b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
c56f781994 getting-started: Removed unused figures
The figures from the deeper look of the build section got moved
to the concepts manual.  Removed these unused figures.

(From yocto-docs rev: 13175a89b6d7bf79a86f4ac45d5f2cd78ba02108)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
56729c9087 concepts-manual: Added figures for closer look section
Had to move these figures from the getting-started manual to
the concpets manual.

(From yocto-docs rev: ba221db465a7535197d9e29f5136ef2d3a6e3171)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
8d320536dc dev-manual, getting-started: Moved the BB syntax section
This section on BitBake syntax appeared in the Getting Started
manual.  I decided that it should live with the section on
writing a new recipe.

(From yocto-docs rev: 8d83ce3e11405b2f12f27cdd117a19c4af52146a)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
72be05b9f5 concepts-manual: Updated the introduction text.
(From yocto-docs rev: f8ee4c23b46bb02cf82d26ed6c1849cae0cad51f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
01a70aaea9 concepts-manual: General edits
Removed redundant links, changed some wordings.  This was a general
scrub of the prose.

(From yocto-docs rev: 2c0ff0af7df3aa46fc05aaf28039a2ffb380424a)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
d74420e778 concepts-manual: Updated toolchain fig to use "*_ext"
(From yocto-docs rev: 64f3edd786779a1c1a7da8a5005c653a4ff8ce2a)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
d9ead424c5 ref-manual: Updated "Build System" term to "Build Host"
(From yocto-docs rev: 2f5b8678e3c4b791a8cdfe5e75da706b97fbc753)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
27072387fa concepts-manual: Updated toolchain figure to use "*_ext
(From yocto-docs rev: 88bf1a438f7a7323f1b7275d3d7bf715d4973569)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
30335a6269 ref-manual: Updated comprehensive list of manuals etc.
I added the concepts manual, the ref manual, and the mega-
manual to the list.

(From yocto-docs rev: 180387ac9ae74cd5b69c4cf6338b72daef4b9f37)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
64c70a7137 concepts-manual: Content adjustments for the manual.
The manual's two files are an introductory chapter and then
a deeper concepts chapter. I scrubbed through the material, which
originated from the getting-started (overview-manual).

(From yocto-docs rev: 2ca572fac3ca71e73aad9bdd516a6ce90b148c53)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
d924e446a3 Makefile: Updates so that the new concepts-manual can be made.
(From yocto-docs rev: ede784df8034d3e582248952716af3441315cae9)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
6512622882 documentation: Updated links into new concepts-manual
Creation of a new concepts manual and moving of chapters from the
getting-started (overview-manual) caused many links and manual
reference titles to break.  I fixed these throughout the YP
docs.

(From yocto-docs rev: 30f2bc46be4a0faf5302eb8605bcb29f3bee6cf3)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
5eed9a3fbe concepts-manual: Updates to parent file
Edits to create the main file that builds the concepts-manual.
Includes the chapters that comprise the book.

(From yocto-docs rev: d3a82e7cf50d77fcc4a37f13be98a61d85b1e527)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:31 +00:00
Scott Rifenbark
e5b1c55760 concepts-manual: Updated customization files to point to style guide.
(From yocto-docs rev: d0b35e9fa0240466dc4d5436e3a12ba87114951e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:30 +00:00
Scott Rifenbark
675ba3064f concepts-manual: Updated style sheet to display title PNG file.
(From yocto-docs rev: 90eab7064d1fca0d37fd49db163d792880be5a1b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:30 +00:00
Scott Rifenbark
d1249c2ba8 mega-manual: Added concepts-manual so it can be made
Also updated the mega-manual.sed file with two lines to process
links in the concepts-manual.

(From yocto-docs rev: 622ce2fc82cbf92351aa2000c3d92bbabafc1d24)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:30 +00:00
Scott Rifenbark
1c4908a1fb concepts-manual, mega-manual: Added title fig for concepts-manual.
(From yocto-docs rev: c932704d29bd0a065a28675859d5b6f09d8e87e5)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:30 +00:00
Scott Rifenbark
2da591b5c2 concepts-manual: Removed unwanted figures
When creating the new concepts-manual, I copied the existing
getting-started manual over.  This created a figures folder that
had a lot of figures not needed in the concepts-manual.  They
have been removed.

(From yocto-docs rev: 24bd39c7f3967a1e8fbac7a8ab44360c25a9bec1)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:30 +00:00
Scott Rifenbark
ca354ba536 concepts-manual: Removed redundant chapter
This chapter appears in the getting-started manual.

(From yocto-docs rev: 3f4c2fc211189e59e45bef6b379dc1f6ebfb7391)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:30 +00:00
Scott Rifenbark
0b70161692 concepts-manual: Added new manual tree
Tree added only.

(From yocto-docs rev: bacfd8c9103489c9b5a3459855d0804531ef3a75)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:30 +00:00
Scott Rifenbark
4d623003f3 documentation: Purged overview manual references
When I converted the Yocto Project Overview Manual to the Getting
Started With Yocto Project Manual, I updated the strings for
references from "&YOCTO_DOCS_OVERVIEW_URL" TO
"&YOCTO_DOCS_GS_URL".  Unfortunately, I did it with a global command
that did not take into account the text the might follow the link
by saying "see such-and-such section in the Yocto Project Overview
Manual."  So, I had to hand fix these.

Additionally, since I have moved a deeper concepts chapter that
was in the getting-started manual to a new Yocto Project Concepts
chapter, many of those links changed had to really go to the new
manual instead.  Those were fixed.

(From yocto-docs rev: fca1c56b0764802fb6a687ea81ab0fb95186cf0a)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:30 +00:00
Scott Rifenbark
31bd483368 mega-manual.xml: Removed the getting-started-concepts.xml file
Because the deeper concepts chapter that was in the Getting Started
With Yocto Project Manual was moved to a new Yocto Project Concepts
Manual, I had to delete it from the mega-manual.xml file where it
would be included as a chapter in the getting-started manual.

(From yocto-docs rev: a6847cc90cd0e35e275dd4cf080067ecbe5d4361)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-02-14 15:25:30 +00:00