Version imprimable
Il existe deja un TAG "générique" qui permet de documenter l'interieur des fonctions, pour récuperer un algorithme par exemple.Citation:
Envoyé par philnext
Voir ici la description du TAG @comment :
http://dephicodetodoc.sourceforge.ne...dedComment.htm
Cela répond-il à ton besoin ?
La le mieux est que tu m'écrives un petit bout de programme, une unité de quelques lignes, avec exactement ce que tu voudrais avoir comme TAG.Citation:
Envoyé par philnext
Je te dirais si c'est possible !
Ok je pense que tu verras mieux avec un exemple (je m'y colle...).
Disons qu'en résumé le but c'est d'avoir, à partir d'un même source, plusieurs sorties de fichiers différentes.
Allez j'essaye de formaliser ma demande d'ici qq jours.
Alors, pas de nouvelles - bonne nouvelle ? :roll:Citation:
Envoyé par philnext
Bonjour Trident et bravo pour ce Javadoc version Delphi !
Nous sommes en train d’intégrer votre logiciel dans un simili processus de « Continuous Integration » à la sauce Java. Toutes les nuits on récupère les sources des codeurs depuis le dépôt svn, on créé dynamiquement le fichier xml de configuration, et on lance en ligne de commande DelphiCodeToDoc pour générer la doc en HTML, accessible depuis un serveur web interne.
Nous constatons cependant 2 problèmes :
1. Il semble qu’il y ait un bug dès lors qu’on référence plusieurs sources .DPR dans les balises <FilesIncludeList> : la génération se plante au 2ème fichier .DPR, avec pour motif l’incapacité à trouver les unités du .DPR. Il semble qu’il y ait confusion entre le chemin d’accès du 1er .DPR correctement parsé et le 2d ?
2. Ce point n’est pas un bug, et je comprends qu’il puisse être long à rajouter Cela concerne les indicateurs qualités qui n’apparaissent pas dans le cas d’un <OutputFormat> HTML. Peut-on imaginer en disposer un jour ? (où dois-je arriver à la conclusion qu’il me faut nous y coller !)
Merci encore,
Mc/
Je suis intéressé de savoir quel outil d'intégration continue vous utilisez (j'utilise CruiseControl.NET).Citation:
Envoyé par mctahiti
Chaque project de DelphiCodeToDoc doit avoir un seul DPR ou une liste de fichiers et / ou de répertoires (jokers possible 'machin*').Citation:
bug dès lors qu’on référence plusieurs sources .DPR dans les balises <FilesIncludeList>
Si vous voulez documenter plusieurs projets, il faut créer plusieurs fichiers de configuration. plusieurs documentations seront alors générées.
Il est effectivement prévu des ressortir les statistiques détaillés en format xml. Cela repondrait-il à votre attente ?Citation:
indicateurs qualités qui n’apparaissent pas dans le cas d’un <OutputFormat> HTML.
Pour l'instant je parle de "simili intégration continue" car nous n'avons intégré que la production journalière de notre doc avec suivi des indicateurs et fixation des objectifs.
Nous avons écrit tout cela en script batch "Cygwin" que nous portons sur un moteur (commercial) d'ordonnanceur. Mais rien de bien sorcier, cela se résume à automatiser de l'enchainement de commandes.
L'étape qui suit (début d'année 2008 peut-être) sera l'intégration des tests unitaires (DUnit) toujours en journaliers, avec production des indicateurs notamment de régression. La mécanique sera toujours la même : récupération des codes sources, compilation auto et parsing des résultats.
J'ai repéré CruiseControl avec sa possibilité d'intégration dans Delphi, mais je n'ai pas testé. Mais comme la mode est à Ruby maintenant, je me demandais si on allait pas utiliser ce truc puisque Borland propose des lib Delphi (compilation etc.).
Bref, pour le moment on n'en n'est qu'au début du processus.
Concernant DelphiCodeToDoc :
- Oui les statistiques détaillés en format xml c'est impeccable ! on pourra du coup facilement historiser en base pour faire de jolies courbes :)
- Pour l'unique .DPR c'est dommage, mais je comprends maintenant la logique.. je vais voir si on ne peut pas contourner cela par un artifice
- Dernière chose (s'il faut des idées !) : il serait intéressant d'avoir un recueille des tags "TODO" (activable ou non dans le fichier de conf XML, histoire de ne pas l'imposer) qui se présenterait de la forme :
Nom du fichier / Nom de la classe / Nom du membre
en cliquant sur le membre, on aurait ce qui existe déjà
en cliquant sur la classe, on aurait un tableau qui donnerait pour toute cette classe : le nom des membres / les tags TODO
en cliquant sur le nom du fichier on aurait un tableau qui donnerait pour tout le fichier : le nom des classes / le nom des membres / les tags TODO
et on pourrait imaginer une vue "de la racine" qui ferait la même chose mais sur tous les fichiers...
(je ne sais pas si c'est bien clair, mais je peux faire une petite doc pour ça!)
A bientôt,
Mc/
Pour que je comprenne bien le problème, peux-tu expliquer pourquoi il te faut une seule documentation pour plusieurs fichiers DPR ?Citation:
Envoyé par mctahiti
Je crois comprendre l'idée : un peu ce que l'on trouve dans l'interface de Delphi avec la gestion des TODO ? mais avec les TAG JavaDoc @todo, et à inclure dans la doc finale. Peux-tu m'envoyer un petit bout de fichier html du résultat attendu, pour confirmer cela ?Citation:
avoir un recueille des tags "TODO"
Je viens d'envoyer le petit bout de fichier html par email.
Concernant les DPR, l'objectif étant de n'avoir qu'un seul point d'entrée pour l'ensemble de nos objets métiers et projets, d'où cette nécessite de référencer plusieurs DPR.
Ce que nous allons à priori faire maintenant c'est autant de point d'entrée qu'il existe de projet + 1 point d'entrée pour nos objets métiers (qui sont utilisés dans tous nos projets).
Tient, peut-être un bug dans DCTD_cmd.exe :
je traite un projet, et il me donne une erreur "Exception TEParseError Unexpected token, expected "BEGIN".
Jusque là c'est normal, sauf que le code d'erreur de retour est 0, ce qui ne me permet pas de monter une alerte au développeur pour lui dire de revoir son dépôt.
Les autres erreurs renvoient bien 1, sauf celle là...
Autre chose, serait-il possible que les erreurs qui renvoient 1 en ligne de commande ne lève pas d'exception (objectif : éviter de bidouiller la base de registre pour ne pas avoir la boite de dialogue Windows de traitement des exceptions) ?
Merci,
Mc/
PS: nous avons modifier notre production de doc dans la logique DelphiCodeToDoc avec génération dynamique d'un fichier de conf XML par projet... la seule chose que ça rajoute, c'est la création d'une page HTML de récap de tous les projets, avec analyse du code d'erreur retourné pour indiquer si tout s'est bien passé ou pas...
je n'ai rien recu. voici mon adresse mailCitation:
Envoyé par mctahiti
trident_job@hotmail.com
oui, c'est bien un bug. J'ai ouvert un tracker ici :Citation:
Envoyé par mctahiti
http://sourceforge.net/tracker/index...81&atid=614255
merci pour l'info !
ANN: DelphiCodeToDoc v0.19Beta disponible - Outil gratuit de generation de documentation pour Delphi
La dernière version de DelphiCodeToDoc (v0.19Beta) est disponible. Elle peut être téléchargée ici :
http://downloads.sourceforge.net/dep...exe_v0.19b.zip
DelphiCodeToDoc est un outils gratuit de génération de documentation pour Delphi, distribué sous la licence GNU - GPL. Il utilise les informations contenu dans le code source, comme les symboles et les commentaires formattés, pour produire une documentation précise de votre code ou de votre composant.
-----------------------------------------------------------------
Quelles sont les nouveautés de cette version ?
Cette version v0.19Beta contient les modifications suivantes :
:arrow: Correction du code retour de l'outil en ligne de commande lorsque le process echoue (Tracker 1830301)
:arrow: Refactoring des générateurs de document (générique + HTML)
:arrow: Correction d'une exception lors de l'utilisation de la visibilité AUTOMATED (Tracker 1736944)
:arrow: Correction des commentaires hérités pas toujours copiés de l'ancètre
:arrow: Correction des proprietés affichées à tor d'être documentées (Tracker 1735145)
:arrow: Correction d'une exception avec l'instruction {$ELSEIF} (Tracker 1732710)
:arrow: Correction d'une exception avec un record vide comme variable locale (Tracker 1732652)
:arrow: L'analyseur de commentaire ignorera maintenant les variables locales des fonctions
Quels sont les bugs connus du logiciel ?
*Generiques non-supportés (Tracker 1828114)
*Differences non justifiés entre champs et variables de classe
*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 ?
* Fix critical and major bugs
* Refactor generator code to improve reuse and subclassing (add another generator)
* Improve links between items in html documentation (Fields / assessors / class / sub-class links)
* Add an application configuration file (different from the project's configuration file)
Re-bonjour à tous,
La nouvelle version marche bien en effet, elle corrige les quelques bugs que j'avais notamment rencontré, reste plus qu'à espérer que notre développeur favori arrive à faire avancer les autres items :-)
A ce propos, serait-il possible d'avoir le dépôt de source en SVN plutôt que CVS ? Ca fait en effet un bail que je n'ai plus CVS installé sur mon poste, et je voulais récupérer le code source pour voir un peu comment c'était écrit (-> ne pas faire le raccourci "pour participer au développement" hein ! je voudrais juste jeter un oeil, pour qui sait, peut-être, un jour, quand j'aurais le temps, apporter une éventuelle contribution... remarquez tous les conditionnels que j'utilise !)
Merci, et bon courage pour la suite, on apprécie tous ces nouvelles versions!
Mc/
Je suis en train de faire la conversion du dépot CVS -> SVN, ca devrait venir d'ici le debut de l'année. Tu as eu une vision :king:Citation:
Envoyé par mctahiti
Je note donc que tu veux fortement contribuer au projet, très bien, je te donne les droits et je t'assignes tout de suite quelques Trackers à corriger ... ;o)
Je plaisante ... je te tiens au courant dès que SVN est operationnel, et si tu as des remarques / commentaires, critiques sur le code, je suis toujours preneur ! ;)
TridenT
Tient, bug trouvé ce jour (et posté sous le track 1855474) :
- le tag quality ne tient pas compte de la configuration mise dans "output filtering category", mais par contre la documentation en tient compte..
Ca serait d'ailleurs intéressant de séparer ce qu'on veut voir dans la doc (l'actuel "output filtering category" qui fonctionne bien) de ce que l'on veut suivre en terme d'indicateur qualité (une nouvelle section à créer, comme "tag quality filtering category").
A bientôt,
Mc/
Oui, je partage ton point de vue. Je vais travailler sur ce sujet dès que possible. J'aimerai aussi finir l'export des statistiques au format XML, ce qui servira aussi bcq !Citation:
Envoyé par mctahiti
Encore merci pour tes idées 8-)
ANN: DelphiCodeToDoc v0.20Beta disponible - Outil gratuit de generation de documentation pour Delphi
La dernière version de DelphiCodeToDoc (v0.20Beta) est disponible. Elle peut être téléchargée ici :
http://downloads.sourceforge.net/dep...exe_v0.20b.zip
DelphiCodeToDoc est un outils gratuit de génération de documentation pour Delphi, distribué sous la licence GNU - GPL. Il utilise les informations contenu dans le code source, comme les symboles et les commentaires formattés, pour produire une documentation précise de votre code ou de votre composant.
-----------------------------------------------------------------
Quelles sont les nouveautés de cette version ?
Cette version v0.20Beta contient les modifications suivantes :
:arrow: Correction des "generics" qui crashent le parser (Tracker 1828114)
:arrow: Correction du double slash dans le chemin de sortie de la documentation
:arrow: Correction des commentaires après le END final qui génèrent une exception (Tracker 1870254)
:arrow: Correction des records dans une section VAR qui génèrent une exception (Tracker 1870547)
:arrow: Correction d'une exception avec les pointeur de fonctions constants (Tracker 1802084)
:arrow: Correction de résumé (summary) ajouté çà chaque construction du projet (Tracker 1835631)
:arrow: Correction de la génération vide (pas de fichiers) avec l'expert par défaut (Tracker 1867938)
Quels sont les bugs connus du logiciel ?
*Differences non justifiés entre champs et variables de classe
*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 ?
* Fix critical and major bugs
* Improve links between items in html documentation (Fields / assessors / class / sub-class links)
* Add an application configuration file (different from the project's configuration file)
iaorana everybody,
everybody iaorana,
J'ai essayé de "checkouter" le nouveau dépôt SVN de Delphicodetodoc et ça me donne un :
Error: REPORT of '/svnroot/dephicodetodoc/!svn/vcc/default': 400 Bad Request (http://dephicodetodoc.svn.sourceforge.net)
Suis-je le seul ?
Merci!
Mc/
Essaye avec ce chemin, ca ira mieux !Citation:
Envoyé par mctahiti
http://dephicodetodoc.svn.sourceforg...elphiCodeToDoc
Fa’itoito :P
Beuh !
Error: REPORT request failed on '/svnroot/dephicodetodoc/!svn/vcc/default'
Error: REPORT of '/svnroot/dephicodetodoc/!svn/vcc/default': 400 Bad Request (http://dephicodetodoc.svn.sourceforge.net)
J'ai essayé sur 2 PCs différents, et même au boulot, pas de problème.
Je n'ai pas de paramétrage spécifique, voici la copie d'écran avant de faire OK.
Si cela ne fonctionne toujours pas, peux-tu m'envoyer qcq infos sur ta config et ton SVN.
Alors, toujours des problèmes d'accès à SVN ?Citation:
Envoyé par trident_job
Salut Trident,
Je n'avais pas pu me replonger dedans avant ce jour. En fait ça vient de la connexion HTTP, et le serveur distant qui me jete sur la requète PROPFIND (erreur 405). Çà vient à priori du http://, car quand je passe en https:// ça passe...
Bizarre... Peut-être Sourceforge qui ne livre qu'en https ? En tous les cas ça y est, c'est en train de monter là...
Merci !
Mc/
En effet, le Subversion de SourceForge ne passe qu'en https. C'est indiqué dans leur documentation.
Pour ma part, j'arrive à faire un checkout (anonyme) en http, quelquesoit le projet (DelphiCodeToDoc et autres).Citation:
En effet, le Subversion de SourceForge ne passe qu'en https. C'est indiqué dans leur documentation.
Ce doit être le commit qui doit être fait en https non ?
Si tu trouves le lien vers la doc de sf.net, ça m'interresse.
Ben tu vas dans un projet -> Code -> Instructions sur SVN. Tu tombes là-dessus :
http://alexandria.wiki.sourceforge.n...or+Source+Code
Bonjour,
J'utilise DCTD depuis quelques jours et je suis loin d'avoir exploité toutes ses possibilités (il me semble) mais je me demandais s'il existait un moyen de visualiser sous forme graphique les appels entre fonction à la manière de Doxigen (mais j'ai des doutes car je n'ai rien lu le laissant supposé).
Merci
Non, pas encore, c'est prévu, avec des graphes aussi pour les classes, mais pas encore !Citation:
Envoyé par Bzc.Bzh
Si je trouve un bonne âme pour l'aider :P
Ok, merci pour cette info. Et merci pour cet outil bien pratique:king:Citation:
Envoyé par trident_job
Bonjour,
Merci pour ce programme que je vient de découvrir et qui va m'etre bien utile.
Par contre j'ai un petit soucis au niveau de la génération automatique de commentaire. En effet, j'ai installé Gexpert puis inclus ton fichier xml comme expliqué dans la vidéo, mais la macro CTRL + P ne fonctionne pas chez moi, contrairement à la macro CTRL + U qui fonctionne bien.
Si j'appuie deux fois de suite sur CTRL + P, le caractere suivant s'affiche
Est ce que quelqu'un à une idée ?Citation:
Merci
Edit : j'ai remplacer la macro CTRL + P par CTRL + * est ca marche. Mais ma question tient toujours, je cherche a comprendre pourquoi ca ne marcher pas. Merci
J'ai effectivement le même problème avec une nouvelle installation de Delphi2007. Le raccourci doit être utilisé pour autre chose, je ne sais pas quoi.
Ca marche avec certaine touche, et d'autre non.
Je ne sais pas qui utilise le CTRL+P ... je ne sais même pas si c'est Delphi2007 qui l'utilise (windows ?).
TridenT
en tous cas, c'est pas l'imprimante qui est appelé par ce racourci.
Heuresement :mouarf:
Bonjour à tous,
L'utilisation des commentaires DCTD doit obligatoirement se faire avant la déclaration de la méthode et/ou propriété à documenter.
Or certains générateurs de codes (l'excellent DAO InstantObject par exemple) positionnent leur code immédiatement avant la déclaration suivante par ordre alphabétique.
Exemple. Mon code d'origine :
Au travers du framework je rajoute une propriété "Remote", qui va donc automatiquement me créer un GetRemote et un SetRemote. Ainsi je me retrouve avec :Citation:
{*
Statut du ticket
}
function TTicket.GetStatus: string;
begin
Result := _Status.Value;
end;
L'inverse est vrai : si je supprime une propriété depuis le framework, le code est supprimé, mais pas le commentaire.Citation:
{*
Statut du ticket
}
function TTicket.GetRemote: string;
begin
Result := _Remote.Value;
end;
function TTicket.GetStatus: string;
begin
Result := _Status.Value;
end;
J'ai fais des essais en positionnant les commentaires entre la déclaration et le begin. Là, tout fonctionne bien : le commentaire reste dans la bonne section, et en cas de suppression, l'ensemble est bien supprimé. Voilà ce que ça donne :
Le 2d intérêt que j'y vois est que si on utilise les fonctions graphiques de l'IDE de dégroupement / regroupement, cela évite les surcharges de commentaires.Citation:
function TTicket.GetRemote: string;
begin
Result := _Remote.Value;
end;
function TTicket.GetStatus: string;
{*
Statut du ticket
}
begin
Result := _Status.Value;
end;
Seul soucis : DCTD "ne voit pas" les commentaires ainsi positionnés.
Ma question est simple : est-ce envisageable simplement (avec ou sans option) ?
A bientôt,
Mc/
Oui, c'est une demande fréquente :roll: que je prendrais en compte dès que possible. Effectivement, cela sera compatible avec l'IDE de Delphi !
Ce sera bien sûr une option de DCTD, comme cela, chacun choisira sa façon de faire.
par contre, je ne peux pas donner de date, mon temps pour developper ces fonctionnalité et corriger des bugs est assez réduit ces derniers temps. :(
ANN: DelphiCodeToDoc v0.21Beta disponible - Outil gratuit de generation de documentation pour Delphi
La dernière version de DelphiCodeToDoc (v0.21Beta) est disponible. Elle peut être téléchargée ici :
http://downloads.sourceforge.net/dep...exe_v0.21b.zip
DelphiCodeToDoc est un outil gratuit de génération de documentation pour Delphi, distribué sous la licence GNU - GPL. Il utilise les informations contenues dans le code source, comme les symboles et les commentaires formatés, pour produire une documentation précise de votre code ou de votre composant.
-----------------------------------------------------------------
Quelles sont les nouveautés de cette version ?
Cette version v0.21Beta contient les modifications suivantes :
:arrow: Correction de l'option AllowHtmlInDescription inversée
:arrow: L'application est maintenant complètement unicode - gestion des chaines unicode de Delphi2009 (Tracker 1055059)
:arrow: Ajout du support des méthodes anonymes de Delphi2009
:arrow: Ajout d'un fichier de configuration de DCTD pour sauvegarder la langue utilisée (Tracker 1680457)
:arrow: Corrections de divers crash du parser (out keyword, unicode, Empty class var, offset keyword)
:arrow: Mise à jour du html produit pour être conforme XHTML 1.0 Transitional
:arrow: Correction des chemins relatifs (dans le fichier projet) qui ne fonctionnaient pas en ligne de commande (Tracker 2272357)
:arrow: Ajout d'une option pour utiliser un CSS personnel au lieu de celui fourni en standard (Tracker 875929)
Quels sont les bugs connus du logiciel ?
:arrow: Différences non justifiées entre champs et variables de classe
:arrow: Les traductions ne sont pas à jour
Quelles sont les limitations connues du programme ?
:arrow: Les variables de classe ne peuvent être commentées que par un commentaire inline juste après la déclaration
:arrow: Les événements n'ont pas de description
:arrow: Seul l'Anglais est disponible pour le document généré
:arrow: Le TAG @see n'est pas supporté
Quelles seront les futures évolutions ?
:arrow: Fix critical and major bugs
Pour répondre à mctahiti et pour tous ceux qui sont interressés :
Une nouvelle version v0.21beta.1 est disponible en test. Cette version supporte les commentaires écrits après la déclaration de la procédure (entre procedure et begin).
exemple:
Le lien de téléchargement (vers la dernière version de test) ici :Code:
2
3
4
5
6
7
8
9
10
11
12
13
14
15
http://trident.job.free.fr/delphicod...iCodeToDoc.zip
bon, j'ai travailler à mort ce soir sur cette fonctionnalité, je vais me coucher :mouarf:
hiiyaa ! voilà un super cadeau de nouvelle année !
un grand merci à trident pour tous ces efforts au bénéfice de la communauté...
je m'en vais tester cette béta et la faire tourner sur nos codes InstantObjects (car c'était bien là que ça posait le plus de problèmes - pour tous ceux qui ne connaissent pas encore ce DAO, allez sur www.instantobjects.org et arrêtez définitivement l'écriture de requète SQL au profit d'un monde 100% objet - une requète complexe que vous mettiez 10mns à écrire auparavant se réduira à 30sec avec cet ORM)
(et d'ici 1 mois ou 2 je devrais aussi avoir une belle annonce à faire pour la communauté Delphi open-source)
à bientôt,
Mc/
Trident est-ce que je peux me permettre de te demander le binaire de ta version en ligne de commande ? Ou bien si tu as déjà posté tes modifications sur le SVN je peux aussi le récupérer et le compiler...
Effectivement, il faut que j'ajoute la ligne de commande dans le dailybuild aussi.
Je viens de la mettre à jour !
http://trident.job.free.fr/delphicod...iCodeToDoc.zip
8-)
Merci à vous tous, visiteurs/membres/moderateurs de developpez.net pour votre soutient et vos messages/idées/tests/bugs et coups de gueule !
ANN: DelphiCodeToDoc v0.22Beta disponible - Outil gratuit de generation de documentation pour Delphi
La dernière version de DelphiCodeToDoc (v0.22Beta) est disponible. Elle peut être téléchargée ici :
http://downloads.sourceforge.net/dep...exe_v0.22b.zip
DelphiCodeToDoc est un outils gratuit de génération de documentation pour Delphi, distribué sous la licence GNU - GPL. Il utilise les informations contenu dans le code source, comme les symboles et les commentaires formattés, pour produire une documentation précise de votre code ou de votre composant.
-----------------------------------------------------------------
Quelles sont les nouveautés de cette version ?
Cette version v0.22Beta contient les modifications suivantes :
:arrow: Ajout de la reconnaissance des commentaires entre la déclaration de la procédure et le BEGIN
:arrow: Modification du html généré maintenant au format UTF8
:arrow: Modification du parser pour analyser les spécificités du freepascal (exposant **, operator ...)
:arrow: Correction de l'execution de HHC qui retournait des caractères étranges
:arrow: Correction de bugs (Tracker 2488024, 2487028)
Quels sont les bugs connus du logiciel ?
*Differences non justifiés entre champs et variables de classe
*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 ?
* Fix critical and major bugs