Hi, 2012/3/9 Daniel Bünzli <daniel.buen...@erratique.ch>: >> E.g setting "Type: >> ocamlbuild" + a couple of field to tell that your doc will be >> extracted from some libraries/module and build using ocamldoc + >> ocamlbuild: >> >> Document "api-ounit" >> Title: API reference for OUnit >> Type: ocamlbuild (0.2) >> BuildTools+: ocamldoc >> XOCamlbuildLibraries: oUnit >> XOCamlbuildPath: src/ > > In fact I may change my mind about that (since I already publish docs on the > web). Two questions : > > 1) In the manual under the library section it's written : > > "Define an OCaml library. OCaml API is generated using `ocamldoc` applied to > `Modules` with `BuildDepends` required flags." > > is that outdated info ? because in that case I don't even need to define a > section like you do above.
No you are right, this is 'semi'-outdated info. It is only 'semi' because this behavior is till handled by the OCamlbuild plugin, once you have attached libraries to it. A good example is http://darcs.ocamlcore.org/cgi-bin/darcsweb.cgi?r=ounit/ounit;a=headblob;f=/_oasis Basically, you attach library to this document using 'XOCamlbuildLibraries: oUnit' (you can attach more than if you want, but I think it is no use for you). > > 2) In both cases how can I pass arguments to ocamldoc (I need to give it a > -charset utf-8). > Good catch and the answer is "you can't". I think this is worth a feature request. Cheers Sylvain -- Caml-list mailing list. Subscription management and archives: https://sympa-roc.inria.fr/wws/info/caml-list Beginner's list: http://groups.yahoo.com/group/ocaml_beginners Bug reports: http://caml.inria.fr/bin/caml-bugs
