diff options
author | Paul Eggleton <bluelightning@bluelightning.org> | 2024-04-14 13:43:10 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2024-04-16 07:55:42 +0100 |
commit | cb7663fe2b71b66b301fb2aafd772d744a4d736a (patch) | |
tree | aae67e97b53534b7bc622e78111e0947f7ad9069 /documentation/ref-manual | |
parent | 073c07ef767cfd3942b31c5a7d08507ca3805371 (diff) | |
download | poky-cb7663fe2b71b66b301fb2aafd772d744a4d736a.tar.gz |
ref-manual: add virtual-slash QA check
Add the new virtual-slash QA check to the insane class section and the
QA checks section.
(From yocto-docs rev: fdca0217558185eca67f7ec04b9d282b7819d107)
Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r-- | documentation/ref-manual/classes.rst | 6 | ||||
-rw-r--r-- | documentation/ref-manual/qa-checks.rst | 8 |
2 files changed, 14 insertions, 0 deletions
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 1d01456ece..29e5624e95 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst | |||
@@ -1582,6 +1582,12 @@ The tests you can list with the :term:`WARN_QA` and | |||
1582 | This is only relevant when you are using runtime package management | 1582 | This is only relevant when you are using runtime package management |
1583 | on your target system. | 1583 | on your target system. |
1584 | 1584 | ||
1585 | - ``virtual-slash:`` Checks to see if ``virtual/`` is being used in | ||
1586 | :term:`RDEPENDS` or :term:`RPROVIDES`, which is not good practice --- | ||
1587 | ``virtual/`` is a convention intended for use in the build context | ||
1588 | (i.e. :term:`PROVIDES` and :term:`DEPENDS`) rather than the runtime | ||
1589 | context. | ||
1590 | |||
1585 | - ``xorg-driver-abi:`` Checks that all packages containing Xorg | 1591 | - ``xorg-driver-abi:`` Checks that all packages containing Xorg |
1586 | drivers have ABI dependencies. The ``xserver-xorg`` recipe provides | 1592 | drivers have ABI dependencies. The ``xserver-xorg`` recipe provides |
1587 | driver ABI names. All drivers should depend on the ABI versions that | 1593 | driver ABI names. All drivers should depend on the ABI versions that |
diff --git a/documentation/ref-manual/qa-checks.rst b/documentation/ref-manual/qa-checks.rst index 58526a0e57..53b1836e74 100644 --- a/documentation/ref-manual/qa-checks.rst +++ b/documentation/ref-manual/qa-checks.rst | |||
@@ -799,6 +799,14 @@ Errors and Warnings | |||
799 | section in the Yocto Project Development Tasks Manual. See also the | 799 | section in the Yocto Project Development Tasks Manual. See also the |
800 | ":ref:`ref-classes-ptest`" section. | 800 | ":ref:`ref-classes-ptest`" section. |
801 | 801 | ||
802 | .. _qa-check-virtual-slash: | ||
803 | |||
804 | - ``<variable> is set to <value> but the substring 'virtual/' holds no meaning in this context. It only works for build time dependencies, not runtime ones. It is suggested to use 'VIRTUAL-RUNTIME_' variables instead.`` | ||
805 | |||
806 | ``virtual/`` is a convention intended for use in the build context | ||
807 | (i.e. :term:`PROVIDES` and :term:`DEPENDS`) rather than the runtime | ||
808 | context (i.e. :term:`RPROVIDES` and :term:`RDEPENDS`). Use | ||
809 | :term:`VIRTUAL-RUNTIME` variables instead for the latter. | ||
802 | 810 | ||
803 | 811 | ||
804 | Configuring and Disabling QA Checks | 812 | Configuring and Disabling QA Checks |