From: Eric Sunshine <sunshine@sunshineco.com>
Date: Thu, 21 Mar 2024 05:21:22 GMT
Subject: Re: [PATCH v4 4/4] config.txt: describe handling of whitespace further
Message-ID: <CAPig+cTgbjCg5jkidEufgHgpkPOZPhfSbd_gbBxOFK=B8mX+fw@mail.gmail.com>
In-Reply-To: <9a5217f7f7a35768a3eb45060fb3e4f4@manjaro.org>

On Thu, Mar 21, 2024 at 1:16 AM Dragan Simic <dsimic@manjaro.org> wrote:
> On 2024-03-21 06:11, Eric Sunshine wrote:
> > It should be possible to rephrase it to be more definite, while
> > dropping the final sentence altogether. Perhaps:
> >
> >     Whitespace surrounding `name`, `=` and `value` is ignored. If
> >     `value` is surrounding by double quotation marks (`"`), all
> >     characters within the quoted string are retained verbatim,
> >     including whitespace. Comments starting with either `#` or `;` and
> >     extending to the end of line are discarded. A line that defines a
> >     value can be continued to the next line by ending it with a `\`;
> >     the backslash and the end-of-line are stripped.
>
> Looking good to me, thanks.  I'll include it into the v5, with
> a small grammar issue fixed.

For completeness, I should mention that I intentionally reordered the
topics so that the most common/important ones are mentioned earlier
rather than later; i.e. (1) surrounding whitespace ignored, (2)
double-quoted value, (3) comments, (4) `\` line-splicing with.