Inscrivez-vous gratuitement
pour pouvoir participer, suivre les réponses en temps réel, voter pour les messages, poser vos propres questions et recevoir la newsletter
Template de commentaires avec GExperts
Nouveau !
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
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 :
Correction d'une assertion avec trop de neuds enfants (Tracker 1510470)
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.
Tutoriels Delphi Win32/Delphi .NET/Oracle/PowerShell - FAQ Delphi - FAQ Delphi .NET
Beatus, qui prodest, quibus potest.
J'aime beaucoup ces nouvelles fonctionnalités:
EtEnvoyé par trident_job
pour les VMTOFFSET
sjrd, ancien rédacteur/modérateur Delphi.
Auteur de Scala.js, le compilateur de Scala vers JavaScript, et directeur technique du Scala Center à l'EPFL.
Découvrez Mes tutoriels.
Oui, fort sympathiques ces fonctionnalités, j'espère qu'il y en aura d'autres du même typeJ'aime beaucoup ces nouvelles fonctionnalités
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 :%ENDPARAMLIST%@return %RESULT% ResultDescription
Avec cette macro il n'y a plus d'excuse pour ne pas document son code.%ENDPARAMLIST%@return ResultDescription
Bravo.
Tutoriels Delphi Win32/Delphi .NET/Oracle/PowerShell - FAQ Delphi - FAQ Delphi .NET
Beatus, qui prodest, quibus potest.
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 ...).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.
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.
Tutoriels Delphi Win32/Delphi .NET/Oracle/PowerShell - FAQ Delphi - FAQ Delphi .NET
Beatus, qui prodest, quibus potest.
Preview v0.17b (future v1.0 beta 1)
bonjour aux lecteurs de ce post.
Après un temps d'absence
* 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.
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
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
sjrd, ancien rédacteur/modérateur Delphi.
Auteur de Scala.js, le compilateur de Scala vers JavaScript, et directeur technique du Scala Center à l'EPFL.
Découvrez Mes tutoriels.
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
Tu sais bien que je suis fan de ton prog
sjrd, ancien rédacteur/modérateur Delphi.
Auteur de Scala.js, le compilateur de Scala vers JavaScript, et directeur technique du Scala Center à l'EPFL.
Découvrez Mes tutoriels.
ANN: DelphiCodeToDoc v0.17Beta disponible
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 :
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 !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.
DelphiCodeToDoc v0.18Beta
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 :
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
v0.18b1 HOTFIX
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.
TridenT
Demande de fonction (ou d'explication)
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.
C'est à dire ? Détailles ta demande.
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 !
Répondre avec citation
Partager