1

私は ocamldoc を使用して私の小さなプロジェクトを文書化しようとしています。
1 つのメイン.mlファイルがあり、opens他の 2 つのファイルがあり.mlます。

$ ocamldoc -html included1.ml included2.ml

うまく動作しますが、インクルードファイルを追加すると、

$ ocamldoc -html included1.ml included2.ml including.ml

私はこれを得る：

File "including.ml", line 5, characters 5-16:
Error: Unbound module Included1
1 error(s) encountered

ocamldoc のドキュメントから、競合が発生しなくなるまで、モジュールを開くことはまったく問題ないことがわかります。
どのように進めればよいですか？

4

1 に答える 1

2

モジュールが他のモジュールを使用することは問題ありませんが、それらのコンパイル済みインターフェースを表示できる必要があります。したがって、あなたの場合、最初にファイルをコンパイルして.mlファイルを生成する必要があり.cmiます。次に、これらのファイルの場所を ocamldoc に示す必要があります。したがって、次のようなことを行う必要があります。

ocamlc -c included1.ml
ocamlc -c included2.ml
ocamlc -c -I . including.ml
ocamldoc -html -I . included1.ml included2.ml including.ml

一般に、ファイルではなく.mli、各モジュール、ドキュメント、およびこれらのファイルを作成することは、良い (必須の) プラクティスであることに注意してください。ocamldoc.ml

于 2016-10-07T16:16:41.637 に答える