summaryrefslogtreecommitdiffstats
path: root/documentation
Commit message (Collapse)AuthorAgeFilesLines
...
* sdk-manual: Edits to the Oxygen sectionScott Rifenbark2018-06-151-56/+64
| | | | | | | | | | Found several items that were slightly off after working through the procedure. Updates to bring it into line with reality. (From yocto-docs rev: bc024c4484db3fdfb44fdb6f8709ad47378d85e2) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Updated the "Makefile-Based Projects" section.Scott Rifenbark2018-06-151-55/+230
| | | | | | | | | | | Expanded this section to contain a figure of the flow and an example that showcases the ways to override and use SDK environment and Makefile variables. (From yocto-docs rev: 422b5dda50c47d03adf2a8c4e8cfdb02eddff0ca) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Created a new Makefile flow diagramScott Rifenbark2018-06-153-2/+2
| | | | | | | | | | | | | | The Makefile-Based Projects section was expanded to add a useful example and figure. Added this figure to the sdk-manual and mega-manual figures folders. Updated the Makefile to include the new figure as part of the tar files for each manual. (From yocto-docs rev: 5bf979f924200a31cb28fe9920b0877d5562e0f5) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Review edits to the "Autotools-Based Projects" section.Scott Rifenbark2018-06-153-61/+40
| | | | | | | | | | | | Autotools is simpler now as it uses "autoreconf" to one-step a bunch of the existing tools such as aclocal and autoconf. I updated the figure to reflect the simpler flow and also the steps that accompany the figure. (From yocto-docs rev: 232f80b4723c1a51ed0d0e55c00b13e64390d69a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Updates to the "Makefile-Based Projects" section.Scott Rifenbark2018-06-151-33/+96
| | | | | | | | | | | I wrote the section to include a flow diagram using "make" and provided a working example highlighting how to override environment variables. (From yocto-docs rev: c147d1ee1f6f33a5222eb1ccf466d1854c67815c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Added cross-reference to Makefile section. Fixed syntaxScott Rifenbark2018-06-151-4/+12
| | | | | | | | | | | | | | | Two changes here. One was a note to the "make" step of the Autotools-based section. I cross-referenced the Makefile section for information on how SDK installation environment variables are respected and or overridden when using make variables. Also, fixed the quotation syntax of the four environment variable examples used in the "Makefile-Based Projects" section. (From yocto-docs rev: a5742a8730359ed28f10108cb741913472337c57) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual, mega-manual: Added Autotools flow figureScott Rifenbark2018-06-153-2/+2
| | | | | | | | | | | | | | New figure for the section on Autotools workflow. The figure goes in the folders for both the sdk-manual and the mega-manual. Updated the Makefile to include the new figure in the tarball when creating both manuals. (From yocto-docs rev: 01f33f7ee293de4dbe0398aae6c087de686be965) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Updated the Autotools workflow example.Scott Rifenbark2018-06-151-165/+167
| | | | | | | | | | | Did a re-write of this section with better explanations. I also pulled the bit about passing parameters to the configure script into the step that talks about that. (From yocto-docs rev: 778e566100450cce15808f80ace2b92f811001a7) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Changed "configure.ac" file in the autotools-based exampleScott Rifenbark2018-06-151-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | The line used to be "AC_PROG_INSTALL". I did some digging and can't really figure out why the example is not following the standard "helloworld" stuff out there all over the internet. So, I have the user create a configure.in file as follows now: AC_INIT(hello,0.1) AM_INIT_AUTOMAKE([foreign]) AC_PROG_CC AC_CONFIG_FILES(makefile) AC_OUTPUT The original was as follows: AC_INIT(HELLO,0.1) AM_INIT_AUTOMAKE([foreign]) AC_PROG_CC AC_PROG_INSTALL AC_OUTPUT(Makefile) (From yocto-docs rev: 21eac500384aaea577ce90098c835cd140517941) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Updated link to variables set for cross-toolchain scriptScott Rifenbark2018-06-151-2/+2
| | | | | | | | | | | The link was going to a spot from which another link was suggested. Too many redirections for the reader. Linked to the original place instead. (From yocto-docs rev: 9983cecb37f179a8eef28ab20a6539f8af100978) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Updated formatting for "configure" scriptScott Rifenbark2018-06-151-3/+5
| | | | | | | | | | Formatting used for the "configure" script created using the "autoconf" command in the example. (From yocto-docs rev: 6c57cd80acc0d5fa5f75a4b6341bc2521ceb43b5) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Replaced "configure.in" with "configure.ac"Scott Rifenbark2018-06-151-1/+1
| | | | | | | | | | | | The Autotools example called for a "configure.in" file as part of the "hello-world" example. When working through the example, a warning occurs saying that the file needs to be "configure.ac". I changed the example. (From yocto-docs rev: f2ec3e564f828ad79f778d47862b4b422ad5a147) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Added cross-referencing to "Autotools-Based Projects"Scott Rifenbark2018-06-151-2/+4
| | | | | | | | | | Needed to reference a couple terms for first use: "cross-development toolchain" and "OpenEmbedded build system". (From yocto-docs rev: a0058122b00833bad84af007dfe466e9a2f6434b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Running the SDK Environment Setup Script"Scott Rifenbark2018-06-151-8/+9
| | | | | | | | | Minor edits to this section. (From yocto-docs rev: 40217ebcbae17f39cc8eca17f309068f4d055c23) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to standard SDK intro and install sectionsScott Rifenbark2018-06-151-28/+26
| | | | | | | | | | | Changed the output to reflect the real command's output. Updated prose to match (mostly) that used in the similar extensible SDK sections. (From yocto-docs rev: dd929244162eaf00f5e552ea8a96a7c2a89daa9f) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Creating a Derivative SDK With Additional Components"Scott Rifenbark2018-06-151-16/+19
| | | | | | | | | Fixed some poor writing in this section. (From yocto-docs rev: ed59c0e30d6c093f0dda54c0d61a2863a7e826e0) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Installing Additional Items Into the Extensible SDK"Scott Rifenbark2018-06-151-13/+13
| | | | | | | | | Minor edits. (From yocto-docs rev: 4a8d8eb83f4a9712e883a4fed98038d14ef48fb6) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Restoring the Target Device to its Original State"Scott Rifenbark2018-06-151-7/+7
| | | | | | | | | Fixed a grammar error and made a few other corrections. (From yocto-docs rev: 22c2f0643975b620fb543b651eae7c510b141770) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Packaging" section.Scott Rifenbark2018-06-151-16/+17
| | | | | | | | | Edits to improve writing. (From yocto-docs rev: 470549b0d5c74f256fec2947e701a0fa3a0f6591) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Sharing Files Between Recipes"Scott Rifenbark2018-06-151-3/+5
| | | | | | | | | | Added a cross-reference to the term "build host". Corrected a subject/verb grammar error. (From yocto-docs rev: 4f5c3a49555601d8a20da1b629a46bde03866e78) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Finding Logs and Work Files"Scott Rifenbark2018-06-151-35/+46
| | | | | | | | | | This section was poorly organized with a mile long sentence as the opener. Fixed it. (From yocto-docs rev: c2496c7aebc056395b7a796501cf6cd5f6519fff) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Added links to sample tasks to "Working With Recipes"Scott Rifenbark2018-06-151-13/+18
| | | | | | | (From yocto-docs rev: 4c59f516de8edff7eb9ae27194c9af27a853dfa9) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Adding Node.js Modules"Scott Rifenbark2018-06-151-10/+9
| | | | | | | | | Fixed a few sentences up by providing clearer text. (From yocto-docs rev: 64af3ec2c380d73dc863b2aea7878544b472218d) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Adding Native Tools"Scott Rifenbark2018-06-151-5/+7
| | | | | | | | | | Added a cross-reference link to the term "bulid host" and removed the redundant word "system". (From yocto-docs rev: 258086ab4af3739a845d6031e5875c13084e7eb0) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Adding Makefile-Only Software"Scott Rifenbark2018-06-151-17/+17
| | | | | | | | | Fixed some prose in various places. (From yocto-docs rev: f368408a3764ad9248478383236261066772f0b6) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "License Detection"Scott Rifenbark2018-06-151-14/+17
| | | | | | | | | Updates to prose for better understanding. (From yocto-docs rev: 5c4384d4311d8fbedad0eb9ebb77427a1dbbbdcf) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Dependency Detection and Mapping"Scott Rifenbark2018-06-151-12/+13
| | | | | | | | | Updated various prose for better understanding. (From yocto-docs rev: 13d5330dc5de232311fbb43d5041d0f7f11de6c0) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "Name and Version"Scott Rifenbark2018-06-151-9/+13
| | | | | | | | | Poor writing left over in here. Updated some of the prose. (From yocto-docs rev: 9812ce3f1b6a4931a1b8b634a6d1f69c0e96c957) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to "A Closer look at devtool add" section.Scott Rifenbark2018-06-151-4/+4
| | | | | | | | | Corrected some prose to be clearer. (From yocto-docs rev: 9ab0ef0c00792f07f3b45466baeafe30199f048f) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual, mega-manual: Updated devtool add and upgrade figuresScott Rifenbark2018-06-154-0/+0
| | | | | | | | | | Took out the $TMPDIR part for the output and left more generically as "Build Output". (From yocto-docs rev: 90b3c468dbea19c87340bd234ffe1b263ffa1e4f) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Changes to the devtool upgrade section.Scott Rifenbark2018-06-151-29/+52
| | | | | | | | | Edits to improve this section. (From yocto-docs rev: af0084dd82b7dcec73db5a1b4e6760b7b7738bf9) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual, mega-manual: Updated the devtool upgrade flow diagram.Scott Rifenbark2018-06-152-0/+0
| | | | | | | | | | Added more detail at the top for how the local recipe interacts with the Upstream Source. (From yocto-docs rev: fea704bc485c53bf27ce43f5d1d491bf652ddc9c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to the devtool add workflow section.Scott Rifenbark2018-06-151-2/+2
| | | | | | | | | Minor edits from the read-through. (From yocto-docs rev: ee25d5a607591823401b6c7e8b9b7dccf707f996) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual, mega-manual: Updated devtool add flow diagramScott Rifenbark2018-06-152-0/+0
| | | | | | | | | | Added more detail on how the upstream source or files from srctree are located. (From yocto-docs rev: 11c4679ee91afbb96a7ea82f6e32c90b5e3a0d66) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Updated devtool add workflow section.Scott Rifenbark2018-06-153-132/+121
| | | | | | | | | | | | | Had to update the figure to use "Upstream Source" labels and fix a wrong "devtool edit-recipe" command. That new figure went into both figures folders for the sdk-manual and mega-manual areas. Provideds some cleaner wording. (From yocto-docs rev: b55ccf14a9a4b8948a920f0942da1fdda93b2e9e) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Edits to section on running the sdk installation scriptScott Rifenbark2018-06-151-6/+15
| | | | | | | | | | | | | I changed the way we handle the list of exported variables resulting from running the *.sh installation script. Rather than list them all out (they were getting to be quite numerous), I am referencing a few as examples and recommending the user look at the actual *.sh file if they would like to examine the entire list. (From yocto-docs rev: fa60c255a12bd3dd79da4a77c3150937eeb4e201) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Updates to "Running the Extensible SDK Environment Setup Script"Scott Rifenbark2018-05-241-19/+29
| | | | | | | | | | | | Some Minor edits to this section. Also, a scrub of the list of variables exported when running the install script. The list is out of date and is missing many variables. I noted these in comments for now and will add them in later. (From yocto-docs rev: a03f00142f82dd4b2b10332f2fe1c71c2bdd8c35) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Updated the "Installing the Extensible SDK" section.Scott Rifenbark2018-05-241-27/+36
| | | | | | | | | | | | | | | The text had not been updated to include the many architectures now supported in the Index of Releases toolchain directories. I added the list of architectures. Renamed the section to a more appropriate section heading. Verified the example and put in the latest output. (From yocto-docs rev: a567f5101d230ef1fa4428e9c6905e9e23bd5855) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* sdk-manual: Minor edits to the intro chapter.Scott Rifenbark2018-05-241-27/+40
| | | | | | | (From yocto-docs rev: 706b4adfd925d247da2ce7405f12ce1e05666a9e) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bsp-guide: Fixed MACHINE_EXTRA_RRECOMMENDS syntax in conf file exampleScott Rifenbark2018-05-241-1/+1
| | | | | | | | | | | | | Fixes [YOCTO #12628] The syntax for MACHINE_EXTRA_RRECOMMENDS was off in the machine.conf example. I have removed that leading space, which should not have been there. This matches the actual file in poky now. (From yocto-docs rev: 11e38c4c2b23f9a8ae9a0655a07af1a5682c24b8) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Removed "newbie" chapter.Scott Rifenbark2018-05-244-631/+627
| | | | | | | | | | | | | This chapter only had the stuff about submitting a defect against YP and making a change to YP. I moved that information into the common tasks chapter as it is "how-to" information. Removal of this chapter alse required that the mega-manual.xml file be updated to not include the chapter. (From yocto-docs rev: 4421b1585c21a6f7862525ba972f7e765626066e) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved "Speeding Up the Build" and renamed it.Scott Rifenbark2018-05-243-165/+160
| | | | | | | | | | | Renamed to "Speeding Up a Build" and moved out of the setting up chapter to the common tasks chapter. Fixed a couple links in the ref-manual. (From yocto-docs rev: c53fddd353230c8ef1abc21c7a2d2b1f492f034a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Finalized edits on the 2.5 Migration sectionKristi Rifenbark2018-05-241-108/+88
| | | | | | | (From yocto-docs rev: 54259a4d4d69be73e7c614baa2a8d87faa2e3ea5) Signed-off-by: Kristi Rifenbark <kristi@buzzcollectivemarketing.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved "Building Software from an External Source" section.Scott Rifenbark2018-05-241-75/+75
| | | | | | | | | | This section is now organized under the parent "Building" section in the common tasks chapter. (From yocto-docs rev: bc1bc9965cda547e45ff09a1c9e77be5e8c0a3d9) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved "Building Images for More than One Machine" section.Scott Rifenbark2018-05-241-198/+198
| | | | | | | | | | This section is now organized inside the parent "Building" section in the common tasks chapter. (From yocto-docs rev: 71be83e1ebfd2ad8606bddf852a4c06ab7d7c53d) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved "Building a Tiny System"Scott Rifenbark2018-05-241-427/+425
| | | | | | | | | | This section is now part of the building parent section. I have moved it there in the common tasks chapter. (From yocto-docs rev: a9fccb1bca8e18169d93416c7a6e17723bcf01c7) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved "Building an Initial RAM Filesystem (initramfs) Image"Scott Rifenbark2018-05-241-139/+105
| | | | | | | | | | This section now belongs under the parent "building" section in the common tasks chapter. (From yocto-docs rev: dad6029b9b45fd6ec564894ba101991fd8a2162e) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved "Building Targets with Multiple Configurations"Scott Rifenbark2018-05-241-96/+95
| | | | | | | | | | This is a "building" topic. I moved it beneath the new parent "building" section. (From yocto-docs rev: 0426f0dd6871c8063476945b93743ffc5cfc0856) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved the "Simple Build" sectionScott Rifenbark2018-05-245-143/+168
| | | | | | | | | | | | | I had a section on building an image up in chapter that talks about getting set up to use YP. I moved the build section to a new parent section that will hold topics on building various things. I renamed the section to "Building a Simple Image". I had to fix several links in the sdk-manual, overview-manual, and dev-manual. (From yocto-docs rev: c119fc7c6148e7b08acad374fe2981842e9462a3) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Pulled cloning sections up into a parent section.Scott Rifenbark2018-05-241-26/+30
| | | | | | | (From yocto-docs rev: 68ef556831f687e25e3f4df068db4ea86bffb3b3) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>