Как да редактирате javadoc шаблон на Netbeans, за да включите непроверени изключения?

Търся начин да включа параметъра @throws за непроверени изключения в шаблона на javadoc. Забелязах, че в официалната документация на Java те винаги са документирани и дори в тези указания на Netbeans страница го споменават като добра практика за програмиране:

Изхвърлянето на непроверено изключение, без да е споменато в Javadoc, е забранено.

Въпреки това в редактора на Netbeans тези изключения не се добавят към списъка @throws в генерирания javadoc - опитах с този много прост код:

public void method() {
    throw new IllegalArgumentException();
}

генерираният javadoc за него е празен.

Решението, което намерих за персонализиране на javadoc, е описаното в този отговор, но не виждам начин за включване видът на "динамично" съдържание като клаузата @throws за непроверени изключения ще бъде в моя случай.

Намерих също тази връзка от wiki на Netbeans, която обяснява как да добавяте нови персонализирани променливи, които да използвате в шаблони, но отново, не виждам как да използвам това за динамично включване на @throws за непроверените изключения, използвани в метода, който се документира.


person Antiphon0x    schedule 25.02.2015    source източник
comment
Ще трябва да направите повече от това просто да редактирате шаблона. Ще трябва да промените кода на NetBeans, който го попълва.   -  person user207421    schedule 26.02.2015
comment
И в общия случай не е приложимо правилно, тъй като ще трябва да включите всички грешки и изключения по време на изпълнение, хвърлени от затварянето на всички методи, извикани от този метод и неуловени, което не е известно по време на компилиране. Затова бих поставил под въпрос целта. Правенето му частично е със съмнителна стойност, вероятно отрицателна.   -  person user207421    schedule 26.02.2015
comment
Разбирам какво казваш. Така че единственият начин да се включи такава документация е да се напише изрично на ръка - и предполагам, че изборът кое непроверено изключение включва в документацията е оставен на програмиста, който трябва да напише достатъчно, за да опише интерфейса за този метод, без да отива дълбоко в детайлите на изпълнението. Прав ли съм?   -  person Antiphon0x    schedule 26.02.2015