Re: [Caml-list] [ANN] Argot: 1.0 release

[Anil Madhavapeddy <anil@recoil.org>]

On 4 Nov 2011, at 09:24, rixed@happyleptic.org wrote:

> -[ Thu, Nov 03, 2011 at 09:15:57PM +0100, Fabrice Le Fessant ]----
>> Hi,
>> 
>>  By the way, Thomas is also working on a plugin for ocamldoc, with
>> incremental search. An example of what it generates (for the stdlib and
>> some of our internal libraries) is available here:
>> 
>> http://www.ocamlpro.com/doc/stdlib/index_modules.html
>> 
>>  It is not yet released, but we plan to do it in the next months, with
>> some other tools.
> 
> This looks very promising.
> Will the tool generate mere html files or is it intended for an ocaml
> web framework such as ocsigen ?

It's all pure HTML/CSS. The wonders of the Twitter Bootstrap framework :-)

> Also, apparently one cannot search by type. It would be a nice feature
> to have.

Thomas also prototyped a searchable version for the CUFP Mirage tutorial:
e.g.: http://www.ocamlpro.com/mirage/xen/ 

but the search view does need some optimisation with a large number of modules, as in the standard library.  The new version he's doing in HTML is far slicker and faster.

Citrix have a really useful JSON output to ocamldoc in the XAPI tree that is very handy for anyone else who wants to do something like this:
https://github.com/xen-org/xen-api/blob/master/ocaml/doc/odoc_json.ml

-anil