Envoyé par
pepito62
Vous me confirmez, il n'est pas possible de gérer des groupes de projet avec delphicodetodoc ?
Je n'ai jamais suffisamment approfondi pour le dire !
Lors de son utilisation, j'avais des projets séparés (de très gros EXE) et la quantité de documentation ne couvrait que mes modules (à peine 10% du code), le reste développé par plusieurs développeurs n'avait pas vraiment de norme à ce sujet
Il me semble qu'un collègue de l'époque, avait intégré cela au FinalBuilder de ses projets.
Envoyé par
pepito62
Envoyé par
ShaiLeTroll
Je te confirme, qu'il y a bcp de doublons lorsque les projets utilisent des unités communes, et parfois des trous si ils ne trouvent pas les dépendances
Généralement les générateurs parcourent les fichiers sources (*.pas) et décrivent les objets/méthodes...
En fait, actuellement, je suis conforme avec la syntaxe Doxygen (BCB), il fonctionne à partir d'un répertoire et non à partir d'un projet C++Builder !
Ce qui est tout à fait logique puisque Doxygen est général au C++, il ne peut pas se spécialiser pour tel ou tel environnement !
DelphiToDoc fonctionne de la même façon et sait analyser un DPR mais pas les DPROJ si j'ai bien compris, n'ayant pas dépasse D7 avec DTD, je n'en sais pas plus
Mais si l'on part du répertoire racine, on se retrouve avec un monstre sur plusieurs projets qui durent une plombe à générer, donc il est préférable de découper
Si tu veux séparer, il faut partir sur le dossier regroupant les sources d'un projet, selon les outils, tu peux mettre des références sur des documentations externes (utile si tu as une lib commune)
Sauf que si tu as un programme écrit avec la version N de la lib et un autre en N+1, si tu changes la documentation externe de la lib en N+1, tes références de la version N ne seront peut-être plus conforme... encore un soucis
Idem, si tu as un projet qui utilise des unités d'un autre, je pense par exemple à une DLL ou le fichier des déclarations de types est commun à la DLL et aux modules appelant
Cela peut devenir fort compliquer de gérer les dépendances
Ensuite tout dépend comment tes sources sont organisées, actuellement, mon responsable a choisi de mettre tous les fichier cbproj dans le même répertoire, puis il y a tout un découpage en sous-dossier, les projets utilisant les unités d'autres projets, ... un peu confus tout ça à mon gout !
1 |
0 |
Documenter son code Delphi
Qu'utilisez-vous ?
