From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail2-relais-roc.national.inria.fr (mail2-relais-roc.national.inria.fr [192.134.164.83]) by sympa.inria.fr (Postfix) with ESMTPS id 70A347F734 for ; Sat, 12 Sep 2015 21:24:20 +0200 (CEST) IronPort-PHdr: 9a23:1wHhsRGV20MhL4XixqDRSJ1GYnF86YWxBRYc798ds5kLTJ75ocywAkXT6L1XgUPTWs2DsrQf27aQ6fmrADRYqb+681k8M7V0HycfjssXmwFySOWkMmbcaMDQUiohAc5ZX0Vk9XzoeWJcGcL5ekGA6ibqtW1aJBzzOEJPK/jvHcaK1oLsh7z0ocSYOl0QzBOGIppMbzyO5T3LsccXhYYwYo0Q8TDu5kVyRuJN2GlzLkiSlRuvru25/Zpk7jgC86l5r50IAu3GePEzRLlcRCk9PnourJngvBzHCA+O/Wc0U2MMkxMODRKTvz/gWZKknSLwrOtw3GGhNs37V70uEWCt5q1xSRLszjwMNzMj/Xv/hcl5jaYdqxWk8U8si7XIaZ2YYaItNpjWeskXEDJM Authentication-Results: mail2-smtp-roc.national.inria.fr; spf=None smtp.pra=gabriel.scherer@gmail.com; spf=Pass smtp.mailfrom=gabriel.scherer@gmail.com; spf=None smtp.helo=postmaster@mail-io0-f176.google.com Received-SPF: None (mail2-smtp-roc.national.inria.fr: no sender authenticity information available from domain of gabriel.scherer@gmail.com) identity=pra; client-ip=209.85.223.176; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="gabriel.scherer@gmail.com"; x-sender="gabriel.scherer@gmail.com"; x-conformance=sidf_compatible Received-SPF: Pass (mail2-smtp-roc.national.inria.fr: domain of gabriel.scherer@gmail.com designates 209.85.223.176 as permitted sender) identity=mailfrom; client-ip=209.85.223.176; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="gabriel.scherer@gmail.com"; x-sender="gabriel.scherer@gmail.com"; x-conformance=sidf_compatible; x-record-type="v=spf1" Received-SPF: None (mail2-smtp-roc.national.inria.fr: no sender authenticity information available from domain of postmaster@mail-io0-f176.google.com) identity=helo; client-ip=209.85.223.176; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="gabriel.scherer@gmail.com"; x-sender="postmaster@mail-io0-f176.google.com"; x-conformance=sidf_compatible X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0CiBwBhcfRVlLDfVdFdg3dpBoMkp1aGVItgAQEIgXeHEwc+DgEBAQEBAQEBEAEBAQEHCwsJHzCCHYIfER0BGx4DEhAPAiYCJAERAQUBIjWHdgEDEg2mXIIFgTA+MYtGgWyCeYlPChknDVaEPQEBBA6BFIVRhH2HfYFDBZVWcYQZh3GZLxIjgRc+AQEBAoQjPDOKHQEBAQ X-IPAS-Result: A0CiBwBhcfRVlLDfVdFdg3dpBoMkp1aGVItgAQEIgXeHEwc+DgEBAQEBAQEBEAEBAQEHCwsJHzCCHYIfER0BGx4DEhAPAiYCJAERAQUBIjWHdgEDEg2mXIIFgTA+MYtGgWyCeYlPChknDVaEPQEBBA6BFIVRhH2HfYFDBZVWcYQZh3GZLxIjgRc+AQEBAoQjPDOKHQEBAQ X-IronPort-AV: E=Sophos;i="5.17,518,1437429600"; d="scan'208";a="177137144" Received: from mail-io0-f176.google.com ([209.85.223.176]) by mail2-smtp-roc.national.inria.fr with ESMTP/TLS/AES128-GCM-SHA256; 12 Sep 2015 21:24:19 +0200 Received: by iofh134 with SMTP id h134so130377825iof.0 for ; Sat, 12 Sep 2015 12:24:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:from:date:message-id:subject:to:content-type; bh=FfHw3z2ldk8bDh0+giGhJow+uvttgSeRBmwdtuBkDP0=; b=yFDzdkFplecObN2jf9iJpiQKVr67NJbsi1ShssaxI+bl8a/OVdbxfzTR//m2o0RW3u brgGmTUjWkTqAkY7Mull6LQiDeZ1ysPiskrdpY9NVGElkjmeO/WAHc0bqVam2tI/0U+g yw7KJSuOUZuB6PMLOZYZGQaDfjWvzSkwkwxb65eUNra09tDOu5MZiiDDr4VIekuvV3Yq /6eFypNDlSfgQPHa4UObWJeJV5Nmb1ENk28P1SNY5iXaWcC4CaUyZmky22lygsiPlAD2 ge91nx0vHFwgW9VteH9iCtlx42p+yEMSb4wDb30CJ4WpFWO7oOcXEyYMhelUq8hvGwrN Tj6w== X-Received: by 10.107.19.70 with SMTP id b67mr12447950ioj.144.1442085858351; Sat, 12 Sep 2015 12:24:18 -0700 (PDT) MIME-Version: 1.0 Received: by 10.79.19.68 with HTTP; Sat, 12 Sep 2015 12:23:39 -0700 (PDT) From: Gabriel Scherer Date: Sat, 12 Sep 2015 21:23:39 +0200 Message-ID: To: caml users Content-Type: text/plain; charset=UTF-8 Subject: [Caml-list] New ocamlbuild manual -- a usable draft Hi all, In August 2013 I started working on-and-off (mostly off) on a new ocamlbuild manual, given that many users were not satisfied with the existing documentation. https://github.com/gasche/manual-ocamlbuild/blob/master/manual.md The project is now reaching a state where I think it should be usable by any ocamlbuild user as a documentation starting point. I am thinking of "releasing" it in the following weeks/months by pushing it in a more authoritative place than a personal github repository. More than ever, I am highly interested in feedback and contributions on this manual. (I think the manual still lacks some content that I initially planned to include. In particular, I would like to eventually have a skeleton of example of a project with a non-trivial mix of C and OCaml code. I myself don't know much about these so I didn't delay a "release" for it.) In the course of writing this manual I have done some improvements to ocamlbuild's auto-documentation engine (the -documentation command-line flag) to support parametrized flags, which are not part of a released ocamlbuild version (feedback welcome on https://github.com/ocaml/ocaml/pull/231 ) and extended some of the .mli documentation (to which Cristophe Troestler had already made great contributions, PR#5243) with examples of tags/rules declarations for plugin authors. Happy builds.