[PATCH master 2/2] Documentation: migration-guides: 2026.01.0: clarify fsdev linux.bootargs change

[Ahmad Fatoum]

The entry is a bit confusing and it's not clearly spelt out that this
doesn't affect global.linux.bootargs, so make this clearer.

Signed-off-by: Ahmad Fatoum <a.fatoum at pengutronix.de>
---
 .../migration-guides/migration-2026.01.0.rst  | 23 ++++++++++---------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/Documentation/migration-guides/migration-2026.01.0.rst b/Documentation/migration-guides/migration-2026.01.0.rst
index 931972901695..b40d125195a7 100644
--- a/Documentation/migration-guides/migration-2026.01.0.rst
+++ b/Documentation/migration-guides/migration-2026.01.0.rst
@@ -12,21 +12,22 @@ like the in-tree boards are already doing.
 Filesystems
 -----------
 
-``{linux.bootargs}`` is replaced with ``root={linux.bootargs.root} {linux.bootargs.rootopts}``
+The ``linux.bootargs`` file system device parameter (e.g. ``ext40.linux.bootargs``)
+has been replaced by the two variables ``${fsdev}.linux.bootargs.root`` and
+``${fsdev}.linux.bootargs.rootopts``, splitting the previous bootargs
+into three parts. For example, the previous::
 
-The variable linux.bootargs has been replaced by the two variables
-linux.bootargs.root and linux.bootargs.rootopts, splitting the previous bootargs
-into three parts. A nonexistent fixed "root=", then the root filesystem and then
-additional optional params for this particular filesystem.
-
-for example the previous::
-
-    linux.bootargs="root=/dev/nfs nfsroot=192.168.1.1:/rootfs"
+    ext40.linux.bootargs="root=/dev/nfs nfsroot=192.168.1.1:/rootfs"
 
 becomes::
 
-    linux.bootargs.root="/dev/nfs"
-    linux.bootargs.rootopts="nfsroot=192.168.1.1:/rootfs"
+    ext40.linux.bootargs.root="/dev/nfs"
+    ext40.linux.bootargs.rootopts="nfsroot=192.168.1.1:/rootfs"
+
+Scripts that access these parameters will need to be adapted to replace
+``{linux.bootargs}`` with ``root={linux.bootargs.root} {linux.bootargs.rootopts}``.
+
+``global.linux.bootargs.*`` is unaffected by this change.
 
 Boards
 ------
-- 
2.47.3