Warum unterbricht der Eclipse-Codeformatierer </a> in einem Javadoc-@see-Tag?

Question

Ich verwende Eclipse 3.4 und habe den Java-Codeformatierer mit allen Optionen auf dem konfiguriert Kommentare Registerkarte aktiviert.Das Problem besteht darin, dass ich einen Dokumentkommentar formatiere, der Folgendes enthält:

* @see <a href="test.html">test</a>

Der Codeformatierer fügt ein Leerzeichen in den schließenden HTML-Code ein und unterbricht ihn:

* @see <a href="test.html">test< /a>

Warum?Wie kann ich das verhindern?

Dies lässt sich nicht durch Deaktivieren einer der Optionen beheben Kommentare Registerkarte, wie z Formatieren Sie HTML-Tags.Die einzige Lösung, die ich gefunden habe, besteht darin, die Javadoc-Formatierung vollständig zu deaktivieren, indem beide deaktiviert werden Aktivieren Sie die Javadoc-Kommentarformatierung Und Blockkommentarformatierung aktivieren Optionen, was bedeutet, dass ich Kommentarblöcke dann manuell formatieren muss.

Answer 1

Ich kann nur davon ausgehen, dass es sich um einen Fehler in Eclipse handelt.Es passiert nur mit @sehen Tags, es passiert auch für alle 3 integrierten Code-Formatierungseinstellungen.

Es wurden bereits einige interessante Fehler in der Nachbarschaft gemeldet, aber ich konnte diesen speziellen nicht finden.Siehe zum Beispiel eine Suche nach @sehen im Eclipse Bugzilla.

Answer 2

Strenge XML-Spezifikationen erfordern, dass die selbstschließenden Tags ein Leerzeichen vor dem schließenden Schrägstrich haben müssen, etwa so:

<gcServer enabled="true" /> <!-- note the space just after "true" -->

Ich kann nur annehmen, wie Bart sagte, dass es einen Fehler im Reformatierer von Eclipse gibt, der denkt, dass das schließende Tag tatsächlich ein selbstschließendes Tag ist.Eine andere Idee:Können Sie bestätigen, dass Ihre A Tags sind ausgewogen (d. h.keine offenen Tags weiter oben im Dokument)?

Answer 3

Dies könnte ein Fehler in Eclipse 3.4 sein.Ich verwende 3.3 (M20080221-1800) und beobachte dieses Verhalten nicht.