Der Assistent
Javadoc-Generierung ermöglicht das Generieren von Javadoc-Dateien. Er stellt eine Schnittstelle für das Tool javadoc.exe dar, das in der Java-JDK verfügbar ist. Besuchen Sie die Seite Sun's Javadoc Tool, um eine vollständige
Dokumentation für das Javadoc-Tool abzurufen.
Typauswahl:
Option |
Beschreibung |
---|---|
Javadoc-Befehl |
Gibt an, welcher Befehl zur Javadoc-Generierung verwendet werden soll. |
Typen auswählen, für die eine Javadoc-Generierung erfolgt |
Aktivieren bzw. inaktivieren Sie die Markierungsfelder in der Liste, um exakt die Typen anzugeben, die exportiert werden sollen. Diese Liste wird mit der Workbench-Auswahl initialisiert. |
Javadoc für sichtbare Member erstellen |
|
Standard-Doclet verwenden |
Javadoc-Befehl mit dem Standard-Doclet starten (Standardeinstellung)
|
Angepasstes Doclet verwenden |
Verwendung eines angepassten Doclets zur Generierung von Dokumentation
|
Standard-Doclet-Argumente (bei Auswahl von Standard-Doclet verwenden verfügbar):
Option |
Beschreibung |
---|---|
Dokumenttitel |
Angeben eines Dokumenttitels. |
Verwendungsseite generieren | Wählen Sie diese Option aus, wenn die Dokumentation eine Verwendungsseite enthalten soll. |
Hierarchiebaumstruktur generieren | Wählen Sie diese Option aus, wenn die Dokumentation eine Baumstrukturseite enthalten soll. |
Navigatorleiste generieren |
Wählen Sie diese Option aus, wenn die Dokumentation eine Navigatorleiste (Kopfzeile und Fußzeile) enthalten soll. |
Index generieren | Wählen Sie diese Option aus, wenn die Dokumentation eine Indexseite enthalten soll. |
Separater Index pro Buchstabe | Für jeden Buchstaben einen Indexeintrag generieren. Diese Option ist aktiviert, wenn Index generieren ausgewählt ist. |
@author | Wählen Sie diese Option aus, wenn das Tag '@author' dokumentiert werden soll. |
@version | Wählen Sie diese Option aus, wenn das Tag '@version' dokumentiert werden soll. |
@deprecated | Wählen Sie diese Option aus, wenn das Tag '@deprecated' dokumentiert werden soll. |
heruntergestufte Liste | Wählen Sie diese Option aus, wenn die Dokumentation eine Seite 'Heruntergestuft' enthalten soll. Diese Option ist aktiviert, wenn die Option @deprecated ausgewählt wird. |
Archive und Projekte auswählen, auf die verwiesen wird und zu denen Links generiert werden sollen: |
Geben Sie an, zu welcher anderen Dokumentation Javadoc Links erstellen soll, wenn auf andere Typen verwiesen wird.
|
Style-Sheet | Zu verwendendes Style-Sheet auswählen |
Allgemeine Javadoc-Optionen:
Option |
Beschreibung |
---|---|
Übersicht |
Gibt an, dass Javadoc den Text für die Dokumentation der Übersicht aus der angegebenen Datei abrufen sollte. Dieser Text wird in der Datei overview-summary.html platziert. |
VM-Optionen |
Fügen Sie hier eine beliebige Anzahl zusätzlicher VM-Optionen hinzu. |
Zusätzliche Javadoc-Optionen |
Fügen Sie hier eine beliebige Anzahl zusätzlicher Optionen hinzu: angepasste Doclet-Optionen oder JRE 1.4-Kompatibilitätsoptionen. |
Kompatibilität der JRE-Quelle |
Die Kompatibilität der JRE-Quelle, die vom Javadoc-Tool akzeptiert werden soll. |
Einstellungen dieses Javadoc-Exports als Ant-Script speichern |
Speichern eines Ant-Scripts angeben, das den angegebenen Javadoc-Export ohne Benötigung des Assistenten ausführt. Vorhandenes Ant-Script kann mit diesem Assistenten bearbeitet werden. (Verwenden Sie hierfür die Option für das Öffnen des Javadoc-Assistenten im Kontextmenü des generierten Ant-Scripts.) |
Generierte Indexdatei in Browser öffnen | Öffnet die generierte Datei index.html im Browser (nur bei Verwendung des Standard-Doclets verfügbar). |
Klicken Sie auf Fertig stellen, um die Javadoc-Generierung zu starten. Unterscheidet sich das Ziel von der Position, die auf der Seite Javadoc-Position des Projekts konfiguriert wurde, werden Sie gefragt, ob Sie die Javadoc-Position des Projekts als neuen Zielordner festlegen möchten. Tun Sie dies, verwenden alle Aufrufe für 'Externe Javadoc öffnen# die soeben erstellte Dokumentation.
Eine neue Verarbeitung wird gestartet, und die Generierung wird im Hintergrund ausgeführt. Öffnen Sie die Ansicht Konsole (Fenster > Ansicht anzeigen > Konsole), um den Fortschritt und den Status der Generierung anzuzeigen.