Re: [PATCH v10 7/9] doc: Improve environment documentation further

[Simon Glass <sjg@chromium.org>]

Hi Heinrich,

On Sat, 23 Oct 2021 at 02:23, Heinrich Schuchardt <xypron.glpk@gmx.de> wrote:
>
> On 10/22/21 05:08, Simon Glass wrote:
> > Make various other updates suggested during review of the rST conversion.
> >
> > Signed-off-by: Simon Glass <sjg@chromium.org>
> > Suggested-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
> > ---
> >
> > Changes in v10:
> > - Add updates as suggested by Heinrich
> >
> >   doc/develop/environment.rst |  51 ++++++++++++++++
> >   doc/develop/index.rst       |   1 +
> >   doc/usage/environment.rst   | 115 ++++++++++++++----------------------
> >   3 files changed, 95 insertions(+), 72 deletions(-)
> >   create mode 100644 doc/develop/environment.rst
> >
> > diff --git a/doc/develop/environment.rst b/doc/develop/environment.rst
> > new file mode 100644
> > index 00000000000..0b86fafbff7
> > --- /dev/null
> > +++ b/doc/develop/environment.rst
> > @@ -0,0 +1,51 @@
> > +.. SPDX-License-Identifier: GPL-2.0+
> > +

[..]

>
> ethaddr
>         Ethernet address
>
>          This variable can be set only once. U-Boot refuses to delete or
>         overwrite this variable once it has bee set unless
>         CONFIG_ENV_OVERWRITE is enabled in the board configuration.
>         The same applies to eth*addr (where * is an integer) if
>         CONFIG_REGEX=y.

I added the other two suggestions but I am not sure what you intend
for this one. We have serial# and ethaddr which are both 'write once'.

[..]

Regards,
Simon