[PATCH] Documentation: turn more magic variable literals into references

[PATCH] Documentation: turn more magic variable literals into references

[Ahmad Fatoum]

Since the last replacement of magic variables with references, two more
instances have made it into the docs, so switch them over now.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/user/booting-linux.rst | 2 +-
 Documentation/user/security.rst      | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Documentation/user/booting-linux.rst b/Documentation/user/booting-linux.rst
index 4a765363b182..ed1ec3f68a93 100644
--- a/Documentation/user/booting-linux.rst
+++ b/Documentation/user/booting-linux.rst
@@ -193,7 +193,7 @@ bootloader spec file detected at runtime as described in the next section.
 There is also a number of generic default boot targets available, when
 ``CONFIG_BOOT_DEFAULTS`` is enabled. These expands to a single device at most:
 
-* ``bootsource``: expands to the device barebox booted from
+* :ref:`bootsource <magicvar_bootsource>`: expands to the device barebox booted from
 * ``diskuuid.*``: expands to the device with specified ``*`` diskuuid
 
 For these targets that expand to a single device, a partition can also be specified,
diff --git a/Documentation/user/security.rst b/Documentation/user/security.rst
index 5a23bd83ba65..94184ab8e893 100644
--- a/Documentation/user/security.rst
+++ b/Documentation/user/security.rst
@@ -99,8 +99,8 @@ different compression algorithm.
 The fail-safe alternative is to use a parameter name understood only by the
 initramfs (e.g. ``verity_root=``) in all bootloader scripts. If the
 ``root=$dev`` is fixed up by barebox dynamically, the
-``$global.bootm.root_param`` variable can be used to customize the name of the
-parameter passed to Linux.
+:ref:`global.bootm.root_param <magicvar_global_bootm_root_param>` variable can
+be used to customize the name of the parameter passed to Linux.
 
 Disabling the shell
 ^^^^^^^^^^^^^^^^^^^
-- 
2.47.3

Re: [PATCH] Documentation: turn more magic variable literals into references

[Sascha Hauer]

On Wed, 07 Jan 2026 09:10:51 +0100, Ahmad Fatoum wrote:
> Since the last replacement of magic variables with references, two more
> instances have made it into the docs, so switch them over now.
> 
> 

Applied, thanks!

[1/1] Documentation: turn more magic variable literals into references
      https://git.pengutronix.de/cgit/barebox/commit/?id=02eb22bd9494 (link may not be stable)

Best regards,
-- 
Sascha Hauer <s.hauer@pengutronix.de>