Correctly parse docblock comments

[rizo]

Docblock is a common formatting of docstrings:

(**
 * Some comment
 *)

Currently odoc does not correctly parse this because of the leading * symbols. Although most OCaml libraries don’t use this style, I think it’s an unnecessary surprise for users who expect this to work.

[dbuenzli]

Although most OCaml libraries don’t use this style, I think it’s an unnecessary surprise for users who expect this to work.

But if that is something that OCaml programmers manage to be consistent about, is it really worth introducing styling entropy by allowing this ?

[dbuenzli]

As I said in my previous message since OCaml programmers are consistent about not doing this, I don't think it's a good idea to introduce this so I'm closing this.