.NET // vs /// Kommentare Konvention

Question

Ich checke gerade F #, also Entschuldigung, wenn das eine dumme Frage ist, aber in der VS2008 F # CTP 1.9.6.2 'Tutorial' Projekt, sowohl // und /// werden für das Kommentieren von Code verwendet.

Gibt es einen funktionalen Unterschied zwischen den zwei Schrägstrich vs drei Schrägstrich kommentieren, oder ist es Konvention (wie es im Tutorial-Code erscheint), eine Funktion mit /// kommentieren und // für alles andere verwenden?

Answer 1

Die Verwendung von drei Schrägstrichen (///) ist eine C# -Konvention für XML Documentation Comments, die auch von F # übernommen wird.

Answer 2

/// ist für Dokumentationskommentare. VS wird es beim Generieren von Intellisense-Informationen verwenden.

Answer 3

Es ist vergleichbar mit /* comment */ vs /** documented comment */ in Java.

Letzteres funktioniert genauso, wird aber von Dokumentationssoftware auch als Entwicklerdokumentation erkannt - nicht nur als Hinweis.