web-dev-qa-db-fra.com

Comment commenter dans CoffeeScript? "/ * this * /" ne fonctionne pas

De quelles manières pouvez-vous commenter dans CoffeeScript?

La documentation indique que vous pouvez utiliser trois symboles de hachage pour démarrer et fermer un bloc de commentaires:

###
  Comments
  go
  here
###

J'ai découvert que je pouvais parfois utiliser les deux formats suivants

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

Existe-t-il un moyen plus simple d’insérer de courts commentaires dans CoffeeScript?

Ne pas utiliser ce style **

Comme cela suscite beaucoup de points de vue, je tiens à souligner que

/* Comment goes here */

produit une erreur MATH lorsque le /* est sur sa propre ligne.

Comme Trevor l'a souligné dans un commentaire sur la question, il s'agit d'un expression régulière, ET NON un commentaire!

139
Eric Hu

Utilisez un seul signe #

# like this

Un personnage semble assez minime;)

Aussi:

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

Le moyen principal de commenter est sh/Perl/Ruby/... style # commentaires:

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

Vous utilisez le style de bloc ### commentaires lorsque vous souhaitez qu'un commentaire apparaisse dans la version JavaScript:

Parfois, vous souhaitez transmettre un commentaire de blocage au code JavaScript généré. Par exemple, lorsque vous devez incorporer un en-tête de licence en haut d'un fichier. Les commentaires de bloc, qui reflètent la syntaxe de heredocs, sont conservés dans le code généré.

Donc si vous commencez par

###
PancakeParser is Public Domain
###

alors vous obtiendrez ce commentaire JavaScript dans le code JavaScript généré:

/*
PancakeParser is Public Domain
*/
24
mu is too short

Faîtes attention à ###! Si vous utilisez ### pour séparer des sections de code (comme je le fais), il est extrêmement surprenant de constater que ce code cesse de fonctionner.

3
Mark Wilden