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 pBEFbU0U005946 for ; Wed, 14 Dec 2011 16:37:30 +0100 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AhEBAALC6E7U4xEIkGdsb2JhbABDhQimHyIBAQEBCQkNBxQDIoFyAQEEASNWBQsLGAICHwcCAlcGJ4dmAqVAkgSBL4lEgRYEjQ6NM4xe X-IronPort-AV: E=Sophos;i="4.71,352,1320620400"; d="scan'208";a="123360375" Received: from moutng.kundenserver.de ([212.227.17.8]) by mail4-smtp-sop.national.inria.fr with ESMTP; 14 Dec 2011 16:37:28 +0100 Received: from office1.lan.sumadev.de (dslb-188-097-012-119.pools.arcor-ip.net [188.97.12.119]) by mrelayeu.kundenserver.de (node=mrbap4) with ESMTP (Nemesis) id 0MeSlT-1RNL3116Q3-00QEnA; Wed, 14 Dec 2011 16:37:28 +0100 Received: from [192.168.178.11] (546BF816.cm-12-4d.dynamic.ziggo.nl [84.107.248.22]) by office1.lan.sumadev.de (Postfix) with ESMTPSA id D50B1C00C7; Wed, 14 Dec 2011 16:37:27 +0100 (CET) From: Gerd Stolpmann To: oliver Cc: Gabriel Scherer , Edgar Friendly , caml-list@inria.fr In-Reply-To: <20111214145555.GB1888@siouxsie> References: <20111213202253.GC5387@siouxsie> <1323864897.7750.12.camel@samsung> <20111214145555.GB1888@siouxsie> Content-Type: text/plain; charset="UTF-8" Date: Wed, 14 Dec 2011 16:37:26 +0100 Message-ID: <1323877046.7750.42.camel@samsung> Mime-Version: 1.0 X-Mailer: Evolution 2.32.2 Content-Transfer-Encoding: 7bit X-Provags-ID: V02:K0:5rJzZgvne3AkV4hFfd4b67vbdv1JDj7CApy9pDYtF4w M+kBJmc8Ps0r34KzEQ8/plgKFB9I9kDEH9ii3FIpCL2bQ1p/eI 7XhTxBDIgOMwkq1zOlml3bw2SmZxlYuccCx7+940ZsHdu+p+T0 WF8OGFjsJG3duQf11T7fM+kKJ6rfU3WNShWeLPys5JV2t/iiDo q41OxHNmrB4AnUpXDLvCXM/JabhMmbxJyGQ57SJjQEtfOuYytz 7BhKckxnoPoIWcCr3nRD6Gj1d9iWSOnyJRJ3IS3AVfem6+Bbkm sq3LEuPIwWmc85KDY7nE16LWUGDxTdTTXm+QFIVChqWbarBQ2k 6k9uX+EQDC0is4K84G2EWoPi2ipNiBFmxNH4dDvC0 Subject: Re: more ideas (Re: [Caml-list] how could the community help with Oasis-DB;) towards a CPAN for OCaml? Am Mittwoch, den 14.12.2011, 15:55 +0100 schrieb oliver: > On Wed, Dec 14, 2011 at 01:14:57PM +0100, Gerd Stolpmann wrote: > > Am Dienstag, den 13.12.2011, 21:22 +0100 schrieb oliver: > > > Hello, > > > > > > > > > I again want to mention R. > > > > > > The installation procdure for users is very easy. > > > What I also like there, is that the documentation > > > includes references to books, which explain the algorithms > > > or other background information. > > > Maybe thats too much of what is needed for OCaml. > > > > > > But it's what I do like there. > > > > > > Also R-packages necessarily need to be documented, > > > have a manpage / package description. > > > > > > Not sure if this is necessary with OCaml stuff, > > > because *.mli files are there, and ocamlc -i could > > > print the interfaces of the modules, if nothing else is there > > > to rely on. > > > But maybe these kinds of minimalistic documentation-generation > > > could be created automatically by the installing tools. > > > > > > Nicely printed html-docs for interfaces are very helpful. > > > > > > And also nice would be, to have such nicely printed documentation > > > also available at the server, even before downloading any packages. > > > So, browsing a package documentation online could be done > > > before downloading the package. > > > > docs.camlcity.org > [...] > > Yes, I see. > There are these nice htmlized-docs. > > But I meant that this kind of docs also should also be on > a CPAN-like server for OCaml. > So every package that is available there should also be > documented in this way. Yes, it's a third party server. What's the problem? My thinking here is different: We should lower the barriers for packages as far as possible. We are not in the position of CPAN who can reject packages not conforming to a relatively high standard. docs.camlcity.org does the best in this situation: If there is a manual, you can look at this. But if not, there is at least a pretty-printed interface, and you can search these interfaces. Gerd > Ciao, > Oliver >