Discussion :

[BeanzMaster]

Bonjour à tous,

je suis en pleine réflexion pour ce qui touche à la création "semi-automatique" d'une documentation pour un code. Je sais qu'il existe plusieurs outils et donc forcément plusieurs façons de commenter son code.
Je vous pose donc la question quel est l'utilitaire et la manière de commenter ses lignes de codes me suggérez vous, ou que vous utiliser ?

Utilisez-vous, plus des balises avec @TAG ou <TAG> et /// ? j'ai un peu de mal à savoir quel est le meilleur utilitaire ?

J'ai déja essayé pasdoc et lazarus. Mais les limites sont vite atteintes.

Après il y a les payants, mais arf, pas tout de suite, pour commencer.

Sinon reste les anciens comme "DelphiCodetoDoc" que je n'ai jamais utilisé.

Je cherche, une méthode, un outils, pour générer un code html de préférence. Qui me permettrai de pouvoir personnaliser un minimum cette documentation.

Quand je parle de personnalisation, j'aimerai pouvoir par exemple une page externe, changer les styles etc......sans être obliger
d'aller mettre les mains dans les sources HTML/CSS . (juste un petit peu, cela ne me pose pas de problèmes) ? Pasdoc atteint ici ses limites.

Merci d'avance pour vos conseils.

Bonne fin de soirée.

[SergioMaster]

Bonsoir,

J'ai fini par arrêter mon choix sur PasDoc seul open source qui propose déjà de une sortie de la documentation en français, avant j'en ai tester d'autres (open source) mais galère pour les traductions (dommage il y en avait avec raccourcis intéressants) j'ai tester quelques payants mais pas de sortie en français
Il m'a fallu mâtiner PasDoc avec des raccourcis créés via GExpert et je voulais aussi pallier au truc qui m'énerve : les commentaires qui sont au dessus de la déclaration de la procédure ou fonction et qui peuvent se déplacer au dessus d'un autre lors de l'ajout d'un nouvel évènement