From mboxrd@z Thu Jan 1 00:00:00 1970 Received: (from weis@localhost) by pauillac.inria.fr (8.7.6/8.7.3) id NAA26696 for caml-redistribution; Mon, 31 Aug 1998 13:56:58 +0200 (MET DST) Received: from nez-perce.inria.fr (nez-perce.inria.fr [192.93.2.78]) by pauillac.inria.fr (8.7.6/8.7.3) with ESMTP id WAA27231 for ; Sat, 29 Aug 1998 22:37:32 +0200 (MET DST) Received: from mail1.javanet.com (mail1.javanet.com [205.219.162.10]) by nez-perce.inria.fr (8.8.7/8.8.7) with ESMTP id WAA18173 for ; Sat, 29 Aug 1998 22:37:30 +0200 (MET DST) Received: from dwarin (bos-us346.javanet.com [209.94.140.157]) by mail1.javanet.com (8.8.8/8.7) with SMTP id QAA08971; Sat, 29 Aug 1998 16:37:17 -0400 (EDT) From: "Adam P. Jenkins" To: , "Vincent Poirriez" Cc: Subject: RE: documentation automatique Date: Sat, 29 Aug 1998 16:36:05 -0400 Message-ID: <000001bdd38c$a56517f0$9d8c5ed1@dwarin> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook 8.5, Build 4.71.2173.0 In-Reply-To: Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V4.72.3110.3 Sender: weis > | It should be nice if an automatic documentation tool could be provided > | for ocaml. It should take .ml and/or .mli files correctly documented > | and return a nice latex/html (eventually via HeVeA) docummentation. > > I don't know what you exactly want, but if you want to convert your > caml code to html with syntax coloring and the like, I'd suggest you I think he means something like Javadoc, but for O'Caml instead of Java. With Javadoc, you put a comment in front of every function or class in your code, using some special format for the comments, and then run Javadoc with the source code as input. It extracts the special comments and generates an HTML document for your code. I've seen several programs like this for C++ also, but not for Caml yet. Adam