Third draft spec for String Templates (JEP 430) now available

[Gavin Bierman]

Thanks Alex (and apologies for missing your earlier email - don’t know what happened there).

Updated spec available at:

https://cr.openjdk.org/~gbierman/jep430/latest/

Thanks,
Gavin

On 28 Feb 2023, at 18:37, Alex Buckley <alex.buckley at oracle.com<mailto:alex.buckley at oracle.com>> wrote:

1. Escape sequences are legal in fragments, so 3.10.7 should open with something like:

"In character literals, string literals, and text blocks (§3.10.4, §3.10.5, §3.10.6), +and in fragments of a template (3.13),+ the escape sequences allow for ..."


2. 3.10.7 goes on to say that "An escape sequence in the content of a character literal, string literal, or text block is interpreted by ...". This statement constitutes one half of a two-part exposition of interpretation, the other half being found in 3.10.4/5/6 where `String.translateEscapes` is mentioned. Two-way exposition is hard to write, expensive to maintain, but helpful to read. 3.13 is upfront that StringTemplateBegin, StringTemplateMid, and StringTemplateEnd tokens enjoy interpretation, so let's get them named in 3.10.7. 3.13 is less upfront about TextBlockTemplateBegin, TextBlockTemplateMid, and TextBlockTemplateEnd tokens, let me set them aside for now.


3. 3.10.7 should end with a note that the character sequence \{ is not an escape sequence but rather has meaning in a template (3.13).


4. In 3.13, consider "A fragment ~consists of~ +represents+ a non-expression part of a template."  (Ch.3 is big on "representing", or perhaps "denoting", things.)  This sentence would work well in the opening paragraph of the section.


5. 15.8.6 needs more polishing, per the mail I sent about it last time. I'll discuss offline.

Alex

On 2/28/2023 8:15 AM, Gavin Bierman wrote:
Following the feedback, a small update of the String Templates Spec is now available:
https://cr.openjdk.org/~gbierman/jep430/jep430-20230222/specs/string-templates-jls.html <https://cr.openjdk.org/~gbierman/jep430/jep430-20230222/specs/string-templates-jls.html>
Any further comments welcomed!
Thanks,
Gavin
On 9 Feb 2023, at 15:28, Gavin Bierman <gavin.bierman at oracle.com<mailto:gavin.bierman at oracle.com> <mailto:gavin.bierman at oracle.com>> wrote:

Dear experts:

A new, updated spec covering JEP 430 (String Templates) is now available at:

https://cr.openjdk.java.net/~gbierman/jep430/latest <https://cr.openjdk.java.net/~gbierman/jep430/latest>

This is a substantial rewrite: it now covers more fully how templates are tokenized, how to deal with ambiguities, and how text block templates are dealt with.

Comments welcomed!
Gavin

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/amber-spec-observers/attachments/20230301/948dd278/attachment-0001.htm>