diff options
author | Michael Opdenacker <michael.opdenacker@bootlin.com> | 2023-03-02 19:40:23 +0100 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2023-03-20 13:16:52 +0000 |
commit | 8355326ffad023d886da163a2a03f6efb7941116 (patch) | |
tree | 1380f2912816560460644901b55350f8cbc231cd /documentation/README | |
parent | 1f8322c8322543b7bb06df85e77355f99b5f8ecd (diff) | |
download | poky-8355326ffad023d886da163a2a03f6efb7941116.tar.gz |
manuals: simplify references to the BitBake User Manual
- Replacing
:ref:`bitbake:bitbake-user-manual/...`
by :ref:`bitbake-user-manual/...`
Adding "bitbake:" as a prefix is not necessary
as there is no naming conflict between the YP
and the BitBake manuals (all documents are in
"bitbake-user-manual/")
- Explaining the rules in the README file
- When necessary, fixing line length in the modified paragraphs.
(From yocto-docs rev: d80b31705450cfb98d217ea44ba2edace2d64095)
Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/README')
-rw-r--r-- | documentation/README | 18 |
1 files changed, 13 insertions, 5 deletions
diff --git a/documentation/README b/documentation/README index c27ed86a33..e8aed86eb4 100644 --- a/documentation/README +++ b/documentation/README | |||
@@ -357,13 +357,16 @@ The sphinx.ext.intersphinx extension is enabled by default | |||
357 | so that we can cross reference content from other Sphinx based | 357 | so that we can cross reference content from other Sphinx based |
358 | documentation projects, such as the BitBake manual. | 358 | documentation projects, such as the BitBake manual. |
359 | 359 | ||
360 | References to the BitBake manual can be done: | 360 | References to the BitBake manual can directly be done: |
361 | - With a specific description instead of the section name: | 361 | - With a specific description instead of the section name: |
362 | :ref:`Azure Storage fetcher (az://) <bitbake:bitbake-user-manual/bitbake-user-manual-fetching:fetchers>` | 362 | :ref:`Azure Storage fetcher (az://) <bitbake-user-manual/bitbake-user-manual-fetching:fetchers>` |
363 | - With the section name: | 363 | - With the section name: |
364 | :ref:`bitbake:bitbake-user-manual/bitbake-user-manual-intro:usage and syntax` option | 364 | :ref:`bitbake-user-manual/bitbake-user-manual-intro:usage and syntax` option |
365 | - Linking to the entire BitBake manual: | 365 | |
366 | :doc:`BitBake User Manual <bitbake:index>` | 366 | If you want to refer to an entire document (or chapter) in the BitBake manual, |
367 | you have to use the ":doc:" macro with the "bitbake:" prefix: | ||
368 | - :doc:`BitBake User Manual <bitbake:index>` | ||
369 | - :doc:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata`" chapter | ||
367 | 370 | ||
368 | Note that a reference to a variable (:term:`VARIABLE`) automatically points to | 371 | Note that a reference to a variable (:term:`VARIABLE`) automatically points to |
369 | the BitBake manual if the variable is not described in the Reference Manual's Variable Glossary. | 372 | the BitBake manual if the variable is not described in the Reference Manual's Variable Glossary. |
@@ -372,6 +375,11 @@ BitBake manual as follows: | |||
372 | 375 | ||
373 | :term:`bitbake:BB_NUMBER_PARSE_THREADS` | 376 | :term:`bitbake:BB_NUMBER_PARSE_THREADS` |
374 | 377 | ||
378 | This would be the same if we had identical document filenames in | ||
379 | both the Yocto Project and BitBake manuals: | ||
380 | |||
381 | :ref:`bitbake:directory/file:section title` | ||
382 | |||
375 | Submitting documentation changes | 383 | Submitting documentation changes |
376 | ================================ | 384 | ================================ |
377 | 385 | ||