Doc comments sometimes raise parser error
This code
## comment
in x: Events[Unit]
does not compile, because the input stream declaration cannot be annotated with a documentation comment. However, in my opinion ## comment
should still be a valid comment and at most raise a warning that the input stream cannot be documented using a doc comment.