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 q29BuNLr002591 for ; Fri, 9 Mar 2012 12:56:23 +0100 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AvsEAMzuWU/U4xEKk2dsb2JhbABCo3mRRSIBAQEBBwsLCRQDJIIKAQEEAW4LBQsFBiUhRRIGEwkIAQKHcQkHtyGQWgSNSheaaA X-IronPort-AV: E=Sophos;i="4.73,557,1325458800"; d="scan'208";a="148425257" Received: from moutng.kundenserver.de ([212.227.17.10]) by mail1-smtp-roc.national.inria.fr with ESMTP; 09 Mar 2012 12:56:18 +0100 Received: from office1.lan.sumadev.de (dslb-094-219-223-186.pools.arcor-ip.net [94.219.223.186]) by mrelayeu.kundenserver.de (node=mreu3) with ESMTP (Nemesis) id 0M2kBW-1SP0cQ0Zwk-00srT5; Fri, 09 Mar 2012 12:56:16 +0100 Received: from gps.dynxs.de (localhost [127.0.0.1]) by office1.lan.sumadev.de (Postfix) with ESMTP id 45FF6C00CB; Fri, 9 Mar 2012 12:56:15 +0100 (CET) Received: from 178.4.227.165 (SquirrelMail authenticated user gerd) by gps.dynxs.de with HTTP; Fri, 9 Mar 2012 12:56:15 +0100 Message-ID: <2bfeb18f8bbf72a2a0b4d1957707338b.squirrel@gps.dynxs.de> In-Reply-To: <51ABA83377A9415BA19B3073BDDCE20F@erratique.ch> References: <1991A512A37E49ACA5AAD30A38D628BF@erratique.ch> <1ACBE325A80144A4885B44685F6E9028@erratique.ch> <51ABA83377A9415BA19B3073BDDCE20F@erratique.ch> Date: Fri, 9 Mar 2012 12:56:15 +0100 From: "Gerd Stolpmann" To: =?iso-8859-1?Q?=22Daniel_B=C3=BCnzli=22?= Cc: "Sylvain Le Gall" , caml-list@inria.fr User-Agent: SquirrelMail/1.4.21 MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 X-Priority: 3 (Normal) Importance: Normal X-Provags-ID: V02:K0:oOXSp4DFfWQcT/RTlPecjImtdW8pDUTGuwdRN7hv2Wl RM6T9qoWRgUSt65gRTFZbqc/zh7dzUxLEpaftTDXXmMZjjTczX t5LbzmuS5EJVINr/dlf1MitGCruDeSNzbA5ecaFqPxQ42v9I0G heq+Ssb2t2B2ExnbPrCvBhLNPGEIbrLZX/JlX0e+KZdpqUBLvj VQbNFb4aVP7ToMrVzewwarNf1z1xjINpih+4ejuf5LUzfuYqsO 0j3znUhbr0v84Gje0ohVe3CmF/3cqGyTYZFnNZO7Trc88heJHn fkF/vWGbz3S+tSOnwwCeohnd3skwNqCFH2cG8OhG11ZZsLVIbi VE2Kxc1+jt6z/wphiY+u54T6EiBwIIpKA/zDVAYL/hZBemHwue iYSFIJjq6Djs0aZ36JydjkrteyAZnhH+Dw= Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from quoted-printable to 8bit by walapai.inria.fr id q29BuNLr002591 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. You can call it KISS, but I would call it short-sighted. This has nothing to do with bureaucracy. Imagine a package has also some utilities to install (and feeled every second package has). You just don't want to have to include tons of bin/ directories into your PATH. It does not scale well, but just slows down your system. There are just different sets of principles, and they have their pros and cons. The simplicity argument is not always the striking one. >> 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. That's really funny how you interpret this, but I guess this is just a matter of perspective. findlib does not support subdirectories just because I wanted to keep it lean, and to avoid adding features it does not need for its core job. And the core job is to drive the compiler with the right flags, and not to provide a container for storing files. > >> 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. I totally understand your point that you want to have a system that makes it easy to hack around (it's clearly no fun with the complex guys). However, I'm really wondering why docs are your first concern here? The real hacker does not need docs :-) Gerd > >> 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 > > > -- > Caml-list mailing list. Subscription management and archives: > https://sympa-roc.inria.fr/wws/info/caml-list > Beginner's list: http://groups.yahoo.com/group/ocaml_beginners > Bug reports: http://caml.inria.fr/bin/caml-bugs > > > -- Gerd Stolpmann, Darmstadt, Germany gerd@gerd-stolpmann.de Creator of GODI and camlcity.org. Contact details: http://www.camlcity.org/contact.html Company homepage: http://www.gerd-stolpmann.de *** Searching for new projects! Need consulting for system *** programming in Ocaml? Gerd Stolpmann can help you.