Ein Kommentarblock ist eine Folgen von Kommentarzeilen, die nicht durch eine Leerzeile getrennt sind.
Das ist ein Kommentarblock:
// This is the first sentence.
// This is the second,
// and this the third
Das folgende Beispiel zeigt zwei Kommentarblöcke, da die Kommentarblöcke durch eine leere Zeile getrennt sind:
// This is the first sentence.
// This is the second,
// and this the third
Hier erkennt Doc-O-Matic nur den Kommentarblock, der am nächsten zum dokumentierten Symbol ist. Der andere Kommentarblock wird nicht extrahiert. Das Beispiel oben resultiert in dem Dokumentationstext:
This is the second, and this the third.
Doc-O-Matic verbindet den gesamten Text in einem Kommentarblock zu einem großen Block. Zum Beispiel
// This is the first sentence.
// This is the second,
// and this the third
wird zum Dokumentationstext
This is the first sentence. This is the second, and this the third.
