On 12/9/17 2:25 PM, Adam D. Ruppe wrote:
On Saturday, 9 December 2017 at 21:05:04 UTC, David Gileadi wrote:
For instance, as I've been working on adding Markdown features I was
surprised to discover that DDoc's current support for
backtick-delimited code only works within a single line. Most
implementations I've seen allow it to span hard-wrapped lines, as long
as it's within a single paragraph.
I kinda object to calling the ddoc `` thing markdown, since that wasn't
the intention. When I added it, I had exactly one goal: be able to write
`<xml samples>` in ddoc without it breaking the html output. At the same
time, I didn't want it to accidentally trigger if someone pasted a
linker error in their doc:
undefined reference to `foo'
undefined reference to `bar'
So it was limited to a single line and required a matching ` to trigger
the new code. Then, btw, it does NOT just wrap it in a $(BACKTICK)
macro. It first *escapes the string*, for example turning < into <,
etc, THEN wraps it in the macro.
Though, the reason it uses ` as the delimiter is because markdown does
it so it looks familiar... but it wasn't actually based on a desire to
be markdown.
Similarly, my adrdox thing has some markdown-ish features, but it is
explicitly NOT markdown, giving me the freedom to avoid brain damage. (I
am not a fan of markdown, it is such a mess and hard to write.)
That makes sense--thanks for the background.
To be fair to markdown, it does also require matching backticks and
escapes < and > within backtick-quoted sections. But I agree that some
markdown "features" are rather messy.
