From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <thelema314@gmail.com>
X-Original-To: caml-list@sympa.inria.fr
Delivered-To: caml-list@sympa.inria.fr
Received: from mail1-relais-roc.national.inria.fr (mail1-relais-roc.national.inria.fr [192.134.164.82])
	by sympa.inria.fr (Postfix) with ESMTPS id 0173C7F249
	for <caml-list@sympa.inria.fr>; Thu,  1 Nov 2012 03:05:57 +0100 (CET)
Received-SPF: None (mail1-smtp-roc.national.inria.fr: no sender
  authenticity information available from domain of
  thelema314@gmail.com) identity=pra; client-ip=209.85.210.182;
  receiver=mail1-smtp-roc.national.inria.fr;
  envelope-from="thelema314@gmail.com";
  x-sender="thelema314@gmail.com";
  x-conformance=sidf_compatible
Received-SPF: Pass (mail1-smtp-roc.national.inria.fr: domain of
  thelema314@gmail.com designates 209.85.210.182 as permitted
  sender) identity=mailfrom; client-ip=209.85.210.182;
  receiver=mail1-smtp-roc.national.inria.fr;
  envelope-from="thelema314@gmail.com";
  x-sender="thelema314@gmail.com";
  x-conformance=sidf_compatible; x-record-type="v=spf1"
Received-SPF: None (mail1-smtp-roc.national.inria.fr: no sender
  authenticity information available from domain of
  postmaster@mail-ia0-f182.google.com) identity=helo;
  client-ip=209.85.210.182;
  receiver=mail1-smtp-roc.national.inria.fr;
  envelope-from="thelema314@gmail.com";
  x-sender="postmaster@mail-ia0-f182.google.com";
  x-conformance=sidf_compatible
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: AsABANDXkVDRVdK2m2dsb2JhbABEhVC+CggjAQEBAQEICQsJFCeCHgEBBTgIARscAgMMBgULDQkWDwkDAgECARERAQUBHBMIAQEXh1gBAw+cWowygnaFDAoZJw1ZiHUBBQyLbIMXgyQDlXaFaYh4P4Qt
X-IronPort-AV: E=Sophos;i="4.80,690,1344204000"; 
   d="scan'208";a="179767832"
Received: from mail-ia0-f182.google.com ([209.85.210.182])
  by mail1-smtp-roc.national.inria.fr with ESMTP/TLS/RC4-SHA; 01 Nov 2012 03:05:56 +0100
Received: by mail-ia0-f182.google.com with SMTP id k10so2782138iag.27
        for <caml-list@inria.fr>; Wed, 31 Oct 2012 19:05:55 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20120113;
        h=message-id:date:from:user-agent:mime-version:to:subject:references
         :in-reply-to:content-type:content-transfer-encoding;
        bh=okM8HSRVbEBS9sPSZ2beqqp3o9TjcpY3dQwoV4xuUfw=;
        b=dkDLywjnbPamTqQMGywviqQ1v0MsFMVWTy6aw+7hTqKLQ8JwUi45HtTN/WQKMspp+8
         +VwfU/5Xym/u4FWZCNaS0shcOHeQqqxl77ulQj5t8BohdSf88M8Eyh9j4cIl2RhWeCMH
         DaWi1MzpMYo+awJNYuwM/cqmmcAXaaf3NY8VwkBULNSQmTJdMfUJxn8aSP5+3C23zi8g
         UfUUrNMjZD/VZ1yQHnIIgin87JMOQSXD/xL7yIujZNtZK7LKFqBbGjY5DXXa+qQK4Wrm
         BW8CZ3WbKMdZXs3SlPYUFOJHtgptFTrB7CzB+bEzMc2IS2A+vCGEhhQWC0SeufgmDqcJ
         IUxA==
Received: by 10.50.57.194 with SMTP id k2mr3569046igq.17.1351735555266;
        Wed, 31 Oct 2012 19:05:55 -0700 (PDT)
Received: from [192.168.1.73] (99-121-78-10.lightspeed.lnngmi.sbcglobal.net. [99.121.78.10])
        by mx.google.com with ESMTPS id gz10sm4733510igc.9.2012.10.31.19.05.54
        (version=SSLv3 cipher=OTHER);
        Wed, 31 Oct 2012 19:05:54 -0700 (PDT)
Message-ID: <5091D90B.6020101@gmail.com>
Date: Wed, 31 Oct 2012 22:06:03 -0400
From: Edgar Friendly <thelema314@gmail.com>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:16.0) Gecko/20121010 Thunderbird/16.0.1
MIME-Version: 1.0
To: caml-list@inria.fr
References: <508F22BD.7010103@riken.jp> <CACX4useWCnu4tg2jAkSx=K=38BaHimgZWRFPF1Jyj5gw+YHAbg@mail.gmail.com> <026F32A8-2790-4CDD-A839-58655A8074CA@first.in-berlin.de> <508FE869.3070603@inria.fr> <508FFB12.9030307@gmail.com> <508FFE82.2050409@inria.fr> <50900466.2050000@gmail.com> <CAPFanBHcmSy3vAS8G+CHey1YZ-6kyYxxgtHJdkt40fmr54Fw1g@mail.gmail.com> <B4888D11-BF86-4756-B529-4D71486B2C8A@first.in-berlin.de> <CAPFanBEHu6ZWm1j0zvsAAWjmnHB4NbsRRTBH18qhOK9yWVA+pA@mail.gmail.com> <5090F66F.60803@erratique.ch> <50912619.9090004@gmail.com> <CAPFanBE+dyP2=bqXdVNVi2h=yGA+eqS7Faho=ZuKbf2HEH21jA@mail.gmail.com> <5091C47D.4070501@riken.jp> <5091C584.1010607@gmail.com> <5091C7E8.7090007@riken.jp>
In-Reply-To: <5091C7E8.7090007@riken.jp>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Subject: Re: [Caml-list] Why should I use .mli files?

On 10/31/2012 8:52 PM, Francois Berenger wrote:
> If the .mli is generated automatically from the .ml,
> including documentation, people can still read their dear
> .mli file (once it has been generated). 
Why bother generating a .mli file if this is the only goal; instead, 
just use ocamldoc to build documentation exactly for the exported 
interface.  But this still needs some backwards-compatible magic to 
indicate the public interface in the .ml file, and I don't think we have 
a good solution to this at the moment.

E.