Inline HTML legalities

[Waylan Limberg]

On Wed, Nov 30, 2011 at 9:27 AM, Andy Bennett <andyjpb at ashurst.eu.org> wrote:

> I'm writing a Markdown Parser in Scheme by porting bits of Markdown.pl.

>

[clip]

>

> There seems to be a discrepancy between the "Markdown: Syntax" document

> and the implementation in _HashHTMLBlocks.


I suspect this post [1] by Gruber himself in the list archive will
shed some light on your conundrum. The issue has come up numerous
times since, but that is the latest response I could find by JG on the
subject.

The point is, when you find a conflict between the documentation and
the implementation - the documentation rules. However, when the
documentation is silent, most of us rely on the implementation as a
guide.

Personally, what I find helpful is the existing test suite. Some of
the examples in there shed light on the intended behavior. It doesn't
hurt to run the test suites from other implementations as well.

If you haven't already, you might want to run your test cases through
babelmark [2] and see what results you get. Sometimes when I can't
find an existing test and no specific documentation on an edge case, I
go with the most common behavior among implementations on babelmark.
Although, be aware that some of those implementations are a little
outdated.

[1]: http://six.pairlist.net/pipermail/markdown-discuss/2008-February/001001.html
[2]: http://babelmark.bobtfish.net/

-- 
----
\X/ /-\ `/ |_ /-\ |\|
Waylan Limberg