Sanitize strings that would lead to uneaven quotes in line

[WalternativE]

• Adds two tests based on failing formatting
  behavior having hash directives
• Documentation of triage session in Fantomas & Friends

[nojaf]

@Smaug123 we sorta went with a dirty hack to solve the problem. I'm going to revisit the solution and try and come up with something better ;)

[nojaf]

So I've refactored the code a bit and tried to come up with a better way of detecting all the defines inside a raw string.
The algorithm is rather primitive were all characters in the string are processed while being aware in what kind of code block you are currently in (string, multiline code comment)

Lastly, I refactored the code so that the define detection dance is only performed once.

[Smaug123]

I don't really understand this fully, but the shape of it certainly makes me think it looks better. (E.g. the fact that we parse out hash-tokens right at the beginning.)

The state machine is big and scary and I don't really feel like I understand it properly!

[nojaf]

Thanks for the review @Smaug123, some very good remarks! I'll revisit this PR later this week.

[nojaf]

@Smaug123 I'm ready for round two 😄.

[Smaug123]

The use of Seq.skip always terrifies me, because it makes it very easy to write things which are quadratic in complexity; but strings are easy to seek around in, so that's fine.

[Smaug123]

I can't say I'm 100% convinced of its correctness, but I don't see anything obviously wrong, and if no tests are broken then that's good enough for me!

[nojaf]

Sold!