[PATCH 2/3] doc: askenv: Reword and remove return value

[Quentin Schulz]

Hi Tom,

On 10/21/25 10:25 PM, Tom Rini wrote:
> With the addition of general text about how the return value is handled,
> remove the examples from the askenv documentation as they are all normal
> expected results.
> 
> Signed-off-by: Tom Rini <trini at konsulko.com>
> ---
> Cc: Heinrich Schuchardt <xypron.glpk at gmx.de>
> ---
>   doc/usage/cmd/askenv.rst | 27 +++------------------------
>   1 file changed, 3 insertions(+), 24 deletions(-)
> 
> diff --git a/doc/usage/cmd/askenv.rst b/doc/usage/cmd/askenv.rst
> index e2b3c5379aea..a8867ce4d266 100644
> --- a/doc/usage/cmd/askenv.rst
> +++ b/doc/usage/cmd/askenv.rst
[...]
> -Return Value of askenv command, when used without any other arguments:
> -
> -::
> -
> -    => askenv;echo $?
> -    askenv - get environment variables from stdin
> -
> -    Usage:
> -    askenv name [message] [size]
> -        - display 'message' and get environment variable 'name' from stdin (max 'size' chars)
> -    1

Shouldn't that be -1 here to match the expected return value when the 
syntax is incorrect?

If it is 1, then it's a difference to the expected return value and thus 
should be documented below?

Cheers,
Quentin