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@g' $(git grep -li '\<printenv\>' doc/) README Signed-off-by: Marek Vasut <[email protected]> --- Cc: "NXP i.MX U-Boot Team" <[email protected]> Cc: Anup Patel <[email protected]> Cc: Atish Patra <[email protected]> Cc: Daniel Golle <[email protected]> Cc: Dillon Min <[email protected]> Cc: E Shattow <[email protected]> Cc: Fabio Estevam <[email protected]> Cc: Frank Wunderlich <[email protected]> Cc: Hal Feng <[email protected]> Cc: Heinrich Schuchardt <[email protected]> Cc: Igor Opaniuk <[email protected]> Cc: Ilias Apalodimas <[email protected]> Cc: James Hilliard <[email protected]> Cc: Kamil Lulko <[email protected]> Cc: Lukasz Majewski <[email protected]> Cc: Mattijs Korpershoek <[email protected]> Cc: Max Merchel <[email protected]> Cc: Michal Simek <[email protected]> Cc: Minda Chen <[email protected]> Cc: Neil Armstrong <[email protected]> Cc: Nobuhiro Iwamatsu <[email protected]> Cc: Nora Schiffer <[email protected]> Cc: Palmer Dabbelt <[email protected]> Cc: Patrice Chotard <[email protected]> Cc: Patrick Delaunay <[email protected]> Cc: Paul Walmsley <[email protected]> Cc: Quentin Schulz <[email protected]> Cc: Sam Protsenko <[email protected]> Cc: Simon Glass <[email protected]> Cc: Stefano Babic <[email protected]> Cc: Tom Rini <[email protected]> Cc: [email protected] Cc: [email protected] Cc: [email protected] --- 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
