Как мне комментировать в CoffeeScript? «/ * Это * /» не работает

Каким образом вы можете комментировать в CoffeeScript?

В документации сказано, что вы можете использовать три символа хеша для запуска и закрытия блока комментариев:

###
  Comments
  go
  here
###

Я обнаружил, что иногда могу использовать следующие два формата

`// backticks allow for straight-JavaScript,
 // but the closing backtick can't be on a comment line (I think?)
`

Есть ли более простой способ вставить короткие комментарии в CoffeeScript?

НЕ используйте этот стиль **

Так как это получает много мнений, я хочу подчеркнуть, что

/* Comment goes here */

выдает ошибку MATH, когда /*находится на отдельной строке.

Как отметил Тревор в комментарии к вопросу, это регулярное выражение , а не комментарий!

Используйте один знак #

# like this

Один персонаж кажется довольно минимальным;)

Также:

###
This block comment (useful for ©-Copyright info) also gets 
passed on to the browsers HTML /* like this! */
###

Основной способ комментирования - это #комментарии в стиле sh / Perl / Ruby / ... :

# This comment goes to the end of the line
# and it won't appear in the "compiled"
# JavaScript version.

Вы используете комментарии стиля блока,### когда хотите, чтобы комментарий появился в версии JavaScript:

Иногда вы хотите передать блочный комментарий в сгенерированный JavaScript. Например, когда вам нужно вставить лицензионный заголовок вверху файла. Блочные комментарии, которые отражают синтаксис heredocs, сохраняются в сгенерированном коде.

Так что, если вы начнете с

###
PancakeParser is Public Domain
###

тогда вы получите этот комментарий JavaScript в сгенерированном JavaScript:

/*
PancakeParser is Public Domain
*/

Остерегаться ###! Если вы используете ### для разделения разделов кода (как и я), то это очень удивительно, когда этот код перестает работать в результате.