Javadoc генерирует только комментарии интерфейса, а не реализации классов - PullRequest
1 голос
/ 31 марта 2012

Я смущен чем-то очень простым при создании Javadoc.

Допустим, у меня есть интерфейс:

/**
*Javadoc comment in interface
*
*/
public interface IOne{
    public Comparable[] meth();
}

Тогда у меня есть класс:

public class ClassOne implemets IOne{
    /**
    *Javadoc comment in class
    *
    */
    public Comparable[] meth(){
        //implementation
    }
}

Когда я генерирую Javadoc:

  • Проект> Создать Javadoc
  • Я указываю в команде Javadoc на исполняемый файл Javadoc
  • Я выбираю Public
  • Я выбираю пункт назначения
  • Конец

Он генерирует и, по-видимому, правильный HTML.

Когда я иду в IOne, документация для meth() говорит:

Javadoc комментарий в классе

Но это говорит о том же самом, когда я иду к методу класса в meth().

Это то, что он должен делать?

Где я могу найти / сгенерировать Javadoc comment in class?

UPDATE:

Это из-за @Override перед комментариями. Я читаю, где должно быть переопределение или нет.

1 Ответ

3 голосов
/ 31 марта 2012

Использование {@inheritDoc} до слияния документация по реализации и интерфейсу.

...