diff options
author | Quentin Schulz <foss@0leil.net> | 2021-06-19 09:07:35 +0200 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2021-07-16 21:59:31 +0100 |
commit | 5a6fb291ad16ce4110e65adf2d29e8ccfe6fa25a (patch) | |
tree | df43222dc7a0def1bbc6246ca2a33953f85e584f /documentation/overview-manual | |
parent | be3e14dd43220db034a63b7a9f5516feb6a00110 (diff) | |
download | poky-5a6fb291ad16ce4110e65adf2d29e8ccfe6fa25a.tar.gz |
docs: replace remaining ``FOO`` by :term:`FOO`
A few occurences appeared between the time the original patch was sent
and it was applied, this fixes it.
Also, the original patch didn't take into account lowercase terms, this
is now fixed, see module_autoload for example.
Finally, as is often the case with regexp, there was a typo in it that
didn't make it match as much as it should have.
The script that is used to do the replacement of ``FOO`` by :term:`FOO`
is the following Python code:
import re
from pathlib import Path
from runpy import run_module
import contextlib
import io
import sys
re_term = re.compile(r'variables.html#term-([a-zA-Z_0-9]*)')
terms = []
new_terms = set()
with contextlib.redirect_stdout(io.StringIO()) as f:
run_module('sphinx.ext.intersphinx', run_name='__main__')
objects = f.getvalue()
match = re_term.search(objects)
while match:
if match.group(1):
terms.append(match.group(1))
match = re_term.search(objects, match.end())
for rst in Path('.').rglob('*.rst'):
with open(rst, 'r') as f:
content = "".join(f.readlines())
for term in terms:
content = re.sub(r'``({})``(?!.*\s+[~=-]{{{:d},}})'.format(term, len(term)), r':term:`\1`', content)
with open(rst, 'w') as f:
f.write(content)
This script takes one argument as input: an objects.inv. Bitbake's can
be gotten from https://docs.yoctoproject.org/bitbake/objects.inv. The
objetcs.inv from the current git repo can be gotten from
documentation/_build/html/objetcs.inv after running `make html`.
Note that this excludes from replacement terms that appear in section
titles as it requires refs to be changed too. This can be automated too
if need be but right now it looks a bit confusing to have an anchor link
(for sections) also have a term/reference link in it. I am not sure this
is desired today.
This is the result of two runs of the aforementioned script, once with
Bitbake objects.inv and once with this repo's.
Fixes: ba49d9babfcb "docs: replace ``FOO`` by :term:`FOO` where possible"
(From yocto-docs rev: 1e1b0c4dd241b6657035172b1f7b5f341afa8b25)
Signed-off-by: Quentin Schulz <foss@0leil.net>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/overview-manual')
-rw-r--r-- | documentation/overview-manual/concepts.rst | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst index 642ef15fe5..1e5f0f9039 100644 --- a/documentation/overview-manual/concepts.rst +++ b/documentation/overview-manual/concepts.rst | |||
@@ -774,7 +774,7 @@ Build Directory's hierarchy: | |||
774 | 774 | ||
775 | - :term:`BPN`: The name of the recipe | 775 | - :term:`BPN`: The name of the recipe |
776 | used to build the package. The :term:`BPN` variable is a version of | 776 | used to build the package. The :term:`BPN` variable is a version of |
777 | the ``PN`` variable but with common prefixes and suffixes removed. | 777 | the :term:`PN` variable but with common prefixes and suffixes removed. |
778 | 778 | ||
779 | - :term:`PV`: The version of the | 779 | - :term:`PV`: The version of the |
780 | recipe used to build the package. | 780 | recipe used to build the package. |
@@ -1918,7 +1918,7 @@ shared state files. Here is an example:: | |||
1918 | 1918 | ||
1919 | .. note:: | 1919 | .. note:: |
1920 | 1920 | ||
1921 | The shared state directory (``SSTATE_DIR``) is organized into two-character | 1921 | The shared state directory (:term:`SSTATE_DIR`) is organized into two-character |
1922 | subdirectories, where the subdirectory names are based on the first two | 1922 | subdirectories, where the subdirectory names are based on the first two |
1923 | characters of the hash. | 1923 | characters of the hash. |
1924 | If the shared state directory structure for a mirror has the same structure | 1924 | If the shared state directory structure for a mirror has the same structure |
@@ -2028,7 +2028,7 @@ dependencies, you must manually declare the dependencies. | |||
2028 | 2028 | ||
2029 | .. note:: | 2029 | .. note:: |
2030 | 2030 | ||
2031 | By default, ``foo-dev`` also has an ``RDEPENDS``-style dependency on | 2031 | By default, ``foo-dev`` also has an :term:`RDEPENDS`-style dependency on |
2032 | ``foo``, because the default value of ``RDEPENDS_${PN}-dev`` (set in | 2032 | ``foo``, because the default value of ``RDEPENDS_${PN}-dev`` (set in |
2033 | bitbake.conf) includes "${PN}". | 2033 | bitbake.conf) includes "${PN}". |
2034 | 2034 | ||