diff mbox series

[v2] ref-manual/variables.rst: add note about PSEUDO ignore/include precedence

Message ID 20251013132247.3987452-1-skandigraun@gmail.com
State Under Review
Headers show
Series [v2] ref-manual/variables.rst: add note about PSEUDO ignore/include precedence | expand

Commit Message

Gyorgy Sarvari Oct. 13, 2025, 1:22 p.m. UTC
This commit[1] in pseudo introduced the PSEUDO_INCLUDE_PATHS variable, however
the previous PSEUDO_IGNORE_PATHS variable is still present also. Add a clarifying
note about the order of precedence of the two.

[1]: https://git.yoctoproject.org/pseudo/commit/?id=2c43381180f9cfef4c0a8bb0c1658a86c3fcc876

Signed-off-by: Gyorgy Sarvari <skandigraun@gmail.com>
---
 documentation/ref-manual/variables.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)
diff mbox series

Patch

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 1d4ec413ca..591c03028c 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -7567,7 +7567,9 @@  system and gives an overview of their function and contents.
       by pseudo when monitoring and recording file operations, in order to avoid
       problems with files being written to outside of the pseudo context and
       reduce pseudo's overhead. A path is ignored if it matches any prefix in the list
-      and can include partial directory (or file) names.
+      and can include partial directory (or file) names. In case a path prefix is
+      present in both :term:`PSEUDO_IGNORE_PATHS` and in :term:`PSEUDO_INCLUDE_PATHS`,
+      :term:`PSEUDO_INCLUDE_PATHS` takes precedence.
 
    :term:`PSEUDO_INCLUDE_PATHS`
       A comma-separated (without spaces) list of path prefixes that should be included
@@ -7575,7 +7577,10 @@  system and gives an overview of their function and contents.
       problems with files being written to outside of the pseudo context and
       reduce :ref:`pseudo <overview-manual/concepts:Fakeroot and Pseudo>`'s overhead.
       A path is included if it matches any prefix in the list and can include
-      partial directory (or file) names.
+      partial directory (or file) names. In case a path prefix is present in both
+      :term:`PSEUDO_IGNORE_PATHS` and in :term:`PSEUDO_INCLUDE_PATHS`,
+      :term:`PSEUDO_INCLUDE_PATHS` takes precedence.
+
 
    :term:`PTEST_ENABLED`
       Specifies whether or not :ref:`Package