merci.Citation:
Envoyé par trident_job
Java, je faisait cela avec notepad ou vi... :oops:
Version imprimable
merci.Citation:
Envoyé par trident_job
Java, je faisait cela avec notepad ou vi... :oops:
Bonjour,
Et d'abord merci trident pour cette application qui me permet de ne pas avoir à tout réapprendre.
J'ai découvert 2 bugs que j'ai rajouté au tracker de façon anonyme, alors si mes explications ne sont pas claires tu peux toujours me demander des précisions ici :
- La clause else dans un except provoque une erreur de parsing si elle comporte plusieurs lignes.
- Après une erreur de parsing (voir ci dessus ;) ), reconstruire la doc après avoir modifié le code plante DelphiCodeToDoc. Il faut fermer le projet et le rouvrir pour rétablir la situation. Ceci n'arrivait pas dans la version 0.11 que j'utilisais avant (mais pour laquelle je ne pouvais déterminer la cause de l'erreur, les messages étant trop laconiques).
Il y a un petit truc pratique avec Javadoc qui manque. c'est le link. C'est pratique dans le texte de faire référence directement à une autre classe/propriété/methode...
Donc pour une future version... :?
Pour info dans mon dernier message je pensais que la possibilité de générer de la doc sous Delphi 2005 était aisée ...
C'est pas vraiment le cas pour les pré-requis :
:roll:Citation:
The XMLDoc tool requires a number of supporting tools:
- Delphi 2005
- Python (tested with Python 2.3)
- Saxon (tested with Instant Saxon 6.5.3)
- The Java SDK (tested with J2SE v 1.4.2_05 SDK)
Merci d'avoir rajouté ces Trackers, je vais vérifier et corriger au plus tôt.Citation:
Envoyé par sovitec
Si tu as d'autres bugs ou souhaits, n'hésites pas :!:
Oui, j'avais prévu d'ajouter le TAG @see pour la prochaine version, mais j'avais mis de coté le @Link.Citation:
Envoyé par eponette
J'essayerai de l'ajouter en même temps, mais je ne promet rien, j'ai une longue liste de reste à faire :o !
Voici le lien vers le Tracker que je viens de rentrer.
http://sourceforge.net/tracker/index...81&atid=614258
Merci pour l'info !
Oui, effectivement, c pas si simple 8O :?Citation:
Envoyé par Laurent Dardenne
C'est un aspect que je n'avais pas encore regardé, je me concentre sur l'avancée d'une v1.0 stable :wink:
Si tu as d'autres infos sur le sujet (un exemple + résultat), je suis preneur !
Chers utilisateurs de DCTD,
à travers cette note, je voudrais vous informer du développement de l'application DelphiCodeToDoc. La dernière version publique, la v0.13b, date du 22/06/2005 ... plus de trois mois.
Alors, que-ce passe-t-il ? Y aura-t-il d'autre versions ? Si oui, quelles seront les nouveautés ?
J'anticipe les questions, et voici quelques explications.
Tout d'abord, il faut savoir que je développe DelphiCodeToDoc de manière tout à fait personnelle, je ne fais pas ce logiciel dans le cadre d'une société, donc c'est mon temps libre qui dirige le planning du développement.
En ce moment, j'ai beaucoup de mal à trouver du temps, je dois passer 1 à 2 heures par semaine tout au plus.
Je vous rassure donc, le développement n'est pas arrêté, il reste une quantité non négligeable de Trackers à corriger.
Si vous jetez un oeil dans le repository CVS ( http://cvs.sourceforge.net/viewcvs.py/dephicodetodoc ) vous verrez que je commit régulièrement des versions. DelphiCodeToDoc vit !
Je travaille en ce moment sur la syntaxe dotNet de Delphi, qui me pose pas mal de problèmes. J'ai dû revoir certains points dans l'architecture pour répondre correctement à ce point là, ce qui m'a pris pas mal de temps. Le but est de finaliser une version qui prenne en charge les types imbriqués, les variables et constantes de classes, les classes "helper" , la surcharge des opérateurs etc ...
Cette fonctionnalité est finie a environ 70%, le reste ne devrait pas prendre trop de temps.
La version prochaine (v0.14b) va donc répondre au besoin de documenter des codes utilisant la syntaxe dotNet, en plus de la correction de bug recensés (10 sur les 13 actuels). http://sourceforge.net/tracker/?atid=614255&group_id=96281&func=browse
Cette version devrait être finalisée d'ici la fin du mois au plus tard. Je prends aussi du temps pour écrire des tests avec DUnit ce qui m'aide dans la recherche des régressions.
Pour les versions futures, voici en gros la roadmap pour la version suivante v1.0 (enfin)
* Correction des bugs restants.
* Lien HTML sur les parents de chaque objet de la documentation
* Support du TAG @Link et @See
* La mise à jour complète des traductions
* Ajout du choix de la langue de la Documentation générée
* Fichier de configuration au format XML
Voila, vous savez à présent quelle direction prend DelphiCodeToDoc, je vous demande juste un peu de patience.
Je voudrais profiter de l'occasion pour remercier toutes les personnes qui ont participé au développement, par leur remarques, leurs idées, leur traductions et parfois leur soumission de code.
Merci à tous de votre aide, j'adore l'ambiance de la communauté Delphi, et j'ai appris beaucoup grâce à vous. Encore Merci !
TridenT
salut trident,
à mon avis tu devrais pondre un fichier xml qui résulte du parsing de ton fichier.
faire la production de html à partir de ce fichier xml, par exemple en xslt.
comme ça,
un utilisateur peut
- modifier le xslt s'il souhaite rajouter 2 3 trucs.
- faire son propre xslt s'il veut un truc simple et repartir de 0
en tout cas passe par un fichier intermédiaire qui soit accessible.
et si tu trouves que mettre à jour ton parser est un peu lourd, tu peux aller voir du côté de antlr qui est un générateur de parser à partir d'une méta grammaire.
bon courage.
Salut Bruno75,
Oui, j'y ai pensé recemment, mais je suis encore novice dans la transformation XML pour généré du HTML par exemple. Mais je vais y regarder de plus près, vu que je voudrais travailler sur des "templates" pour générer la documentation.Citation:
tu devrais pondre un fichier xml qui résulte du parsing de ton fichier
Quand à antlr, je connais pas, je vais jeter un coup d'oeil.
Merci !
ANN: DelphiCodeToDoc v0.14Beta disponible - Outil gratuit de generation de documentation pour Delphi
La dernière version de DelphiCodeToDoc (v0.14Beta) est disponible. Elle peut être téléchargée ici :
http://prdownloads.sourceforge.net/dephicodetodoc/DelphiCodeToDoc_exe_v0.14b.zip?download
Situation : Cette version supporte (enfin) la syntaxe dotNET de Delphi2005 (et certaine de Delphi2006)
-----------------------------------------------------------------
Quelles sont les nouveautés de cette version ?
Cette version v0.14Beta contient les modifications suivantes :
:arrow: Correction des commentaires sur de propriétée de classe non renseignés (Tracker 1398703)
:arrow: Correction d'une exception du parser avec un cast en System.Object ou System.Type (Tracker 1398699)
:arrow: Correction d'une exception du parser avec mot-clé dans un nom composé (Tracker 1411446)
:arrow: Correction d'une exception lorsqu'une classe est déclarée dans l'implementation (Tracker 1413730)
:arrow: Ajout du support du caractète '&' avant un identifiant ou une méthode (Tracker 1398699)
:arrow: Ajout du support de l'écriture des tableaux dynamiques et tableaux ouverts (Tracker 1398699)
:arrow: Correction de la confusion lors de l'utilisation des même identifiant dans un même espace de nommage (Tracker 1398703)
:arrow: Correction d'une erreur lors de l'utilisation de System.Object or System.Type (Tracker 1398699)
:arrow: Correction d'une exception du parser avec le mot-clé 'var' dans une classe (Tracker 1398699)
:arrow: Ajout du support du multicast (Add et Remove) dans les propriétés (Tracker 1398699)
:arrow: Ajout d'une option pour copier le commentaire de l'accesseur pour les propriétés non-commentées
:arrow: Ajout d'un lien vers l'accesseur dans la documentation html pour les propriétés
:arrow: Correction du lien 'Suivant' jamais actif dans la barre d'outils HTML
:arrow: Ajout du support des unités avec un nom composé
:arrow: Ajout du lien vers le parent pour les classes dans la documentation HTML
:arrow: Correction du répertoire non sauvegardé lors de la selection d'un fichier ou d'un répertoire (Tracker 1251032)
:arrow: Ajout du lien vers la classe pour les membres (Tracker 1206745)
:arrow: Ajout du support des des directives de classe 'Sealed' et 'Final' (Tracker 1380515)
:arrow: Ajout du support de la directive de méthode 'Final' (Tracker 1337618)
:arrow: Correction d'une assertion lors de la deuxième construction de la documentation (Tracker 1234775)
:arrow: Modification de la valeur par défaut de l'option 'HideEmptyOutputBlock' de Faux à Vrai
:arrow: Correction des membres imbriqués manquant dans le fichier CHM
:arrow: Correction de la visibilité pour les classes imbriquées
:arrow: Correction d'une exception du parser avec le mot-clé Index pour une fonction externe (Tracker 369011)
:arrow: Correction des parents pour les UseUnit, Class et Interface (Tracker 1348051)
:arrow: Correction de la fonctionnalité 'cacher les blocks vides"
:arrow: Ajout du support pour les constantes imbriquées dans une classe
:arrow: Ajout du support pour les classes imbriquées dans une classe
:arrow: Ajout du support pour les variables imbriquées dans une classe
:arrow: Ajout du support des espaces de nom composés (Tracker 1331694)
:arrow: Ajout du support des noms composés pour les identifiants (type, uses, inheritance ...)
:arrow: Ajout de la visibilité 'Strict' dans la documentation
:arrow: Mise à jour de la structure interne pour simplifier la gestion des classes et types imbriqués
:arrow: Correction d'une exception avec une classe définie dans l'implementation (Tracker 1226175)
:arrow: Correction d'une exception lors de l'utilisation d'un mot réservé comme identifiant (Tracker 1145132, 1298482)
:arrow: Correction d'une exception lors de la destruction de la classe TDocOptions
:arrow: Ajout d'une option 'Autoriser le HTML dans la description" pour embarquer du HTML
:arrow: Correction de l'encodage HTML des caractères spéciaux (Tracker 1232749)
:arrow: Correction du delimiteur de chemin du fichier CSS dans le HTML (Tracker 1305970)
:arrow: Correction du crash du programme à la seconde analyse (Tracker 1234775)
:arrow: Correction du crash du programme après une analyse échouée (Tracker 1230817)
Quels sont les bugs connus du logiciel ?
*Les traductions ne sont pas à jour
Quelles sont les limitations connues du programme ?
*Les variables de classe ne peuvent être commentées que par un commentaire inline juste après la declaration
*Les évenements n'ont pas de description
*Seul l'Anglais est disponible pour le document généré
*Le TAG @see n'est pas supporté
Quelles seront les futures évolutions ?
*
Bonjour,
j'aurais souhaité savoir si il était possible d'automatiser la création du fichier dct. Pour être plus clair, serait t'il possible de générer le fichier .chm sans avoir à ouvrir l'interface utilisateur? Utiliser une ligne de commande pour lui dire où ce trouve les fichiers à scanner et que DCTD face tout d'un trait. Car pour le moment je passe obligatoirement par l'interface pour créer un fichier de projet.
Nous avons créer un système qui évite de passer par l'interface, mais cela nous demande de reprendre votre code et de faire des modifications à chaque fois qu'une nouvelle version sort.
A bientot
Xander
Xander, Je travaille en ce moment sur la version XML du fichier de config (binaire précédement).
Cela devrait solutionner tes soucis je pense ?
Les fichiers de configurations sont maintenant sauvegardés au format XML à partir de la version v0.14beta.1
Enfin :D
ANN: DelphiCodeToDoc v0.15Beta disponible - Outil gratuit de generation de documentation pour Delphi
La dernière version de DelphiCodeToDoc (v0.15Beta) est disponible. Elle peut être téléchargée ici :
http://prdownloads.sourceforge.net/d...b.zip?download
-----------------------------------------------------------------
Quelles sont les nouveautés de cette version ?
Cette version v0.15Beta contient les modifications suivantes :
:arrow: Mise à jour du fichier de configuration en XML
:arrow: Ajout d'une fonction d'import de l'ancien fichier de configuration (*.dcd)
:arrow: Mise à jour du projet avec Delphi2006
:arrow: Ajout du nom du projet dans le titre de la feuille
:arrow: Ajout d'une confirmation lors de la fermeture d'un projet
:arrow: Correction d'un problème lorsque l'assesseur n'est pas défini dans l'unité (Tracker 1482445)
:arrow: Correction d'un problème avec les commentaires commençant par (** (Tracker 1352650)
:arrow: Correction du répertoire de sortie impossible à modifier pour un projet existant (Tracker 1475301)
:arrow: Correction lors de la sauvegarde et du chargement d'un projet
:arrow: Suppression de l'affichage de la boite dos lors d'un appel à HHC.exe pour compiler le CHM (Tracker 1119969)
:arrow: Ajout des messages produits pas hhc.exe dans la fenêtre de debug (Tracker 1462810)
:arrow: Ajout d'un apnneau d'attente pour l'utilisateur (la compilation du CHM peut prendre du temps)
:arrow: Mise à jour des informations de copyright
:arrow: Correction des noms de fichiers COM (Tracker 1447905)
:arrow: Correction d'une assertion lorsque qu'une proprieté est liée à une variable de classe (Tracker 1460512)
:arrow: Correction du lien html dans la barre d'outils (Tracker 1469081)
Quels sont les bugs connus du logiciel ?
*Les traductions ne sont pas à jour
Quelles sont les limitations connues du programme ?
*Les variables de classe ne peuvent être commentées que par un commentaire inline juste après la declaration
*Les évenements n'ont pas de description
*Seul l'Anglais est disponible pour le document généré
*Le TAG @see n'est pas supporté
Quelles seront les futures évolutions ?
*
Merci :P
Tu as une date de prévue pour la V1.0 ?
Salut, je viens de voir un très bon référent pour ton outil.
:applo:
Salut Laurent, désolé pour la réponse tardive, mais je n'ai aps reçu de mail pour m'avertir de ta réponse ...
La v1.0 sortira ... lorsque tous les bugs / fonctionnalitées critiques seront corrigés ... il y en a encore pas mal :roll: :
* Pb de traductions
* Pb avec les langues étendue (chinois, coréens, etc ...)
* Pb avec les records
* manque un graphe des classes, et un résumé de la couverture de commentaire.
Donc, pour le tout début 2007 avec en prime qcq nouveauté (nouveau générateur de doc en XML + XSLT en plus de HTML/CHM).
Oui, j'avais contacté à l'époque Zarko Gajic pour faire un peu de pub ;) , et cela a très bien marché (x5 en nombre de visite et download sur 1 mois).Citation:
Salut, je viens de voir un très bon référent pour ton outil.
Nouveau ! :f1:
Voici une petite video pour présenter comment utiliser les templates de commentaires de GExperts pour ajouter en un clic des canevas de commentaires pour les méthodes et unités.
N'hésitez pas à donner votre avis ;) !
http://dephicodetodoc.sourceforge.ne...tsTemplate.htm
ANN: DelphiCodeToDoc v0.16Beta disponible - Outil gratuit de generation de documentation pour Delphi
La dernière version de DelphiCodeToDoc (v0.16Beta) est disponible. Elle peut être téléchargée ici :
http://prdownloads.sourceforge.net/d...b.zip?download
-----------------------------------------------------------------
Quelles sont les nouveautés de cette version ?
Cette version v0.16Beta contient les modifications suivantes :
:arrow: Correction d'une assertion avec trop de neuds enfants (Tracker 1510470)
:arrow: Possibilité d'avoir le répertoire de sortie en chemin relatif (Tracker 1549273)
:arrow: Correction des liens précédent / suivant dans la documentation HTML et CHM
:arrow: Suppression des espaces dans les listes de fichiers à inclure / exclure
:arrow: Correction d'une assertion avec une constante définie dans une classe avant un identifiant de visibilité (Tracker 1516235)
:arrow: Correction d'une exception avec un mot-clé réservé dans un identifiant (Tracker 1516226)
:arrow: Correction d'un problème de delimiter de chemin pour compatibilité avec la dernière JCL (Tracker 1547733)
:arrow: Correction du mot-clé UNSAFE qui génère une exception (Tracker 1548390)
:arrow: Ajout des mots-clé assembleur VMTOFFSET and DMTOFFSET non reconnus (Tracker 1552479)
:arrow: Correction d'une regression lors de la construction des listes de constantes, variables, et fonctions
:arrow: Correction d'un appel à HHC pouvant échouer (Tracker 1547734)
:arrow: Correction de classes non-générée en décochant l'option mvPrivate (Tracker 1547737 )
:arrow: Ajout de la possibilité d'utilisiser des chemins relatifs dans la liste des fichiers inclus au projet (Tracker 1547740, 1204843)
:arrow: Ajout de la prise en compte des masques de fichier (joker) dans la liste des exclusions (Tracker 1547741)
:arrow: Correction des caracteres invalides dans le menu (charset changed from ANSI to DEFAULT)
:arrow: Ajout d'une option pour afficher les objets cachés (définis uniquement dans l'implémentation) (Tracker 1478189)
Quels sont les bugs connus du logiciel ?
*Les traductions ne sont pas à jour
Quelles sont les limitations connues du programme ?
*Les variables de classe ne peuvent être commentées que par un commentaire inline juste après la declaration
*Les évenements n'ont pas de description
*Seul l'Anglais est disponible pour le document généré
*Le TAG @see n'est pas supporté
Quelles seront les futures évolutions ?
*Support des records
*Controle de la couverture de comentaire
*Arbre des classes
*Generateur XML / XSLT
Salut,
je vais regarder tes templates et la nouvelle version.
:ccool:
J'aime beaucoup ces nouvelles fonctionnalités :D :
Et :merci: pour les VMTOFFSET :)Citation:
Envoyé par trident_job
Oui, fort sympathiques ces fonctionnalités, j'espère qu'il y en aura d'autres du même type :roll:Citation:
Envoyé par sjrd
Pour le VMTOFFSET, j'avoue que je n'avais pas souvent vu ce mot-clé assembleur ... on en apprend tous les jours ;)
Concernant le template pour GExpert, la clause return, dans le détail des paramètres d'une méthode, contient le type de donnée renvoyée. Ce n'est pas nécessaire car le soft, lors de la compilation du .chm, le renseigne déjà.
La ligne suivante du fichier XML :
peut être remplacée par :Citation:
%ENDPARAMLIST%@return %RESULT% ResultDescription
Avec cette macro il n'y a plus d'excuse pour ne pas document son code.Citation:
%ENDPARAMLIST%@return ResultDescription
Bravo.
yes, je vais le modifier, bien vu.
C'est clair ! Je suis en train de finir une visualisation des items non-renseignés (classes, methodes, paramètres, constantes ...).Citation:
Avec cette macro il n'y a plus d'excuse pour ne pas document son code.
Alors là, celui qui ne le fait pas, il est de mauvaise fois !
Bientôt une V1 alors.Citation:
Envoyé par trident_job
Sinon je t'ai posté un msg dans le forum français sur SourceForge concernant un msg d'erreur sans gravité qui est affiché lors de la compilation.
bonjour aux lecteurs de ce post.
Après un temps d'absence:roll: , DelphiCodeToDoc revient avec quelques nouveatés :
* Couverture de commentaires
* Arbre des classes
* Corrections de bug
Avant de finaliser cette future version (il reste encore des choses à faire!), je souhaitais soumettre la version en cours à votre oeil critique :
* Que pensez-vous des informations présentes dans l'onglet Comment Quality ?
* Que pensez-vous de la présentation ?
N'hésitez pas à m'envoyer vos remarques / critiques / idées, elles sont toujours appréciées 8-) .
Téléchargement de l'EXE (extrait de CVS) :
http://dephicodetodoc.cvs.sourceforg...iCodeToDoc.exe
Les modifications (en anglais):
* Refactored Structure Sort using a Visitor
* Fixed Config file date changed even if not modified (Tracker 1604036)
* Added TAG coverage detail for each node
* Added Tag coverage summary in mainform
* Added brazillian portuguese translations
* Fixed Parse Error with &variable syntax (Tracker 1589861)
* Updated visitor for DocTemplate
* Fixed Comments not included with different method declaration (Interface and Implementation) (Tracker 1337626)
* Added Quality comments coverage visualization
* Added simple comments coverage statistics
* Fixed varargs keyword generate an exception (Tracker 1607892)
* Fixed Parser exception with tabs after final end (Tracker 1601763)
* Fixed Parser exception with the deprecated directive (Tracker 1581963)
* Added Class tree (text format) in the documentation
* Added Chinese translations (traditional and simplified)
* Fixed Exports in unit throw an exception (Tracker 1402652)
Les points en cours :
* #TODO# Fix option ParseImplementation
* #TODO# Update translation html page
* #TOFIX# Verify Nested type in TDOCClass
* #TOFIX# Merge TDOCVars and TDOCFields
* #TODO# Add support for records as class ?
* #TOFIX# Test Multiple variable declaration in one line (comma separated)
C'est vraiment très intéressant :ccool:
Mais il y a un truc qui personnellement me dérange : il s'agit des chaînes de ressources. En effet, je ne les documente jamais, parce que ça rend mon code illisible et que de toute façon ce serait pour remettre le contenu de la chaîne en description.
Du coup j'ai pas mal de rouge sur toutes mes constantes chaînes. Et j'ai plus de mal à repérer les "vrais" manquant.
Serait-il possible d'avoir une option pour documenter automatiquement les constantes non documentées avec leur valeur ? Et ne pas émettre d'avertissement ?
En tous cas c'est du très beau boulot :D Bravo pour ce logiciel :D
Pour les ResourceStrings, il y a deja une demande ici : http://sourceforge.net/tracker/index...81&atid=614258
Je vais voir si je peux le faire assez facilement, car je dois modifier le parser pour cette detection.
En tout cas, ta demande est jsutifiée, car les commentaires des resourcestring ne sont pas très utiles, effectivement.
Merci pour tes retours (rapides).
TridenT
:merci:Citation:
Envoyé par trident_job
Tu sais bien que je suis fan de ton prog :PCitation:
Envoyé par trident_job
ANN: DelphiCodeToDoc v0.17Beta disponible - Outil gratuit de generation de documentation pour Delphi
La dernière version de DelphiCodeToDoc (v0.17Beta) est disponible. Elle peut être téléchargée ici :
http://downloads.sourceforge.net/dep...exe_v0.17b.zip
-----------------------------------------------------------------
Quelles sont les nouveautés de cette version ?
Cette version v0.16Beta contient les modifications suivantes :
:arrow: Added support for record and extended record (D2006) as class (Tracker 1168150)
:arrow: Fixed Field comments for Records don't work right (Tracker 1534349)
:arrow: Fixed Method on records not parsed (Tracker 1649093)
:arrow: Added Quality comments coverage visualization
:arrow: Added simple comments coverage statistics
:arrow: Added Tag coverage summary in mainform
:arrow: Added TAG coverage detail for each node
:arrow: Added inheritance for comments of override methods (Tracker 1648834)
:arrow: Fixed Impossible to change copyrigth information in html footer (Tracker 1702094)
:arrow: Added support for UTF8 source files
:arrow: Fixed Parsing function in implementation section (Tracker 1635904)
:arrow: Fixed CHM files not generated in a specific folder
:arrow: Moved CSS file to a new resource folder
:arrow: Fixed Links section is always displayed as #UNDER_CONSTRUCTION# (Tracker 1672418)
:arrow: Fixed Parser exception with assembly attributes (Tracker 1649782)
:arrow: Updated JCL/JVCL package to JVCL330CompleteJCL198-Build2509
:arrow: Fixed Multiple variable declaration in one line not recognized
:arrow: Fixed a Memory Leak with TDOCClassesTree missing destructor
:arrow: Added Warn when "Included Files list" is empty (Tracker 1623150)
:arrow: Removed unused units (converters and BasicStats)
:arrow: Refactored Structure Sort using a Visitor
:arrow: Fixed Config file date changed even if not modified (Tracker 1604036)
:arrow: Added brazillian portuguese translations
:arrow: Fixed Parse Error with &variable syntax (Tracker 1589861)
:arrow: Updated visitor for DocTemplate
:arrow: Fixed Comments not included with different method declaration (Interface and Implementation) (Tracker 1337626)
:arrow: Fixed varargs keyword generate an exception (Tracker 1607892)
:arrow: Fixed Parser exception with tabs after final end (Tracker 1601763)
:arrow: Fixed Parser exception with the deprecated directive (Tracker 1581963)
:arrow: Added Class tree (text format) in the documentation
:arrow: Added Chinese translations (traditional and simplified)
:arrow: Fixed Exports in unit throw an exception (Tracker 1402652)
Quels sont les bugs connus du logiciel ?
*Les traductions ne sont pas à jour
Quelles sont les limitations connues du programme ?
*Les variables de classe ne peuvent être commentées que par un commentaire inline juste après la declaration
*Les évenements n'ont pas de description
*Seul l'Anglais est disponible pour le document généré
*Le TAG @see n'est pas supporté
Quelles seront les futures évolutions ?
*Generateur XML / XSLT
Merci pour cette nouvelle version.
Malheureusement j'ai plusieurs fois ce message lors du parsing de mon projet :
Exception EAccessViolation Access violation at address 004E29CA in module 'DelphiCodeToDoc.exe'. Read of address 00000000
La version 0.16 marchait par contre très bien, je vais rester avec elle en attendant.
Et encore merci pour ce super outil malgré tout.
Sovitec
Salut, j'aimerais avoir plus d'information sur ces problèmes. Peux-tu m'envoyer la fenêtre de log, et eventuellement, le fichier ou un morceau du fichier incriminé. Cela m'aidera à identifier puis corriger rapidement le problème. Sinon, sans informations ... c'est difficile !Citation:
Malheureusement j'ai plusieurs fois ce message lors du parsing de mon projet
Il y a eu bcq de changement dans l'architecture et le parser, mais jusqu'à maintenant, tout mes tests DUnit passent, donc ce doit être un nouveau problème.
ANN: DelphiCodeToDoc v0.18Beta disponible - Outil gratuit de generation de documentation pour Delphi
La dernière version de DelphiCodeToDoc (v0.18Beta) est disponible. Elle peut être téléchargée ici :
http://downloads.sourceforge.net/dep...exe_v0.18b.zip
-----------------------------------------------------------------
Quelles sont les nouveautés de cette version ?
Cette version v0.18Beta contient les modifications suivantes :
:arrow: Correction des 'packed record' non affichés dans la documentation (Tracker 1723230)
:arrow: Ajout du support des types de fonction (Tracker 1551120)
:arrow: Correction d'une exception du parser avec les types de fonction (Tracker 1719702, 1719213)
:arrow: Correction d'une exception avec les 'Variant record' ou UNION (Tracker 1719703)
Quels sont les bugs connus du logiciel ?
*Les traductions ne sont pas à jour
Quelles sont les limitations connues du programme ?
*Les variables de classe ne peuvent être commentées que par un commentaire inline juste après la declaration
*Les évenements n'ont pas de description
*Seul l'Anglais est disponible pour le document généré
*Le TAG @see n'est pas supporté
Quelles seront les futures évolutions ?
*Generateur XML / XSLT
bonjour,
quelques utilisateurs ont eu droit à des exceptions du parser sur la dernière version.
Ces deux problèmes sont :
1/ Parser Exception on {$ELSEIF} statement => voir http://sourceforge.net/tracker/index...81&atid=614255
2/ Exception with empty records => voir http://sourceforge.net/tracker/index...81&atid=614255
J'ai corrigé ces deux problèmes, une nouvelle version temporaire est disponible sous le numéro v0.18beta.1
DelphiCodeToDoc Executable
http://dephicodetodoc.cvs.sourceforg...athrev=v0_18b1
DCTD_cmd command line executable
http://dephicodetodoc.cvs.sourceforg...athrev=v0_18b1
Vous pouvez télécharger et copier ces fichiers dans votre répertoire de DelphiCodeToDoc. Rappelez-vous que :
* C'est une version non-officielle, partiellement testée et toujours en developpement.
* Pas de traductions embarquées dans l'EXEcutable.
* Si vous trouvez d'autres bugs, envoyez-moi un mail ou ouvrez un Tracker dans l'interface de SourceForge.
merci à tous pour vos encouragements et vos remontées de bugs. :roll:
TridenT
Bonjour
Je commence à utiliser DCTD pour mes sources même si je me suis interessé au produit pour d'autres raisons à l'origine.
Voilà ma demande :
En plus de commenter mes sources j'aimerais utiliser DCTD pour d'autres fonctionnalités :
=Documenter d'autres points de mon projet notamment les tables utilisées dans ma base de données.
=Gérer les versions...
Le but étant de générer un doument par fonctionnalités.
Quelqu'un a une idée ??
PS : j'ai déja posté qq chose de similaire dans le forum de SourceForge.
DCTD te permet de documenter le code, donc si les tables sont représentée dans le code des unités, alors oui.Citation:
Envoyé par philnext
C'est à dire ? Détailles ta demande.Citation:
Envoyé par philnext
Oui, j'ai aussi vu ton post sur le site de sourceforge !
Merci pour la réponse du coup je me lance dans les explications...
Aujourd'hui j'utilise DCTD pour générer la doc de mon code et tout va bien.
Mais j'ai quelques autres besoins :
1/ Fournir aussi une doc à des partenaires qui vont travailler sur la base de données que je crée.
Pour cela j'aimerais créer une autre doc que celle de mon soft mais toujours à partir de mon source. Bien sûr je n'ai pas besoin que le parser aille vérifier la structure de la base mais simplement que je puisse avoir des tags particuliers pour ce besoin.
2/ Gérer les versions. Bon là le but est simplement de générer la doc. des évolutions de versions à jour. Chaque modification de code importante est documentée par un tag avec le N° de version, le type de modif (+ : fonction, - correctif, = autre) et le descriptif de la modif.
La doc générée fait juste ( !) une compilation des modif et classe tout par version.
Bon ce sont 2 exemples mais, je pense, significatifs de mes besoins.
Si tu veux un coup de main sur le soft, je peux t'aider, bien qu'un peu débordé ces temps ci.
Bon courage !