linux/poky.git/documentation/ref-manual/devtool-reference.rst, branch 4.2_M3

ref-manual: improve "devtool check-upgrade-status" explanations

2023-02-10T11:03:36+00:00

- Fix broken link to a .bb file - Clarify the explanations (From yocto-docs rev: 937ef39cb4d04da388b1945d741820089daa2780) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie

manuals: fix double colons

2022-12-18T10:41:21+00:00

Fixing double colons appearing alone on a line, while they could be put at the end of the previous line. Sometimes placing a note after the quoted text to avoid such a situation. It's more natural too not to have a note between the introduction text and the quoted section. (From yocto-docs rev: fb054622f5119444eb947fe580253f37e0d872c6) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie

manuals: split dev-manual/common-tasks.rst

2022-12-01T19:20:29+00:00

A 500 KB source file is always harder to manage, and can have section title conflicts. So, the "Common Tasks" document is gone and all its constituents are moved up one level. You now have 40 chapters in the Development Tasks Manual. (From yocto-docs rev: 8a45bc469411410020b8e688c137395fcaf3761b) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie

manuals: replace hyphens with em dashes

2022-06-27T13:55:08+00:00

Fix some hyphens being improperly used as em dashes. See https://www.grammarly.com/blog/hyphens-and-dashes/ Using em dashes may also allow Sphinx to hyphenate and break lines in the best way. Note that the first character after an em dash not supposed to be capitalized, unless a specific rule applies, typically when what follows is a proper noun. Fix a few misuses of parentheses in following text. (From yocto-docs rev: 5918f019f63f6e820b1168f4cc001faa1d1cdc6f) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie

manuals: improve the width of diagrams

2022-05-10T11:52:35+00:00

Better for EPUB output in particular - Make some diagrams wider when necessary - Remove ":align: center" when we have ":width: 100%" - Update the standards.md files to mention this (From yocto-docs rev: 848ba7bd8984cc3f4bf6b818259865011cde0476) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie

ref-manual: update "devtool check-upgrade-status" output

2021-09-18T12:03:45+00:00

This command now uses "INFO" insted of "NOTES" and output information in columns. Also good to show more recent versions of recipes. (From yocto-docs rev: d875083150ac30b884d823e9f0f568d3a92ddcc1) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie

ref-manual: improve documentation for RECIPE_NO_UPDATE_REASON

2021-09-18T12:03:45+00:00

This add a description of this variable to the variable index, and clarifies the explanations given in the devtool reference section. (From yocto-docs rev: 034b976addd0db6da31c4bacdbea21f2d47c00dc) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie

ref-manual: improve "devtool check-upgrade-status" details

2021-09-18T12:03:45+00:00

- Mention "devtool latest-version recipe" to process a single version - Explain that the mechanism is controlled by the UPSTREAM_CHECK* variables, which are not referred to anywhere else in the manuals, except in the variable index. (From yocto-docs rev: eded237f1a1ec7df3f9910242bfa4b3818ff3e58) Signed-off-by: Michael Opdenacker Reviewed-by: Alexander Kanavin Signed-off-by: Richard Purdie

ref-manual: remove mention of obsolete devtool "--any-recipe" option

2021-09-18T12:03:44+00:00

Running "devtool edit-recipe -h" produces, in part, the output: --any-recipe, -a Does nothing (exists for backwards-compatibility) so it seems of little value to continue referring to it. (From yocto-docs rev: fdac1da045e60d37025f754c9b6be5bb36f31c86) Signed-off-by: Robert P. J. Day Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie

ref-manual: render options in monospace to show quotes properly

2021-09-18T12:03:44+00:00

It's important (at least for now) to mark up options with monospaced font to highlight the difference between single and double quotes. (From yocto-docs rev: 8d71ffdd3f354747dcade6de512355e8fa567728) Signed-off-by: Robert P. J. Day Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie