Pour une grosse application, quand le main
est dans une classe, ça peut être bien (et même nécessaire), mais sinon je ne vois pas trop l'utilité : Vala mets automatiquement les méthodes hors des classes/interfaces en static
et le public
ne sert à rien, puisque cette méthode n'est censée être appelée qu'au lancement du programme, et pas par d'autres méthodes. Et puis pour un tuto qui se veut accessible aux débutants, c'est bien je pense de ne pas balancer 42 mot-clés dès le début, sans vraiment comprendre à quoi ils servent.
Et pour les commentaires Valadoc, il ont la forme suivante (je suis allé vérifier ).
1 2 3 4 5 6 | /** * Le point d'entrée du programme */ void main () { // blabla } |
Mais les commentaires multilignes ne servent pas que pour la doc, on peut en mettre où on veut. Par contre je ferai sûrement une annexe sur comment bien documenter son coder, en suivant le format de Valadoc.