summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual/dev-manual-common-tasks.xml
Commit message (Collapse)AuthorAgeFilesLines
* dev-manual: Fixed bad linkScott Rifenbark2017-10-161-1/+1
| | | | | | | | | Link to metadata term was not going to the ref-manual. (From yocto-docs rev: 7a116ece403cb88977dfcce3006e2e1bb52b5df0) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Updates to cull out buried YP Website references.Scott Rifenbark2017-10-161-2/+1
| | | | | | | | | | | | | With the redoing of the YP website, it was decided that the manuals could only reference into the top-level and the top-level/documentation URLs of the website. I removed all references to areas such as projects (e.g. Toaster, VM, etc.) and any other URL that was not the top-level landing page or the documentation page. (From yocto-docs rev: 2bd838f1a9fb2698bab098b13b76c8852853e0e7) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Updated .mtoolsrc error instruction note.Scott Rifenbark2017-10-161-3/+4
| | | | | | | (From yocto-docs rev: cb8b2e89406a8c786bbabf78f17d66bb953c6dbf) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Added wic ls, rm, and cp exampleScott Rifenbark2017-10-161-0/+132
| | | | | | | | | | | | Fixes [YOCTO #12191] Put in a new example in the Wic section to highlight the use of the 'wic ls', 'wic rm', and 'wic cp' commands. (From yocto-docs rev: 2bf316961d22d5dc2df2d849c50ec347d5f9db51) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, dev-manual: Updated "Creating Partitioned Images" section title.Scott Rifenbark2017-10-161-2/+2
| | | | | | | | | | | Added "Using Wic" to the section head because that is all we talk about. This affect three links in the ref-manual so I fixed those as well. (From yocto-docs rev: 0e4f245f2b872810e2e164a227900ca6aa313ab8) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, ref-manual: Moved kickstart reference to ref-manualScott Rifenbark2017-10-161-316/+3
| | | | | | | | | | | | | | This section was misplaced in the dev-manual and really needed to be in the ref-manual. I created a new chapter that follows the devtool reference chapter and put the kickstart chapter there. Links were needed to be fixed up and a new chapter in the ref-manual named ref-kickstart.xml had to be created. (From yocto-docs rev: b4d5b7077a978e4966d1273a374741075a1b0c7d) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, dev-manual: Moved plug-in section for wic to ref-manualScott Rifenbark2017-10-161-664/+446
| | | | | | | | | Fixed links affected by the move. (From yocto-docs rev: 250d312274788b0eebf3ae9143f2f89eafd4ab90) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Updated the plug-ins section.Scott Rifenbark2017-10-161-80/+118
| | | | | | | (From yocto-docs rev: d1a4ff5ee177c7b9442d805b6e20a8ba8410d91d) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Updated Wic Kicstart examples.Scott Rifenbark2017-10-161-216/+237
| | | | | | | (From yocto-docs rev: b5393e416c779aa9d4f5116cdea8d5fd09c21bd1) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Fixed broken link to "Images" section in ref manual.Scott Rifenbark2017-10-161-1/+1
| | | | | | | (From yocto-docs rev: b5bc0f8d4be9746281d81555d7c90f66be285fe0) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* kernel-dev: Eliminated "Generating Configuration Files" section.Scott Rifenbark2017-10-061-3/+0
| | | | | | | | | | | | | | | This section was largely redundant now. The small things that did add value I placed in other areas of the chapter 2. One was a new section on expanding variables using bitbake -e. Another was a bit about the defconfig file. And a small procedure on how to create config fragments using the "diffconfig" command was retained. Links from the dev-manual and the ref-manual were adjusted as well. (From yocto-docs rev: 7059d3eac1fec20089cabf197503f1bec747686d) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Updated compatible log program section.Scott Rifenbark2017-09-261-12/+11
| | | | | | | | | Script name changed to "yocto-check-layer". (From yocto-docs rev: 545a90dd2816c4e97dc70efc76c7cca49684c2d8) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Compatibility program and moving kernel configurationScott Rifenbark2017-09-261-529/+62
| | | | | | | | | | | | | | Should have been two commits but I forgot to do them separately. 1. I updated the YP Compatible Program section. 2. I moved the "Configuring the Kernel" section from the dev-manual to the kernel-dev manual. (From yocto-docs rev: cdb5bbc917db55a2ca987ce9b9ed371f9fca6524) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Purged "oe-init-build-env-memres" from docsScott Rifenbark2017-09-221-21/+9
| | | | | | | | | | | | | | Fixes [YOCTO #11968] Purged all occurrences of the "oe-init-build-env-memres" script from the YP documentation set. Occurrences in a lot of places. The BBSERVER variable was also impacted and had to have the definition updated. (From yocto-docs rev: 274b05108d1bc53df20c11ab2efa15363bce23da) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Added support for signed RPM package feedsKristi Rifenbark2017-09-021-3/+1
| | | | | | | | | | | Fixed [YOCTO #11209] Rewrote so text indicates signed RPM package feeds work. (From yocto-docs rev: 41c1e3d786f4436de59697431b2494cbabdebb8d) Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: removed note indicating signed RPM packages unsupported.Scott Rifenbark2017-09-021-4/+3
| | | | | | | (From yocto-docs rev: 00c312e7515d82661fb16cd51f8fe9d03b4ea394) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, kernel-dev, sdk-manual: Moved patching kernel sectionScott Rifenbark2017-09-021-341/+0
| | | | | | | | | | | | | | Moved the "Patching the Kernel" section, which was in the dev-manual to the kernel-dev manual. During the move, renamed the section to "Using devtool to Patch the Kernel". This move bothered a lot of links so I had to fix them in various manuals. (From yocto-docs rev: a000be1eddf33e4d7de8f350e076d48e27ca4b98) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Updated "Sharing Files Between Recipes"Kristi Rifenbark2017-09-021-4/+4
| | | | | | | | | | Updated text for sysroot terminology, and clarity. Fixed a capitalization error. (From yocto-docs rev: 4eea6497663efc937cddf4700298f5824ade7b47) Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, ref-manual: Moved recipe syntax section to ref-manualScott Rifenbark2017-09-021-297/+5
| | | | | | | | | | | The section on recipe syntax that was buried in the creating a new recipe section was really a reference on syntax. I have moved it to the ref-manual. (From yocto-docs rev: cb55d1b5832cca6faa6e2a5b26f3add3032cade2) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Converted sections for following best layer practicesScott Rifenbark2017-08-091-182/+167
| | | | | | | | | | | | | | The section about following best practices was more of a reference section the way it was written. I recast the section and the sub-sections such that it is a list of items to consider. Also renamed the section to be more of an action section rather than passive. (From yocto-docs rev: 8b050a46c67a3d3e89d905cf028eec6ae370388a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Updates to "Using .bbappend Files in Your Layer"Scott Rifenbark2017-08-091-35/+36
| | | | | | | | | | | | | | | I did some rewriting for clarity in the "Using .bbappend Files in Your Layer" section. The section needed to be retitled so focus on the layer aspect of .bbappend files. Also, while I was in there, I did more work on the prose in general. Also had to fix some links in the bsp, kernel, and ref manuals that linked into the section whose name I changes. (From yocto-docs rev: a82bcc9fe0f909135434ee1bd36b4414f6c046c9) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Changed wording that intros layer creation stepsScott Rifenbark2017-08-091-1/+1
| | | | | | | | | | I updated the wording to note that the steps are how to create a layer without the aid of steps (i.e. by hand). (From yocto-docs rev: 81800fa9ba0dd9ff439a43b286981eea51d4c87f) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Fixed Flash the Device exampleKristi Rifenbark2017-07-121-3/+3
| | | | | | | | | | | | | | | Fixes [YOCTO #11774] Updated bmaptool instructions in Flashing Images Using bmaptool section by changing the sudo command. Fixed the oe-run-native line. (From yocto-docs rev: c3a1e2882abbb7b682ce101a8b038f89c4e2261c) Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Updated the section on initramfsScott Rifenbark2017-07-121-62/+127
| | | | | | | | | | | | I did a rewrite of the section to get it into a procedural form. Missing some technical information and needs a review but it is the best that can be done at this time. The code for initrd is not settled. (From yocto-docs rev: 0fdef8c5fed6ac510d1604a677e6546494b4c96b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Moved devtool workflow to sdk manualScott Rifenbark2017-07-121-7/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Fixes [YOCTO #11630] The section on the devtool workflow in the dev-manual was 99% identical to what was in the sdk-manual. I have moved the workflow procedure from the old "Model" chapter of the dev-manual to be merged with what was in the sdk-manual. In truth, the only things added were a note about devtool not being exclusive to SDK development. The result of moving (deleting) this section was that the "model" chapter of the dev-manual went away. The devtool stuff, Quilt, devshell, and python shell are all out now and there is no chapter left. So, mega-manual had to be adjusted to not pull that chapter in when building the dev-manual. I had to delete three figures that were used in the flow. The figures were already replicated in the sdk-manual. The figures were deleted from the figures folder of both the dev-manual and the mega-manual. I had to make sure all references to the old devtool stuf in the YP doc set were adjusted. (From yocto-docs rev: 5dbd643d31ab502df53a22229e457a03da7772b7) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved devshell and python shell workflow sections.Scott Rifenbark2017-07-121-0/+175
| | | | | | | | | | | | Fixes [YOCTO #11630] These two sections can stand alone as tasks. I moved them to the "Common Tasks" chapter. (From yocto-docs rev: 60c810a9682f8a110fe7c7e4d0d40583a7d72735) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved "Using Quilt in Your Workflow" to tasksScott Rifenbark2017-07-121-0/+134
| | | | | | | | | | | | Fixes [YOCTO #11630] The section on useing Quilt can be a stand-alone task. I moved it to the "Common Tasks" chapter. (From yocto-docs rev: bb84b88fc8fc7f82e7bbe580d408ae7880f38d8b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved "Finding Temporary Source Code"Scott Rifenbark2017-07-121-2/+103
| | | | | | | | | | | | Fixes [YOCTO #11630] This section can stand as a separate task. I have moved it to the Common Tasks chapter. (From yocto-docs rev: e4fb1ce8b160528aae0f192add614a595b2560a3) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Moved the "Flashing Images using bmaptool" section.Scott Rifenbark2017-07-121-0/+92
| | | | | | | | | | | | | Fixes [YOCTO #11630] Moved this section from the "Getting Started with the Yocto Project" section. The topic is not really a getting started topic. It is better suited in the "Common Tasks" chapter. (From yocto-docs rev: d6cdade9066bdbce0596672978c178d2ec82c9a4) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Fixed poor cross-referenceScott Rifenbark2017-07-121-2/+2
| | | | | | | | | | Was referencing the "Building Images" section when should have been referencing the "Images" section in the ref-manual. (From yocto-docs rev: 7340b358d57c110240e75c1164226144065120b7) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Updated Using RPM exampleKristi Rifenbark2017-07-121-1/+1
| | | | | | | | | | | | Fixes [YOCTO #11699] Configuration example didn't work with "" around baseurl. Removed "". (From yocto-docs rev: c40d818fb92904b74e677749ee16c52716dd02a9) Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Changes section head for sumbitting change to YPScott Rifenbark2017-06-221-1/+1
| | | | | | | | | | | | | Fixes [YOCTO #11630] I changed the section heading for the section that describes how to make a change to the YP. It was passive. I need it to be active and in line with the "how-to" dev-manual. (From yocto-docs rev: 340e1b6ab9806ec11ec894d4472bc2c937c2b058) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Moved "Yocto Project Source Repositories" sectionScott Rifenbark2017-06-221-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | Fixes [YOCTO #11630] The "Yocto Project Source Repositories" section is purely conceptual and thus does not belong in the reconstituted dev-manual, which is converting to a "how-to" manual. I have moved this section to the ref-manual under "The Yocto Project Development Environment" section. Moving the section affected several things. Three figures that where in the dev-manual were copied and moved to the figures folder of the ref-manual. This required deleting them from the dev-manual and adding them to the ref-manual. The makefile had to be edited to move those figures into the ref-manual and delete them from the latest version of the dev-manual in order for the tarball of files to be correct when the manuals are made. Links to anchors within the moved section had to be fixed in various manuals. Links to the main section "id" had to be fixed to point to the ref-manual manual. (From yocto-docs rev: c619ae2bbc6be93cb0324ca44e936eefec12b28c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Re-org for "closer-look" chapterScott Rifenbark2017-06-221-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Fixes [YOCTO #11630] The ref-manual needs expansion for the old "closer-look" chapter. This chapter previously held a detailed look at what happens when a user uses the YP to develop something. Now, the chapter needs to also contain YP development environment concepts (e.g. open- source philosophy, etc.), which are coming from the dev-manual. Because of this, I renamed the "closer-look.xml" chapter to be "ref-development-environment.xml". I also renamed the larger section that was formerly the entire chapter into its own section named "Development Concepts". Both these changes caused a few links to break. I fixed all the links from within the various manuals so they would find appropriate targets. I did some re-writing for introductory material to introduce the new chapter and the section on "Development Concepts". A new file ("ref-development-environment.xml") was added by basically renaming the "closer-look.xml" chapter. And, the tracking for "closer-look.xml" was deleted. (From yocto-docs rev: e37806474578b4f0ed137f64d68a39a17ab60644) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Fixed broken links to "Source Directory" term.Scott Rifenbark2017-06-221-16/+16
| | | | | | | | | | | | | Fixes [YOCTO #11630] Moving the "Yocto Project Terms" section from dev-manual to ref-manual broke all the links to the "Source Directory" term. I fixed them. (From yocto-docs rev: d3a206b141e0b0c623362622ec73bbf44118071a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Fixed links for "metadata" term.Scott Rifenbark2017-06-221-5/+6
| | | | | | | | | | | | | Fixes [YOCTO #11630] Moving the "Yocto Project Terms" section from the dev-manual to the ref-manual broke the links to the "Metadata" term. I fixed these. (From yocto-docs rev: 190da4b4d44952d141db26ca72b5bc1a52d77023) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Fixed links for "build-directory" term.Scott Rifenbark2017-06-221-28/+31
| | | | | | | | | | | | | Fixes [YOCTO #11630] Moving the "Yocto Project Terms" section from the dev-manual to the ref-manual broke several links to the id "build-directory". I fixed these to reference into the ref-manual now. (From yocto-docs rev: debe2ae8ce203ebe0f1cee0de54124c15df8bb7e) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, dev-manual: replaced "depexp" with "taskexp"Scott Rifenbark2017-05-101-2/+2
| | | | | | | (From yocto-docs rev: 3d7a13357a12b70d0c46b8aafdaf2ace20dcb970) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Cleaned up "Gdbserver" termScott Rifenbark2017-05-101-16/+16
| | | | | | | | | This should be "gdbserver" when referred to generically. (From yocto-docs rev: 83b2be50e34b0c07cce1f27b55e595752b80b3ea) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Updated a few occurrences of "dnf" to "DNF"Scott Rifenbark2017-05-101-3/+3
| | | | | | | | | | These depend on context. In general, "DNF" is the preferred terminology unless directly referring to an application or such. (From yocto-docs rev: 29012a8f8e21b964e1ea6d32841dffa8dae7df9f) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Changed "Dnf" to "DNF" for consistencyScott Rifenbark2017-05-101-2/+2
| | | | | | | (From yocto-docs rev: 22ca6c591fd28995a5444635dc787c67f8af822a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, dev-manual: Completed first draft of 2.3 migration section.Scott Rifenbark2017-05-101-9/+10
| | | | | | | (From yocto-docs rev: 42ab9e34da640b46d39741c9c83648dc65518ec1) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, ref-manual: Updated various wordings and linksScott Rifenbark2017-04-201-16/+18
| | | | | | | | | | | | | Fixes [YOCTO #10995] I implemented various wording changes based on feedback from the review. One section title changes so some links in the ref-manual and the dev-manual needed updating as well. (From yocto-docs rev: 43a35a311a006d47db50602822e44ab431ca3e43) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, dev-manual: Updates to support recipe-specific sysrootsScott Rifenbark2017-04-181-17/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Changes covered several areas. Version 2.3 of the YP now supports recipe-specific sysroots and is not limited to machine-specific as was prior releases. Manual changes were as follows: dev-manual: "Sharing Files Between Recipes" - Wordings were changed to support the new functionality. ref-manual: do_prepare_recipe_sysroot task added to the list of tasks described in "Configuration and Compilation". ref-manual: Extensive re-write of the "staging.bbclass" section. ref-manual: Added a section to the build structure for build/tmp/work/tunearch/recipename/version/. This section breaks down the recipe-specific subdirectories used to create (stage) the sysroot. ref-manual: New section (entry) for the do_prepare_recipe_sysroot task in the task chapter. ref-manual: Added a variable glossary description for the SSTATE_SCAN_FILES variable. In addition to these changes, I sprinkled in a liberal amount of cross-referencing for the readers pleasure. (From yocto-docs rev: 3a8ca96861f4c5d3badb91d0cdc5a3df513d4e59) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, ref-manual: Edits to the "Incrementing Binary Package" section.Scott Rifenbark2017-04-121-114/+170
| | | | | | | | | | | | | | | | Fixes [YOCTO #10995] I applied some revisions to the related sections for incrementing a binary package version and revision sections. Mainly clarified terminology and pulled the sections into one single section head. I also cleaned up referencing to all these sections throughout the YP manual set (i.e. the ref-manual). (From yocto-docs rev: 7deda18dd496cc383c5de71a10f2b11b1ca0688f) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, ref-manual: Created new section on linear revision for packagesScott Rifenbark2017-04-121-5/+96
| | | | | | | | | | | | | | | | Fixes [YOCTO #10995] For the dev-manual, I added a new section on incrementing package revision numbers that explains how the build system uses various variables to create linearly numbered revisions for packages. For the ref-manual, I cross-referenced into the new section from the AUTOSRC and SRCREV variables. (From yocto-docs rev: 53c3092e0f0293f4db0a88659abb4cf1c93f208c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Added section on using headers to interface with devicesScott Rifenbark2017-04-121-0/+87
| | | | | | | | | | | | | | Fixes [YOCTO #8596] Added a new section to describe the right way to use headers to interface to a device or custom Linux kernel API. Too often a user wants to modify the libc header file, which absolutely wrong. This new section provides some guidance. (From yocto-docs rev: 960c49bf6446398a9efb2d018d09d63b49e97196) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, ref-manual: Added PACKAGE_WRITE_DEPS and concept supportScott Rifenbark2017-04-121-5/+19
| | | | | | | | | | | | | | | | | Fixes [YOCTO #11274] When a post-installation or pre-installation script uses tools that have dependencies, you need to specify the tools using the new PACKAGE_WRITE_DEPS variable. I added this information at the end of the "Post Installtion Scripts" section in the dev-manual. I also added a new variable entry for the PACKAGE_WRITE_DEPS variable in the glossary. (From yocto-docs rev: 4d130b63cba5ebabd4af52b62421d387a4b54353) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Added cross-reference to QA and Test Infrastructure section.Scott Rifenbark2017-04-121-0/+7
| | | | | | | | | | | | | Fixes [YOCTO #10887] I placed a small paragraph at the end of the introduction to the "Performing Automated Runtime Testing" section that points into the new section on QA and testing infrastructure in the ref-manual. (From yocto-docs rev: 493051e1770e07b89c19a1f235f1dd226610c77a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Added YP Compatibility featureScott Rifenbark2017-04-121-1/+218
| | | | | | | | | | | | | | | Fixes [YOCTO #10596] No information existed for the version 1.0 YP Compatibility Program for layers. Additionally, the version 2.0 flavor is adding a script as part of the application process. I put in a new section on the whole topic. Also, integrated the information into relevant sections with some cross-referencing. (From yocto-docs rev: 6341705d4c08901b2657c489f4e995968db00d85) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>