Заставить Javadoc игнорировать аннотацию

Question

Я пытаюсь задокументировать аннотированный интерфейс и включить пример того, как он используется в Javadoc. например,

/**
 * Here's an example usage:
 *
 * 
 * @IFaceAnnotation(value="")
 * public interface IFace {
 *
 *     @MethodAnnotation("")
 *     public String Method();
 * }
 * 

* /

Однако Javadoc рассматривает мои аннотации как инструкции Javadoc (например, @param и т. Д.) И в результате выводит только:

Вот пример использования:

В сгенерированной документации. Единственный способ остановить это - добавить дополнительный символ перед аннотацией, например,

/**
 * Here's an example usage:
 *
 * 
 * \@IFaceAnnotation(value="")
 * public interface IFace {
 *
 *     \@MethodAnnotation("")
 *     public String Method();
 * }
 * 

* /

но это выглядит немного грязно.

Просто подумал, есть ли у кого-нибудь предложения, спасибо.

Answer 1

Вы можете использовать '@' вместо @, но это еще страшнее.

Answer 2

Для записи, правильный и полный ответ:

<code>/**
 * Here's an example usage:
 *
 * <pre>
 * {@code}
 * &#064;IFaceAnnotation(value="")
 * public interface IFace {
 *
 *     &#064;MethodAnnotation("")
 *     public String Method();
 * }
 * 

* /

, что приводит к

Answer 3

Вы пытались обернуть его в нотацию {@code}?