From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Original-To: caml-list@sympa.inria.fr Delivered-To: caml-list@sympa.inria.fr Received: from mail3-relais-sop.national.inria.fr (mail3-relais-sop.national.inria.fr [192.134.164.104]) by sympa.inria.fr (Postfix) with ESMTPS id D5E0181799 for ; Fri, 26 Jul 2013 15:48:21 +0200 (CEST) Received-SPF: None (mail3-smtp-sop.national.inria.fr: no sender authenticity information available from domain of darioteixeira@yahoo.com) identity=pra; client-ip=98.138.91.137; receiver=mail3-smtp-sop.national.inria.fr; envelope-from="darioteixeira@yahoo.com"; x-sender="darioteixeira@yahoo.com"; x-conformance=sidf_compatible Received-SPF: None (mail3-smtp-sop.national.inria.fr: no sender authenticity information available from domain of darioteixeira@yahoo.com) identity=mailfrom; client-ip=98.138.91.137; receiver=mail3-smtp-sop.national.inria.fr; envelope-from="darioteixeira@yahoo.com"; x-sender="darioteixeira@yahoo.com"; x-conformance=sidf_compatible Received-SPF: None (mail3-smtp-sop.national.inria.fr: no sender authenticity information available from domain of postmaster@nm7-vm3.bullet.mail.ne1.yahoo.com) identity=helo; client-ip=98.138.91.137; receiver=mail3-smtp-sop.national.inria.fr; envelope-from="darioteixeira@yahoo.com"; x-sender="postmaster@nm7-vm3.bullet.mail.ne1.yahoo.com"; x-conformance=sidf_compatible X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AhkCAGx98lFiiluJlWdsb2JhbABNDYQLBqsbkiKBGBYOAQEBAQcNCQkSKoIfBQEBBAELIBUBAhUUDgEDCwYFRi8BDgEGEgYnh2kBAQIJBgSoFAmCdoRXASMDASMDiGEBBgoBAQGPPTqEBQOJKo48hhwvUohZb4QU X-IPAS-Result: AhkCAGx98lFiiluJlWdsb2JhbABNDYQLBqsbkiKBGBYOAQEBAQcNCQkSKoIfBQEBBAELIBUBAhUUDgEDCwYFRi8BDgEGEgYnh2kBAQIJBgSoFAmCdoRXASMDASMDiGEBBgoBAQGPPTqEBQOJKo48hhwvUohZb4QU X-IronPort-AV: E=Sophos;i="4.89,751,1367964000"; d="scan'208";a="22351636" Received: from nm7-vm3.bullet.mail.ne1.yahoo.com ([98.138.91.137]) by mail3-smtp-sop.national.inria.fr with ESMTP/TLS/DHE-RSA-AES256-SHA; 26 Jul 2013 15:48:20 +0200 Received: from [98.138.90.50] by nm7.bullet.mail.ne1.yahoo.com with NNFMP; 26 Jul 2013 13:48:18 -0000 Received: from [98.138.87.11] by tm3.bullet.mail.ne1.yahoo.com with NNFMP; 26 Jul 2013 13:48:18 -0000 Received: from [127.0.0.1] by omp1011.mail.ne1.yahoo.com with NNFMP; 26 Jul 2013 13:48:18 -0000 X-Yahoo-Newman-Property: ymail-3 X-Yahoo-Newman-Id: 471690.86487.bm@omp1011.mail.ne1.yahoo.com Received: (qmail 74056 invoked by uid 60001); 26 Jul 2013 13:48:18 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s1024; t=1374846498; bh=ZxxZr3nCYGfGj2vq1yDYg0Gw9D7Bkw/Ze1gbayyXa0E=; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:References:Message-ID:Date:From:Reply-To:Subject:To:In-Reply-To:MIME-Version:Content-Type:Content-Transfer-Encoding; b=d1+j0vitzSYN1HZa7ToBOO6JDI8KR2mUv2CdXwMXJYIMEKSrI0RgcD1thQHXzvgJ+xqLdlEna0Pcw2lBABCCc7nXUuN+5sdH4gjIhVAdBUsYXHq4Yh/U+Wz7P2vioMgaYd6v2HMYJ5Ti3Nk9kNPAReg/8DrQE4vYBwC7ssg9eG4= DomainKey-Signature:a=rsa-sha1; q=dns; c=nofws; s=s1024; d=yahoo.com; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:References:Message-ID:Date:From:Reply-To:Subject:To:In-Reply-To:MIME-Version:Content-Type:Content-Transfer-Encoding; b=3teAwkZmoEtzWPgxw2CHb3Jik3kAayY4z9GcbcmP4dbXGf9uh8VEZaEV62VvDU/BiVP8VpLmgkpnvNdYejFtXz31UMxle3sCr6ik8DP9Tlo8fLkxGf5sFP6xv6RcKIEMM4dpscx21li2pxaILgyuYr+dLHNBFLz7klborq4/6G4=; X-YMail-OSG: iTeoD6QVM1lK5Cr6icJfe0BKbzrQG4g8HWtT0H3Y2aNkiFc iDP4uSYRQ4yaRXGmbsG.Gv0W5F48K_Y3E5vXt21rITiXgOcGKXsFv4MadpBS DReo77VQ8V_AqjM11dA.flOI_Ho8s15Na.CgkWmyW4CQCr.dOMZI2p0_4VBh VRVGSu6SUYmWjD7qcCC6rDgyxkQjjiSMmsLVDUw5OlPtr9HfOkWIQQIABqSz gr6jelAqgBkAmOd4lUrlOX4Gk5kT8TCy6roI9iSuNAycAn9RshEMrQXbTLKQ LhvpDi4GF4rw_KQl6mwMmxt1LVec6faDzvGsA0fMX60vmRSe3mUmRC0RlpQ7 o6Tltel07i1cZP2MHC_X6zPo9oBQ5yvlA1ubFjg9Hztewh8qIa6jaM.F_ZID PMiiuCsK6zA.Ss8bmLMqNA7tuVFt2sGizDqz4KtBKJbHxc0MHVLMbMgDuldI 5ZdfBLc0dynCmiCh0Q3JQFVO6Bn6.8HM4RriEOr8D1p85O1JBJUS73J9_bQM NzTyYrwhwfb7WGhfsZYB0VtXNBPidU0v2HQtZcVVxz987g.bS15JyVgNuZ0L KJpE8_efrRA9a Received: from [195.23.39.42] by web120401.mail.ne1.yahoo.com via HTTP; Fri, 26 Jul 2013 06:48:17 PDT X-Rocket-MIMEInfo: 002.001,SGksCgo.IEFzIEkgc2FpZCBhYm92ZSwgSSBwbGFuIHRvIGtlZXAgdXNpbmcgb2NhbWxidWlsZCBhbmQgaW5jcmVtZW50YWxseSBmaXgKCj4gc29tZSBvZiBpdHMgc2hvcnRjb21pbmdzIChwYXJhbGxlbGl6YXRpb24sIGRvY3VtZW50YXRpb24sIHBsdWdpbgo.IGNvbXBvc2FiaWxpdHkuLi4pLiBJIGhvcGUgdGhhdCBzb21lIG90aGVyIHVzZXJzIHdpbGwgYWxzbyBtYWtlIGEKPiBjb250cmlidXRpb24gYW5kIGhlbHAgdG8gc29sdmUgc29tZSBvZiB0aGUgaXNzdWVzIHRoYXQgaGF2ZSBiZWVuCj4gcmVwb3J0ZWQBMAEBAQE- X-Mailer: YahooMailWebService/0.8.150.561 References: <1374669368.25411.5@samsung> <1B6BB035-9909-4F0C-9DEA-F713B977A467@ocamlpro.com> <7F8931D5-E65D-49EB-B54D-A50716F3EFDD@recoil.org> <51F0801A.5080603@riken.jp> <20130725172359.a40fdfb172b120cadab5544a@gmerlin.de> <20130725200356.GA15673@notk.org> <51F1CD6C.3050305@riken.jp> Message-ID: <1374846497.73427.YahooMailNeo@web120401.mail.ne1.yahoo.com> Date: Fri, 26 Jul 2013 06:48:17 -0700 (PDT) From: Dario Teixeira Reply-To: Dario Teixeira To: Caml List In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Subject: Re: ocamlbuild (was Re: [Caml-list] Re: GODI is shutting down) Hi, > As I said above, I plan to keep using ocamlbuild and incrementally fix > some of its shortcomings (parallelization, documentation, plugin > composability...). I hope that some other users will also make a > contribution and help to solve some of the issues that have been > reported on the bugtracker (most of them are not very hard to tackle). > Wojciech and I eager to welcome patches and review them. Please consider starting with the documentation, which is IMHO OCamlbuild's Achilles's heel.=A0 I will go as far as saying that what stopped OCamlbuild= from becoming the ultimate OCaml build tool and thus preempting the constant popping up of new but often ephemeral build tools was precisely the lack of good documentation.=A0 Moreover, I reckon that even the other OCamlbuild shortcomings (namely parallelisation) would have been patched long ago if the tool had gained the community mind share that it missed due to its poor documentation. Daniel has already mentioned some of the things wrong with OCamlbuild's doc= s. For me, the most egregious aspect of the manual is the lack of a good narra= tive and a bird's eye view of the tool.=A0 One can go through the whole document= and remain wondering how does it actually work and what does it do!=A0 The read= er is thus left without a good mental model of the tool.=A0 Moreover, bear in = mind that the wiki documentation is a good resource only *after* one already understa= nds how the tool works and what the various entities mean and how they fit toge= ther. Anyway, I'm sure you (Gabriel and Wojciech) are well aware of the points I'= ve just raised, and time availability is the only limiting factor for improving the= situation. But since you've bravely "inherited" the maintenance of OCamlbuild, my 2 ce= nts is that your short term move that is likely to wield greater long term bene= fits is to write a short introduction that allows the reader to really grok OCamlbu= ild. Best regards, Dario Teixeira