1

我正在为 OCaml 项目使用Oasis构建系统,我想构建文档并将其放入${projectroot}/doc/api/.

现在,我的_oasis文件是这样的:

OASISFormat: 0.4
Name: MyProject
Version: 0.1alpha
Plugins: META (0.4)
BuildTools: ocamlbuild
AlphaFeatures: ocamlbuild_more_args

PostDistcleanCommand: $rm _tags myocamlbuild.ml setup.ml setup.data

Document api
Title: MyProject API
Type: ocamlbuild (0.4)
BuildTools: ocamldoc
XOCamlbuildPath: src
XOCamlbuildExtraArgs: -docflags -d,doc/api,-colorize-code,-charset,utf-8

然后,我运行以下命令:

$> oasis setup
$> ocaml setup.ml -configure
...
$> ocaml setup.ml -doc
...

然后,我api.docdir/ --> _build/src/api.docdir/在项目的顶级目录中获得了一个链接,该链接指向我期望的文档。但是,似乎-d doc/api没有考虑到带有额外参数的 。

那么,我错过了什么?因为,我在这里有点没有想法......

4

1 回答 1

2

一种正确的方法是使用install将您的文档(以及其他数据)复制到适当位置的configure命令,该位置可通过命令或InstallDir字段进行自定义。

此外,如果您仍想在项目中迁移文档,而不进行安装,那么您可以使用PostCommand字段,并使用一个小脚本(或只是一个单行)将您的文档移动到更好的位置。

于 2015-07-31T13:19:41.330 回答