[Uboot-stm32] [PATCH v2 2/2] doc: Switch from printenv to env print
Marek Vasut
marek.vasut+renesas at mailbox.org
Tue Jul 28 13:33:18 UTC 2026
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
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
--
2.53.0
More information about the Uboot-stm32
mailing list