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 pBEEu3e0004063
	for <caml-list@sympa-roc.inria.fr>; Wed, 14 Dec 2011 15:56:03 +0100
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: AjMCAI+46E7AbSoIe2dsb2JhbABDhQimHyIBARYmBCGBcgEBBSNWEAsJBQoCAh8HAgIUGDEnh2ilRZIEE4EciUQzYwSNO4c4kiw
X-IronPort-AV: E=Sophos;i="4.71,352,1320620400"; 
   d="scan'208";a="123354293"
Received: from einhorn.in-berlin.de ([192.109.42.8])
  by mail4-smtp-sop.national.inria.fr with ESMTP/TLS/DHE-RSA-AES256-SHA; 14 Dec 2011 15:55:57 +0100
X-Envelope-From: oliver@first.in-berlin.de
Received: from first (e178008171.adsl.alicedsl.de [85.178.8.171])
	(authenticated bits=0)
	by einhorn.in-berlin.de (8.13.6/8.13.6/Debian-1) with ESMTP id pBEEttU9021960
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT);
	Wed, 14 Dec 2011 15:55:55 +0100
Received: by first (Postfix, from userid 1000)
	id 3FB0D1540359; Wed, 14 Dec 2011 15:55:55 +0100 (CET)
Date: Wed, 14 Dec 2011 15:55:55 +0100
From: oliver <oliver@first.in-berlin.de>
To: Gerd Stolpmann <info@gerd-stolpmann.de>
Cc: Gabriel Scherer <gabriel.scherer@gmail.com>,
        Edgar Friendly <thelema314@gmail.com>, caml-list@inria.fr
Message-ID: <20111214145555.GB1888@siouxsie>
References: <CAPFanBFiE0rzRrA0hcbULQo34p-pD3XXx62T8nbSH1nwNTZW-w@mail.gmail.com>
 <20111213202253.GC5387@siouxsie>
 <1323864897.7750.12.camel@samsung>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
In-Reply-To: <1323864897.7750.12.camel@samsung>
User-Agent: Mutt/1.5.20 (2009-06-14)
X-Scanned-By: MIMEDefang_at_IN-Berlin_e.V. on 192.109.42.8
Subject: Re: more ideas (Re: [Caml-list] how could the community help with
 Oasis-DB;) towards a CPAN for OCaml?

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.

Ciao,
  Oliver