Accueil » Divers

Natural Docs

16 avril 2004 Pas de commentaires

Natural Docs est un outil permettant de générer automatiquement
de la documentation à partir de code source Ada.


Natural Docs est un générateur de documentation pour du code
source, écrit en Perl. Il parcourt le code afin de trouver
des commentaires marqués spécialement et les utilise pour
créer une documentation indépendante. Il est disponible
gratuitement et sous forme de logiciel libre (licence GPL).
Il est écrit en Perl.

Philosophie

Les deux principes fondateurs de Natural Docs sont:

- Les commentaires doivent rester aussi lisibles et naturels que possible (d’où le nom, Natural Docs). Les marqueurs obligatoires sont aussi légers que possible. Notamment, il n’y a pas de marqueur tel que =head1 (comme dans POD) ou @param (comme dans JavaDoc). La structure est minimale et quasi-transparente. Les commentaires dans les fichiers sources sont aussi lisibles que la documentation générée.

- Le programme doit être aussi automatique et non-intrusif que possible.

Natural Docs supporte un grand nombre de langages, dont Ada.

Lien

La page de Natural Docs se trouve sur .

Laissez un commentaire

Ajoutez votre commentaire ci-dessous, ou créez un rétrolien depuis votre site. Vous pouvez également souscrire à ces commentaires par RSS.

Merci de vous conformer à la netetiquette.

Vous pouvez utiliser ces balises :
<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>