Version française
Home     About     Download     Resources     Contact us    
Browse thread
[ANN] OCaml Batteries Included, alpha 3
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: -- (:)
From: Romain Bardou <Romain.Bardou@l...>
Subject: Re: ocamlbuild documentation (was Re: [Caml-list] Re: [ANN] OCaml Batteries Included, alpha 3)
> Simple projects are not the problem. The plugin interface lacks 
> documentation.

Well I would like to know what "simple things" Jon could not do then.

> Wikis are nice but not are no substitute for real documentation. The 
> designers of ocamlbuild should once take the time to thoroughly explain 
> and document the philosophy and workings of ocamlbuild; how does it 
> work, what is the right way to do thing, what is the wrong way to do 
> things, how do I achieve this etc.
> 
> So far every program of the caml toolchain had sufficiently clear 
> documentation in ocaml's manual. With respect to that ocamlbuild is an 
> unwelcomed precedent.

Is it just a matter of copy/pasting the contents of the wiki into the 
OCaml manual? Or does the wiki really lacks important information? As 
far as I can tell it does answer a lot of the questions you highlighted.

-- 
Romain Bardou