评论Scheme中的代码

Question

我正在查看来自Scheme的{​​{1}}中的一些代码，似乎无法弄清楚这些评论。目前，我可以看到Festival，;和;;用于表示评论行。网上的其他消息来源表明，上述某些方法可能是表明多行评论的方式。我的问题是：

1. ;;;，;和;;之间的评论区别是什么？
2. 何时使用另一个？
3. 在;;;中是否还有其他IMO标注方式来评论代码？

Answer 1

您提到的所有三种表单都是单行注释。双分号最初可能是Dorai Sitaram的SLaTeX排版包中的一个提示，该评论将被排版为普通文本，而不是程序文本。

Scheme也有多行注释。

特别是，似乎R6RS与Racket一样，允许使用#|和|#来开始和结束多行注释。此外，完全华丽的#;组合评论了一个完整的s表达式。所以，例如，如果你写

#;(define (terrible-function a)
    (totally-broken-code
     here))

整个定义被视为已注释掉。

Answer 2

评论字符是;并且该行上的任何内容都将被忽略。区别在于视觉效果。我经常看到一个;如果注释在带代码的行上，则使用;;;如果评论单独在一条线上，并且;;;如果它是某种类型的标题。评论中最重要的事情可能是遵循您在使用的代码中看到的任何约定。

Answer 3

MIT / GNU方案允许将;用于单行注释，并将#|和|#用于打开和关闭多行注释。刚刚在10.1.10版上进行了测试。