Javadoc отображает значение для внутренней константы класса, используя значение @value

У меня есть внутренний класс, который объявляет константу и хочет отобразить ее значение в Javadoc из охватывающего класса верхнего уровня, используя аннотацию @value. Например:

/**
 * {@value #FOO_CONS} // this displays well
 * {@value #BAR_CONS} // this does not work (checked in the latest Eclipse)
 * {@value Bar#BAR_CONS} // this does not work, either
 */
public Foo {
  public static final int FOO_CONS = 1;
  static class Bar {
    public static final int BAR_CONS = 42;
  }
}

Любые идеи о том, как отображать значение BAR_CONS в Javadoc класса Foo (или вообще любой другой класс)?

Ответ 1

Формат Javadoc для константы, определенной в другом пакете, должен быть:
{@value package.class # field}

Однако это потенциально не рендеринг - это известная проблема:
https://bugs.eclipse.org/bugs/show_bug.cgi?id=342194

Ответ 2

если создать javadoc для членов с видимым "пакетом" (который является видимостью для вашего класса Bar), я получаю константу в javadoc под Foo.Bar