Комментирование кода на схеме

Я просматриваю какой-то код в Scheme из Festival и не могу представить комментарии. В настоящее время я могу видеть ;, ;; и ;;;, используемые для указания строк комментариев. Другие источники в Интернете показывают, что некоторые из вышеперечисленных способов могут указывать многострочные комментарии. Мои вопросы:

В чем разница между ;, ;; и ;;; для комментариев?
Когда один из них используется другим?
Есть ли другой, IMO saner, способ прокомментировать код в Scheme?

Ответ 1

Символ комментария; и все, что после этого на линии будет проигнорировано. Разница визуальная. Я часто видел сингл; используется, если комментарий находится в строке с кодом;;; если комментарий находится по одной строке, и;;; если это какой-то заголовок. Самое важное в комментариях, вероятно, будет следовать любым соглашениям, которые вы видите в коде, с которым работаете.

Ответ 2

Все три формы, которые вы упоминаете, являются однострочными комментариями. Двойная точка с запятой, возможно, первоначально возникла как реплика в наборе наборов Dorai Sitaram SLaTeX, который должен был набираться как обычный текст, а не как текст программы.

В схеме также есть многострочные комментарии.

В частности, похоже, что R6RS, например Racket, позволяет использовать #| и |# для начала и завершения многострочных комментариев. Кроме того, совершенно великолепная комбинация #; комментирует полное s-выражение. Так, например, если вы пишете

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

Все определение считается закомментированным.