Highlighting of @doc """heredoc"""

[tmbb]

Should heredocs following @doc, @moduledoc and @typedoc be highlighted in a different color from normal heredocs? Makeup's styles provide a :string_doc token type for this purpose, which I'm not using.

I think such heredocs should be highlighted as normal heredocs, because highlighting them differently would needlessly complicate the grammar. Besides, they are simple heredocs, and masking this fact doesn't really help anyone.

Pinging @josevalim for his always insightful comments.

[josevalim]

I personally treat them as string_doc so they appear more faded but I can see the argument to why not.

[tmbb]

Hm... I think you're right. Even github's highlighter does it. And treating them in a special way allows us to highlight markdown inside the docs, and elixir in the code examples (once I get around to writing a markdown lexer). I'm still not sure this is a good idea, but it's an intriguing possbility)

It doesn't even complicate the grammar that much...