From: Dragan Simic Date: Thu, 21 Mar 2024 05:31:06 GMT Subject: Re: [PATCH v4 4/4] config.txt: describe handling of whitespace further Message-ID: In-Reply-To: On 2024-03-21 06:21, Eric Sunshine wrote: > On Thu, Mar 21, 2024 at 1:16 AM Dragan Simic > 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.