Quand je code en C je fais trois types de fichiers :
un .h un .c et un .d pour "documentation" qui a le même principe que
les .c sauf qu'au lieu d'implémenter les prototypes il explique les spécifications, raison d'être de la fonction et quelques petits exemples.
Comme ça quand je navigue dans le .c j'ai pas des millions de commentaires qui embrouillent le bazar, et quand je veux savoir ce que fait une fonction, je dois pas bouger jusqu'a sa définition.
Bon maintenant il me reste à faire un plugin vim qui va chercher automatiquement la doc de la fonction et ça sera le pied.
# Moi ce que je fais ...
Posté par chack . En réponse au journal à quand un code commenté ?. Évalué à 4.
un .h un .c et un .d pour "documentation" qui a le même principe que
les .c sauf qu'au lieu d'implémenter les prototypes il explique les spécifications, raison d'être de la fonction et quelques petits exemples.
Comme ça quand je navigue dans le .c j'ai pas des millions de commentaires qui embrouillent le bazar, et quand je veux savoir ce que fait une fonction, je dois pas bouger jusqu'a sa définition.
Bon maintenant il me reste à faire un plugin vim qui va chercher automatiquement la doc de la fonction et ça sera le pied.