发新帖我要提问
12
返回列表
打印
[STM32]

这个程序注释中的1,2,3,4需不需要去掉,想请教下

[复制链接]
楼主: 编号27149
手机看帖
扫描二维码
随时随地手机跟帖
21
编号27149|  楼主 | 2020-6-1 09:47 | 只看该作者 回帖奖励 |倒序浏览
梦幻泡影 发表于 2020-6-1 09:08
我一般不会写这么详细,因为工程太大,只注释重要部分。还有一个就是,变量最好也不要这样声明(比如S) ...

谢谢前辈耐心的回答,想再问下那你身边的有这么注释的吗?或者这么注释会不会要求更改或重写?

使用特权

评论回复
22
ayb_ice| | 2020-6-1 10:00 | 只看该作者
编号27149 发表于 2020-5-29 23:49
我是想问下,我这么注释对不对,1,2,3,4什么的要不要去掉?在公司里这么写是不是不规范? ...

1.1
1.1.2
这些就没必要了,又不是菜单,还分层

使用特权

评论回复
23
编号27149|  楼主 | 2020-6-1 10:14 | 只看该作者
ayb_ice 发表于 2020-6-1 10:00
1.1
1.1.2
这些就没必要了,又不是菜单,还分层

谢谢前辈耐心的回答,想再问下那你身边的有这么注释的吗?或者这么注释会不会要求更改或重写?因为感觉这么注释感觉比较清晰清楚,有逻辑性

使用特权

评论回复
24
hehailun| | 2020-6-1 11:31 | 只看该作者
挺好的啊   注释又不占资源   其实自己看得好看就好

使用特权

评论回复
25
ayb_ice| | 2020-6-1 13:35 | 只看该作者
编号27149 发表于 2020-6-1 10:14
谢谢前辈耐心的回答,想再问下那你身边的有这么注释的吗?或者这么注释会不会要求更改或重写?因为感觉这 ...

我一般般注释很少,只写这段完成什么功能
或容易错误的地方注释一下,
有点懒
但我的函数,变量命名很规范的

使用特权

评论回复
26
编号27149|  楼主 | 2020-6-1 13:49 | 只看该作者
ayb_ice 发表于 2020-6-1 13:35
我一般般注释很少,只写这段完成什么功能
或容易错误的地方注释一下,
有点懒

明白,我以前也是,以正点原子的注释为模板,讲求言简意赅。现在有点习惯1,2,3,4,5那样,但又觉得与众不同感觉怪怪的,有人说这样详细,有人说这样啰嗦不好,所以挺纠结糊涂的。

使用特权

评论回复
27
编号27149|  楼主 | 2020-6-1 16:18 | 只看该作者
梦幻泡影 发表于 2020-6-1 09:08
我一般不会写这么详细,因为工程太大,只注释重要部分。还有一个就是,变量最好也不要这样声明(比如S) ...

这么写的话在贵公司会不会被骂或者被炒鱿鱼

使用特权

评论回复
28
梦幻泡影| | 2020-6-2 08:41 | 只看该作者
编号27149 发表于 2020-6-1 16:18
这么写的话在贵公司会不会被骂或者被炒鱿鱼

这么声明是很规范的好不好

使用特权

评论回复
29
编号27149|  楼主 | 2020-6-2 12:43 | 只看该作者
梦幻泡影 发表于 2020-6-2 08:41
这么声明是很规范的好不好

我是说注释中有1,2,3,4,5,6这样注释,在贵公司会不会不允许

使用特权

评论回复
30
梦幻泡影| | 2020-6-2 13:39 | 只看该作者
编号27149 发表于 2020-6-2 12:43
我是说注释中有1,2,3,4,5,6这样注释,在贵公司会不会不允许

看你心情啊,从来没听说注释过多而不被允许的

使用特权

评论回复
31
编号27149|  楼主 | 2020-6-2 14:41 | 只看该作者
梦幻泡影 发表于 2020-6-2 13:39
看你心情啊,从来没听说注释过多而不被允许的

因为我在群里发了下,他们就有说要是在他们公司,就是要,骂死了或开了

使用特权

评论回复
发新帖 我要提问
您需要登录后才可以回帖 登录 | 注册

本版积分规则