diff mbox series

[15/17] ref-manual/classes.rst: document the relative_symlinks class

Message ID 20251016-release-note-5-3-second-hunk-v1-15-20f21db1f93c@bootlin.com
State New
Headers show
Series Updates for 5.3 | expand

Commit Message

Antonin Godard Oct. 16, 2025, 8:54 a.m. UTC
Added by commit e478550c8cd8 ("openssl/fontconfig/bzip2: Use relative
symlinks instead of absolute ones (using a new class)") in OE-Core.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/classes.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

Comments

Paul Barker Oct. 16, 2025, 10:41 a.m. UTC | #1
On Thu, 2025-10-16 at 10:54 +0200, Antonin Godard wrote:
> Added by commit e478550c8cd8 ("openssl/fontconfig/bzip2: Use relative
> symlinks instead of absolute ones (using a new class)") in OE-Core.
> 
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>  documentation/ref-manual/classes.rst | 19 +++++++++++++++++++
>  1 file changed, 19 insertions(+)
> 
> diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
> index 9fbdb22e1..4d74563e1 100644
> --- a/documentation/ref-manual/classes.rst
> +++ b/documentation/ref-manual/classes.rst
> @@ -2494,6 +2494,25 @@ The :ref:`ref-classes-recipe_sanity` class checks for the presence of any host s
>  recipe prerequisites that might affect the build (e.g. variables that
>  are set or software that is present).
>  
> +.. _ref-classes-relative_symlinks:
> +
> +``relative_symlinks``
> +=====================
> +
> +The :ref:`ref-classes-relative_symlinks` class walks the symbolic links in the
> +:term:`D` directory and replaces links pointing to absolute paths to relative
> +paths. This is occasionally used in some recipes that create wrong symbolic
> +links when their :ref:`ref-classes-native` version is built, and/or would cause
> +breakage in in the :ref:`overview-manual/concepts:shared state cache`.

Typo: "in in" should just be "in".

Thanks,
diff mbox series

Patch

diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index 9fbdb22e1..4d74563e1 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -2494,6 +2494,25 @@  The :ref:`ref-classes-recipe_sanity` class checks for the presence of any host s
 recipe prerequisites that might affect the build (e.g. variables that
 are set or software that is present).
 
+.. _ref-classes-relative_symlinks:
+
+``relative_symlinks``
+=====================
+
+The :ref:`ref-classes-relative_symlinks` class walks the symbolic links in the
+:term:`D` directory and replaces links pointing to absolute paths to relative
+paths. This is occasionally used in some recipes that create wrong symbolic
+links when their :ref:`ref-classes-native` version is built, and/or would cause
+breakage in in the :ref:`overview-manual/concepts:shared state cache`.
+
+For example, if the following symbolic link is found in :term:`D`::
+
+   /usr/bin/foo -> /sbin/bar
+
+It is replaced by::
+
+   /usr/bin/foo -> ../../sbin/bar
+
 .. _ref-classes-relocatable:
 
 ``relocatable``