On 2024-03-21 06:21, Eric Sunshine wrote:
On Thu, Mar 21, 2024 at 1:16 AM Dragan Simic <dsimic@xxxxxxxxxxx>
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.
