On 8/22/12, David A. Wheeler <dwhee...@dwheeler.com> wrote: > Alan Manuel Gloria: >> We should also probably "formalize" the semantics of #-based comments >> (basically, standard #|..|# and #;, and Guile's extension #!...!#, as >> well as all #-syntax that does not actually yield a datum) > > Absolutely. I'm feeling good that we've confirmed that this can be done > *without* cross-connecting all the tiers. > >> They are: >> >> 1. The term "#-based comment" refers to all # syntax that does not >> actually yield a datum when read in by the standard, s-expression >> parser of a particular implementation. For example, an implementation >> might define a #readoption(ignore-case), which changes some internal >> settings, but does not yield an actual datum. An implementation for >> scripting might want to ignore text after a #!. Item comments such as >> #; and multiline comments such as #| comment |# commonly used in Lisp >> implementations are also #-based comments. > > I'd use #; and #|...|# first as the examples, as they're more common, but > okay. > >> 2. A #-based comment found at the top-level (i.e. before finding any >> other item) at any indentation (including !-indentation) is completely >> ignored; in particular, it will not cause the reader to enter >> "indented-compatibility" mode under any circumstances, regardless of >> any indentation or lack thereof. > > Need to define "indented-compatibility" mode first; I'm not sure what you > mean.
This one: If an expression starts indented, then indentation is completely ignored (that line switches to neoteric-expressions). > >> 3. A #-based comment found as the first item on any sub-block line is >> treated the same as the SPLIT symbol. In particular, indentation is >> considered to end at the point at which the #-based comment is found. >> Also, any newlines and spaces inside the #-based comment are ignored. > > Okay. The last sentence is kindof redundant, but if it's important leave it > in. > >> 4. A #-based comment found after the first item of any line is >> completely ignored. In particular, any newlines and spaces inside the >> #-based comment are ignored. > > Okay. Can they delimit tokens, e.g., a#|hi|#b? > > --- David A. Wheeler > ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ _______________________________________________ Readable-discuss mailing list Readable-discuss@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/readable-discuss
