aboutsummaryrefslogtreecommitdiffstats
AgeCommit message (Collapse)Author
2021-09-03dev-manual: small number of minor aesthetic tweaksRobert P. J. Day
Just a collection of: - grammar tweaks - space fixes - font changes Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
2021-09-03ref-manual: add missing "${PN}-src" to default PACKAGES listRobert P. J. Day
Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Reviewed-by: Quentin Schulz <foss@0leil.net> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-09-03dev-manual: explicit that devpyshell is a taskMichael Opdenacker
Without this, readers could think that "devpyshell" is a script, at least until they read the remainder of the section. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net>
2021-09-03dev-manual: pass False to d.getVar() for devpyshell exampleRobert P. J. Day
In the example in section 3.9, the call to d.getVar() needs to have the additional argument of "False" so that the output is not expanded. Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Reviewed-by: Quentin Schulz <foss@0leil.net> Tested-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-09-03dev-manual/common-tasks: sync libxpm fragment with the recipeRoss Burton
Specifically, the actual recipe now has LICENSE=MIT. Signed-off-by: Ross Burton <ross.burton@arm.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2021-08-18ref-manual: Fix reference to bbappend section of dev-manualRichard Purdie
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2021-08-18bsp-guide: Fix reference to bbappend section of dev-manualRichard Purdie
This was broken in a previous commit which broke doc generation. Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2021-08-18docs: update docs with new tune locationsJon Mason
Signed-off-by: Jon Mason <jdmason@kudzu.us> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2021-08-13kickstart: document which options accept unitsOlaf Mandel
Document which units are accepted as parameters for the four options that accept units. Also be pedantic about using binary instead of decimal prefixes so readers don't have to wonder. Signed-off-by: Olaf Mandel <o.mandel@menlosystems.com> Reviewed-by: Quentin Schulz <foss@0leil.net> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-13manuals: Rename the "Using .bbappend Files in Your Layer" sectionTom Rini
To prepare to add another example bbappend, rename the current "Using .bbappend Files in Your Layer" section to "Appending Other Layers Metadata With Your Layer". Name the current example as "Overlaying a File Using Your Layer". Signed-off-by: Tom Rini <trini@konsulko.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net>
2021-08-13common-tasks: Add a summary to the end of the bbappend exampleTom Rini
Try and make it clearer what the final result of this bbappend example is. Signed-off-by: Tom Rini <trini@konsulko.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net>
2021-08-13docs: fix typo in releasesDaniel Gomez
Fix dunfell typo for releases 3.1.9 and 3.1.10. Signed-off-by: Daniel Gomez <daniel@qtec.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12dev-manual: fix grammar in post-install script explanationsMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12Manuals: replace "file name" by "filename"Michael Opdenacker
There are many more instances of "filename" or "filenames" than of "file name" or "file names". The winner takes it all! Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12sdk-manual: reference obsolete reference to ADTMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12docs: overview-manual: concepts: remove long-gone BBHASHDEPS variableQuentin Schulz
BBHASHDEPS was removed from bitbake in April 2014, with the following commit: 92526eadd09d "bitbake-worker: Drop BBHASH variables" so let's remove mentions from the docs. Signed-off-by: Quentin Schulz <foss@0leil.net> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12docs: fix new override syntax migrationQuentin Schulz
Fix bits missed by the migration script. Signed-off-by: Quentin Schulz <foss@0leil.net> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12test-manual: overrides syntax updatesMichael Opdenacker
Updated with openembedded-core/scripts/contrib/convert-overrides.py Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12sdk-manual: overrides syntax updatesMichael Opdenacker
Updated with openembedded-core/scripts/contrib/convert-overrides.py Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12ref-manual: overrides syntax updatesMichael Opdenacker
Updated with openembedded-core/scripts/contrib/convert-overrides.py Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12kernel-dev manual: overrides syntax updatesMichael Opdenacker
Updated with openembedded-core/scripts/contrib/convert-overrides.py Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12dev-manual: overrides syntax updatesMichael Opdenacker
Updated with openembedded-core/scripts/contrib/convert-overrides.py Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-12bsp-guide: overrides syntax updatesMichael Opdenacker
Updated with openembedded-core/scripts/contrib/convert-overrides.py Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-10releases: update to include 3.1.10Michael Halstead
Adding 3.1.10 to documentation switcher and release list. Signed-off-by: Michael Halstead <mhalstead@linuxfoundation.org>
2021-08-09manuals: further documentation for cve-checkMichael Opdenacker
This adds details about the actual implementation of vulnerability checks, about how to fix or ignore vulnerabilities in recipes, and documents the CVE_CHECK_PN_WHITELIST and CVE_CHECK_WHITELIST variables. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net>
2021-08-06manuals: mention license information in footerMichael Opdenacker
Previously, the license for the manuals was only stated in the SPDX headers at the beginning of source files Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-06migration-3.4: Add extra notes to override syntax changesRichard Purdie
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-06test-manual: Add extra detail to YP Compatible sectionRichard Purdie
Add a note about documenting where a layer doesn't support 'core' functionality. Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-03releases: update to include 3.3.1Michael Halstead
Adding 3.3.1 to documentation switcher and release list. Signed-off-by: Michael Halstead <mhalstead@linuxfoundation.org>
2021-08-02profile-manual: document how to build perf manpages on targetMichael Opdenacker
Thanks to closing yocto bug #3388, there is now a simple way to build the perf manpages for use on the target Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-02ref-manual: remove example recipe source filesMichael Opdenacker
These files are not used to build to documentation and were updated and moved to the "meta-skeleton" layer (except "mtd-makefile" which is broken and no longer worth maintaining there, as a recipe for more recent versions of "mtd-utils" exists). Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-08-02manuals: initial documentation for CVE managementMichael Opdenacker
This starts to document vulnerability management and the use of the CVE_PRODUCT variable Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net>
2021-08-02dev-manual: fix source release example scriptStefan Wiehler
Signed-off-by: Stefan Wiehler <stefan.wiehler@missinglinkelectronics.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-07-30common-tasks: Fix conversion error in npm exampleRichard Purdie
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2021-07-30manuals: remove explicit BitBake variable referencesMichael Opdenacker
The standard :term:`VARIABLE` will refer to the description of the variable in the YP variable index. If it doesn't exist, it will refer to the description of the variable in the BitBake manual. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net>
2021-07-30manuals: simplify references to BitBake manualMichael Opdenacker
Replacing ":ref:`section name<bitbake:bitbake-user-manual/bitbake-user-manual-<section>:section name>`" by ":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-<section>:section name`" when the reference description is the same as the section name. In this case, that's unnecessary to repeat the section name in the description part. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net>
2021-07-30documentation/README: improve BitBake manual referencing guidelinesMichael Opdenacker
Removing the ":ref:`-D <bitbake:..." syntax as it's not necessary Adding more and simpler ways of making references to the BitBake manual. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Quentin Schulz <foss@0leil.net>
2021-07-30migration-guides: Add start of 3.4 guide with override migration notesRichard Purdie
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org> Reviewed-by: Quentin Schulz <foss@0leil.net> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-07-28dev-manual: fix wrong reference to classMichael Opdenacker
The file 'meta/classes/core-image.bbclass' seems have nothing about the 'IMAGE_FEATURES' variable, using 'meta/classes/image.bbclass' instead. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Mingrui Ren <jiladahe1997@gmail.com>
2021-07-23quick start manual: update "source oe-init-build-env" outputMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-07-23test-manual: document LTO related reproducibility bugMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Reviewed-by: Tony Battersby <tonyb@cybernetics.com>
2021-07-12ref-manual: Document BUILDHISTORY_PATH_PREFIX_STRIPJoshua Watt
Signed-off-by: Joshua Watt <JPEWhacker@gmail.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-07-12docs: replace remaining ``FOO`` by :term:`FOO`Quentin Schulz
A few occurences appeared between the time the original patch was sent and it was applied, this fixes it. Also, the original patch didn't take into account lowercase terms, this is now fixed, see module_autoload for example. Finally, as is often the case with regexp, there was a typo in it that didn't make it match as much as it should have. The script that is used to do the replacement of ``FOO`` by :term:`FOO` is the following Python code: import re from pathlib import Path from runpy import run_module import contextlib import io import sys re_term = re.compile(r'variables.html#term-([a-zA-Z_0-9]*)') terms = [] new_terms = set() with contextlib.redirect_stdout(io.StringIO()) as f: run_module('sphinx.ext.intersphinx', run_name='__main__') objects = f.getvalue() match = re_term.search(objects) while match: if match.group(1): terms.append(match.group(1)) match = re_term.search(objects, match.end()) for rst in Path('.').rglob('*.rst'): with open(rst, 'r') as f: content = "".join(f.readlines()) for term in terms: content = re.sub(r'``({})``(?!.*\s+[~=-]{{{:d},}})'.format(term, len(term)), r':term:`\1`', content) with open(rst, 'w') as f: f.write(content) This script takes one argument as input: an objects.inv. Bitbake's can be gotten from https://docs.yoctoproject.org/bitbake/objects.inv. The objetcs.inv from the current git repo can be gotten from documentation/_build/html/objetcs.inv after running `make html`. Note that this excludes from replacement terms that appear in section titles as it requires refs to be changed too. This can be automated too if need be but right now it looks a bit confusing to have an anchor link (for sections) also have a term/reference link in it. I am not sure this is desired today. This is the result of two runs of the aforementioned script, once with Bitbake objects.inv and once with this repo's. Fixes: ba49d9babfcb "docs: replace ``FOO`` by :term:`FOO` where possible" Signed-off-by: Quentin Schulz <foss@0leil.net> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-07-10docs: remove image-mklibs referencesPatrick Williams
The image-mklibs bbclass was removed from OE-Core with commit 908df863b419d1cad7317153101fc827e7e3a354 and corresponding changes to local.conf.sample were made in meta-yocto with c8c8f284eb2abe7e1352850a885454487cc01986. Remove all references to image-mklibs from the documentation as it is no longer supported. Signed-off-by: Patrick Williams <patrick@stwcx.xyz> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2021-06-30 releases: update to include 3.1.9Michael Halstead
Adding 3.1.9 to documentation switcher and release list. Signed-off-by: Michael Halstead <mhalstead@linuxfoundation.org>
2021-06-18sdk-manual: add missing index referencesMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-06-18sdk-manual: fix wrong wordMichael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-06-18sdk-manual: add missing quoting around "devtool upgrade"Michael Opdenacker
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-06-17manuals: fix issues related to trailing dotsMichael Opdenacker
Fix missing reference and styling issues found thanks to trailing dots (only non black character in a line) Matches (and multiple false positives) found with the below command: git grep "\s\.$" Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
2021-06-17migration guides: remove index reference to BB_SETSCENE_VERIFY_FUNCTION2Michael Opdenacker
This variable is no longer documented in Bitbake's manual as it's not in use any more. Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>