[Uboot-stm32] [PATCH v2 2/2] doc: Switch from printenv to env print

Tue Jul 28 17:22:18 UTC 2026

Am 28. Juli 2026 15:33:18 MESZ schrieb Marek Vasut <marek.vasut+renesas at mailbox.org>:
>The "env" command is the recommended environment management command,
>its "print" subcommand is the equivalent replacement for legacy "printenv"
>command. Update the documentation to use the contemporary "env print"
>command instead of legacy "printenv" command.
>
>Note that the "printenv" command is unlikely to be removed from U-Boot
>in the near future due to it being integral part of the command line
>ABI.
>
>Implemented using:
>$ sed -i 's@\<printenv\>@env print at g' $(git grep -li '\<printenv\>' doc/) README

Hello Marek,

An earlier version of the series was merged today. Please, create a patch for the delta.

Best regards

Heinrich

>
>Signed-off-by: Marek Vasut <marek.vasut+renesas at mailbox.org>
>---
>Cc: "NXP i.MX U-Boot Team" <uboot-imx at nxp.com>
>Cc: Anup Patel <anup at brainfault.org>
>Cc: Atish Patra <atishp at atishpatra.org>
>Cc: Daniel Golle <daniel at makrotopia.org>
>Cc: Dillon Min <dillon.minfei at gmail.com>
>Cc: E Shattow <e at freeshell.de>
>Cc: Fabio Estevam <festevam at gmail.com>
>Cc: Frank Wunderlich <frank-w at public-files.de>
>Cc: Hal Feng <hal.feng at starfivetech.com>
>Cc: Heinrich Schuchardt <xypron.glpk at gmx.de>
>Cc: Igor Opaniuk <igor.opaniuk at gmail.com>
>Cc: Ilias Apalodimas <ilias.apalodimas at linaro.org>
>Cc: James Hilliard <james.hilliard1 at gmail.com>
>Cc: Kamil Lulko <kamil.lulko at gmail.com>
>Cc: Lukasz Majewski <lukma at nabladev.com>
>Cc: Mattijs Korpershoek <mkorpershoek at kernel.org>
>Cc: Max Merchel <Max.Merchel at ew.tq-group.com>
>Cc: Michal Simek <michal.simek at amd.com>
>Cc: Minda Chen <minda.chen at starfivetech.com>
>Cc: Neil Armstrong <neil.armstrong at linaro.org>
>Cc: Nobuhiro Iwamatsu <iwamatsu at nigauri.org>
>Cc: Nora Schiffer <nora.schiffer at ew.tq-group.com>
>Cc: Palmer Dabbelt <palmer at dabbelt.com>
>Cc: Patrice Chotard <patrice.chotard at foss.st.com>
>Cc: Patrick Delaunay <patrick.delaunay at foss.st.com>
>Cc: Paul Walmsley <paul.walmsley at sifive.com>
>Cc: Quentin Schulz <quentin.schulz at cherry.de>
>Cc: Sam Protsenko <semen.protsenko at linaro.org>
>Cc: Simon Glass <sjg at chromium.org>
>Cc: Stefano Babic <sbabic at nabladev.com>
>Cc: Tom Rini <trini at konsulko.com>
>Cc: u-boot at ew.tq-group.com
>Cc: u-boot at lists.denx.de
>Cc: uboot-stm32 at st-md-mailman.stormreply.com
>---
>V2: Fix up "env set" and "env print" in README
>---
> README                    | 8 ++++----
> doc/README.odroid         | 4 ++--
> doc/android/ab.rst        | 2 +-
> doc/usage/cmd/askenv.rst  | 6 +++---
> doc/usage/cmd/memsize.rst | 2 +-
> 5 files changed, 11 insertions(+), 11 deletions(-)
>
>diff --git a/README b/README
>index 0e3c278e29d..f740188a4bb 100644
>--- a/README
>+++ b/README
>@@ -754,7 +754,7 @@ The following options need to be configured:
> 		directly type `$name' at the command prompt.
> 
> 		Global environment variables are those you use "env set"
>-		or printenv to work with. To run a command stored
>+		or "env print" to work with. To run a command stored
> 		in such a variable, you need to use the run command,
> 		and you must not use the '$' sign to access them.
> 
>@@ -1655,15 +1655,15 @@ The "bootm" command is used to boot an application that is stored in
> memory (RAM or Flash). In case of a Linux kernel image, the contents
> of the "bootargs" environment variable is passed to the kernel as
> parameters. You can check and modify this variable using the
>-"printenv" and "env set" commands:
>+"env print" and "env set" commands:
> 
> 
>-	=> printenv bootargs
>+	=> env print bootargs
> 	bootargs=root=/dev/ram
> 
> 	=> env set bootargs root=/dev/nfs rw nfsroot=10.0.0.2:/LinuxPPC nfsaddrs=10.0.0.99:10.0.0.2
> 
>-	=> printenv bootargs
>+	=> env print bootargs
> 	bootargs=root=/dev/nfs rw nfsroot=10.0.0.2:/LinuxPPC nfsaddrs=10.0.0.99:10.0.0.2
> 
> 	=> bootm 40020000
>diff --git a/doc/README.odroid b/doc/README.odroid
>index f0592dd57fc..8fe226cf4cf 100644
>--- a/doc/README.odroid
>+++ b/doc/README.odroid
>@@ -200,7 +200,7 @@ Odroid #
> Note that this automatically sets the many IP address related variables in
> U-Boot that is obtained from the DHCP server.
> 
>-Odroid # printenv ipaddr netmask gatewayip dnsip
>+Odroid # env print ipaddr netmask gatewayip dnsip
> ipaddr=192.168.1.10
> netmask=255.255.255.0
> gatewayip=192.168.1.1
>@@ -256,7 +256,7 @@ Loading: ####
> 	 40 KiB/s
> done
> Bytes transferred = 46935 (b757 hex)
>-Odroid # printenv bootargs
>+Odroid # env print bootargs
> bootargs=Please use defined boot
> Odroid # env set bootargs console=ttySAC1,115200n8 root=/dev/mmcblk0p2 rootwait
> Odroid # bootz 40080000 - 42000000
>diff --git a/doc/android/ab.rst b/doc/android/ab.rst
>index 7fd4aeb6a72..b0123db28e4 100644
>--- a/doc/android/ab.rst
>+++ b/doc/android/ab.rst
>@@ -54,7 +54,7 @@ or::
> 
> Result::
> 
>-    => printenv slot_name
>+    => env print slot_name
>     slot_name=a
> 
> Based on this slot information, the current boot partition should be defined,
>diff --git a/doc/usage/cmd/askenv.rst b/doc/usage/cmd/askenv.rst
>index a8867ce4d26..0aebc70214f 100644
>--- a/doc/usage/cmd/askenv.rst
>+++ b/doc/usage/cmd/askenv.rst
>@@ -44,7 +44,7 @@ Value of a environment variable env1 without message and size parameters:
> 
>     => askenv env1
>     Please enter 'env1': val1
>-    => printenv env1
>+    => env print env1
>     env1=val1
> 
> Value of a environment variable env2 with message and size parameters:
>@@ -53,7 +53,7 @@ Value of a environment variable env2 with message and size parameters:
> 
>     => askenv env2 Please type-in a value for env2: 10
>     Please type-in a value for env2: 1234567890123
>-    => printenv env2
>+    => env print env2
>     env2=1234567890
> 
> Value of a environment variable env3 with size parameter only:
>@@ -62,7 +62,7 @@ Value of a environment variable env3 with size parameter only:
> 
>     => askenv env3 10
>     Please enter 'env3': val3
>-    => printenv env3
>+    => env print env3
>     env3=val3
> 
> Configuration
>diff --git a/doc/usage/cmd/memsize.rst b/doc/usage/cmd/memsize.rst
>index 6e99d7c1d33..9ebeefc58fa 100644
>--- a/doc/usage/cmd/memsize.rst
>+++ b/doc/usage/cmd/memsize.rst
>@@ -34,7 +34,7 @@ This second example shows assign ram size to environment variable:
> ::
> 
>   => memsize memsz
>-  => printenv memsz
>+  => env print memsz
>   memsz=8192
> 
> Return value