Programmer's Guide To Text Blocks

Tagir Valeev amaembo at
Mon Aug 12 06:01:46 UTC 2019


In general, looks good, thanks!

> *Guideline:* *Avoid aligning the opening and closing delimiters and the
text block's left margin. This requires reindentation of the text block if
the variable name or modifiers are changed.*

I'm not sure about this recommendation. Reindentation could be necessary in
other cases as well, e.g. if you move this declaration to the nested block.
I think every IDE will take care of any necessary reindentation for you.
It's similar to a method declaration that contains several parameters one
per line. E.g. (from OpenJDK Collectors class):

public static Collector<CharSequence, ?, String> joining(CharSequence

Here three parameters are indented in the same way: if method name,
modifiers, return type or type parameters ever change, this would require
the reindentation of second and third lines (and IDEs do this
automatically). Is such a code style acceptable for Java? If yes, then
indenting opening and closing delimiters of the text block should also be
acceptable, in my opinion.

With best regards,
Tagir Valeev.

On Mon, Aug 5, 2019 at 7:38 PM Jim Laskey <james.laskey at> wrote:

> The enclosed PDF is the content of the proposed "Programmer's Guide To
> Text Blocks".  Document source is located at
> Please review and comment back to this mailing list.
> Cheers,
> -- Jim
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <>

More information about the amber-spec-experts mailing list