Faire Eclipse Java de formateur de code ignorer bloquer les commentaires

Est-il un moyen de faire de l'Éclipse est intégré dans le code Java formateur ignorer les commentaires? Chaque fois que je le lance, il transforme ce:

    /*
     * 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
     */

dans cette:

    /*
     * 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
     */

J'ai déjà joué un peu avec le Windows > Préférences > Java > Code > module de Formatage des paramètres, mais ne peut pas en trouver un pour garder au commentaire de formatage. Je suis à l'aide d'Eclipse 3.4.0.

C'est là, dans le module de Formatage de config, je ne sais pas comment vous manque. Modifier le profil, il y a une boîte de dialogue avec 8 onglets, le dernier onglet est pour commenter la mise en forme.
Je vois l'onglet commentaire, mais les problèmes de mise en forme se produire n'importe quelle combinaison de cases à cocher que j'utilise.
double possible de Comment désactiver l'Éclipse formateur de code, pour certaines sections de code Java?
Je vais avoir le même problème avec la Scala dans Eclipse, mais les solutions ci-dessous sont Java spécifiques, comme la Scala formateur de code de l'onglet options différentes. Est-il un moyen de désactiver les commentaires du reformatage pour Scala?

InformationsquelleAutor Pops | 2009-06-21

36

Mise à jour de 2010, comme signalé par l'OP et dans cette réponse, la chaîne de caractères spéciaux //@formatter:off dans Eclipse 3.6 est assez.

Il n'était pas disponible au moment de la question.

Réponse originale à cette question: en juin 2009, Eclipse 3.4/3.5

Avec le Java Formateur (Windows > Preferences > Java > Code Style > Formatter), vous pouvez créer un nouveau profil de Formateur.

Dans l'onglet Commentaires (en eclipse3.5), vous pouvez vous assurez, dans le "Javadoc comment settings", décochez l'option "Format HTML tags".

Vérifiez également la "Never join lines" dans le "General settings" section.

Ensuite, votre commentaire doit être écrite comme suit:
```
/**
 * PSEUDOCODE
 * Read in user's string/paragraph
 * 
 * Three cases are possible:
 * <dl>
 *   <dt>Case 1: foobar</dt>
 *     <dd>        do case 1 things</dd>
 *   <dt>Case 2: fred hacker</dt>
 *     <dd>        do case 2 things</dd>
 *   <dt>Case 3: cowboyneal</dt>
 *     <dd>        do case 3 things</dd>
 * </dl>        
 * In all cases, do some other thing
 */
```
Note: j'ai fait une Javadoc commentaire, et non pas un simple commentaire, car je pense qu'un commentaire avec beaucoup de texte, il peut être mieux placé en face d'une méthode. De Plus, Javadoc sections ont plus de paramètres de mise en forme pour jouer avec.

Si il est en face d'une méthode (vrai Javadoc), le HTML les balises <dl>, <dt> et <dd> aidera à présent correctement dans la Javadoc de la vue.
- La partie pertinente de cette réponse, pour moi, est que les balises HTML ne sont PAS automatiquement inséré à sauts de ligne et la comme. Probablement évident pour la plupart, mais je ne savais pas que j'avais à la main le code des choses comme <br>s jusqu'à ce que j'ai vu ici.
- Torgamus: non seulement vous devez ajouter thosetags, mais la première phrase nécessite une période et un espace avant le <br />! (voir bugs.sun.com/bugdatabase/view_bug.do?bug_id=4165985)
- Je vais avoir le même problème avec la Scala dans Eclipse, mais les solutions ci-dessous sont Java spécifiques, comme la Scala formateur de code de l'onglet options différentes. Est-il un moyen de désactiver les commentaires du reformatage pour Scala?
- cela ne répond pas à la question posée
InformationsquelleAutor VonC
172

Il y a une autre solution que vous pouvez utiliser pour supprimer la mise en forme de bloc spécifique des commentaires. Utilisation /*- (notez le trait d'union) au début du bloc de commentaire, et la mise en forme
ne sera pas affectée si vous formatez le reste du fichier.
```
/*- 
* Ici, c'est un bloc de commentaire avec quelques très spéciale 
* la mise en forme que je veux tiret(1) pour les ignorer. 
* 
* un 
* deux 
* trois 
*/
```
Source: http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-141999.html#350
- C'est du jamais vu, même en dehors du contexte. +1!
- Je souhaite que j'avais connu à ce sujet (c'est à dire, la recherche de la solution précédente.
- Malheureusement, cela ne fonctionne qu'avec des "réguliers" bloquer les commentaires, pas de commentaires Javadoc.
- Jamais vu ça. Pourquoi n'est-ce pas la accepté de répondre?
- il ne fonctionne plus dans mon eclipse indigo, il ne veut pas rejoindre les lignes, mais enlève toute l'indentation
- semble fonctionner pour moi dans Eclipse Juno.
- Parfait pour la Version: Juno Service Release 1. Je vous remercie, mon sauveur!
- Le lien a été déplacé ici
- et même cela est utile lorsque vous avez votre propre formateur qui est l'attachement d'étoiles pour chaque ligne de départ et que vous ne voulez pas formateur par défaut de le faire alors que vous pourriez utiliser /*- ...... */ ce qui est très utile
- cela fonctionne encore en 2018 avec Eclipse Photon
InformationsquelleAutor Michelle Crane
23

J'ai juste appris à partir d'un collègue de travail Eclipse propose des balises de mise en forme qui peut être utilisé pour cela:
```
//@formatter:off
/*
 * ╔════════╦═══════╦══════════╗
 * ║ Month  ║ Sales ║ Position ║
 * ╠════════╬═══════╬══════════╣
 * ║ June   ║ 44k   ║ 2nd      ║
 * ║ July   ║ 39k   ║ 2nd      ║
 * ║ August ║ 49k   ║ 4th      ║
 * ╚════════╩═══════╩══════════╝
 *
 * This comment shouldn't be formatted, and will now be ignored by the formatter.
 */
