Eclipse中OCaml代码的文档

时间:2016-05-03 09:09:09

标签: eclipse ocaml

我正在使用Eclipse和OcaIDE-Plugin来编写我的ocaml项目。

我已经编写了几个我要记录的ocaml函数(注释,返回值和参数)。

我已在.ml文件中创建了我的文档,如此链接中所述:http://caml.inria.fr/pub/docs/manual-ocaml/ocamldoc.html

以下是一个函数的示例:

(** sorting tuples where first element is key *)
let my_comp x y = (*Some code*)

不幸的是,我的评论没有显示,当我在其中一个功能上按F2时,它只显示名称及其包含的文件。

在mli文件中编写注释时,它按预期工作,但我也想记录无法从外部访问的“私有”函数。我可以在mli中定义不能从外部访问的函数,仅用于文档吗?

如何让Eclipse显示我的文档?

1 个答案:

答案 0 :(得分:1)

好吧,正如您所说,您希望显示文档但不会将该功能导出模块。遗憾的是,这不起作用。

我猜OcaIDE可以被认为是不完整的,但它看起来并不像人们所关心的(我不知道一个人在OcaIDE工作)。如果您喜欢自动完成等,可以尝试使用emacs编程并安装merlin(看,我找到了适合您的完美帖子:here

至于在mli中定义一个无法从外部访问的函数的建议,它完全反对为什么创建mli文件,所以不要指望这是可能的。 ; - )

我希望我能够帮助你。