mirror of
https://git.yoctoproject.org/poky
synced 2026-06-01 00:59:48 +00:00
docs: replace `FOO by :term:FOO` where possible
If a variable has a glossary entry and some rST files write about those
variables, it's better to point to the glossary entry instead of just
highlighting it by surrounding it with two tick quotes.
This was automated by the following python script:
"""
import re
from pathlib import Path
with open('objects.inv.txt', 'r') as f:
objects = f.readlines()
with open('bitbake-objects.inv.txt', 'r') as f:
objects = objects + f.readlines()
re_term = re.compile(r'variables.html#term-([A-Z_0-9]*)')
terms = []
for obj in objects:
match = re_term.search(obj)
if match and match.group(1):
terms.append(match.group(1))
for rst in Path('.').rglob('*.rst'):
with open(rst, 'r') as f:
content = "".joing(f.readlines())
for term in terms:
content = re.sub(r'``({})``(?!.*\s*[~-]+)'.format(term), r':term:`\1`', content)
with open(rst, 'w') as f:
f.write(content)
"""
(From yocto-docs rev: ba49d9babfcb84bc5c26a68c8c3880a1d9c236d3)
Signed-off-by: Quentin Schulz <foss@0leil.net>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Reviewed-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
committed by
Richard Purdie
parent
7a9b74e9d2
commit
7d3f57cfd2
@@ -239,7 +239,7 @@ to catch recipes that are building software without using the
|
||||
OpenEmbedded :term:`LDFLAGS`. This change could result in
|
||||
seeing some "No GNU_HASH in the elf binary" QA issues when building such
|
||||
recipes. You need to fix these recipes so that they use the expected
|
||||
``LDFLAGS``. Depending on how the software is built, the build system
|
||||
:term:`LDFLAGS`. Depending on how the software is built, the build system
|
||||
used by the software (e.g. a Makefile) might need to be patched.
|
||||
However, sometimes making this fix is as simple as adding the following
|
||||
to the recipe::
|
||||
@@ -291,7 +291,7 @@ The following changes took place for BitBake:
|
||||
:term:`SRC_URI` parameters to specify these. This
|
||||
change is more in-line with how the other fetchers work for source
|
||||
control systems. Recipes that fetch from Perforce will need to be
|
||||
updated to use ``SRCREV`` in place of specifying the source revision
|
||||
updated to use :term:`SRCREV` in place of specifying the source revision
|
||||
within ``SRC_URI``.
|
||||
|
||||
- Some of BitBake's internal code structures for accessing the recipe
|
||||
@@ -308,7 +308,7 @@ The following changes took place for BitBake:
|
||||
to cause any problems for most users. However, the setscene
|
||||
verification function as pointed to by
|
||||
``BB_SETSCENE_VERIFY_FUNCTION`` needed to change signature.
|
||||
Consequently, a new variable named ``BB_SETSCENE_VERIFY_FUNCTION2``
|
||||
Consequently, a new variable named :term:`BB_SETSCENE_VERIFY_FUNCTION2`
|
||||
has been added allowing multiple versions of BitBake to work with
|
||||
suitably written metadata, which includes OpenEmbedded-Core and Poky.
|
||||
Anyone with custom BitBake task scheduler code might also need to
|
||||
|
||||
Reference in New Issue
Block a user