Open panglesd opened 3 weeks ago
I'm in favor of doing this in the ocaml parser directly. This would also make ocamlformat's job easier (assuming there is a flag to tell us whether there is a column of *
to be printed or not).
I think that's a good argument to do it in the ocaml parser. That might complicate upstream though, we should ask what the maintainers think.
I've seen several libraries use this style of comments:
However, the
*
at the beginning of lines confuse odoc. Should this be dealt in the odoc parser, or upstream in OCaml?Here are some examples, taken from @jonludlam's list in #1138: