ocamldoc可以引用类型构造函数吗？

Question

我正在尝试引用ocamldoc中的类型构造函数。

例如：

type x = Awesome | Boring

稍后，我们想在一些文档中引用其中一个构造函数：

(** {!Awesome} is a really great constructor for {!x}.  You should definitely use it instead of {!Boring}. *)

ocamldoc抱怨：

Warning: Element Awesome not found
Warning: Element Boring not found

有没有办法引用类型构造函数，以便ocamldoc可以链接到相应的类型？

Answer 1

不能直接交叉链接到类型构造函数。但是，您可以链接到类型本身：

(** {{!x}Awesome} is a really great constructor for {!x}. *)

如果你想有更精确的东西，你可以写一个小的ocamldoc插件来覆盖html_of_Ref方法。

Answer 2

这是不可能的。您可以看到可以使用此语法here进行的引用的类型。但是，您可以做的是：

(** {{!x}[Awesome]} that will at least bring to {!x} by clicking on it. *)