Re: Is SRFI-110 ready for final release?
David A. Wheeler 02 May 2013 23:52 UTC
Beni Cherniavsky-Paskin:
> misc proofreading:
Awesome! Thanks for doing that.
> "Unfortunately, SRFI-49 had some awkward usage issues, and by itself it
> lacks support for infix notation (e.g., {a + b}) and prefix formats (e.g.,
> f(x)). Sweet-expressions build on and refine SRFI-49 by addressing these
> issues. "
> Won't hurt to link here (again) to SRFI-105?
Done.
> # Tutorial
> ## Clarifications
> "2. Lines with only a ;-comment (preceded by 0 or more indent characters)
> are completely ignored - even their indentation (if any) is irrelevant."
> I'd explicitly add they are not considered empty and don't end an
> expression.
Done (I just said that they "do not end an expression" since that's the main thing).
> ## Advanced features
> "Sweet-expressions also add a few additional abbreviations, sometimes
> called sweet-expression “advanced features”, that make sweet-expressions
> even more pleasant to use"
> At least GROUP is essential, not just "more pleasant". Though the
> existing formulation may be better than any precise alternatives.
Well... technically you can also use parens with traditional formatting.
And I can't offhand think of a better way to say it.
> - SUBLIST - add comment drawing attention to c d e f $ g == c d e f g != c d e f (g)
Done.
> - mention in tutorial how to escape special markers (e.g. {\\})
Done.
> # Spec
> ## Other requirements
> "Implementations that provide R7RS semantics ... SHOULD appropriate
> variants of these"
> s/SHOULD/SHOULD include/.
Done.
--- David A. Wheeler