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 q28MdbGi006170 for ; Thu, 8 Mar 2012 23:39:37 +0100 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ArEDAGY0WU9KN1ZKlWdsb2JhbABChUKwFgEBAQEJCwkJEimCCgEBBAEjVgULCxoCGA4CAj0KEAYbDIdxBQStB4oqgS+OETNjBJsXjSo X-IronPort-AV: E=Sophos;i="4.73,553,1325458800"; d="scan'208";a="135114246" Received: from mail6.webfaction.com (HELO smtp.webfaction.com) ([74.55.86.74]) by mail4-smtp-sop.national.inria.fr with ESMTP; 08 Mar 2012 23:39:31 +0100 Received: from heyho.local (53-234.197-178.cust.bluewin.ch [178.197.234.53]) by smtp.webfaction.com (Postfix) with ESMTP id 6CCF3209F8D0; Thu, 8 Mar 2012 16:39:29 -0600 (CST) Date: Thu, 8 Mar 2012 23:39:26 +0100 From: =?utf-8?Q?Daniel_B=C3=BCnzli?= To: Sylvain Le Gall Cc: caml-list@inria.fr Message-ID: <51ABA83377A9415BA19B3073BDDCE20F@erratique.ch> In-Reply-To: References: <1991A512A37E49ACA5AAD30A38D628BF@erratique.ch> <1ACBE325A80144A4885B44685F6E9028@erratique.ch> X-Mailer: sparrow 1.5 (build 1043.1) MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from quoted-printable to 8bit by walapai.inria.fr id q28MdbGi006170 Subject: Re: [Caml-list] Re: oasis packaging questions Le jeudi, 8 mars 2012 à 22:27, Sylvain Le Gall a écrit : > It does it the right way ;-) The "I'm going to vomit files across your whole file system so that you need another bureaucratic tool/database too keep track of what I did whenever you want to remove me" way. Sure if you're looking for a business model and more bureaucracy that's the way to do it the "right way". The key insight in things like gnu stow or homebrew is that this tool/database already exists, it's the file system itself, KISS principle. And this simplicity also allows you to deal very easily with multiple version installs of the same package. > I would probably object to have html documentation in the $SITELIB of > findlib. To me that seems to be an ideological objection (debian related I guess), I don't see any technical objection. KISS should be applied here: I installed that package in that directory anything related to it is in that single directory. > I think a CHANGES/README is light enough to be in $SITELIB as well. CHANGES and README light, html heavy ? For one thing keep it at least consistent either you choose to put nothing in SITELIB or everything. I don't want to have to lookup two different places for documentation. > To be honest, if it was the only problem I have to solve, I'll be happy to spend hours on that. I don't think it's a good idea for the whole system to underestimate the importance of documentation. > But all this need to be more widely discuss (with OCamlPro for > TypeRex, Maxence for .odoc/Cameleon, Gerd for ocamlfind and the rest > of the community to have a real agreement on this point). I'm all for it, but now that I'm in these things I want to move forward. So what should I write something like this (currently) nop ? Document xmlm Title: "Xmlm documentation and module reference" Format: html Index: Xmlm.html Install: true InstallDir: $docdir DataFiles: CHANGES README doc/*.html, doc/*.css Or should I make another Document for CHANGES README ? > Well _oasis can also go there, even though it will be a little bit a > duplicate with META... It also has much more information in a machine readable format. Like the home page of the project, the maintainers, maybe even the repos etc. Best, Daniel