linux/poky.git/documentation/overview-manual, branch styhead

documentation/conf.py: define a manpage url

2025-05-25T11:37:57+00:00

By defining the manpages_url we can use the :manpage: role in the documentation for providing links to manpages. See: https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-manpages_url Replace existing manpages links to use this role. Reviewed-by: Quentin Schulz (From yocto-docs rev: f5c964f41ed0f9a9740769e40aabf543df274c03) Signed-off-by: Antonin Godard (cherry picked from commit 4e63cd74cd1a330ea5e96bb04243a90f607b2857) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

overview-manual/concepts: add UNPACKDIR in the directory description

2025-05-25T11:37:57+00:00

Mention that UNPACKDIR is used as a location to unpack the source code, and that S is the final location of the source code. This is deliberately vague, because as there are multiple instances of how these directories can be defined and used. The proper explanation of how the UNPACKDIR and S directories interact is left to the reference manual, under the UNPACKDIR variable description. (From yocto-docs rev: 85e738e4c0e62f69699fff4bb0482ee3e3121496) Signed-off-by: Antonin Godard (cherry picked from commit 39ca56c3a3a5218ca73c7ced212b2ee89428a2d1) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

overview-manual/concepts: remove PR from the build dir list

2025-05-25T11:37:57+00:00

PR was removed by cc83e4548465 ("bitbake.conf: Drop PE and PR from WORKDIR and STAMP") on OE-Core. (From yocto-docs rev: 05a7235cfa9a3d899395c80a1a8caae8b3b3eba9) Signed-off-by: Antonin Godard (cherry picked from commit d7a1038ee7c8c463623f0996963f9e8f29d40555) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

overview-manual: convert analysis-for-package-splitting.png to svg

2025-05-25T11:37:57+00:00

- Convert the png file to an SVG file - Add the UNPACKDIR reference. - Remove ${PR} from WORKDIR value, after cc83e4548465 ("bitbake.conf: Drop PE and PR from WORKDIR and STAMP") on OE-Core. - Change S value to BP (equal to ${BPN}-${PV}, but more accurate). (From yocto-docs rev: 2836f36e6e9fd42801b129232fc9e7db35ea7136) Signed-off-by: Antonin Godard (cherry picked from commit 18832dd1e90ad85916b1f757271493ddfd3eb432) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

overview-manual: convert configuration-compile-autoreconf.png to svg

2025-05-25T11:37:57+00:00

- Convert the png file to an SVG file - Add the UNPACKDIR reference. - Remove ${PR} from WORKDIR value, after cc83e4548465 ("bitbake.conf: Drop PE and PR from WORKDIR and STAMP") on OE-Core. - Change S value to BP (equal to ${BPN}-${PV}, but more accurate). (From yocto-docs rev: 272056be6e32d1b6cd2b7064ab764a55474721b5) Signed-off-by: Antonin Godard (cherry picked from commit 91b53f4d1de5b9669cbb8d7fc741ba9c08c31f94) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

overview-manual: convert patching.png to svg

2025-05-25T11:37:57+00:00

- Convert the png file to an SVG file. - Add the new UNPACKDIR directory to the image. - Remove ${PR} from WORKDIR value, after cc83e4548465 ("bitbake.conf: Drop PE and PR from WORKDIR and STAMP") on OE-Core. - Change S value to BP (equal to ${BPN}-${PV}, but more accurate).- Reviewed-by: Quentin Schulz (From yocto-docs rev: 508d65d5eb1759caa926aa8a4634679647e2b121) Signed-off-by: Antonin Godard (cherry picked from commit 3aa3af6d5214b47555c4c2b16e9c720122e16fa4) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

overview-manual: convert source-fetching.png to svg and fix UNPACKDIR

2025-05-25T11:37:57+00:00

- Convert the png file to an SVG file. - Add the new UNPACKDIR directory to the image. - Remove ${PR} from WORKDIR value, after cc83e4548465 ("bitbake.conf: Drop PE and PR from WORKDIR and STAMP") on OE-Core. - Change S value to BP (equal to ${BPN}-${PV}, but more accurate).- This fixes [YOCTO #15730]. Reviewed-by: Quentin Schulz (From yocto-docs rev: 404a0fb167402e13d3a4ce5aba23aa22a78a0c06) Signed-off-by: Antonin Godard (cherry picked from commit 27725e4e7bf4d5fe7ad222de077cc693b9205b17) Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie

overview-manual: concepts: add details on package splitting

2024-10-29T12:51:03+00:00

The package splitting section of the overview manual currently lacks any explanation of how package splitting is implemented and redirects to the package class, which is not really understandable for newcomers to the project. This patch adds a short explanation of what is done: * How the PACKAGES variable is defined. * How the FILES variable is defined. * How the two work together. * How to add a custom package. This should give enough details to a new user on what package splitting achieves and how to add a custom package. Adresses [YOCTO #13225] Reviewed-by: Quentin Schulz (From yocto-docs rev: fe96edac4bf17915d1d301f9122ce7ae981fe0da) Signed-off-by: Antonin Godard (cherry picked from commit 143c3cacdec36c9d7ab81c89bbcc12c0c3936bd9) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

manuals: fix trailing spaces

2024-04-08T13:36:38+00:00

Fixing errors reported by "make sphinx-lint" (From yocto-docs rev: ef6b650c31c4320314564bb85a45eebde3fd98c1) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie

ref-manual: variables: correct sdk installation default path

2024-03-06T16:54:54+00:00

The SDKPATH variable seems mistakenly identified as the default path where the SDK will be installed by the generated installation script, unless option '-d' or a manual input overrides this default. The intended variable is SDKPATHINSTALL. SDKPATH indicates where the SDK is being composed and built. The definitions have been added/updated. (From yocto-docs rev: d5b9c4b9c443cc728a11fd1e0a26a11aac8ee2c5) Signed-off-by: Johan Bezem Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie