【发布时间】:2013-03-07 05:42:57
【问题描述】:
众所周知,代码不断变化。有人创建它,然后成千上万的人将更改函数和底层代码的参数。记录的功能参数不断变化。
例如,函数文档现在看起来是这样的:
/**
* 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 中是否也有这样的东西来更新文档?
【问题讨论】: