Как можно документировать параметры записи Java ? Я имею в виду параметры, которые в конечном итоге становятся параметрами конструктора, полями классов.
Я старался:
/**
* @param name the name of the animal
* @param age the age of the animal
*/
public record Animal(String name, int age)
{
}
но IntelliJ IDEA помечает @param
s как ошибку. Я не смог найти онлайн пример того, как это должно работать. Самое близкое обсуждение, которое я нашел, является https://bugs.openjdk.java.net/browse/JDK-8225055 .
Я нашел несколько модульных тестов в JDK, которые, кажется, подразумевают, что это должно работать. Возможно, это ошибка IDE?
Я использую OpenJDK 14 + 36-1461, IDEA 2020.1.