English version
Accueil     À propos     Téléchargement     Ressources     Contactez-nous    

Ce site est rarement mis à jour. Pour les informations les plus récentes, rendez-vous sur le nouveau site OCaml à l'adresse ocaml.org.

Browse thread
[Caml-list] CDK binary release
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: 2001-05-10 (22:55)
From: Markus Mottl <mottl@m...>
Subject: Re: [Caml-list] CDK binary release
Thorsten Ohl schrieb am Thursday, den 10. May 2001:
> Yes, but it would be very useful if the markup could serve both purposes
> simultaneously.  I'm using ocamlweb extensively and I find myself
> writing *.mli files that could be turned into online documentation

The same is true for me: the documentation of interfaces is the same
for users of some module and for developers. Only the latter usually
also want to see the documentation of the implementation. Being able
to generate both kinds of documentations without having to write extra
annotations would be a big help! That's why I am a bit reluctant about
cdk_doc, because it only addresses the library user's point of view.

Ocamlweb could probably (please correct me if I am wrong) be turned into
a general tool much more easily than the other approaches I have seen.

Any chance that it (or something similar) could ever get the status of
a standard tool (which cdk_doc seems to be targeting)?

Best regards,
Markus Mottl

Markus Mottl, mottl@miss.wu-wien.ac.at, http://miss.wu-wien.ac.at/~mottl
To unsubscribe, mail caml-list-request@inria.fr.  Archives: http://caml.inria.fr