[PATCH] Important fix and HTML markup improvements Mark H Weaver (31 Oct 2012 09:24 UTC)
Re: [PATCH] Important fix and HTML markup improvements David A. Wheeler (31 Oct 2012 11:05 UTC)
Re: [PATCH] Important fix and HTML markup improvements David A. Wheeler (31 Oct 2012 12:53 UTC)
Re: [PATCH] Important fix and HTML markup improvements Mark H Weaver (31 Oct 2012 16:03 UTC)

Re: [PATCH] Important fix and HTML markup improvements David A. Wheeler 31 Oct 2012 11:06 UTC

Mark H Weaver:
> The current draft says:
> > 5. An unprefixed ( . e) MUST evaluate as e.
>
> s/MUST evaluate as/MUST be read as/

I agree that the word "evaluate" here is misleading, so yes, we should fix that to clarify things.  However, the rest of the text uses "maps to" or its abbreviation =>.  So for consistency with the rest of the text, it should probably instead say something like this:

.... 5. An unprefixed ( . e) MUST map to e.

> I've attached a patch which fixes this, and also improves the HTML
> markup.  Most notably, I converted many VAR elements to CODE elements,
> e.g. every occurrence of $nfx$ and $bracket-apply$, since these are not
> variables for purposes of this specification, but rather constant
> symbols.
>
> I used VAR for symbols that can stand for any of a set of expressions
> (e.g. 'e', 'e1', and 'e2' in the n-expression spec), which I believe is
> a more appropriate use of VAR.  I also tried to use CODE and SAMP where
> appropriate, and avoided marking ellipses with either one.
>
> What do you think?

I think you're right, that's a more accurate use of HTML tags & it produces more consistent typography.  It's subtle but nice. Whew, that was a lot of work, thanks for doing that.

I propose accepting the HTML tagging, and changing the line about unprefixed (. e) to use the term "map" like everything else does.  Any other last-minute comments?

--- David A. Wheeler