Re: [PATCH v4 4/4] config.txt: describe handling of whitespace further
- From
- Dragan Simic <dsimic@manjaro.org>
- Date
- Mar 21, 2024, 05:31 UTC
- Message-ID
- <fdaec126df16bf6fe1c1fca9698f7dcc@manjaro.org>
- In-Reply-To
- <CAPig+cTgbjCg5jkidEufgHgpkPOZPhfSbd_gbBxOFK=B8mX+fw@mail.gmail.com>
On 2024-03-21 06:21, Eric Sunshine wrote:
Show 21 quoted lines
> 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.