From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.1.3 (2006-06-01) on yquem.inria.fr X-Spam-Level: ** X-Spam-Status: No, score=2.8 required=5.0 tests=AWL,DNS_FROM_RFC_POST, SPF_NEUTRAL autolearn=disabled version=3.1.3 X-Original-To: caml-list@yquem.inria.fr Delivered-To: caml-list@yquem.inria.fr Received: from mail3-relais-sop.national.inria.fr (mail3-relais-sop.national.inria.fr [192.134.164.104]) by yquem.inria.fr (Postfix) with ESMTP id 27DFDBBB7 for ; Mon, 9 Feb 2009 11:31:22 +0100 (CET) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ArkBAFOUj0lIDtyckGdsb2JhbACTeD8BAQEBCQkMBxEDrGmMZQEDAQOEFwaCMYFt X-IronPort-AV: E=Sophos;i="4.37,404,1231110000"; d="scan'208";a="22693974" Received: from fg-out-1718.google.com ([72.14.220.156]) by mail3-smtp-sop.national.inria.fr with ESMTP; 09 Feb 2009 11:31:21 +0100 Received: by fg-out-1718.google.com with SMTP id e21so993336fga.43 for ; Mon, 09 Feb 2009 02:31:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:sender:message-id:from:to :in-reply-to:content-type:content-transfer-encoding:mime-version :subject:date:references:x-mailer; bh=SJANOZg14ySE9XZ0wXG3YlBcwo7lBEF4QVQz96xN7Tg=; b=Ws4bWZjklCFud+c+MVMdb4vpYPxN9/FbfZn4pMsgB5Dl48Ba07dTeGTYmNXZ5Q5NGp OmGuf4hFB3BFeaYcb2DqgUPhX1bLi3XjpS6xfxWE5ZD3cjzKHxoyCrF5d4dogmPRUjUQ jrKIPKjGqnw3Klhf4Un8RYoddG1qiAd30W2Gs= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=sender:message-id:from:to:in-reply-to:content-type :content-transfer-encoding:mime-version:subject:date:references :x-mailer; b=QUSiE84swbEbJhOjnomCM+em4mY+YsH3d5l1mtU1xCUVt1tOogqOOewfy2/iTuiuYF fwDjQ3nfuXZqtKfrQ7gCwikpLtaVqY7qZbPU3zO6ZsmCdebFjior5mH3u1ulcN9K2jKt fHPdYkeiF3elQfGeQ2h5UjtTNIaaVgi19QazY= Received: by 10.86.59.18 with SMTP id h18mr663856fga.45.1234175481721; Mon, 09 Feb 2009 02:31:21 -0800 (PST) Received: from ?192.168.1.34? (163-119.77-83.cust.bluewin.ch [83.77.119.163]) by mx.google.com with ESMTPS id l12sm610801fgb.1.2009.02.09.02.31.21 (version=TLSv1/SSLv3 cipher=RC4-MD5); Mon, 09 Feb 2009 02:31:21 -0800 (PST) Sender: =?UTF-8?Q?Daniel_B=C3=BCnzli?= Message-Id: From: =?ISO-8859-1?Q?Daniel_B=FCnzli?= To: OCaml List In-Reply-To: <498FF839.6090901@lri.fr> Content-Type: text/plain; charset=ISO-8859-1; format=flowed; delsp=yes Content-Transfer-Encoding: quoted-printable Mime-Version: 1.0 (Apple Message framework v930.3) Subject: ocamlbuild documentation (was Re: [Caml-list] Re: [ANN] OCaml Batteries Included, alpha 3) Date: Mon, 9 Feb 2009 11:30:41 +0100 References: <1233936696.6216.65.camel@Blefuscu> <200902071458.45000.jon@ffconsultancy.com> <498FF839.6090901@lri.fr> X-Mailer: Apple Mail (2.930.3) X-Spam: no; 0.00; bunzli:01 buenzli:01 ocaml:01 lacks:01 ocaml:01 wiki:01 wikis:01 toolchain:01 ocaml's:01 blessing:98 imho:01 caml-list:01 modularity:02 caml:02 philosophy:02 Le 9 f=E9vr. 09 =E0 10:32, Romain Bardou a =E9crit : > It would really help to improve the documentation if you could =20 > explain what were the problems you encountered and where did you =20 > look for the documentation. Simple projects are not the problem. The plugin interface lacks =20 documentation. > Please note that since the first OCaml meeting (last year), the wiki =20= > has changed quite a bit, so if you tried Ocamlbuild before, you =20 > might want to try it again. Wikis are nice but not are no substitute for real documentation. The =20 designers of ocamlbuild should once take the time to thoroughly =20 explain and document the philosophy and workings of ocamlbuild; how =20 does it work, what is the right way to do thing, what is the wrong way =20= to do things, how do I achieve this etc. So far every program of the caml toolchain had sufficiently clear =20 documentation in ocaml's manual. With respect to that ocamlbuild is an =20= unwelcomed precedent. It's sad because this seems to hinder the adoption of this very =20 powerful tool that IMHO drifts away from make nightmares in the right =20= way. For example being able to do this kind of tricks [1] without any =20= hassle is just a blessing for your modularity and productivity. Best, Daniel [1] = http://brion.inria.fr/gallium/index.php/Working_on_dependent_projects_with= _ocamlbuild