From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail4-relais-sop.national.inria.fr (mail4-relais-sop.national.inria.fr [192.134.164.105]) by walapai.inria.fr (8.13.6/8.13.6) with ESMTP id q29L73qY021310 for ; Fri, 9 Mar 2012 22:07:03 +0100 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AscBALRvWk/RVdK2mGdsb2JhbABDtSoIIgEBAQEBCAkNBxQnggoBAQEDARICLAE4AQMMAQUFCzsiEgEFARwGEyKHYwULnUIKjmWFFokzAQULkG0ElUmHcoZMPYFUgjE X-IronPort-AV: E=Sophos;i="4.73,559,1325458800"; d="scan'208";a="135286866" Received: from mail-iy0-f182.google.com ([209.85.210.182]) by mail4-smtp-sop.national.inria.fr with ESMTP/TLS/RC4-SHA; 09 Mar 2012 22:06:57 +0100 Received: by iahk25 with SMTP id k25so4268683iah.27 for ; Fri, 09 Mar 2012 13:06:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=oxchtMQdtJsAlL9xw8b7dl+KpXaEo+z1DbL55nEoSz4=; b=qHAo57zmnTA5GUQA6ud3U7ENVrIcRJkA27pcoLRHFlo/1buGPEnjku6ByimtJqdpK9 uJ4IHQBYrg9JTHNffYliFoQLZSHsoCiN1oyyHUyiBrJ2WplzyOtwuqEiBA2NdqpyRxbc Nlxzrdc3FwtgEShjGl22xMO4rHh0An9CMHZFOfBQoscuSQzj703VK0oQVhVG17JizMXG rG2+VXeJGWrIWfiXfsvLmBhUZK857ZfGkdGf+fZutJ1TwRg9V95fAZwUGVLR3vhRK9VU hjRAhEBj7eYcKnNIwK+u/1hjRT8MeD0fo+zL6sR/rX0uVWynyH26zUcp4UwmZxuBWUX7 OJEw== MIME-Version: 1.0 Received: by 10.50.191.233 with SMTP id hb9mr5471581igc.44.1331327215931; Fri, 09 Mar 2012 13:06:55 -0800 (PST) Sender: gildor478@gmail.com Received: by 10.42.169.135 with HTTP; Fri, 9 Mar 2012 13:06:55 -0800 (PST) In-Reply-To: <8B4246A25F95441BB031B33E77CF68B7@erratique.ch> References: <1991A512A37E49ACA5AAD30A38D628BF@erratique.ch> <1ACBE325A80144A4885B44685F6E9028@erratique.ch> <2588CBF13EAF449DBCAF86436DFC354E@erratique.ch> <8B4246A25F95441BB031B33E77CF68B7@erratique.ch> Date: Fri, 9 Mar 2012 22:06:55 +0100 X-Google-Sender-Auth: cs83nuZ4I8l9EWNkIUM-U4Dcatw Message-ID: From: Sylvain Le Gall To: =?ISO-8859-1?Q?Daniel_B=FCnzli?= Cc: caml-list@inria.fr Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from quoted-printable to 8bit by walapai.inria.fr id q29L73qY021310 Subject: Re: [Caml-list] Re: oasis packaging questions Hi, 2012/3/9 Daniel Bünzli : >> E.g setting "Type: >> ocamlbuild" + a couple of field to tell that your doc will be >> extracted from some libraries/module and build using ocamldoc + >> ocamlbuild: >> >> Document "api-ounit" >> Title: API reference for OUnit >> Type: ocamlbuild (0.2) >> BuildTools+: ocamldoc >> XOCamlbuildLibraries: oUnit >> XOCamlbuildPath: src/ > > In fact I may change my mind about that (since I already publish docs on the web). Two questions : > > 1) In the manual under the library section it's written : > > "Define an OCaml library. OCaml API is generated using `ocamldoc` applied to > `Modules` with `BuildDepends` required flags." > > is that outdated info ? because in that case I don't even need to define a section like you do above. No you are right, this is 'semi'-outdated info. It is only 'semi' because this behavior is till handled by the OCamlbuild plugin, once you have attached libraries to it. A good example is http://darcs.ocamlcore.org/cgi-bin/darcsweb.cgi?r=ounit/ounit;a=headblob;f=/_oasis Basically, you attach library to this document using 'XOCamlbuildLibraries: oUnit' (you can attach more than if you want, but I think it is no use for you). > > 2) In both cases how can I pass arguments to ocamldoc (I need to give it a -charset utf-8). > Good catch and the answer is "you can't". I think this is worth a feature request. Cheers Sylvain