[ocaml-infra] [ocaml-platform] status of ocaml-doc

[Anil Madhavapeddy]

Do note that the 'opam-doc' package in OPAM does work at the moment.

It's just not integrated into the compiler, but it does do enough to
compile up the Core docs at Jane Street or the mirage.github.io docs.
We're unlikely to do any bugfixes to that though, as the effort is
going into the new version that Leo describes below.

-anil

On 20 Jun 2014, at 17:05, Leo White <lpw25 at cam.ac.uk> wrote:

> Hi Ashish,
> 
> I will be rewriting the opam-doc tool over the summer as part of work
> towards the OCaml platform. Should hopefully have something usable by
> September.
> 
> The `bin-doc` parts of the tool (which previously parsed documentation
> comments and stored them in ".cmd" files) have already been rewritten as
> a compiler patch to parse comments and store them in ".cmt" files as
> special attributes (on github as pr #51). Unfortunately this patch did
> not get into 4.02 as there were some concern over parts of it. I hope to
> address these concerns over the summer as well.
> 
> Regards,
> 
> Leo
> 
> Ashish Agarwal <agarwal1975 at gmail.com> writes:
> 
>> Does anyone know the status of opam-doc. Are we closer to having nice documentation easily generated for all of our
>> installed libraries?
>> 
>> _______________________________________________
>> Platform mailing list
>> Platform at lists.ocaml.org
>> http://lists.ocaml.org/listinfo/platform
> _______________________________________________
> Infrastructure mailing list
> Infrastructure at lists.ocaml.org
> http://lists.ocaml.org/listinfo/infrastructure
>