前端之家收集整理的这篇文章主要介绍了
我应该在C中评论声明或定义吗?,
前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
哪个更容易
评论,声明(在头
文件中)或定义(在源
文件中)?也许我应该
评论两者,或者不
评论,并将它们全部放在一个单独的
文件中……
您应该完全记录具有最高优先级的头
文件.
定义中的注释应该集中在实现细节上,而标题注释应该集中在接口上.
如您所建议的,第三个文档来源也很有用.它应该描述整体概念.
评论头文件的一大优点是,如果您遵循一些简单的语法,您可以自动创建文档.跟你说doxygen你好!
原文链接:https://www.f2er.com/c/110408.html