poky/documentation/kernel-dev
Quentin Schulz 7d3f57cfd2 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>
2021-06-19 16:54:01 +01:00
..
figures kernel-dev, mega-manual: kernel dev flow fig update and chapter revs 2017-09-13 18:00:19 +01:00
advanced.rst docs: replace `FOO by :term:FOO` where possible 2021-06-19 16:54:01 +01:00
common.rst docs: replace `FOO by :term:FOO` where possible 2021-06-19 16:54:01 +01:00
concepts-appx.rst kernel-dev manual: simplify style 2021-05-22 12:16:40 +01:00
faq.rst docs: replace `FOO by :term:FOO` where possible 2021-06-19 16:54:01 +01:00
history.rst docs: Fix license CC-BY-2.0-UK -> CC-BY-SA-2.0-UK 2020-10-08 11:28:30 +01:00
index.rst kernel-dev: remove 'kernel-dev' from filenames 2020-12-09 12:21:27 +00:00
intro.rst kernel-dev manual: simplify style 2021-05-22 12:16:40 +01:00
maint-appx.rst docs: replace `FOO by :term:FOO` where possible 2021-06-19 16:54:01 +01:00