Ведение комментариев в файлах .js после компиляции из .coffee

Question

Я бы хотел, чтобы комментарии, которые я пишу в файлах CoffeeScript, оставались нетронутыми в выходных файлах JavaScript.Как я могу это сделать?

#!/usr/bin/env bash

./node_modules/.bin/coffee --output lib/ --compile --bare --watch src/

Answer 1

Из документации сценария кофе :

Блочные комментарии, которые отражают синтаксис heredocs, сохраняются в сгенерированном коде.

Это (заимствуя из ответа typeonerror ниже - аккуратно!):

###*
# This will be preserved in a block comment in the javascript
###

Компилирует к этому:

/**
 * This will be preserved in a block comment in the javascript
 */

Answer 2

Расширяя ответ Линуса выше, я обнаружил, что это лучший стиль для получения желаемого стиля комментария:

###*
# Hello world
# @param Object object
# @return String
###

Добавление первых ### ворот запускает комментарий и дополнительные * дает нам

/**
 * Hello world
 * @param Object object
 * @return String
 */