Literate Scala via Macros

[cretz]

• Need literate Scala, but can't simply use .md files lest we lose our IDE features
• Can make a macro that is a string context w/ multiline string format that accepts markdown
• Macro is a no-op during normal compilation
• Something like scala meta can be used to extract these markdown pieces and build "literate scala" md files with the rest of the code as "code example" style (or a left-human-right-code visualization as seen in other literate contexts)
• Can support syntax for referencing scaladoc pieces (in both directions maybe)

[cretz]

Meh, could just use comments, e.g. https://github.com/inca/circumflex/blob/a02b10c5bcd1d47a2dade8fd93638240451e7da1/docco/src/main/scala/docco.scala. Macros and multiline strings probably don't provide as much of a benefit as it does costs. Some discussion here on tut: https://github.com/tpolecat/tut/ issue 69 (removed link to avoid postback link). Specifically look at https://github.com/laughedelic/literator which is close.