Re: [PATCH v4] Documentation: bootconfig: Update boot configuration documentation

[Masami Hiramatsu]

Hi Randy,

Thanks for review and good suggestions!

On Tue, 3 Mar 2020 20:55:39 -0800
Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote:

> > +Boot Configuration Syntax
> > +=========================
> > +
> > +The boot configuration syntax is a simple structured key-value. Each key
> > +consists of dot-connected-words, and key and value are connected by ``=``.
> > +The value has to be terminated by semi-colon (``;``) or newline (``\n``).
> >  For array value, array entries are separated by comma (``,``). ::
> 
>              values,
> or just
>    For an array, its entries are separated by

I like this latter one.

[...]
> > +Tree Structured Key
> > +-------------------
> >  
> > -The boot config file syntax allows user to merge partially same word keys
> > -by brace. For example::
> > +The boot configuration syntax allows user to merge same parent key using
> 
>                                  allows the user
> although I am having problems with the rest of that sentence.

What about the following?

User can group identical parent keys together and use braces to list child keys
under them.

Thank you,

-- 
Masami Hiramatsu <mhiramat@xxxxxxxxxx>