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=2.9 required=5.0 tests=AWL,DNS_FROM_RFC_ABUSE, DNS_FROM_RFC_POST,DNS_FROM_RFC_WHOIS,DNS_FROM_SECURITYSAGE autolearn=disabled version=3.1.3 X-Original-To: caml-list@yquem.inria.fr Delivered-To: caml-list@yquem.inria.fr Received: from mail4-relais-sop.national.inria.fr (mail4-relais-sop.national.inria.fr [192.134.164.105]) by yquem.inria.fr (Postfix) with ESMTP id 4398BBBAF for ; Tue, 4 Nov 2008 20:19:34 +0100 (CET) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AiQBAGovEEnOvjGukWdsb2JhbACUFwEBAQEJCwoHEQOqM4xPBQIBg1A X-IronPort-AV: E=Sophos;i="4.33,544,1220220000"; d="scan'208";a="31123365" Received: from web54604.mail.re2.yahoo.com ([206.190.49.174]) by mail4-smtp-sop.national.inria.fr with SMTP; 04 Nov 2008 20:19:33 +0100 Received: (qmail 61673 invoked by uid 60001); 4 Nov 2008 19:19:32 -0000 DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=s1024; d=yahoo.com; h=X-YMail-OSG:Received:X-Mailer:Date:From:Subject:To:MIME-Version:Content-Type:Content-Transfer-Encoding:Message-ID; b=vrJhS2z8Mnti6cTbc0U4IGRNXqm58lk7vj7OIbXQR3TMgu9BxBMTqbrfeeXxwdVYTp3oURi9GDEZc2PBTbKgLAK+gX9mJ2ct3GWLNM6cDraKA57TuFmBAa7ne2fRWagwUziVCGtskSfZ4108JBPVejE8EESZtVHPC0jnAWElLSc=; X-YMail-OSG: w_j33CsVM1mG0eqE80U_CpCaRBrKSanbRt0y6T4YvRXoFT9jEXVepBncVA6IFv2OdiAPxnPVAXs5xhOUW4TkwAKMcCBnzpfqDICmlZTEr7DiQpm92RFs12EkEnQMJwdQ7m7cfb6.n5XmBspWCU5DfnazFjWl7wnj2bNxInBPKv.a1b3oUsEGwDEZJ9tF Received: from [213.205.71.48] by web54604.mail.re2.yahoo.com via HTTP; Tue, 04 Nov 2008 11:19:32 PST X-Mailer: YahooMailWebService/0.7.247.3 Date: Tue, 4 Nov 2008 11:19:32 -0800 (PST) From: Dario Teixeira Subject: Ocamlbuild + Ocamldoc troubles To: caml-list@yquem.inria.fr MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Message-ID: <602309.60888.qm@web54604.mail.re2.yahoo.com> X-Spam: no; 0.00; ocamldoc:01 compilation:01 wiki:01 findlib:01 compilation:01 ocamldoc:01 invocation:01 ocaml:01 invocation:01 ocamlfind:01 html':98 invoke:01 invoke:01 complains:01 modules:02 Hi, I'm using Ocamlbuild to manage the compilation of a library. The myocamlbuild.ml plugin I'm using is a slight variation of the one found on the Wiki and that adds support for Findlib [1]. Even though the actual cod= e compilation is working fine, I'm having problems getting it to correctly invoke Ocamldoc to produce the API docs. On the project's root directory I have the plugin and a '_tags' file that simply says that the 'lambdoc' (contains code) and 'apidoc-src' (contains txt files with intro and tutorials for API doc) directories should be inclu= ded: : include : include Also on the root directory I have a 'lambdoc.mlpack' file containing all th= e modules that should be packed together (the modules themselves are inside t= he 'lambdoc' directory), and a 'lambdoc.mllib' file with a single line 'Lambdo= c' that signals that the pack should be made into a library. In addition, I modified the plugin so that an invocation of ocamldoc would add the '-intro= ' option to Ocamldoc: let ocamldoc_opts =3D S [A"-intro"; A"intro.txt"] And flagged it accordingly in the After_rules: flag ["ocaml"; "doc"] ocamldoc_opts; Unfortunately this isn't working. When I invoke 'ocamlbuild lambdoc.docdir/index.html', Ocamldoc always complains it can't find the intro.txt file. Moreover, if I forgo the intro modifications to the plugin= , even though the ocamldoc invocation succeeds, the lambdoc.docdir directory contains only skeleton Ocamldoc files, ie, no actual generated API. So my questions are on how to get Ocamlbuild to generate the API documentat= ion in this context, and on how can external txt files also be included. Thanks in advance for your attention! Best regards, Dario Teixeira [1] http://brion.inria.fr/gallium/index.php/Using_ocamlfind_with_ocamlbuild =0A=0A=0A