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 mail2-relais-roc.national.inria.fr (mail2-relais-roc.national.inria.fr [192.134.164.83]) by sympa.inria.fr (Postfix) with ESMTPS id 4A9647EE49 for ; Thu, 12 Sep 2013 17:41:15 +0200 (CEST) Received-SPF: None (mail2-smtp-roc.national.inria.fr: no sender authenticity information available from domain of gabriel@kerneis.info) identity=pra; client-ip=176.31.113.173; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="gabriel@kerneis.info"; x-sender="gabriel@kerneis.info"; x-conformance=sidf_compatible Received-SPF: Pass (mail2-smtp-roc.national.inria.fr: domain of gabriel@kerneis.info designates 176.31.113.173 as permitted sender) identity=mailfrom; client-ip=176.31.113.173; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="gabriel@kerneis.info"; x-sender="gabriel@kerneis.info"; x-conformance=sidf_compatible; x-record-type="v=spf1" Received-SPF: Pass (mail2-smtp-roc.national.inria.fr: domain of postmaster@wanbli.kerneis.info designates 176.31.113.173 as permitted sender) identity=helo; client-ip=176.31.113.173; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="gabriel@kerneis.info"; x-sender="postmaster@wanbli.kerneis.info"; x-conformance=sidf_compatible; x-record-type="v=spf1" X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AgIFAGvfMVKwH3Gt/2dsb2JhbABbgwc4wTSBHBZ0giUBAQQBOgYBATcBBAsLGAkTEg8FKCGIDwoIqR6ETAEFjioGjiKBSQeDHYEAjmmJEoEwhHQNi0ODI4Fw X-IPAS-Result: AgIFAGvfMVKwH3Gt/2dsb2JhbABbgwc4wTSBHBZ0giUBAQQBOgYBATcBBAsLGAkTEg8FKCGIDwoIqR6ETAEFjioGjiKBSQeDHYEAjmmJEoEwhHQNi0ODI4Fw X-IronPort-AV: E=Sophos;i="4.90,891,1371074400"; d="scan'208";a="32630873" Received: from wanbli.kerneis.info ([176.31.113.173]) by mail2-smtp-roc.national.inria.fr with ESMTP/TLS/DHE-RSA-AES128-SHA; 12 Sep 2013 17:41:14 +0200 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=kerneis.info; s=wanbli-rsa1; h=In-Reply-To:Content-Type:MIME-Version:References:Message-ID:Subject:Cc:To:From:Date; bh=gDP2oedrAmDFCzIDRWNS7/XgUzWLEVEjTcXMmfJUMQM=; b=fuRF2J+bTn8MpZy8Dl6kQh6djVML8lsvvDmI0ObR/BXlS6aSqolGn1vR22k4MRdEACR2OuE5FVLGKuXJo6mTM9MtpquFGT6Qm12prJOpuZI7rc5ts6fCDfDMNvfpNUtSJQRIg28WQEcx93Jdhij0TfGu3xOSwqEBLL12H+sdErA=; Received: from [176.254.216.29] (helo=wacehi.kerneis.info) by wanbli.kerneis.info with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from ) id 1VK917-0000O7-NY; Thu, 12 Sep 2013 15:41:13 +0000 Received: from gabriel by wacehi.kerneis.info with local (Exim 4.80) (envelope-from ) id 1VK916-0007Wr-Pw; Thu, 12 Sep 2013 16:41:12 +0100 Date: Thu, 12 Sep 2013 16:41:12 +0100 From: Gabriel Kerneis To: Gabriel Scherer Cc: Romain Bardou , caml users Message-ID: <20130912154112.GA28924@kerneis.info> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) X-SA-Exim-Connect-IP: 176.254.216.29 X-SA-Exim-Mail-From: gabriel@kerneis.info X-SA-Exim-Scanned: No (on wanbli.kerneis.info); SAEximRunCond expanded to false Subject: Re: [Caml-list] ocamlbuild documentation (was: OCaml release 4.01.0) Hi Gabriel, On Thu, Sep 12, 2013 at 05:25:30PM +0200, Gabriel Scherer wrote: > Note that the "ocamlbuild API" is mostly meant for rather advanced users > (which should be comfortable reading a .mli file in their favorite text > editor). I disagree with that. I enjoy much more browsing ocamldoc's output than an mli file, mostly because of hyperlinks, and I'm not always developping on computers where I can, or wish to, rebuild it. Moreover, if ocamlbuild is part of the standard ocaml distribution, I don't understand why its API is not hosted on http://caml.inria.fr/. What would it take it to dump to http://caml.inria.fr/pub/docs/manual-ocamlbuild/libref/ [*] just like http://caml.inria.fr/pub/docs/manual-ocaml/libref/ contains stdlib's API? [*] or maybe http://caml.inria.fr/pub/docs/manual-ocaml/ocamlbuildref/ > https://github.com/gasche/manual-ocamlbuild > > (I had planned to give myself more time to improve this documentation > draft, before making a call to contributions on the list, but your message > prompted an earlier response. Thanks for your interest.) Thank you some much for your effort. I think it deserves its own email on this list (maybe in a few weeks) to gather more attention and feedback. -- Gabriel