summaryrefslogtreecommitdiffstats
path: root/documentation
Commit message (Collapse)AuthorAgeFilesLines
* ref-system-requirements.rst: Add openSUSE Leap 15.2 to list of supported distrosSteve Sakoman2021-11-211-0/+2
| | | | | | | (From yocto-docs rev: 895ce3b9dda96a049c92754cf06eb34635097861) Signed-off-by: Steve Sakoman <steve@sakoman.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: prepare for 3.1.12 releaseMichael Opdenacker2021-11-212-1/+2
| | | | | | | (From yocto-docs rev: d97525982602db05e31b89a9076c93420974fd68) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-system-requirements.rst: Add Fedora 33 and 34 to list of supported distrosSteve Sakoman2021-11-211-0/+4
| | | | | | | | (From yocto-docs rev: b85b532b8360756798c08482b94758d5df55f5ed) Signed-off-by: Steve Sakoman <steve@sakoman.com> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-system-requirements.rst: Add Debian 11 to list of supported distrosSteve Sakoman2021-11-211-1/+2
| | | | | | | | (From yocto-docs rev: aa212ce6c6fb9b92e0cf4e32ae8d2458aab4a055) Signed-off-by: Steve Sakoman <steve@sakoman.com> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: simplify SRC_URI referenceMichael Opdenacker2021-11-211-116/+9
| | | | | | | | | | After some features that also apply to BitBake were moved to the BitBake manual. (From yocto-docs rev: 1415521656427f351ab2d3f8bc498130c4653396) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: BBFILES_DYNAMIC - fix punctuation and quoting issuesMichael Opdenacker2021-11-211-2/+4
| | | | | | | (From yocto-docs rev: a798e1172ac507549ad36c0cfd4b92f53a1bef87) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: remove reference to TOPDIRMichael Opdenacker2021-11-211-5/+0
| | | | | | | | | | Already described in BitBake's manual As it is not specific to OE / Yocto Project (From yocto-docs rev: 150d5e938e9f413ade8bd6211ee7d55a2819a431) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: generalize definition of "container layer"Robert P. J. Day2021-11-211-4/+21
| | | | | | | | | | | | Given that there seems to be little value in being excruciatingly pedantic about whether a container layer has a valid layer as a top-level directory, expand the definition to allow either. (From yocto-docs rev: 95e5df9a51a7cda6588af523a3a0d6752613f189) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* releases: update to include 3.3.4Michael Halstead2021-11-193-2/+3
| | | | | | | | | Adding 3.3.4 to documentation switcher and release list. (From yocto-docs rev: 468e8bfb4b9bed662f1b32b0563339d0816a7e98) Signed-off-by: Michael Halstead <mhalstead@linuxfoundation.org> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: start of documentation standards documentMichael Opdenacker2021-11-073-3/+1273
| | | | | | | | | This first version specifies how to create consistent SGV graphics (From yocto-docs rev: 370b9e34e9092c9eed22df2e8b2d0bb979487e5c) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* kickstart: update busybox note regarding PARTUUIDRoss Burton2021-11-071-2/+3
| | | | | | | | | | | As of oe-core c996cabf the default BusyBox configuration supports PARTUUID, so update the note to reflect this. (From yocto-docs rev: cfd0498c6a981bcdc4b6bd03cb5f8dd42f0b39fc) Signed-off-by: Ross Burton <ross.burton@arm.com> Reviewed-by: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: update overlayfs classVyacheslav Yurkov2021-11-071-1/+15
| | | | | | | | | | | Describe how to use a generated helper service to set up a proper systemd dependency chain. (From yocto-docs rev: c8c1f7e852830dae4468da70e1ac732d7bbce06f) Signed-off-by: Vyacheslav Yurkov <uvv.mail@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: correct "take affect" by "take effect"Michael Opdenacker2021-11-072-4/+4
| | | | | | | (From yocto-docs rev: aeaf46f78b940744ce2e160e78b244395087e8e7) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: improve documentation for SDKMACHINERoss Burton2021-11-071-11/+9
| | | | | | | | | (From yocto-docs rev: 69bfb07772e7d358bb532191189a2518d1046178) Signed-off-by: Ross Burton <ross.burton@arm.com> Reviewed-by: Quentin Schulz <foss@0leil.net> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* releases: update to include 3.4 honisterMichael Halstead2021-10-262-1/+8
| | | | | | | | | Adding 3.4 to the release switcher and incrementing dev to say 3.5. (From yocto-docs rev: a171e88bc572e45d700d257a9de521520b4d5d5e) Signed-off-by: Michael Halstead <mhalstead@linuxfoundation.org> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* docs: poky.yaml: updates for 3.4Michael Opdenacker2021-10-221-8/+8
| | | | | | | (From yocto-docs rev: d080c62f3ec489275b2f241ccea51cf127f4f782) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* releases.rst: fix release number for 3.3.3Michael Opdenacker2021-10-221-1/+1
| | | | | | | (From yocto-docs rev: 8e0e33663b4f7e58b02e3b5153e4164a7d3db20e) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: Update how to set a useradd passwordDaiane Angolini2021-10-221-5/+11
| | | | | | | | | | Partial fix for [YOCTO 14605] (From yocto-docs rev: 3f3e5574ac9801ad92940168b61b532e0bd53a80) Signed-off-by: Daiane Angolini <daiane.angolini@foundries.io> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* migration-3.4: add some extra packaging notesPaul Eggleton2021-10-221-0/+9
| | | | | | | | | | Add some notes on minor packaging changes that I missed earlier. (From yocto-docs rev: a4f345f888b466bd1459b767c1b8cf8b9397e27e) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* poky.yaml: fix lz4 package name for older Ubuntu versionsPaul Eggleton2021-10-221-1/+1
| | | | | | | | | | | | | It turns out that for Ubuntu, lz4 is the valid package name for newer versions (e.g. 20.04 LTS) but not for older ones (e.g. 18.04 LTS, where the correct package is liblz4-tool). In 20.04 the lz4 package includes liblz4-tool in its "provides" so it's best to list that one for now. (From yocto-docs rev: 2a4e259d2786c14b19a632b3a8f1a06383b6a80c) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: fix description of SOURCE_DATE_EPOCHMichael Opdenacker2021-10-221-1/+1
| | | | | | | | | | Update the reference to the code that computes this default value for this variable. (From yocto-docs rev: b115a1c07f76d2cca37565ac678c21e0e6056fff) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: document SOURCE_DATE_EPOCHMichael Opdenacker2021-10-201-0/+17
| | | | | | | (From yocto-docs rev: 160d672641c52338ba499edfb66339a10b088490) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: rename "devpyshell" to "pydevshell"Michael Opdenacker2021-10-202-10/+10
| | | | | | | | | | This addresses [YOCTO #14531] after the "devpyshell" task was renamed to "pydevshell" in OE core. (From yocto-docs rev: 1056320e90545c8dff0fc71a5fde752295d4d6e4) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: document TOOLCHAIN_HOST_TASK_ESDKMichael Opdenacker2021-10-202-1/+10
| | | | | | | (From yocto-docs rev: 2adac164a2d4cf23c0372c1154709f2866d483fa) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* migration: tweak introduction sectionPaul Eggleton2021-10-201-4/+22
| | | | | | | | | | Ensure we have a brief introductory section and tweak the general migration considerations a little. (From yocto-docs rev: b127348bbc6a7a6e48ee14434fffc56e08aa9e02) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* migration-3.4: add additional migration infoPaul Eggleton2021-10-201-0/+176
| | | | | | | | | | Add migration instructions gathered by combing the commits in this release. (From yocto-docs rev: 2fc89fa1d4e29d2498d5b736ffe85c1cdc8b62e7) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* poky.yaml: add lz4 and zstd to essential host packagesPaul Eggleton2021-10-201-5/+6
| | | | | | | | | | These are now required so update the corresponding distro-specific lists used in the system requirements documentation. (From yocto-docs rev: 604deb5c30a8808a60187f81645fa08b67ef2de9) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: remove meta classPaul Eggleton2021-10-201-9/+0
| | | | | | | | | This was recently removed so remove the reference to it. (From yocto-docs rev: 53f52adf212e35e7588a90e94b03b5cfae6f867c) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* migration-3.4: tweak overrides change sectionPaul Eggleton2021-10-201-15/+19
| | | | | | | | | Minor grammar and readability improvements. (From yocto-docs rev: e33a809d139d52a8aa262a25fe3031a8882dee2e) Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: warn about license compliance issues when static libraries are usedMichael Opdenacker2021-10-081-0/+20
| | | | | | | | | This partly addresses [YOCTO #14407] (From yocto-docs rev: 444ca8900e8057562d2a71a77e6e6798aca3ce85) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: correct NO_GENERIC_LICENSE section titleMichael Opdenacker2021-10-081-2/+2
| | | | | | | | (From yocto-docs rev: 522841b4715295c6f399fc5affe2ade128d139ae) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-By: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* overview-manual: simplify expressionMichael Opdenacker2021-10-081-1/+1
| | | | | | | (From yocto-docs rev: ea1e5d4214f30927119f0124ee8a80a558601161) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* dev-manual: remove errant /Jon Mason2021-10-081-2/+2
| | | | | | | | (From yocto-docs rev: 5a10c78c574eae48f50f5c912fd6534bdf99f71c) Signed-off-by: Jon Mason <jdmason@kudzu.us> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: use YOCTO_DL_URLJon Mason2021-10-083-26/+26
| | | | | | | | (From yocto-docs rev: e3ad609d9fce8d6729bf6cb553993bddba1785ae) Signed-off-by: Jon Mason <jdmason@kudzu.us> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: replace http with https for URLsJon Mason2021-10-084-30/+30
| | | | | | | | | | | | https has been the preferred way to access websites for many years now. Change all of the URLs with a _working_ https server/certificate to use that URL. (From yocto-docs rev: c77868c780df94356d5f21453f80ace073fade9b) Signed-off-by: Jon Mason <jdmason@kudzu.us> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: introduce 'yocto_sstate' extlinkMichael Opdenacker2021-10-082-1/+2
| | | | | | | (From yocto-docs rev: f428c8d3bb12bfdb2b2afb03e0e6b80e28fd0e62) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* docs: add "make all" to build old types of docs (html, epub, pdf) at onceMichael Opdenacker2021-10-081-1/+3
| | | | | | | | | (From yocto-docs rev: 8ce6aa0d4c0985e187464c7578662ff7581bc9ce) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Nicolas Dechesne <nicolas.dechesne@linaro.org> Signed-off-by: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* overview-manual: SVG diagram for the git workflowMichael Opdenacker2021-10-083-2/+1207
| | | | | | | | | | | | Set in full-width mode to make it ready in PDF and EPUB outputs. (From yocto-docs rev: 394c7c26c6591153670c67740d9a64f54725321b) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Nicolas Dechesne <nicolas.dechesne@linaro.org> Signed-off-by: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* conf.py: use PNG first in EPUB outputMichael Opdenacker2021-10-081-0/+4
| | | | | | | | | | | | | | SVG directly included in EPUB output has multiple issues, in particular font size and alignment ones (tested on two EPUB readers). Instead, using PNG, generated from SVG when available as the primary format for images. GIF and JPEG are fine too. (From yocto-docs rev: ff3876ca4910cf61bc25bfeb07e65ad6f6a93b48) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Nicolas Dechesne <nicolas.dechesne@linaro.org> Signed-off-by: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* Makefile: allow epub and latexpdf outputs to use diagrams from SVG sourcesMichael Opdenacker2021-10-083-3/+32
| | | | | | | | | | | | | | | | | | | | | | html output is great when directly using SVG epub output has to use exported PNG because of issues using SVG directly latexpdf output cannot use SVG, it needs exported PDF instead This adds rules to generate PNG and PDF formats from new SVG sources. Newly added diagrams have be stored in svg/ subdirectories so that PNG and PDF files generated from SVG can be "gitignored" without ignoring the original PNG diagrams that have no SVG source. Note: had to remove the dependency to "Makefile" in the final "catch-all" target, otherwise it was also catching the SVG to PNG and SVG to PDF targets. (From yocto-docs rev: cd9bbd41d323bc124057396f142010509c65bbaf) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Nicolas Dechesne <nicolas.dechesne@linaro.org> Signed-off-by: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: replace "apt-get" by "apt"Michael Opdenacker2021-10-085-11/+11
| | | | | | | | | | | | | Modern Debian based distros (such as Ubuntu) now use "apt" instead of "apt-get" Also make sure "apt" is invoked with root privileges (mandatory) (From yocto-docs rev: 380ef2474f3ecc2bce83f11cd838d054bef56d22) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* documentation: update sources mirror URLJon Mason2021-10-082-11/+12
| | | | | | | | | | | The URL for the sources mirror no longer works. Update to the new location. (From yocto-docs rev: 616c326437c03d7f4530168c4c9d6ef50743952e) Signed-off-by: Jon Mason <jdmason@kudzu.us> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: document DEBUG_PREFIX_MAPMichael Opdenacker2021-10-082-1/+18
| | | | | | | | | Fixes [YOCTO #14433] (From yocto-docs rev: 23eb07c26044d06bc51c757bf1b0a53b1b357dc8) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* manuals: font fixesMichael Opdenacker2021-10-087-12/+12
| | | | | | | | | | | | | | This fixes font inconsistencies, mixing a ``text`` string with another string with the regular font, where the whole string makes more sense with a single font. The result is also much simpler and will make future searches easier. (From yocto-docs rev: e6d1c166a97a1b6bb42ca49dfcbd3d39f8eadc16) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* overview-manual: delete bad backslashes in SSTATE_MIRRORS exampleRobert P. J. Day2021-10-021-2/+2
| | | | | | | | | | | | | Two inappropriate backslashes in the example for setting SSTATE_MIRRORS are apparently the result of an error by the transmogrification script for migrating XML to rST. (From yocto-docs rev: 9cff301a768b248f19fc1d5834f04d3defffcbc7) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: add note about license implications of bundled initramfsDaniel Wagenknecht2021-10-021-0/+6
| | | | | | | | | | | Ensure users are aware that usage of INITRAMFS_IMAGE_BUNDLE is only appropriate for use with GPLv2 compatible software. (From yocto-docs rev: ecf4582b454aa301905f0f9e3c6f5adb98dc1991) Signed-off-by: Daniel Wagenknecht <dwagenknecht@emlix.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* common-tasks: add note about license implications of bundled initramfsDaniel Wagenknecht2021-10-021-0/+6
| | | | | | | | | | | Ensure users are aware that usage of INITRAMFS_IMAGE_BUNDLE is only appropriate for use with GPLv2 compatible software. (From yocto-docs rev: 1859654663ebb3b051fb6c4da4dc76f0dd46c47c) Signed-off-by: Daniel Wagenknecht <dwagenknecht@emlix.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: mention INHIBIT_PACKAGE_DEBUG_SPLIT variableRobert P. J. Day2021-10-021-0/+5
| | | | | | | | | | | Following a detailed discussion of PACKAGE_DEBUG_SPLIT_STYLE, it seems only appropriate to refer the reader to INHIBIT_PACKAGE_DEBUG_SPLIT. (From yocto-docs rev: d12a6149ed9ec4a5f7c47f4a8c0330c6024c9de5) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: fix missed override syntax changeQuentin Schulz2021-10-021-2/+2
| | | | | | | | | Cc: Quentin Schulz <foss@0leil.net> (From yocto-docs rev: 527e885fa9beedbdcf9942d0d227862af55fcc40) Signed-off-by: Quentin Schulz <quentin.schulz@theobroma-systems.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* ref-manual: extend explanation of PACKAGE_DEBUG_SPLIT_STYLERobert P. J. Day2021-10-021-27/+33
| | | | | | | | | | | | The current explanation of this variable seems incomplete, so be a bit more verbose to make sure the reader understands the packaging possibilities. (From yocto-docs rev: 1914705f062b232c10624c11fc85935cc454d2eb) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>