From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail1-relais-roc.national.inria.fr (mail1-relais-roc.national.inria.fr [192.134.164.82]) by walapai.inria.fr (8.13.6/8.13.6) with ESMTP id q29JBk5s018762 for ; Fri, 9 Mar 2012 20:11:46 +0100 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AscBAPpUWk/RVdK2mGdsb2JhbABDtSoIIgEBAQEBCAkNBxQnggsBAQQSAiwBOAEDDAEFBQs7IhIBBQEcBhMih2idQwqOZYUaiTMBBQuQbQSVSYdyhkw9gVSCMQ X-IronPort-AV: E=Sophos;i="4.73,559,1325458800"; d="scan'208";a="148508102" Received: from mail-iy0-f182.google.com ([209.85.210.182]) by mail1-smtp-roc.national.inria.fr with ESMTP/TLS/RC4-SHA; 09 Mar 2012 20:11:44 +0100 Received: by iahk25 with SMTP id k25so4078829iah.27 for ; Fri, 09 Mar 2012 11:11:43 -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=7jn7RRBM72f5VNLbl7041+4YDgS43IV+A2ctpmvNzVY=; b=WHVCzNEJQ9c0D+rI62XicBSbcIlnHPp9wyaD4MwvNPdxVZyIVTxJEZ7x5UKzGej9ps EjQj8LlzTRhmU4EgFYgNSDk13liI3aAoK1DUi+m4UZI85kD2rqPEOU++Rdr+FaYBh2xW Q11X14PW8MW3bT4lwgT2S0VsiU4TzeKdKvS+/of+NrM5qq8/ENtlf49IxGBYmcXtjcJP /tSsdXy3WM+UTTtyYgeIB69nuVNhsVEhpoG3W/NE33YD9orRtdhyErP+hxVVYHTcomRB 9o5ItYReLzVb2CIOrJ+ThJfc4Q64lMWuldG0Z/i1jEAqtxr7YKvaB5LNKbOodawZv1cI Hw/g== MIME-Version: 1.0 Received: by 10.50.37.236 with SMTP id b12mr4956942igk.36.1331320303510; Fri, 09 Mar 2012 11:11:43 -0800 (PST) Sender: gildor478@gmail.com Received: by 10.42.169.135 with HTTP; Fri, 9 Mar 2012 11:11:43 -0800 (PST) In-Reply-To: <2588CBF13EAF449DBCAF86436DFC354E@erratique.ch> References: <1991A512A37E49ACA5AAD30A38D628BF@erratique.ch> <1ACBE325A80144A4885B44685F6E9028@erratique.ch> <2588CBF13EAF449DBCAF86436DFC354E@erratique.ch> Date: Fri, 9 Mar 2012 20:11:43 +0100 X-Google-Sender-Auth: IOKLH-dHkGiBYjgssFi4Ki0fQdQ 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 q29JBk5s018762 Subject: Re: [Caml-list] Re: oasis packaging questions Hi, 2012/3/9 Daniel Bünzli : > > > Le jeudi, 8 mars 2012 à 22:27, Sylvain Le Gall a écrit : > >> Let say that if you just use $htmldir, it will help whatever packaging >> system that cooperate with oasis to enforce it in the future. > > In fact it is possible to not say anything at all, just don't mention InstallDir, oasis doesn't complain. That allows to abstract away the document's final destination and let the underlying body of code that installs choose what's best. So that's what I have : > > Document "reference" >  Title: "Xmlm's documentation and module reference" >  Format: html >  Index: Xmlm.html >  Install: true >  DataFiles: doc/*.html, doc/*.css > > Document "distribution" >  Title: "Xmlm's distribution information files" >  Install: true >  DataFiles: README CHANGES > > Maybe a kind of enumerated Kind: field could give more information about the nature of the documents. That said, oasis still seems to be a little bit schizophrenic about installation: on one hand it shouldn't install, on the other hand it seems to offer fields to perform installation duties. > I am probably off-topic, because I don't understand by what you mean by "on one hand it shouldn't install, on the other hand it seems to offer fields to perform installation duties." ? It should install, if that is not installing, that is a bug (the Static plugin I told would solve that). But maybe what you miss here, is that it is meant to build documentation. 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/ Cheers Sylvain