Как мы все знаем, код постоянно меняется. Кто-то создаст его, а потом тысячи людей изменят параметры функций и базовый код. Задокументированные функциональные параметры постоянно изменяются.
Например, документация функции теперь выглядит так:
/**
* Updates the email of the user to the new one.
*
* @param type $new_email
* @param type $session
* @param type $security_key
*
* @return type
* @throws Exception_SessionExpired
*/
public function update_email($data)
Конечно, это не отражает текущие параметры функции, хуже того, таких гораздо больше :(
Как легко обновить всю документацию по функциям в файле за один раз? Как и для форматирования в соответствии с кодовыми соглашениями, есть Alt+Shift+F. Есть ли в NetBeans такая вещь для обновления документации?