//@formatter:on
```
Notez que vous devrez peut-être activer manuellement cette fonction via le menu Préférences → Java > Code > Formateur, en cliquant sur Modifier, la sélection de la /Désactiver les Balises onglet et la vérification de Activer/Désactiver les balises (source).

Un rapide Google pour la chaîne @formateur:off m'a amené à cette autre AFIN de répondre à, qui a évoqué cette fonction dans le contexte de la désactivation du module de formatage pour les blocs de code. J'ai confirmé qu'il travaille pour de commentaires en ligne, "normal" bloquer les commentaires Javadoc et de bloquer les commentaires.
- Comment avez-vous de faire travailler les commentaires JavaDoc? J'ai trouvé, j'ai dû mettre de commentaires en ligne avant et après la JavaDoc des commentaires pour que cela fonctionne, comme vous l'avez fait pour le bloc de commentaire dans cette réponse. J'espérais que je pourrais désactiver la mise en forme juste pour une section de commentaire JavaDoc.
- il a été un moment, et je ne me souviens plus exactement... avez-vous essayé VonC conseils?
- Une belle. Merci! +1
- C'est excellent, parce qu'il raconte eclipse pour ne pas le format de code. Utile lorsque vous souhaitez garder votre propre mise en forme.
- c'est la vraie réponse à cette question
InformationsquelleAutor Pops
16

Une autre possibilité est d'utiliser de l'HTML <pre> dans la Javadoc:
```
/**
 * <pre>
 *    this
 *   is
 *      kept
 *  as
 *    is
 * </pre>
 */
```
Au moins c'est comment j'ai tendance à intégrer mon ASCII-art dans les commentaires du code source 🙂
- Veuillez noter que l'Éclipse de formater le contenu de <pre></pre> tag s'il le voit comme un code java (sauf si vous décochez la case de la Fenêtre->Préférences->Java->Style de Code->Formateur->Modifier...[Bouton]->Commentaires[Tab]-> Format de"Java des extraits de code à l'intérieur de" pré "tags")
InformationsquelleAutor Thomas Keller
8

Entourent le texte spécifique avec <pre> </pre> balises.

InformationsquelleAutor Philip
2

Dans Eclipse 3.4: Préférences, Java->Style de Code->Formateur, puis modifier le profil, onglet commentaires. Il ya un tas d'options pour le contrôle des commentaires de mise en forme.

InformationsquelleAutor skaffman
1

Si vous souhaitez supprimer la mise en forme dans eclipse, vous pouvez toujours placer le contenu qui est destiné à ne PAS ÊTRE FORMATÉ en <pre>UNFORMATTED CONTENT</pre> tag. Javadoc formateur va détecter que la balise, et de laisser tout entre les balises non formaté.

Pour:
- Reste de la Javadoc est encore formaté
- Javadoc html de sortie sera "non formaté" ainsi, parce que de pré tags
Contre:
- De ne pas voir un
InformationsquelleAutor Antoniossss
1

une solution de contournement consiste à ajouter pré balise pour les commentaires que vous ne voulez pas eclipse pour format
```
/**
 * <pre>
 *    this part
 *   is
 *      out of
 *  format
 *    
 * </pre>
 */
```
- Vrai... mais je ne vois pas ce que cela ajoute à ce que Philippe Thomas Keller déjà dit dans leurs réponses, il y a des années.
InformationsquelleAutor K. Andy wang
0

Il est dépendant de la langue.

Par exemple, si vous travaillez avec javascript, vous allez à la Fenêtre "- > Préférences -> Javascript> Style de Code -> Formateur de" et ensuite modifier les options de formatage.

Modifier (reflétant les changementsdans OP Questions

Pour l'édition de code java mise en forme, aller à l'
"Window -> Préférences -> Java -> Style de Code -> Formateur"

À la partie supérieure du panneau, vous verrez

Profil Actif:

Eclipse [built-in]

À partir de là, vous avez un bouton à la droite, "Modifier", et les deux ci-dessous, "Nouveau..." et "Importer...".
Je recommande l'Édition du profil existant.

Dans la boîte de dialogue modifier le profil, il y a une série d'onglets dans la partie supérieure. Le dernier onglet "Commentaires". Pour désactiver complètement le commentaire de formatage, décochez la case "Activer commentaire Javadoc mise en forme", "Activer le bloc de commentaire mise en forme", "Activer les commentaires de fin de ligne mise en forme", et "Activer le commentaire d'en-tête de" mise en page.

InformationsquelleAutor Jonathan Fingland
0

Vous pouvez changer cela dans
Windows - Préférences - Java - Code De Style De Formateur,
que de cliquer sur le bouton Modifier.., trouver des Commentaires,
choisir de ne Jamais Rejoindre les Lignes.

Ensuite, il devrait être OK.

InformationsquelleAutor GH Dev
0

Essayer celui-ci. Cela a fonctionné pour moi.
Avec le Formateur Java (Windows > Préférences > Java > Code > Formateur), vous pouvez créer un nouveau module de Formatage de profil existant et de le modifier.

Si Eclipse ne permettent pas d'enregistrer ce pour en créer un nouveau et de l'enregistrer dans cela.

InformationsquelleAutor Milan Kamboya

Vous devez vous connecter pour publier un commentaire.