Re: [PATCH v4 4/4] config.txt: describe handling of whitespace further

[Dragan Simic <dsimic@manjaro.org>]

On 2024-03-21 06:21, Eric Sunshine wrote:
> 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.

Hmm, I just noticed that your proposed description actually contains
some issues, e.g. it implies that the value-internal whitespace is
retained verbatim only if the entire value is enclosed in double 
quotation
marks.  I'll try to reword it, so this is fixed.