Eclipse, как связать банку, содержащую javadocs/source, с ее двоичным кодом?

Я хотел бы иметь комментарии javadoc, содержащиеся в представлении jar файла в eclipse, когда я наводил курсор на класс.

Например, после загрузки JODA-2.0 получают три банки:

В eclipse [проект правой кнопкой мыши → Свойства → Путь сборки Java → Библиотеки → ADD JAR...] включает в себя двоичный файл в проекте (может ссылаться на эти классы) для joda-time-2.0.jar.

Но как я могу связать в комментариях sources/javadoc, содержащихся в двух других файлах jar, чтобы при наведении курсора на эти классы я видел javadocs?

Добавление двух других банок (joda-time-2.0-javadoc.jar и joda-time-2.0-sources.jar) в путь сборки не связывает javadocs или источник.

Ответ 1

Вы можете попробовать CTRL + щелкнуть по классу, который не подключен к источнику (сделайте это в редакторе). Когда он покажет вам некоторую информацию о классе, вы увидите кнопку, которая поможет подключить исходный диалог. Щелкните по нему и в появившемся диалоговом окне выберите местоположение источника /javadoc для своего класса.

Вы также можете сделать это из настроек пути создания проекта, о которых вы говорите: выберите вкладку библиотек, разверните библиотеку (банку), которую вы хотите, и вам будет предложено выбрать: исходное вложение, вложение javadoc, расположение родной библиотеки и т.д. Вы просто выбираете все, что хотите, и редактируете его текущие настройки.

Или вы можете сделать, как @JB Nizet сказал...

Ответ 2

  • Щелкните правой кнопкой мыши по проекту → Путь сборки → Настроить путь сборки
  • В новом окне перейдите на вкладку "Библиотеки".
  • Выберите библиотеку и разверните ее.
  • Есть 4 дочерних варианта. Выберите "Местоположение Javadoc" и нажмите кнопку "Изменить" справа.
  • Теперь вы можете добавить файл jar, содержащий документы. Это будет просто zip файл с расширением, измененным на jar. Убедитесь, что внутри jar index.html находится в корне. Вы можете нажать кнопку "Проверить", чтобы проверить, все ли в порядке.

Ответ 3

Вы также можете отредактировать classpathentry в файле ".classpath" в своем проекте eclipse. Это может быть полезно, если вы хотите изменить сразу несколько записей или хотите создать путь. например:.

<classpathentry kind="var" path="HOME/3rdparty/junit.jar" sourcepath="/SOURCE/junit_src.zip"/>

Ответ 4

Щелкните правой кнопкой мыши на банке (той, что есть в файлах классов), выберите "Свойства", "Местоположение Javadoc" и выберите файл jar с помощью javadoc. Сделайте аналогичным образом для исходной банки, используя "привязку источника Java".