bonjour,
J'écris actuellement un programme de génération de documentation pour Delphi. C'est un programme gratuit, open source, sous licence GNU GPL qui utilise les informations du code source (symboles et commentaires formattés) pour produire une documentation de l'application ou du composant.
Il existe déjà quelques outils similaires, mais ils sont soit payant, soit incomplet ou encore non adapté à Delphi. Je pense la à l'excellent Doxygen.
J'espère donc que les programmeurs interressés essayeront cet outils, et eventuellement me fassent part de toutes les suggestions et/ou remontées de prob.
Merci à toute l'équipe de Hardware.com et à tous les contributeurs de nous faire partager leur savoir.
TridenT
Site de DelphiCodeToDoc :
http://dephicodetodoc.sourceforge.net/
---------------------------------------------------
La dernière version de DelphiCodeToDoc (v0.4alpha) est disponible. Elle peut
être téléchargée ici :
http://prdownloads.sourceforge.net [...] p?download
DelphiCodeToDoc est un outils gratuit de génération de documentation pour
Delphi, distribuer sous la licence GNU - GPL. Il utilise les informations
contenu dans le code source, comme les symbols et les commentaires
formattés, pour produire une documentation précise de votre code ou de votre
composant.
Situation : Le project est mûr, et la prochaine version sera une beta.
La syntaxe JavaDoc est prise en charge, ainsi que les commentaires en ligne.
Tous les bugs critiques ont été corrigés.
-----------------------------------------------------------------
What are the change in the last revision ?
Last revision v0.4alpha include all the modifications listed below :
*Fixed ParseTree appearing on exception/assertion error (Feature request
903123).
*Fixed method parameter's name appearing in Parameter description TAG.
*Fixed Untyped parameter in function crash the parser (Tracker 916780).
*Fixed method declaration in interface (class) cause an assertion (Tracker
916816).
*Added Inline description support for Fields.
*Added support for EndOfLine comment (double slash after a field for
example).
*Added "Java TAG" support for Class description.
*Added "Inline comment" support of Class and Method description.
*Improved Description and summary in JavaDoc Style recognition.
*Improved minor user interface controls.
What are the known bugs of the software ?
None for the moment. If you find a problem, please send it by email at
TridenT at users.sourceforge.net or Submit a Tracker.
What are the known limitations of the software ?
*Methods with the same name (overloaded) in a class will result in a single
method in the ouput report.
DelphiCodeToDoc links:
http://dephicodetodoc.sourceforge.net/
http://sourceforge.net/projects/dephicodetodoc/
, pour faire un peu de pub !