English version
Accueil     À propos     Téléchargement     Ressources     Contactez-nous    

Ce site est rarement mis à jour. Pour les informations les plus récentes, rendez-vous sur le nouveau site OCaml à l'adresse ocaml.org.

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: 2009-02-09 (11:51)
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