On Tue, 28 Jan 2003 23:30:55 +0100
Sylvain LE GALL <[EMAIL PROTECTED]> wrote:

> > mouai, je suis plut�t ocamlweb... ;-)
> 
> ocamldoc -html ;->
> 
> C'est pas de l'int�grisme mais ce qu'il y a de pas mal avec ocamldoc,
> c'est que c'est d'office dans ocaml et que ca g�n�re des man, des
> html, du latex...

Pour ceux qui se demandent o� on va comme �a, j'indique que ce point est
analogue au fait de croire qu'appliquer un outil bien joli sur du code
java pour obtenir en html la doc d'une librairie (i.e les commentaires
mais en plus joli) ) c'est de la documentation de logiciel.

Ben non, bien souvent c'est pas suffisant. Il faut pouvoir int�grer des
docs _externes_. En ce sens, pour OCaml, ocamlweb le fait, ocamldoc je
crois pas.

Malheureusement, le type d'outil comme ocamldoc est assez facile �
obtenir et donc c'est standard, et tout le monde est content. Mais le
v�ritable probl�me n'est pas r�solu pour autant.

Ceci dit, utiliser ce genre d'outil est d�j� un r�el progr�s!
A+ 


-- 
mailto:[EMAIL PROTECTED]     tel: (33) 03 20 43 84 06   
INRETS, 20 rue �lis�e Reclus         fax: (33) 03 20 43 83 59   
BP 317 -- 59666 Villeneuve d'Ascq       
http://www3.inrets.fr/estas/mariano

Répondre à