Gibt es eine Möglichkeit, den in Eclipse integrierten Java-Code-Formatierer dazu zu bringen, Kommentare zu ignorieren? Immer wenn ich es laufen lasse, dreht es sich um:
/*
* PSEUDOCODE
* Read in user's string/paragraph
*
* Three cases are possible
* Case 1: foobar
* do case 1 things
* Case 2: fred hacker
* do case 2 things
* Case 3: cowboyneal
* do case 3 things
*
* In all cases, do some other thing
*/
das mögen:
/*
* PSEUDOCODE Read in user's string/paragraph
*
* Three cases are possible Case 1: foobar do case 1 things Case 2: fred
* hacker do case 2 things Case 3: cowboyneal do case 3 things
*
* In all cases, do some other thing
*/
Ich habe bereits mit den Einstellungen Windows> Einstellungen> Java> Codestil> Formatierer herumgespielt, kann jedoch keine finden, um die Formatierung der Kommentare beizubehalten. Ich verwende Eclipse 3.4.0.
Antworten:
Update 2010, wie vom OP und in dieser Antwort angegeben , reicht die spezielle Zeichenfolge
// @formatter:off
in Eclipse 3.6 aus.Es war zum Zeitpunkt der Frage nicht verfügbar .
Ursprüngliche Antwort: Juni 2009, Eclipse 3.4 / 3.5
Mit Java Formatter (
Windows > Preferences > Java > Code Style > Formatter
) können Sie ein neues Formatter-Profil erstellen.Auf der Registerkarte "Kommentare" (in eclipse3.5) können Sie sicherstellen, dass im "
Javadoc comment settings
" die Option "Format HTML tags
" deaktiviert ist .Überprüfen Sie auch das "
Never join lines
" imGeneral settings
Abschnitt " ".Dann sollte Ihr Kommentar wie folgt geschrieben werden:
Hinweis: Ich habe einen Javadoc- Kommentar abgegeben und keinen einfachen Kommentar, da ich glaube, dass ein Kommentar mit so viel Text besser vor einer Methode platziert werden kann. Außerdem haben Javadoc-Abschnitte mehr Formatierungsparameter zum Spielen.
Wenn es vor einem Verfahren (true Javadoc) ist, die HTML - Tags
<dl>
,<dt>
und<dd>
es wird helfen , richtig Ansicht innerhalb der Javadoc zu präsentieren.quelle
<br />
! (siehe bugs.sun.com/bugdatabase/view_bug.do?bug_id=4165985 )Es gibt eine andere Lösung, mit der Sie die Formatierung bestimmter Blockkommentare unterdrücken können. Verwenden Sie
/*-
(beachten Sie den Bindestrich) am Anfang des Blockkommentars, und die Formatierung wird nicht beeinflusst, wenn Sie den Rest der Datei formatieren.Quelle: http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-141999.html#350
quelle
Ich habe gerade von einem Kollegen erfahren, dass Eclipse spezielle Formatierungs-Tags anbietet, die dafür verwendet werden können:
Beachten Sie, dass Sie diese Funktion möglicherweise manuell über das Menü Einstellungen → Java> Codestil> Formatierer aktivieren müssen, auf Bearbeiten klicken , die Registerkarte Aus / Ein-Tags auswählen und die Option Aus / Ein-Tags aktivieren ( Quelle ) aktivieren müssen .
Ein kurzes Google für die Zeichenfolge @formatter: off brachte mich zu dieser anderen SO-Antwort , in der diese Funktion im Zusammenhang mit der Deaktivierung des Formatierers für Codeblöcke erwähnt wurde. Ich habe bestätigt, dass es auch für Zeilenkommentare, "normale" Blockkommentare und Javadoc-Blockkommentare funktioniert.
quelle
Eine andere Möglichkeit ist die Verwendung von HTML <pre> in Javadoc:
Zumindest neige ich so dazu, meine ASCII-Grafik in Quellcode-Kommentare einzubetten :)
quelle
Umgeben Sie den spezifischen Text mit
<pre> </pre>
Tags.quelle
In Eclipse 3.4: Einstellungen Java-> Codestil-> Formatierer, dann Profil bearbeiten, Registerkarte Kommentare. Dort gibt es eine Reihe von Optionen zum Steuern der Kommentarformatierung.
quelle
Wenn Sie die Formatierung in Eclipse unterdrücken möchten, können Sie Inhalte, die NICHT FORMATIERT werden sollen, jederzeit in
<pre>UNFORMATTED CONTENT</pre>
Tags einbinden . Der Javadoc-Formatierer erkennt dieses Tag und lässt alles zwischen diesen Tags unformatiert.Vorteile:
Nachteile:
quelle
Eine Problemumgehung besteht darin, ein Pre- Tag für die Kommentare hinzuzufügen, die Eclipse nicht formatieren soll
quelle
Probier diese. Das hat bei mir funktioniert. Mit dem Java-Formatierer (Windows> Einstellungen> Java> Codestil> Formatierer) können Sie aus dem vorhandenen ein neues Formatierungsprofil erstellen und es dann bearbeiten.
Wenn Eclipse dies nicht zulässt, erstellen Sie eine neue und speichern Sie diese.
quelle
Es ist sprachabhängig.
Wenn Sie beispielsweise mit Javascript arbeiten, gehen Sie zu "Fenster -> Einstellungen -> Javascript -> Codestil -> Formatierer" und bearbeiten Sie die Formatierungsoptionen.
Bearbeiten (Änderungen in OP-Fragen widerspiegeln)
Um die Java-Code-Formatierung zu bearbeiten, gehen Sie zu "Fenster -> Einstellungen -> Java -> Codestil -> Formatierer".
Oben im Panel sehen Sie
Von dort haben Sie eine Schaltfläche rechts, "Bearbeiten", und zwei unten, "Neu ..." und "Importieren ...". Ich würde empfehlen, das vorhandene Profil zu bearbeiten.
Im Dialogfeld "Profil bearbeiten" befinden sich oben eine Reihe von Registerkarten. Die letzte Registerkarte ist "Kommentare". Um die Kommentarformatierung vollständig zu deaktivieren, deaktivieren Sie "Javadoc-Kommentarformatierung aktivieren", "Blockkommentarformatierung aktivieren", "Zeilenkommentarformatierung aktivieren" und "Kopfkommentarformatierung aktivieren".
quelle
Sie können dies unter Windows - Einstellungen - Java - Codestil - Formatierer ändern. Klicken Sie dann auf die Schaltfläche Bearbeiten .., suchen Sie nach Kommentaren und wählen Sie die Option Niemals verbinden.
Dann sollte es OK sein.
quelle