Es gibt drei Möglichkeiten Kommentare mit dem Editor zu schreiben: Sie können:
Text zu bestehenden Kommentaren hinzufügen.
Einen neuen Kommentar für undokumentierte Symbole anlegen.
Einen Kommentar an einer anderen Stelle speichern.
Sie können die Kommentare zur Deklaration, zur Implementierung (nur wenn es sich um eine Methode oder Funktion handelt, von der Doc-O-Matic weiß, wo sie implementiert sind) oder in einer DTX-Datei speichern. DTX-Dateien sind eine spezielle Art von ASCII-Dateien, die Doc-O-Matic verwendet, um damit Kommentare außerhalb des Sourcecodes zu speichern.
Um ein undokumentiertes Symbol zu dokumentieren
Wählen Sie im Contents Managerdas Symbol aus, das Sie dokumentieren möchten.
Klicken Sie auf der Registerkarte Managen, in der Gruppe Create Documentation auf Documentation .
Klicken Sie Empty Topic , um den Kommentar wieder zu löschen.
Um das Thema zu speichern
Klicken Sie auf Save .
Wählen Sie im Dialogfeld Topic Location die Stelle aus, wo Sie den Kommentar speichern möchten (die Deklaration, die Implementierung (nur wenn es sich um eine Methode oder Funktion handelt, von der Doc-O-Matic weiß, wo sie implementiert sind) oder eine DTX-Datei).
Um das Thema in einer DTX-Datei zu speichern
Klicken Sie im Dialogfeld Select Topic Location auf Select Otheraus.
Wählen Sie im Dialogfeld Select DTXdas Verzeichnis aus, in dem Sie die DTX-Datei speichern möchten.
Geben Sie einen Dateinamen ein.
Um einen Kommentar an einer anderen Stelle hinzuzufügen
Wählen Sie das entsprechende Symbol aus.
Klicken Sie mit der rechten Maustaste im Editor und klicken Sie dann auf New Topic Location.
Speichern Sie den Kommentar entweder in einer DTX-Datei oder an einer anderen Stelle in der Sourcedatei (Implementierung oder Deklaration).
Um existierende Kommentare zu bearbeiten
Wählen Sie im Contents Managerdas Symbol aus dessen Kommentar Sie bearbeiten möchten.
Klicken Sie Save.
Doc-O-Matic speichert den Kommentar an der Stelle, an dem es den bestehenden Kommentar extrahiert hat.
Hinweise
Bevor Sie eine Datei bearbeiten, klicken Sie auf der Symbolleiste für den Schnellzugriff auf Update All und lassen Sie alle Dateien von Doc-O-Matic analysieren. Doc-O-Matic kann keine Kommentare in eine Datei speichern, die geändert wurde (zum Beispiel im Source-Editor) und die danach nicht analysiert wurde.