ご存知のように、コードは常に変化し続けています。誰かがそれを作成すると、何千人もの人々が関数のパラメーターと基礎となるコードを変更します。文書化されている関数パラメーターは変化し続けます。
たとえば、関数のドキュメントは次のようになります。
/**
* 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 にもドキュメントを更新するようなものはありますか?