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
documentation automatique
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: 1998-08-31 (17:17)
From: Jan Skibinski <jans@n...>
Subject: RE: documentation automatique

On Sat, 29 Aug 1998, Adam P. Jenkins wrote:

> 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.

	And soon all sources would be obfuscated by all
	sorts of tags, and hardly directly readable by
	a programmer. Unless we have built powerful tools,
	where original source is no longer important
	-- as in Smalltalk or Eiffel -- this does not look
	to me as a good idea. 

	See http://www.numeric-quest.com/news/NQ-comments.html