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=0.2 required=5.0 tests=AWL,MISSING_HEADERS autolearn=disabled version=3.1.3 X-Original-To: caml-list@yquem.inria.fr Delivered-To: caml-list@yquem.inria.fr Received: from mail2-relais-roc.national.inria.fr (mail2-relais-roc.national.inria.fr [192.134.164.83]) by yquem.inria.fr (Postfix) with ESMTP id 16278BB84 for ; Mon, 9 Feb 2009 14:22:11 +0100 (CET) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Aq4FAAS9j0mBrw8EgWdsb2JhbACNDYYQgRwBARYiuhOEGgY X-IronPort-AV: E=Sophos;i="4.37,405,1231110000"; d="scan'208";a="20840321" Received: from ext.lri.fr ([129.175.15.4]) by mail2-smtp-roc.national.inria.fr with ESMTP/TLS/ADH-AES256-SHA; 09 Feb 2009 14:22:10 +0100 Received: from localhost (localhost [127.0.0.1]) by ext.lri.fr (Postfix) with ESMTP id A936CA42AE for ; Mon, 9 Feb 2009 14:22:10 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at lri.fr Received: from ext.lri.fr ([127.0.0.1]) by localhost (ext.lri.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id N6eCsRRJrHIT for ; Mon, 9 Feb 2009 14:22:10 +0100 (CET) Received: from smtp.lri.fr (vhost3-23 [129.175.3.23]) by ext.lri.fr (Postfix) with ESMTP id 9050FA42AD for ; Mon, 9 Feb 2009 14:22:10 +0100 (CET) Received: from [129.175.4.107] (lri4-107 [129.175.4.107]) by smtp.lri.fr (Postfix) with ESMTP id 8E853E0570 for ; Mon, 9 Feb 2009 14:22:10 +0100 (CET) Message-ID: <49902E11.2010101@lri.fr> Date: Mon, 09 Feb 2009 14:22:25 +0100 From: Romain Bardou User-Agent: Thunderbird 2.0.0.19 (X11/20090105) MIME-Version: 1.0 Cc: OCaml List Subject: Re: ocamlbuild documentation (was Re: [Caml-list] Re: [ANN] OCaml Batteries Included, alpha 3) 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> In-Reply-To: <997E6911-3D37-4FAA-A958-757AD21A9F4D@erratique.ch> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Spam: no; 0.00; lri:01 ocaml:01 wiki:01 wiki:01 caml-list:01 btw:03 manual:06 missing:07 disagree:08 function:08 function:08 batteries:91 alpha:08 flag:09 flag:09 > You need a reasonable base documentation first if you want people to try > your system. The bare minimum (i.e. the one that doesn't make your loose > your time with the system) is not here yet. And if you want to build > things for others to use you better have some empathy, so you should be > able to imagine some of these questions. > > What I see in the wiki doesn't qualify as a manual to me. Well I would disagree and say that the bare minimum is here. This is why I stopped contributing to the wiki: I had nothing else interesting to add. So now I ask: what exactly is missing from this bare minimum? In my opinion, questions such as "can I use the flag function inside the rule function" are definitely not part of the bare minimum. (btw, the answer is: the use of the flag function inside the rule function is not specified, thus not documented) -- Romain Bardou