为什么在标题注释中文件/ proc名称之后的双击?

时间:2013-06-15 01:22:06

标签: coding-style tcl

我正在阅读有关TCL编码风格的文章 - wiki.tcl.tk - 我无法想出其中一项建议的原因。

标题注释应采用以下形式:

# tcl::HistRedo --
#
...
proc tcl::HistRedo {{event -1}} {
    ...
}

它强调

  

在程序名称

之后完全遵循语法[...] [即]双击

我的问题是,双击的重点是什么?或者类似地,如果没有它们会出现什么问题,或者出现什么问题呢?如:

# tcl::HistRedo
#

1 个答案:

答案 0 :(得分:2)

免责声明这在很大程度上是猜测,我可能会被一些实际上知道的人在火焰中击落......

我怀疑wiki上的编码样式是Tcl源代码中使用的样式,并且严格遵循语法的强调指令是针对维护这些源的人。

如果你没有完全遵循这种语法,我怀疑我推测的一些工具已被写入有趣的东西(tm) :-)与来源不同找到proc定义。

我很确定没有功能效果。