Eclipse comment lier un jar contenant javadocs / source avec son binary?

Je voudrais que les commentaires de javadoc contenus dans un fichier jar soient affichés en éclipse lorsque je survole une classe.

Par exemple, après avoir téléchargé JODA-2.0, trois bocaux sont obtenus:

  • joda-time-2.0
  • joda-time-2.0-javadoc
  • joda-time-2.0-sources ( http://sourceforge.net/projects/joda-time/files/joda-time/2.0/joda-time-2.0-dist.zip/download )

Dans éclipse, [clic droit sur le projet -> Propriétés -> Java Build Path -> Bibliothèques -> ADD JARs …] inclut le binary dans le projet (peut référencer ces classes) pour joda-time-2.0.jar.

Mais comment puis-je relier les commentaires sources / javadoc contenus dans les deux autres fichiers jar de sorte que lorsque je survole ces classes, je vois les javadocs?

L’ajout des deux autres jars (joda-time-2.0-javadoc.jar et joda-time-2.0-sources.jar) au chemin de génération ne lie pas les javadocs ou la source.

Vous pouvez essayer de CTRL + cliquer sur une classe sans source associée (faites-le dans l’éditeur). Quand il vous montre quelques informations sur la classe, vous verrez le bouton qui guide pour attacher la boîte de dialog source. Cliquez dessus et dans la boîte de dialog qui apparaît, choisissez l’emplacement source / javadoc de votre classe.

Vous pouvez également le faire à partir des parameters de chemin de génération du projet que vous mentionnez: onglet pick libraries, développez la bibliothèque (jar) souhaitée et vous serez invité à choisir: pièce jointe source, pièce jointe javadoc, emplacement de la bibliothèque native, etc. tout ce que vous voulez et modifier ses parameters actuels.

Ou vous pouvez faire comme @JB Nizet a dit …

  1. Faites un clic droit sur le projet -> Build path -> Configurez le chemin de construction
  2. Dans la nouvelle fenêtre, allez dans l’onglet “Bibliothèques”.
  3. Sélectionnez la bibliothèque et développez-la.
  4. Il y a 4 options enfant. Sélectionnez “Emplacement Javadoc” et cliquez sur le bouton “Modifier” à droite.
  5. Vous pouvez maintenant append un fichier jar contenant les documents. Ce serait juste un fichier zip avec l’extension changée en jar. Assurez-vous qu’à l’intérieur du fichier jar, le fichier index.html est à la racine. Vous pouvez appuyer sur le bouton “Valider” pour vérifier que tout va bien.

Cliquez avec le bouton droit sur le fichier jar (celui contenant les fichiers de classe), choisissez “Propriétés”, “Emplacement Javadoc” et choisissez le fichier jar avec le javadoc. Faites de même pour le fichier jar source, en utilisant “Java source attachment”.