summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
Commit message (Collapse)AuthorAgeFilesLines
* ref-manual: Updated PACKAGECONFIG_CONFARGS variableScott Rifenbark2017-06-141-18/+0
| | | | | | | | | | | Fixes [YOCTO #11600] Removed the example. It was not needed. (From yocto-docs rev: 402bb173b00a665fb55a8f740a4dbe60ead57f25) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added warning to native.bbclass for naming conventionScott Rifenbark2017-06-141-0/+8
| | | | | | | | | | | | | Fixes [YOCTO #11411] Added a naming convention warning to the native.bbclass description that is similar to the existing warning used in the description for the nativesdk.bbclass. (From yocto-docs rev: 2ceeb5416d439197e94640229e3685ab8b87e0fb) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated PACKAGECONFIG_CONFARGS variable descriptionScott Rifenbark2017-06-141-5/+2
| | | | | | | | | | | | | Fixes [YOCTO #11600] "configure" and "cmake" are not do_* tasks of BitBake. I updated the formatting of these programs and removed links that were to the tasks in the reference manual. (From yocto-docs rev: 2605c7378f6b4b49c2e2baaf159fd2c289d83a1a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* Documentation: Created YP 2.4 "latest" docsScott Rifenbark2017-06-041-0/+5
| | | | | | | | | | | | | | Updated poky.ent to use 2.4 variables and numbering Updated mega-manual.sed to use "2.4" string for links Updated all manual revision tables to use "2.4" and "Usually October, 2017" string. (From yocto-docs rev: 17ec7da6ab3fd450c2010812f7ad689288b12dcc) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated the PACKAGECONFIG_CONFARGS variable descriptionScott Rifenbark2017-06-041-6/+20
| | | | | | | | | | | | Fixes [YOCTO #11600] Made some technical corrections to the PACKAGECONFIG_CONFARGS variable description in the glossary. (From yocto-docs rev: c422783984748f170943eab418bfa7d0111fa352) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added LAYERRECOMMENDS variable descriptionScott Rifenbark2017-06-041-0/+32
| | | | | | | | | | | Fixes [YOCTO #11579] Added a new description for the LAYERRECOMMENDS variable. (From yocto-docs rev: 3004a5724c4ea7165e4f749f9c9237ee1fbd89f5) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated LAYERDEPENDS variable descriptionScott Rifenbark2017-06-041-11/+20
| | | | | | | | | | | | | Fixes [YOCTO #11579] The syntax for specifying a layer version was incorrect. I have added an explanation for the correct syntax and provided an example. (From yocto-docs rev: 5703fb2f8b9d3df408c596603b8b8416597fc67a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated image-live.bbclass descriptionScott Rifenbark2017-05-182-6/+16
| | | | | | | | | | | | | | | | Fixes [YOCTO #9001] Updated the image-live class description to specifically mention creating *.iso and *.hddimg images as "live" images. Provided more explanation about usage through the NOISO and NOHDD variables. Also, provided a cross-referencing link back to the updated image-live class from the EFI_PROVIDERS variable. (From yocto-docs rev: 788061b2911339c8396b798a0ab5635ab5bb89e1) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Enhanced the glossary description for INHERITScott Rifenbark2017-05-181-4/+14
| | | | | | | | | | | | | Fixes [YOCTO #11498] I enhanced the description of the INHERIT variable's glossary description to provide more detail. I also included a link into the section of the BB manual where INHERIT is described. (From yocto-docs rev: 663cde3cf05ebf564ff3a28cd37b696be2f91ad8) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Fixed typo for "Installation"Joshua Lock2017-05-181-1/+1
| | | | | | | (From yocto-docs rev: fbd983cda864174ac056cb4b9b54296d0f0c22e4) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Removed section on checking for build-time dependencies.Scott Rifenbark2017-05-101-59/+0
| | | | | | | | | | This scheme has changed due to recipe-specific sysroots making it obsolete. Removed the entire section. (From yocto-docs rev: c52a896829212863402e5532dd8fb7fe4c247fca) 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-102-2/+2
| | | | | | | (From yocto-docs rev: 3d7a13357a12b70d0c46b8aafdaf2ace20dcb970) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Removed text surrounding BB_SETSCENE_VERIFY_FUNCTION* varsScott Rifenbark2017-05-101-11/+0
| | | | | | | | | | | | The BB_SETSCENE_VERIFY_FUNCTION2 variable no longer exists. I removed a link to the BB manual to this variable description, which no longer exists. Also, removed a paragraph in the discussion around setscene that talked about the variable. (From yocto-docs rev: 1f8e3d53ee72c369cb1211332e074976737fd76b) 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-1/+1
| | | | | | | (From yocto-docs rev: 22ca6c591fd28995a5444635dc787c67f8af822a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added links for variablesScott Rifenbark2017-05-101-5/+8
| | | | | | | | | Needed to add cross-links into the glossary for various variables. (From yocto-docs rev: 45acf78a2f99e8fda91042c2bee30094255e5a10) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added 4 DISTRO_FEATURES* variable descriptions.Scott Rifenbark2017-05-101-0/+77
| | | | | | | | | | | | | | | | Added the following: * DISTRO_FEATURES_NATIVE * DISTRO_FEATURES_NATIVESDK * DISTRO_FEATURES_FILTER_NATIVE * DISTRO_FEATURES_FILTER_NATIVESDK to the variables glossary. (From yocto-docs rev: ee68291c32cdbf8004c24295784c0f70f02c0a55) 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-107-100/+528
| | | | | | | (From yocto-docs rev: 42ab9e34da640b46d39741c9c83648dc65518ec1) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Applied 2.3 Migration review comments.Scott Rifenbark2017-05-101-49/+120
| | | | | | | (From yocto-docs rev: 08a077adea37d5b3eb3ac119b1a5981a6fef21a3) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added new glossary entries for HOSTTOOLS* variables.Scott Rifenbark2017-05-101-0/+47
| | | | | | | | | Entry added for HOSTTOOLS and HOSTTOOLS_NONFATAL. (From yocto-docs rev: c766920a13071c1bb46a195ea07be38962d2e12d) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added warning for nativesdk recipe naming conventionScott Rifenbark2017-04-291-0/+8
| | | | | | | | | | | | | | Fixes [YOCTO #11411] To help clear up the importance of the naming convention a user must follow when creating a nativesdk-myrecipe.bb recipe that inherits the nativesdk class, I placed a warning note at the end of the section for the "nativesdk.bbclass" section. (From yocto-docs rev: e6dc512aaeb0267c2c15c17a599c6950728b4547) 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-202-3/+3
| | | | | | | | | | | | | 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>
* poky.ent: Removed "python3-expect" package from 3 distros.Scott Rifenbark2017-04-181-1/+7
| | | | | | | | | | | | | | Fixes [YOCTO #11310] After a bit of deliberation.. it was decided that "python3-expect" is not needed in the Debian, Fedora, and OpenSUSE distros as an essential package. They are gone. (From yocto-docs rev: 07fcb23a03122e5f4f9bb2a32e585d9cba7d5d93) 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-185-12/+305
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-122-3/+3
| | | | | | | | | | | | | | | | 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-7/+15
| | | | | | | | | | | | | | | | 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>
* ref-manual: Initial draft of 2.3 migration section.Scott Rifenbark2017-04-121-0/+212
| | | | | | | (From yocto-docs rev: c4c995aa94e5100e0d306eb91f490c23726ea91f) 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-0/+25
| | | | | | | | | | | | | | | | | 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>
* ref-manual: Added section on test and QA infrastructureScott Rifenbark2017-04-121-0/+131
| | | | | | | | | | | | | | Fixes [YOCTO #10887] There needed to be an overview of the test and QA infrastructure used by the YP development team for releases and that is visible to the developer. I added a new section for this information into the existing section on YP release processes. (From yocto-docs rev: 17b3d6898b37bdbfbd23a333a4d659a9746696d0) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Rewording of devtool-deploy target command caveatsScott Rifenbark2017-03-311-3/+3
| | | | | | | | | | | | Fixes [YOCTO #10350] Based on Henry's assesment that the wording was unclear in some spots, I did a little smithing to try and help. (From yocto-docs rev: b52bb8d73071ad6b7a0956dec2f84a84ae1c7045) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual; ref-manual: Updates to replace "smart" with "dnf"Scott Rifenbark2017-03-313-4/+5
| | | | | | | | | | | | Fixes [YOCTO #9675] Various fixes to replace the "smart" package manager references with "dnf". (From yocto-docs rev: 721dc7fb637c4c03534eb19f61b0b08a7303826d) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Fixed wording for clarityScott Rifenbark2017-03-311-3/+3
| | | | | | | | | | | | | Fixes [YOCTO #10898] I altered the verbiage used to describe the inclusive nature of the beginline and endline note to be clear to non-native English speaker based on feedback. (From yocto-docs rev: 5edf417cd044ded30d1f8366ac0cde336d0da016) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, yocto-project-qs, poky.ent: Fixed CentOS essentialsScott Rifenbark2017-03-311-2/+22
| | | | | | | | | | | | | Fixes [YOCTO #10854] I added extra "yum" commands and a make command to deal with some essential packages needed for CentOS distribution. These packages were missing. (From yocto-docs rev: 38ac6cf0165f7dd7bbfd583e218b6948dafae29c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Added support for "pyro" name and May release date.Scott Rifenbark2017-03-241-1/+1
| | | | | | | | | | | | | poky.ent - changed the "tbd" and "TBD" strings to "pyro" and "Pyro", respectively. Manual Head Files - Updated the manual history table with the May release month. (From yocto-docs rev: 076226d2986d0cf69685121e4342f50c1603fc7b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated note about included failed license checkScott Rifenbark2017-03-241-6/+16
| | | | | | | | | | | | | | | Fixes [YOCTO #10898] It is hard to get the exact start and end for included license text during a LIC_FILES_CHKSUM operation. I updated the notes indicating that the QA message returned upon failure includes the attempted license text. The user can better adjust his LIC_FILES_CHKSUM statement to then dig out the proper text. (From yocto-docs rev: 1db04334703f35f1cab933c345fb1db43fd0af79) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual, ref-manual: Added support for WKS_FILE_DEPENDS variable.Scott Rifenbark2017-03-241-0/+44
| | | | | | | | | | | | | | | | | Fixes [YOCTO #11017] There is no current way to specify or list plug-in dependencies when building a Wic image. The variable WKS_FILE_DEPENDS was introduced to allow the user to use this in the recipe building the image. I added a description and example of the variable to the ref-manual variable glossary. I also cross-referenced the variable in the "Plug-ins" section of the dev-manual to point to the variable for more information. (From yocto-docs rev: 5a1072499ab80f74ffec6af2cc0b2f1987843a25) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added information about pre-installed dependenciesScott Rifenbark2017-03-241-0/+45
| | | | | | | | | | | | | | | | | Fixes [YOCTO #10350] A situation exists where a user deploys a new application using devtool target-deploy and the new application has runtime dependencies that are not already on the target. When this situation exists, the application misbehaves if it calls a missing function. I added the explanation of this situation to the section that describes the devtool deploy-target command. Also, put a pointer in the section on devtool add for cross-reference purposes. (From yocto-docs rev: 694151e397ff40871b3ec8700c39d32a15814535) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added new "Release Process" chapterScott Rifenbark2017-03-242-0/+125
| | | | | | | | | | | | | | Fixes [YOCTO #10888] The YP documentation was missing information on how the major and minor (point) release process works. I added a new chapter in front of the "Maintenance" chapter that details the naming schemes, cadence, and maintenance for YP releases. (From yocto-docs rev: b486f871e1fb8a6f763510ed385f459fe215fa27) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added five "COPYLEFT*" variables to the glossary.Scott Rifenbark2017-03-241-0/+155
| | | | | | | | | | | | | | | | | | Fixes [YOCTO #11021] The "Maintaining Open Source License Compliance During Your Product's Lifecycle" section in the dev manual covers use of archiver.bbclass, but is missing mention of the filtering options (e.g COPYLEFT_LICENSE_INCLUDE, COPYLEFT_LICENSE_EXCLUDE and COPYLEFT_RECIPE_TYPES). I added descriptions for these three. During the write-up, Paul noticed a couple other variables missing: COPYLEFT_PN_INCLUDE and COPYLEFT_PN_EXCLUDE. I also added descriptions for these two variables. (From yocto-docs rev: 450311037ea3048d30057c0b9d294efd33db2d3c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Expanded kernel task descriptions.Scott Rifenbark2017-02-191-32/+120
| | | | | | | | | | | | Fixes [YOCTO #9376] Expanded many of the brief descriptions for the kernel-related tasks. (From yocto-docs rev: ee9e54aa9f148e5438cd9bdf7e55d7fa43cc3ec5) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated NO_RECOMMENDATIONS glossary entryScott Rifenbark2017-02-191-1/+1
| | | | | | | | | | | | | Fixes [YOCTO #11010] The second example was incorrect in the glossary entry. Instead of "1" an image name place holder was in the example. I put "1" in there. (From yocto-docs rev: 00ab787d0d90da5c6d384c3669e804c9b2baca53) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: Updated "latest manual" note on title pageScott Rifenbark2017-02-191-6/+26
| | | | | | | | | | | | | | | Fixes [YOCTO #10076] The note on the title page for each manual was brief regarding where to find the latest version of the manual. I updated the note to have more detailed information on finding current, alternate, and latest versions of the manual based on YP releases. (From yocto-docs rev: 0ec81465296a7a78309d3039af4d00caa52d2285) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: remove core-image-directfb referenceScott Rifenbark2017-01-251-3/+0
| | | | | | | | | | | | | | | | core-image-directfb was removed from oe-core with this commit: remove core-image-directfb.bb as part of moving directfb from oe-core (From OE-Core rev: 8871fe1189776d78e5848b08edb9c990b9aebf2d) I made the similar change to the ref-manual by removing it from the "Images" chapter. (From yocto-docs rev: bee62aea8469cfca77e6f5e97a9ef2f52f16c9cb) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Removed package-depends.dot and pn-depends.dotScott Rifenbark2017-01-251-8/+0
| | | | | | | | | | | | | | The generated package-depends.dot and pn-depends.dot stuff contains partial data about the taskgraph and tends to confuse users. Richard Purdie suggested removing these from bitbake/lib/bb/cooker.py. I have removed the references to them in the "Viewing Dependencies Between Recipes and Tasks" section of the ref-manual. (From yocto-docs rev: 3dc9b124532b52369cec2de8209f33aebce2b648) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Updated LIC_FILES_CHKSUM exampleScott Rifenbark2017-01-201-3/+13
| | | | | | | | | | | | | | Fixes [YOCTO #10898] No information indicated the use of "endline" and "beginline" in the examples setting LIC_FILES_CHKSUM. I added a note indicating that line numbering starts with one and the "endline" value is inclusive. (From yocto-docs rev: 21114f09efa423033da67af1f27c99eb3cb9695d) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* yocto-project-qs, ref-manual: Added note for "resources temporarily ↵Scott Rifenbark2017-01-111-0/+33
| | | | | | | | | | | | | | | | | | | | | | | | | | | | unavailable" error Fixes [YOCTO #10818] There is a weird and intermittant error that can occur on any given distribution that has a 4.3+ Linux kernel and a version 228+ systemd. The error happens during an initial build of an image and indicates that resources are unavailable. Investigation determines that resources are available. The combination of the kernel and the systemd in a distro is causing issues when a distro is upgraded. yocto-project-qs: I added a note in the two areas where the user is stepped through the bitbake process to build an image. The note mentions the possibility of the error, the host configuration situation, and a couple work-arounds, which are to reboot the machine or to set the "DefaultTaskMax" systemd parameter to "infinity". ref-manual: Added the same note in the "Building an Image" section. (From yocto-docs rev: 3516803f9e6b5a29e4f95d31742c6e03ff63ef41) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: New VOLATILE_LOG_DIR variable descriptionScott Rifenbark2017-01-112-3/+31
| | | | | | | | | | | | | | Fixes [YOCTO #6132] No mention of how to make the target directory /var/log persistent. I added a note to the "post-install-logging" image feature that points to the new VOLATILE_LOG_DIR variable description, which I added to the glossary. (From yocto-docs rev: 5d2bdf49e569e44d02602501d72418f04dbe6e4a) 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 initramfsScott Rifenbark2017-01-112-20/+51
| | | | | | | | | | | | | | | | | | | | Fixes [YOCTO #7096] We did not document how to create an initramfs image to be included with a kernel build. Various variables sort of inferred the knowledge. I created a new section in the "Common Tasks" section of the dev-manual that describes how to create an initramfs image. Also, I updated the kernel.bbclass reference section to point back to the new "how-to" section. Finally, I also created a bunch of cross-reference links from various related variables back to the new "how-to" section. (From yocto-docs rev: 289dfbd5d24241e42446a043104eecd6dca76f13) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual, dev-manual: Removed term "wic-partitioned"Scott Rifenbark2017-01-111-3/+3
| | | | | | | | | | This term was incorrect and I have replaced it with the term "partitioned." (From yocto-docs rev: 50dd5c6994a2f799fdaf1ccbf7138b0074e981ee) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added WKS_FILE description for new variableScott Rifenbark2017-01-111-0/+20
| | | | | | | | | | This new variable points to the location of the wics kickstart file. (From yocto-docs rev: 80d18224140f95fdca0b4efad8f6a6e545ee4d56) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Added KERNEL_IMAGE_BASE_NAME change to 2.2 migrationScott Rifenbark2016-12-081-0/+21
| | | | | | | | | | | | | | The fact that the OpenEmbedded build system can now build multiple image types caused the KERNEL_IMAGE_BASE_NAME variable to have the KERNEL_IMAGETYPE portion removed. This could cause existing recipes that use the KERNEL_IMAGE_BASE_NAME variable directly issues. I added a section indicating that the user should address those recipes to avoid problems. (From yocto-docs rev: c433fca3840440c14bb364a51afc5c3c2bfc7c88) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>