Собственные теги в Java, как правило, используются в контексте генерации документации с помощью Javadoc. Они позволяют добавить дополнительные сведения к элементам кода (классам, методам, полям и т.д.), которые будут включены в сгенерированную документацию.
Пример создания и использования собственного тега @todo:
Объявление тега в файле overview.html или в конфигурации Doclet:
Если используется стандартный Doclet, тег нужно объявить. Это можно сделать, например, в файле overview.html, который используется для описания общего обзора проекта.
html
Или при запуске javadoc с опцией -tag:
bash
Где "a" указывает, что тег применим ко всем элементам (классы, методы, поля).
Использование тега в коде Java:
java
Генерация документации:
Запустить утилиту javadoc с указанием опций и исходных файлов.
Например:
bash
или, если используется overview.html:
bash
В сгенерированной HTML-документации появится новый раздел или строка для каждого элемента с тегом @todo и указанным рядом с ним описанием.