OVH Cloud OVH Cloud

Générer de la doc d'un script Perl

4 réponses
Avatar
Jules
Salut à tous,

J'aimerai générer de la documentation HTML de code Perl (style doxygen
ou Javadoc) ... existe t'il un outil déjà existant permettant de le faire ?

Merci d'avance.

4 réponses

Avatar
Stephane Zuckerman
Salut à tous,

J'aimerai générer de la documentation HTML de code Perl (style doxygen
ou Javadoc) ... existe t'il un outil déjà existant permettant de le faire ?

Merci d'avance.


Regarde du côté de la Plain Old Documentation (POD) : perldoc perlpod, et
pod2html ...


--
"Je deteste les ordinateurs : ils font toujours ce que je dis, jamais ce
que je veux !"
"The obvious mathematical breakthrough would be development of an easy
way to factor large prime numbers." (Bill Gates, The Road Ahead)

Avatar
Denis -esp2008-
Bonjour Jules,

J'aimerai générer de la documentation HTML de code Perl (style doxygen
ou Javadoc) ... existe t'il un outil déjà existant permettant de le
faire ?


Il y a POD qui est prévu plus ou moins pour cela
http://perl.enstimac.fr/DocFr/perlpod.html mais je le trouve moins
satisfaisant que doxygen. Comme je me pose la même question en ce moment,
je suis preneur de tout ce que trouveras :)

--
Denis

Avatar
Jules
Regarde du côté de la Plain Old Documentation (POD) : perldoc
perlpod, et

pod2html ...


Impeccable, merci ... j'ai plus qu'à me mettre à tout commenter ...

Avatar
Emmanuel Florac
Le Wed, 08 Jun 2005 16:44:56 +0200, Denis -esp2008- a écrit :


Il y a POD qui est prévu plus ou moins pour cela
http://perl.enstimac.fr/DocFr/perlpod.html mais je le trouve moins
satisfaisant que doxygen.


Il a l'avantage d'être très très facile à faire à la main. Sinon
DocBook c'est encore bien mieux que tout le reste, mais c'est assez
indigeste et ça ne se met pas "inline".
Cependant en perl tout ce qui est après le tag __END__ est purement et
simplement ignoré. Donc il est possible de mettre du doxygen, du
docbook ou du MS-Word encodé en base-64 après ce tag...

--
Le travail est la malédiction des classes qui boivent.
O. Wilde.