我正在使用 Netbeans 为每个函数添加专业的评论,我写道。因此,我开始与 /**
,然后我按 Enter
让 Netbeans 完成以下功能的默认注释方案。
到目前为止,我一直使用这只是为 PHP 语言,在这种情况下,Netbeans 总是添加 @returns {type}
部分在注释方案,如果下面的 PHP 函数真的包括 return
语句。对于所谓的“过程”(不返回任何值的函数) ,此部分缺失。
今天我对 Javascript 函数做了同样的尝试,Netbeans 在注释方案中增加了 @returns {undefined}
部分,即使后面的函数不返回任何内容。
这让我很困惑。Netbeans 是否建议每个 Javascript 函数都必须返回任何内容?我该怎么办?忽略(或删除)该注释方案的一部分或遵循建议(如果这是建议) ,并添加 return false;
在这样的功能结束,虽然它是无用的我?