SRFI 220: Line directives
Arthur A. Gleckler
(09 Feb 2021 23:01 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 06:49 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 07:20 UTC)
|
Re: SRFI 220: Line directives Lassi Kortela (10 Feb 2021 08:46 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 10:14 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 10:37 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 10:19 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 10:24 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 10:30 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 10:54 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 11:13 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 12:31 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 12:41 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 12:49 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 13:12 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 13:21 UTC)
|
Re: SRFI 220: Line directives
Vladimir Nikishkin
(10 Feb 2021 12:47 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 12:53 UTC)
|
Re: SRFI 220: Line directives
Vladimir Nikishkin
(10 Feb 2021 12:56 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 12:57 UTC)
|
Re: SRFI 220: Line directives
Vladimir Nikishkin
(10 Feb 2021 13:05 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 13:13 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 13:26 UTC)
|
Re: SRFI 220: Line directives
Vladimir Nikishkin
(10 Feb 2021 13:36 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(10 Feb 2021 13:49 UTC)
|
Re: SRFI 220: Line directives
Vladimir Nikishkin
(10 Feb 2021 15:42 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(11 Feb 2021 10:06 UTC)
|
Declarations in general
Lassi Kortela
(11 Feb 2021 10:26 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(11 Feb 2021 12:18 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(11 Feb 2021 12:57 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(17 Feb 2021 08:23 UTC)
|
Re: SRFI 220: Line directives
John Cowan
(18 Feb 2021 03:07 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(18 Feb 2021 10:16 UTC)
|
Re: SRFI 220: Line directives
John Cowan
(18 Feb 2021 23:47 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(19 Feb 2021 07:08 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(19 Feb 2021 07:16 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(19 Feb 2021 07:18 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(19 Feb 2021 07:27 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(19 Feb 2021 07:32 UTC)
|
Re: SRFI 220: Line directives
Lassi Kortela
(19 Feb 2021 07:42 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(19 Feb 2021 08:35 UTC)
|
Re: SRFI 220: Line directives
John Cowan
(20 Feb 2021 01:11 UTC)
|
Re: SRFI 220: Line directives
Marc Nieper-Wißkirchen
(10 Feb 2021 12:25 UTC)
|
Thank you for the astute comments! > (1) What is the reader supposed to do with the parsed line > directives? Can you explain this in the context of the `read` procedure? The line directive #! foo bar baz is supposed to be read in as if implicitly wrapped in a quoted list: '(foo bar baz) The line directives are not evaluated like ordinary Scheme code (just like existing directives such as #!r6rs are not so evaluated). The SRFI doesn't specify what Scheme implementations should do with them because I couldn't think of a good general-purpose solution and it's not really crucial: the main benefit of the syntax is that external, language-agnostic tools such as Emacs, Vim, Unix kernels (#! line), license checkers, etc. can read the syntax while we retain the possibility of parsing it in the manner of ordinary Scheme syntax. If line directives are implemented, the most likely things that Scheme implementations would do with them in the near future are: (1) Detect character encoding from something like "#! coding: euc-jp". (2) Offer a hook to let users attach custom parser procedures. But since the set of directives is arbitrarily extensible (just coin new identifiers), it's likely that more uses would be discovered over the years. Here are all the uses I know of that Scheme implementations have for directives so far: <https://registry.scheme.org/#hash-bang-syntax>. Quite a few, and our existing directives can't even take "arguments". One could argue there is a preference to use directives only for things that affect the settings of the Scheme reader, but as the registry shows, that rule is often broken, including by Scheme standards (R2RS and DSSSL) and prominent implementations such as Chez and Gambit. That, and the fact that Scheme's directive marker "#!" matches the Unix interpreter marker "#! /usr/bin/env foo", makes it attractive to use "#!" as a general-purpose metadata marker. > (2) IMO, it is a design error that the datums following `#!` mustn't > contain newlines. Don't change the datum system of single datums. > This is important for consistency, for simplicity of reader > implementations, and for compatibility with various pretty printers > that may insert line endings for readability. We don't have a > problem with line comments because line comments do not contain > datums. For anything containing datums, which are newline agnostic > (in contrast to Python syntax), choosing the newline as a delimiter > is a bad idea. Indeed, I was dithering between whether or not newlines should be allowed inside the datums. I agree with you that it's the right thing to allow newlines, and thereby let implementations re-use Scheme's `(read)` as it is. However, it seems the draft ended up internally inconsistent. Sorry about that. The thing with newlines is that most or all of the magic comments from other tools tend to fit on one line: #! /usr/bin/env gosh #! vim: tw=60 ts=2 expandtab fileencoding=euc-jp : #! SPDX-License-Identifier: GPL-3.0-or-later If our more principled syntax for these "magic comments" permits multi-line data unlike the other languages, that can be confusing. I now think the best compromise is to read datums using Scheme `(read)`, but only as long as the line number does not change. The trick is that since `(read)` always reads a complete datum, and Scheme datums can contain embedded newlines, it's possible to write things like multi-line lists to express complex things. That's potentially very useful, and since it makes no sense to have partial lists cut off at the middle without matching closing parentheses, people are unlikely to be confused about the meaning of a multi-line "#!" directive. (Even though "multi-line line directive" sounds amusing; is there a better name?) So things like this would be legal: #! (foo (bar 123) (baz (2 3 4))) and even this: #! foo bar (baz (... (...))) ; tail comment and even crazier: #! foo #| block comment starts at this line and keeps going for another two lines. ends here |# (final list) ; and tail comment (but this line is no longer part of the directive) Even with all these arcane corner cases, at least to me the rule seems easy enough to follow: while on the same line as the original "#!", keep reading another datum. > (3) Why do you special-case `#!r6rs`/`#! r6rs`? What about > `#!fold-case`, etc.? That's more bad wording on my part. #!r6rs is not meant to be special-cased, but is merely used to illustrate what is done to all existing directives: #!r6rs, #!fold-case, #!chezscheme, #!bwp, etc. We should think about whether "#!foo" and "#! foo" should be required mean the same thing. That probably makes sense; it seems confusing if they mean something different.