很厌恶这样的注释....

jman
Dr. Yin 2014-12-13 字数 141

// define field x

let mutable x = 0.0

// define X property

member this.X with get() = x

and set(v) = x <- v

完全是增加读者负担啊....

Programming 编程技术
8 个回复
goodtaste
有乐享乐,没乐刨乐 2014-12-13

写不写注释的一个好标准:

解释为什么要这么做,不要解释这是在干什么。如果代码需要注释才能叫人明白所完成的功能,那它就需要重构。

【 在 jman (慢性子) 的大作中提到: 】

: // define field x

: let mutable x = 0.0

: // define X property

: ...................

Fermat
Fermat 2014-12-13

这个注释要用中文写的,那就很和谐了。

【 在 jman (慢性子) 的大作中提到: 】

: // define field x

: let mutable x = 0.0

: // define X property

: member this.X with get() = x

:               and set(v) = x <- v

: 完全是增加读者负担啊....

lilnelse
不折腾 2014-12-13

嗯,变量名、函数名都用汉语拼音,那就完美了。

【 在 Fermat (Fermat) 的大作中提到: 】

: 这个注释要用中文写的,那就很和谐了。

fanci
大葡萄 2014-12-13

用汉字就可以了...什么?你的编译器不支持汉字?用C#或者VB吧!

【 在 lilnelse (不折腾) 的大作中提到: 】

:  嗯,变量名、函数名都用汉语拼音,那就完美了。

hddd
hdd 2014-12-13

这是写给根本就不懂这个语言的人看的。

【 在 jman 的大作中提到: 】

: // define field x

: let mutable x = 0.0

: // define X property

: ...................

jackfnx
玄之又玄 2014-12-14

用汉字还怎么区分代码和注释

【 在 fanci (大葡萄) 的大作中提到: 】

: 用汉字就可以了...什么?你的编译器不支持汉字?用C#或者VB吧!

fanci
大葡萄 2014-12-14

颜色不同啊

【 在 jackfnx (玄之又玄) 的大作中提到: 】

:  用汉字还怎么区分代码和注释

:  【 在 fanci (大葡萄) 的大作中提到: 】

:  : 用汉字就可以了...什么?你的编译器不支持汉字?用C#或者VB吧!

chaobill
若我离去,后会无期 2014-12-14

英文代码,汉字注释,正好一扫就能扫出来

【 在 jackfnx (玄之又玄) 的大作中提到: 】

: 用汉字还怎么区分代码和注释