Skip to content

Feature request: consistent handling of the empty doc-comment #1282

@craigfe

Description

@craigfe

Describe the solution you'd like

The OCaml manual states that the empty doc-comment is (**). The OCaml lexer claims only that (**) is a empty doc-comment. OCamlformat formats it as (***), which I was surprised to learn has the same AST.

I suggest that the two be unified, either by adding mention of (***) to the OCaml manual or by switching OCamlformat's chosen representation to (**). I'm happy to make the PR to either ocaml/ocaml or OCamlformat depending on which solution we choose.

Additional context

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions