Zitat von
Olli:
Zitat von
shmia:
In .Net Visual Studio werden Kommentare mit /// zum Platzhalter für eingefalteten Code.
Igitt. Das kollidiert ja dann direkt mit einschlägigen Doc-Tools.
Du hast doch gar keine Ahnung.
Wenn man /// über eine Mthode tippt, bekommt man automatisch den Rumpf für die
XML Doku, man hat sogar Code completion für
XML Tags und ein anderes Highlighting als normale Kommentare.
Da das etwas verbose aussieht, kann man sie zusammenklappen.
Das schöne ist, dass man nun nicht nur eine Doku daraus rezeugen kann, sondern dass du diese Infos auch im Code als toolTip siehst.
C# in D2005 stellt das als normale Kommentare da, die man nicht einklappen kann -> ziemlich unübersichtlich.
@Topic
Wenn man viele lange EMthoden hat, ist das oft ein Zeichen dafür, dass man das noch auf eine weitere Klasse aufteilen kann. Ich selbst benutze fast nie Kommentare innerhalb von Methoden. Höchstens an heiklen Punkten...
<summary> und <remarks> reichen mir zur Beschreibung eigentlich aus.