Fixes jashkenas#3132 - Improve rendering of block-comments

Author: Caitlin Potter

lib/coffee-script/nodes.js

@@ -556,7 +556,8 @@ exports.Comment = class Comment extends Base
   makeReturn:      THIS
 
   compileNode: (o, level) ->
-    code = "/*#{multident @comment, @tab}#{if '\n' in @comment then "\n#{@tab}" else ''}*/"
+    comment = @comment.replace /^(\s*)#/gm, "$1 *"
+    code = "/*#{multident comment, @tab}#{if '\n' in comment then "\n#{@tab}" else ''} */"
     code = o.indent + code if (level or o.level) is LEVEL_TOP
     [@makeCode("\n"), @makeCode(code)]
 

src/nodes.coffee

@@ -211,3 +211,24 @@ test "#2916: block comment before implicit call with implicit object", ->
   ### ###
   fn
     a: yes
+
+test "#3132: format block comments prettily", ->
+  cmp = CoffeeScript.compile
+  eq cmp("###\n# Multi-line\n# block\n# comment\n###", bare: on),
+    "\n/*\n * Multi-line\n * block\n * comment\n */\n\n"
+  eq cmp("###\nNot indented\n###\n", bare: on),
+    "\n/*\nNot indented\n */\n\n"
+  eq cmp("fn = () ->\n  ###\n  # Indented\nMultiline\n  ###\n  1", bare: on),
+    """
+    var fn;
+
+    fn = function() {
+
+      /*
+       * Indented
+      Multiline
+       */
+      return 1;
+    };
+
+    """