{@inheritDoc} не наследует Javadoc суперкласса в Eclipse

Question

Когда я использую {@inheritDoc} в Eclipse, комментарии javadoc суперкласса не появляются в javadoc моего класса.

У меня есть следующий кусок кода:

import javax.swing.table.AbstractTableModel;

public class TestTableModel extends AbstractTableModel {

/**
 * {@inheritDoc}
 */
@Override
public int getRowCount() {
    return 1;
}

@Override
public Object getValueAt(int rowIndex, int columnIndex) {
    return null;
}

@Override
public int getColumnCount() {
    return 0;
}
}

Я уверен, что в библиотеке rt.jar (которая содержит javax.swing.table.AbstractTableModel) заданы исходный код и расположение javadoc, и действительно, когда я наведите курсор мыши на getRowCount(), я получаю javadoc AbstractTableModel в подсказке. Когда я генерирую Javadoc из Eclipse, я проверяю, что в разделе "ссылки на архивы и проекты" выбран rt.jar. Но наследование документов не работает.

Answer 1

Похоже, что источник суперкласса (в данном случае AbstractTableModel.java) должен находиться в исходном пути javadoc. Это делается в Eclipse путем создания проекта для AbstractTableModel и выбора его в выборе "Выберите типы, для которых будет сгенерирован Javadoc" во время генерации javadoc.