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.4 required=5.0 tests=AWL 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 3ED17BBAF for ; Wed, 15 Oct 2008 17:06:37 +0200 (CEST) X-IronPort-AV: E=Sophos;i="4.33,416,1220220000"; d="scan'208";a="16116463" Received: from peray.inria.fr (HELO ausone.inria.fr) ([128.93.8.98]) by mail2-relais-roc.national.inria.fr with SMTP; 15 Oct 2008 17:06:37 +0200 Received: by ausone.inria.fr (sSMTP sendmail emulation); Wed, _d Oct 2008 17:05:50 +0200 From: "Nicolas Pouillard" Content-Type: text/plain; charset=UTF-8 Cc: Caml_mailing list , romain.bardou Subject: Re: [Caml-list] File inclusion with Ocamldoc To: Dario Teixeira References: <48F5AFED.5050806@lri.fr> <372513.57372.qm@web54601.mail.re2.yahoo.com> In-Reply-To: <372513.57372.qm@web54601.mail.re2.yahoo.com> Date: Wed, 15 Oct 2008 17:05:50 +0200 Message-Id: <1224083082-sup-3321@ausone.inria.fr> User-Agent: Sup/git X-Spam: no; 0.00; ocamldoc:01 ocamldoc:01 mli:01 mli:01 merging:01 precedence:01 caml-list:01 face:97 pattern:04 inclusion:04 aka:04 truc:05 truc:05 manual:06 manual:06 Excerpts from Dario Teixeira's message of Wed Oct 15 16:43:32 +0200 2008: > Hi, > > > It works for me with the 3.10.1. I just tried to write a > > file test.ml, and a file truc.odocl with "Test" in it, and then > > ran ocamlbuild : > > ocamlbuild truc.docdic/index.html > > And it worked. Or maybe I didn't understand what you want? > > You're right. I took the Ocamlbuild manual at face value, since > it states it cannot handle implementation files. Nevertheless, > I'm still running into some problems with Ocamlbuild+Ocamldoc. > First, while Ocamldoc will by default merge the comments from .ml > and .mli files (with precedence given to the .mli file, unless > -inv-merge-ml-mli is given), when I use Ocamlbuild to generate > the documentation I notice the following pattern: if only the .ml > file is present then it's used for generating the documentation; > If, however, both .ml and .mli are present, then only the .mli > is taken into account (no merging is done). Second, how does one > tell Ocamlbuild to include .txt files in the documentation? The manual states that implementation files are not handled because if you have a .ml and .mli then ocamlbuild will choose the .mli. -- Nicolas Pouillard aka Ertai