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.6 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 mail1-relais-roc.national.inria.fr (mail1-relais-roc.national.inria.fr [192.134.164.82]) by yquem.inria.fr (Postfix) with ESMTP id 0FA15BB84 for ; Mon, 9 Feb 2009 15:38:02 +0100 (CET) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Ao4CAJfOj0lIDtyekGdsb2JhbACTej8BAQEBCQkMBxEDrSaNBAEDAQOEFwaCMYFt X-IronPort-AV: E=Sophos;i="4.37,405,1231110000"; d="scan'208";a="23796906" Received: from fg-out-1718.google.com ([72.14.220.158]) by mail1-smtp-roc.national.inria.fr with ESMTP; 09 Feb 2009 15:38:01 +0100 Received: by fg-out-1718.google.com with SMTP id e21so1032621fga.43 for ; Mon, 09 Feb 2009 06:38:01 -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=VXk1rJ8yMCeJFc4KO76ArcJg3vukVLCrg7Fy5YLs5nc=; b=clt1oS9no6h5+AWJKNFXqIq8Ya5BvEqZOXbwwQMbr3vF8t9s8Jw0+ZNd7ZgJLfoDvu EzEDXeEY2rEMLJwa9aLLAkaVC8j0Cejq8N4nJdM6xbXFMc1Xq9FtDqvNKTz99crdjx38 YeJfM5nTIOyIEkAJwJ0pres2IHtqf2bQ+NWM0= 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=Lux2Xdm1wqF1V9m4MlpNnX3ah2IwR2jfQeB4y94f61JSFeEWcSwdTFHWrgQfayPQyP KStux8qqBv9ky2PtQEom/K4MJPOTda0HorPxWpce5uVxZZeUcU/vBcssFU7jb4/pmw2U siv717tmHuSxC6+A9nTxuPz9cTjvo539L+ypg= Received: by 10.86.29.8 with SMTP id c8mr934226fgc.19.1234190281745; Mon, 09 Feb 2009 06:38:01 -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 4sm1159931fge.44.2009.02.09.06.38.01 (version=TLSv1/SSLv3 cipher=RC4-MD5); Mon, 09 Feb 2009 06:38:01 -0800 (PST) Sender: =?UTF-8?Q?Daniel_B=C3=BCnzli?= Message-Id: <3F6E6CB5-4609-49CE-BCFB-AD609B4BDD78@erratique.ch> From: =?ISO-8859-1?Q?Daniel_B=FCnzli?= To: OCaml List In-Reply-To: <499037FA.1090603@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: Re: ocamlbuild documentation (was Re: [Caml-list] Re: [ANN] OCaml Batteries Included, alpha 3) Date: Mon, 9 Feb 2009 15:37:21 +0100 References: <1233936696.6216.65.camel@Blefuscu> <200902071458.45000.jon@ffconsultancy.com> <498FF839.6090901@lri.fr> <499018C2.9080007@lri.fr> <499026F9.3030708@lri.fr> <997E6911-3D37-4FAA-A958-757AD21A9F4D@erratique.ch> <49902E11.2010101@lri.fr> <0520EBEC-B30C-4D83-9153-A72BC3C986BF@erratique.ch> <499036C6.5070504@lri.fr> <499037FA.1090603@lri.fr> X-Mailer: Apple Mail (2.930.3) X-Spam: no; 0.00; bunzli:01 buenzli:01 ocaml:01 makefiles:01 manpage:01 caml's:01 wiki:01 ocaml:01 imho:01 caml-list:01 caml:02 api:02 seems:03 talks:03 solid:95 Le 9 f=E9vr. 09 =E0 15:04, Romain Bardou a =E9crit : > However, there ARE some examples in the part which talks about =20 > "flag", where we clearly see an usage (After_rules). Which doesn't mean it cannot be used differently. Anyway it seems useless arguing further: we just don't have the same =20 standards. The only thing I see is that there are still a lot of mentions to =20 makefiles on this list and a lot of new projects don't use ocamlbuild =20= while ocamlbuild is clearly a superior alternative. The only way I can =20= explain this is by lack of good documentation. If you get the standard =20= distribution you don't get documentation for ocamlbuild (except a =20 brief manpage), there's no chapter on ocambuild in the manual, caml's =20= site documentation page doesn't even have a link to the small manual =20 or the wiki (you'll have to google to find it), the plugin api =20 documentation is not installed etc. etc. It's a pitty, given its caml only implementation, ocamlbuild could =20 become a key part of a solid cross platform infrastructure for ocaml. =20= Alas it doesn't seem to be used much (and the reason is IMHO the sad =20 state of its documentation/advertising). Best, Daniel