summaryrefslogtreecommitdiffstats
path: root/documentation
Commit message (Collapse)AuthorAgeFilesLines
* sdk-manual: Add SPDX license headersakuster2020-06-1710-0/+13
| | | | | | | | | [Yocto #13873] (From yocto-docs rev: 5b88e5e0f7a71ffefdd5e9c21520bf20692521c6) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* profile-manual: Add SPDX licence headersakuster2020-06-177-0/+10
| | | | | | | | | [Yocto #13873] (From yocto-docs rev: 551c4a7f75e2afeb22d2638cc1e9550ec18c8cb4) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* kernel-dev: Add SPDX license headersakuster2020-06-179-0/+12
| | | | | | | | | [Yocto #13873] (From yocto-docs rev: 4609c3288be259fcc582fbe946ad6b411aa96e1a) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: Add SPDX License headersakuster2020-06-177-0/+10
| | | | | | | | | [Yocto #13873] (From yocto-docs rev: eaded98195eed8adf3bba89a6b49a45383955785) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* brief-yoctoprojectsqa: Add SPDX license headersakuster2020-06-174-0/+7
| | | | | | | | | [Yocto #13873] (From yocto-docs rev: 8bf1b566ddeaf6223ed065e9560cc096a18fe14d) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bsp-guide: Add SPDX license headersakuster2020-06-174-0/+6
| | | | | | | | | [Yocto #13873] (From yocto-docs rev: 0aa081c3f1839833043e116db1729a9de342f72e) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* adt-manual: Add SPDX license headersakuster2020-06-179-0/+11
| | | | | | | | | [Yocto #13873] (From yocto-docs rev: b2d60520431ef71ed2d1decf33605797995cb8f4) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* yocto-docs: Add SPDX headers in scripts and Makefileakuster2020-06-045-14/+16
| | | | | | | | | [Yocto #13873] (From yocto-docs rev: b87c540a1a6c0dce4c6010b89d9831442e0e7f70) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* poky.ent: Update XXX_HOST_PACKAGES_ESSENTIAL to include mesa for other distrosRichard Purdie2020-06-041-3/+3
| | | | | | (From yocto-docs rev: e187f0f858bd4ed2eda10a5140cbc5ec222d7092) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* poky.ent: Update OPENSUSE_HOST_PACKAGES_ESSENTIAL to include mesa-dri-develakuster2020-06-041-1/+1
| | | | | | | (From yocto-docs rev: 3003075b29bee696f226533e24ab7121508ca99b) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* poky.ent: Update UBUNTU_HOST_PACKAGES_ESSENTIAL to match recent changesRichard Purdie2020-05-301-1/+1
| | | | | | (From yocto-docs rev: 7ed90c71caa6a23d2ef3b640a880069ca3ee3d24) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: add PACKAGE_ADD_METADATA documentationMichael Ho2020-05-272-0/+92
| | | | | | | | | | | Add a basic variable definition and a small section to the development tasks manual for using PACKAGE_ADD_METADATA to add custom metadata to packages. (From yocto-docs rev: c5e4d575a771ddd1c970389ce3ace6d6abe68769) Signed-off-by: Michael Ho <Michael.Ho@bmw.de> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: document new unlisted-pkg-lics insane-skip qa checkQuentin Schulz2020-05-212-0/+31
| | | | | | | | | | | | | The new unlisted-pkg-lics INSANE_SKIP QA check was introduced and need proper documentation. This QA check makes sure all licenses listed for all packages built by a recipe are declared in the recipe LICENSE variable. (From yocto-docs rev: a50e0628f3d40f9103c9a6ecccde61ad6d7f21c6) Signed-off-by: Quentin Schulz <quentin.schulz@streamunlimited.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: delete long-unused comments in variable glossaryRobert P. J. Day2020-05-171-571/+0
| | | | | | | | | | As these comments have been around since 2015 and apparently unused, get rid of hundreds of them. (From yocto-docs rev: afec5770a22ac51c956e87567bf39e71064e9f04) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Remove long-dead PACKAGE_GROUP variableRobert P. J. Day2020-05-052-26/+2
| | | | | | | | | | This was, years ago, deprecated in favour of FEATURE_PACKAGES, so remove all references, other than the entry in the migration section. (From yocto-docs rev: 8e5469aadd31bc3de181848aae5733cd7835eefb) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: typo "SSTATE_MIRROR" -> "SSTATE_MIRRORS"Robert P. J. Day2020-05-051-1/+1
| | | | | | | (From yocto-docs rev: d694ff63f4aee0fff6eac0541413c1a36b3b02e2) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: IMAGE_TYPES, add tar.zst, delete elfRobert P. J. Day2020-05-051-1/+1
| | | | | | | | | | Update list of legal IMAGE_TYPES to match what's in image_types.bbclass. (From yocto-docs rev: 7706a240d6dbbace9a76b4b55427f91bd4afc6da) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: fix excessive command indentationRobert P. J. Day2020-05-051-2/+2
| | | | | | | (From yocto-docs rev: a95b49eef8f6bfde153677dda8021ffadf29d8f7) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* Updated patch for publishingMark Morton2020-04-241-2/+2
| | | | | | (From yocto-docs rev: ac352ad7f95db7eeacb53c2778caa31800bd7c26) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* Added usrmerge to distro-features for Bug 13494mmorton2020-04-241-0/+6
| | | | | | (From yocto-docs rev: 049832ea4c13b01c31911ad0a6f3e170781db6cd) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: correct "script" dirname to "scripts"Robert P. J. Day2020-04-241-2/+2
| | | | | | | (From yocto-docs rev: 43f042582675f89fcdf81c0cd2ac2602d4282cb3) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: remove postinst false statementMaxime Roussin-Bélanger2020-04-151-2/+0
| | | | | | | | | | This outdated section contradicts the real behavior expressed in the next paragraph (From yocto-docs rev: 77e8a9e03b3bb6e6b6b2adf7796740fb362f189b) Signed-off-by: Maxime Roussin-Bélanger <maxime.roussinbelanger@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: add migration section for 3.1Paul Eggleton2020-04-151-0/+201
| | | | | | | | | Migration information for the 3.1 release. (From yocto-docs rev: dda13761733c7f3fe672f45b8d06f6c3fcf8cb30) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: basic updates for npm fetcher changesPaul Eggleton2020-04-151-31/+21
| | | | | | | | | | | Update the npm:// URL and the generated npm recipe, and remove references to NPM_SHRINKWRAP, NPM_LOCKDOWN and lockdown functionality in general. (From yocto-docs rev: bc09233543abbf28adfcc1e214f85ef4c7c56639) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: update PACKAGECONFIG glossary entryrpjday@crashcourse.ca2020-04-071-15/+25
| | | | | | | | | | | | | | Update the glossary entry for PACKAGECONFIG in two ways: 1) Explain the recent sixth argument, which identifies conflicting features for a given feature. 2) Use a different example, as the librsvg "croco" feature no longer works that way. (From yocto-docs rev: af9bf61a54c059e72c807ca8061a57d6fe74c5fa) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* overview-manual: fix obvious typo "ORHNAME"Robert P. J. Day2020-04-071-1/+1
| | | | | | | (From yocto-docs rev: d40485a7eecb8d54179b562f05b4d7b044bb03b2) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: clarify how to select "read-only-rootfs"Robert P. J. Day2020-04-071-9/+9
| | | | | | | | | | For stylistic reasons, clarify the use of both IMAGE_FEATURES versus EXTRA_IMAGE_FEATURES when configuring a read-only rootfs. (From yocto-docs rev: 4111e4e70a87400671455ddd873d802d40d6b587) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: use "git", not "apmd", to explain checksum namesrpjday@crashcourse.ca2020-04-061-8/+9
| | | | | | | | | | | The apmd recipe is no longer appropriate to demonstrate the use of SRC_URI checksum names as it has only a single SRC_URI URL, so pick a more illuminating recipe. (From yocto-docs rev: 7f391a0656442e7ee2f3dd48b848befb7f461aec) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: use "strace" for PV example, not cdrtoolsrpjday@crashcourse.ca2020-04-061-4/+4
| | | | | | | | | | | | | | | | | | | | | Section 3.3.5, "Fetching Code", uses the cdrtools recipe as an example for showing the use of PV, but that's a bad example since the current cdrtools recipe file contains: SRC_URI = " \ ${SOURCEFORGE_MIRROR}/project/cdrtools/cdrtools-${REALPV}.tar.bz2 \ ... PV = "3.01a31+really3.01" REALPV = "3.01" which is not exactly the point the dev manual is trying to make, so replace with simpler strace recipe. (From yocto-docs rev: d865b0288a4162a8d4df9a2abde43875e3dc2ced) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* brief-yoctoprojectqs: buildtools changesTim Orling2020-04-061-4/+7
| | | | | | | | | | | | Bump tar, Python versions and add new gcc requirement. Update reference from 'required-git-tar-and-python-versions' to 'required-git-tar-python-and-gcc-versions' (From yocto-docs rev: ca6334c1653d5e2abfe77865391509a8cd516d88) Signed-off-by: Tim Orling <timothy.t.orling@linux.intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: buildtools versions and changesTim Orling2020-04-061-5/+8
| | | | | | | | | | | | Bump tar, Python versions and add new gcc requirement. Update reference from 'required-git-tar-and-python-versions' to 'required-git-tar-python-and-gcc-versions' (From yocto-docs rev: 18b11662c7c9ab7828d2709eed4090116a751e14) Signed-off-by: Tim Orling <timothy.t.orling@linux.intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: add install-buildtools and -extendedTim Orling2020-04-063-17/+120
| | | | | | | | | | | | | Add instructions to use 'install-buildtools' and 'buildtools-extended-tarball'. Add gcc 5.0 requirement and call out how to use above to prepare host development system. (From yocto-docs rev: c6dbd9bf6860ffea1bc025907343373439d91737) Signed-off-by: Tim Orling <timothy.t.orling@linux.intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: fix debian-8 system reqsTim Orling2020-04-061-11/+21
| | | | | | | | | | | | | jessie-backports is no longer supported, so python3-git and pylint3 are not installable via apt-get (or at least not without disabling security checks by using archive.debian.org) Add note to use pip3 to install instead. (From yocto-docs rev: 19a02c5c6ef9a317c2339c2ec71200e51335e32f) Signed-off-by: Tim Orling <timothy.t.orling@linux.intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: bump tar and python min versionsTim Orling2020-04-061-2/+2
| | | | | | | | | | * tar min version is now 1.28 * python min version is now 3.5 (From yocto-docs rev: 96dfaee63f84c21fc2bf460ded642b853a5317cf) Signed-off-by: Tim Orling <timothy.t.orling@linux.intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: split CentOS-7 and CentOS-8 reqsTim Orling2020-04-061-8/+60
| | | | | | | | | | | | | | | CentOS-7 has different requirements than the much newer CentOS-8. Add a section for CentOS-8 and make the old section CentOS-7 specific. NOTE: at the time this was written, the 'fop' package is not yet available in epel-8. As a Fedora packager, that will change. (From yocto-docs rev: caf08811a23a29965ec915459019796a0c882d4d) Signed-off-by: Tim Orling <timothy.t.orling@linux.intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* poky.ent: split centos-7 and centos-8Tim Orling2020-04-061-2/+10
| | | | | | | | | | | | | | | Update Centos-7 to require python3, not python. CentOS-8 has different installation requirements than either CentOS-7 or Fedora (although it is closer to Fedora). Allow for differentiation between CentOS versions. (From yocto-docs rev: 615fc45108d10e842679b3d8a38b53074d3eed4b) Signed-off-by: Tim Orling <timothy.t.orling@linux.intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* poky.ent: recommend python36-pip for CentOSTim Orling2020-04-061-1/+1
| | | | | | | | | | | | | | 'python3' in EPEL7 is now Python 3.6, so we should be recommending python36-pip Python 3.4 is EOL [1] [1] https://www.python.org/downloads/release/python-3410/ (From yocto-docs rev: 817ca8adc91d9975b9ec57e7fead7fdff4001854) Signed-off-by: Tim Orling <timothy.t.orling@linux.intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentaiton: Change author infoakuster2020-04-0610-28/+21
| | | | | | | | | | Update the author indo and use variables for author and email to make it easier to change in future. (From yocto-docs rev: 4fdf2a060705fa00b11b5a9d270f4ffa506c9927) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* BSP Guide: numerous tweaks/grammar/wording/clarificationrpjday@crashcourse.ca2020-04-061-37/+52
| | | | | | | (From yocto-docs rev: 3a87e5900b603f124ce7f63fd072415762f63212) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* kernel-dev: fix explanation of KBUILD_DEFCONFIGrpjday@crashcourse.ca2020-04-061-5/+7
| | | | | | | | | | KBUILD_DEFCONFIG is meant to refer to an *in-tree* defconfig file, not an external one. (From yocto-docs rev: 34202eee3fc2bb4e0b92374822bff87fd3af1ebc) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* correct mention of "postinst_intercept delay_to_first_boot"rpjday@crashcourse.ca2020-04-062-3/+3
| | | | | | | | | | Migration to YP 2.5 contains incorrect description of routine for delaying to first boot. (From yocto-docs rev: 08f71ec137822c0c19b56956d7045dfb73a544d7) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: minor rewording/clarification in chapter 2rpjday@crashcourse.ca2020-04-061-4/+6
| | | | | | | (From yocto-docs rev: a9a3248b12b85f3637ebe5eddd4b1a29268d5598) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: minor rewording in chapter 1rpjday@crashcourse.ca2020-04-061-5/+5
| | | | | | | (From yocto-docs rev: 5582f01fc4774e7d21af24627bbd47a77463d272) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: update PROVIDES example, clarify use of "+="rpjday@crashcourse.ca2020-04-061-6/+18
| | | | | | | | | | | Update the example used in explaining the PROVIDES variable to one that actually exists, and point out that "+=" is unnecessary, a simple assignment is sufficient. (From yocto-docs rev: 80cd888ee81757bc5281f174b26974391ee45522) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: various touchups, rewordings, corrections to Ch 5rpjday@crashcourse.ca2020-04-061-63/+63
| | | | | | | | | | | | | Minor tweaks to chapter 5 of reference manual, including: - grammar - adding slashes to directory names for consistency - collapse trivial paras into one (From yocto-docs rev: 96b75e723bff042183f70a858d09df4aad094578) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* use defined entity "YOCTO_DOCS_URL", not "YOCTO_HOME_URL"rpjday@crashcourse.ca2020-04-0610-20/+20
| | | | | | | | | | | | | | | Given the defined DocBook entity: <!ENTITY YOCTO_DOCS_URL "&YOCTO_HOME_URL;/docs"> replace numerous instances of the more verbose "&YOCTO_HOME_URL;/documentation", which is a redirect, anyway. rday (From yocto-docs rev: 53fa17321624028b12d880bc4236fbef46675eb4) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: minor tweaks, rewording, grammar for chapter 2rpjday@crashcourse.ca2020-04-061-26/+28
| | | | | | | (From yocto-docs rev: 706386ac094479916e1cc482e56a6433caa85e1a) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: clarify PN usage in packagegroup filesrpjday@crashcourse.ca2020-04-061-6/+10
| | | | | | | | | | | Make it clear to the reader that they can use the much shorter form of ${PN} for the base packagegroup name, rather than typing it out in full. (From yocto-docs rev: 19915978c30bbf37b65d9887c78a23394779f079) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: add missing check to yocto-check-layer sectionrpjday@crashcourse.ca2020-04-061-1/+20
| | | | | | | | | | Add explanation of missing checks performed by yocto-check-layer, and fix one typo. (From yocto-docs rev: 231bb92fa4a9c044894f845b8d6d0b9498abfc49) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: use actual machine override demonstrationrpjday@crashcourse.ca2020-04-061-5/+19
| | | | | | | | | | | | Given that the section in question is describing how to configure dependencies based on the machine type, it seems inappropriate to use an example that depends on the choice of C library, so grab a snippet from linux-yocto.inc to really drive the point home. (From yocto-docs rev: 66bfec015f61a690f96cf8e28b80869c77327e6d) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>