comments with 2.13

[tpolecat]

In 2.13 comments evidently work differently so something like

```tut
// foo
1 + 1
```

Will report an error and then continue just fine, but it will fail the compile.

See Gitter discussion at :point_up: February 3, 2019 1:14 PM

[larsrh]

I worked around it (for now) by moving the comments into the function body.

[erikerlandson]

This is causing https://github.com/typelevel/spire/pull/759 to fail CI at the doc generation step

[tpolecat]

For now I recommend only generating doc for 2.11 or 2.12

[erikerlandson]

:+1:

[larsrh]

I ended up doing this as a workaround: typelevel/cats-mtl@1e89758b505ad7f39b4421f15041bad201e53d27

[SethTisue]

has anyone looked into whether the root cause might be a regression in Scala itself?

[larsrh]

I think migrating everyone to mdoc in time is infeasible. A thorough investigation would be highly appreciated.

[leifwickland]

Pureconfig is waiting on a fix for this too, which I mention mostly so I'll get notified of updates. https://github.com/pureconfig/pureconfig/pull/537/files#diff-354f30a63fb0907d4ad57269548329e3R26

[tpolecat]

This is as good a time as any to deprecate tut, so that's what I'm inclined to do. Mdoc is the way forward.

[leifwickland]

@tpolecat Thanks for the heads up and for your years of work on tut.