Generierte Javadoc-Seiten umschließen Methodenargumente unnötig mit Annotationen
Wenn ich erzeugen javadoc für ein Verfahren der Verfahrensparameter / Ausnahmen unnötig in eine neue Zeile umgebrochen erhalten, wie folgt:
Auf der Seite ist noch genügend horizontaler Platz vorhanden. Verwenden von Oracle javadoc.exe 8u60.
Wie kann ich diese unnötigen Zeilenumbrüche verhindern, ohne manuell auf die HTML-Dateien bearbeiten?
Dies ist der Quellcode des Teils im Screenshot zu sehen:
%Vor%Der Quellcode oben herausgezogen wird, kondensiert und durch einen HTML-Formatierer für das Lesen zu vereinfachen verarbeitet, hier ist die sehr roh komplette Datei .
1 Antwort
Sie können das Format Ihres Javadoc anpassen, indem Sie ein benutzerdefiniertes Dokument schreiben.
Bitte überprüfen Sie diesen Abschnitt in der Dokumentation des Javadoc-Generators:
Javadoc Doclets
Sie können den Inhalt und das Format der Ausgabe des javadoc-Befehls mit Doclets anpassen. Der Befehl javadoc verfügt über ein standardmäßiges integriertes Doclet, das so genannte Standard-Doclet, das eine HTML-formatierte API-Dokumentation generiert. Sie können eine Unterklasse des Standard-Doclets ändern oder erstellen oder ein eigenes Doclet schreiben, um HTML, XML, MIF, RTF oder ein anderes gewünschtes Ausgabeformat zu generieren.
Wenn ein benutzerdefiniertes Dokument nicht mit der Option -doclet angegeben wird, verwendet der Befehl javadoc das standardmäßige Standarddoclet. Der Befehl javadoc verfügt über mehrere Optionen, die unabhängig davon verfügbar sind, welches Doclet verwendet wird. Das Standarddoclet fügt zusätzliche Befehlszeilenoptionen hinzu. Siehe Optionen.