coding-style - 为什么标题注释中的文件/过程名称后有双破折号？

Question

我正在阅读 TCL 的编码风格 - 在wiki.tcl.tk - 我想不出其中一个建议的原因。

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

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

它强调

遵循语法 [...] 完全 [即] 过程名称后的双破折号

我的问题是，双破折号的意义何在？或者类似地，如果没有它们，会出现什么问题或不那么好？如：

# tcl::HistRedo
#

Answer 1

免责声明这在很大程度上是猜测，我很可能会被真正知道的人稍后在火焰中击落......

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

如果您未能完全遵循该语法，我怀疑我推测的许多工具已被编写用于做有趣的事情（tm） :-) 与源代码不会找到 proc 定义。

我很确定不会有功能性影响。