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

Question

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

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

Answer 1

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

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

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

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

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

Answer 2

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