Jak komentować w CoffeeScript? „/ * This * /” nie działa

W jaki sposób możesz komentować w CoffeeScript?

Dokumentacja mówi, że możesz użyć trzech symboli skrótu, aby rozpocząć i zamknąć blok komentarza:

###
  Comments
  go
  here
###

Odkryłem, że czasami mogę używać następujących dwóch formatów

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

Czy istnieje prostszy sposób wstawiania krótkich komentarzy w CoffeeScript?

NIE używaj tego stylu **

Ponieważ zbiera to dużo wyświetleń, chcę to podkreślić

/* Comment goes here */

generuje błąd MATH, gdy /*znajduje się w osobnym wierszu.

Jak zauważył Trevor w komentarzu do pytania, jest to wyrażenie regularne , a NIE komentarz!

Użyj pojedynczego znaku #

# like this

Jedna postać wydaje się dość minimalna;)

Również:

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

Głównym sposobem komentowania są komentarze w stylu sh / Perl / Ruby / ... #:

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

Używasz komentarzy w stylu blokowym,### gdy chcesz, aby komentarz pojawił się w wersji JavaScript:

Czasami chcesz przekazać komentarz blokowy do wygenerowanego kodu JavaScript. Na przykład, gdy musisz osadzić nagłówek licencji na górze pliku. Komentarze blokowe, które odzwierciedlają składnię heredoców, są zachowywane w wygenerowanym kodzie.

Więc jeśli zaczniesz od

###
PancakeParser is Public Domain
###

wtedy w wygenerowanym skrypcie JavaScript pojawi się ten komentarz JavaScript:

/*
PancakeParser is Public Domain
*/

Uważać na ###! Jeśli używasz ### do oddzielania sekcji kodu (tak jak ja), jest to strasznie zaskakujące, gdy w rezultacie kod przestaje działać.