Add a try/catch in the Error.prepareStackTrace implementation to make…
… sure that it never throws. Resolves jashkenas/coffeescript#4391.

… sure that it never throws. Resolves jashkenas/coffeescript#4391.
Remove Error.prepareStackTrace and the related source map code. Fixes j…
…ashkenas/coffeescript#4391
jashkenas · murrayju · murrayju · jashkenas · haberbyte · mdcb
diff --git a/.gitignore b/.gitignore
@@ -3,8 +3,6 @@ presentation
 test.coffee
 test.litcoffee
 parser.output
-test/fixtures/underscore
 test/*.js
-examples/beautiful_code/parse.coffee
-*.gem
 /node_modules
+npm-debug.log
diff --git a/Cakefile b/Cakefile
@@ -25,7 +25,7 @@ header = """
 """
 
 # Used in folder names like docs/v1
-majorVersion = CoffeeScript.VERSION.split('.')[0]
+majorVersion = parseInt CoffeeScript.VERSION.split('.')[0], 10
 
 # Build the CoffeeScript language from source.
 build = (cb) ->
@@ -90,7 +90,11 @@ task 'build:parser', 'rebuild the Jison parser (run build first)', ->
 
 
 task 'build:browser', 'rebuild the merged script for inclusion in the browser', ->
-  code = ''
+  code = """
+  require['../../package.json'] = (function() {
+    return #{fs.readFileSync "./package.json"};
+  })();
+  """
   for name in ['helpers', 'rewriter', 'lexer', 'parser', 'scope', 'nodes', 'sourcemap', 'coffee-script', 'browser']
     code += """
       require['./#{name}'] = (function() {
@@ -115,87 +119,109 @@ task 'build:browser', 'rebuild the merged script for inclusion in the browser',
     }(this));
   """
   unless process.env.MINIFY is 'false'
-    {compiledCode} = require('google-closure-compiler-js').compile
+    {compiledCode: code} = require('google-closure-compiler-js').compile
       jsCode: [
         src: code
         languageOut: if majorVersion is 1 then 'ES5' else 'ES6'
       ]
   outputFolder = "docs/v#{majorVersion}/browser-compiler"
   fs.mkdirSync outputFolder unless fs.existsSync outputFolder
-  fs.writeFileSync "#{outputFolder}/coffee-script.js", header + '\n' + compiledCode
+  fs.writeFileSync "#{outputFolder}/coffee-script.js", header + '\n' + code
   console.log "built ... running browser tests:"
   invoke 'test:browser'
 
 
 task 'doc:site', 'watch and continually rebuild the documentation for the website', ->
+  # Constants
+  indexFile = 'documentation/index.html'
+  versionedSourceFolder = "documentation/v#{majorVersion}"
+  sectionsSourceFolder = 'documentation/sections'
+  examplesSourceFolder = 'documentation/examples'
+  outputFolder = "docs/v#{majorVersion}"
+
   # Helpers
-  css = fs.readFileSync('./documentation/css/docs.css', 'utf-8') + '\n' +
-        fs.readFileSync('./documentation/css/tomorrow.css', 'utf-8')
-
-  logo = fs.readFileSync './documentation/images/logo.svg', 'utf-8'
-
-  codeFor = ->
-    counter = 0
-    hljs = require 'highlight.js'
-    hljs.configure classPrefix: ''
-    (file, executable = false, showLoad = true) ->
-      counter++
-      return unless fs.existsSync "docs/v#{majorVersion}/examples/#{file}.js"
-      cs = fs.readFileSync "documentation/examples/#{file}.coffee", 'utf-8'
-      js = fs.readFileSync "docs/v#{majorVersion}/examples/#{file}.js", 'utf-8'
-      js = js.replace /^\/\/ generated.*?\n/i, ''
-
-      cshtml = "<pre><code>#{hljs.highlight('coffeescript', cs).value}</code></pre>"
-      # Temporary fix until highlight.js adds support for newer CoffeeScript keywords
-      # Added in https://github.com/isagalaev/highlight.js/pull/1357, awaiting release
-      if file in ['generator_iteration', 'generators', 'modules']
-        cshtml = cshtml.replace /(yield|import|export|from|as|default) /g, '<span class="keyword">$1</span> '
-      jshtml = "<pre><code>#{hljs.highlight('javascript', js).value}</code></pre>"
-      append = if executable is yes then '' else "alert(#{executable});".replace /"/g, '&quot;'
-      if executable and executable isnt yes
-        cs.replace /(\S)\s*\Z/m, "$1\n\nalert #{executable}"
-      run    = if executable is true then 'run' else "run: #{executable}"
-      name   = "example#{counter}"
-      script = "<script>window.#{name} = #{JSON.stringify cs}</script>"
-      load   = if showLoad then "<div class='minibutton load' onclick='javascript: loadConsole(#{name});'>load</div>" else ''
-      button = if executable then """<div class="minibutton ok" onclick="javascript: #{js.replace /"/g, '&quot;'};#{append}">#{run}</div>""" else ''
-      "<div class='code'>#{cshtml}#{jshtml}#{script}#{load}#{button}<br class='clear' /></div>"
-
-  monthNames = [
-    'January'
-    'February'
-    'March'
-    'April'
-    'May'
-    'June'
-    'July'
-    'August'
-    'September'
-    'October'
-    'November'
-    'December'
-  ]
-
-  formatDate = (date) ->
-    date.replace /^(\d\d\d\d)-(\d\d)-(\d\d)$/, (match, $1, $2, $3) ->
-      "#{monthNames[$2 - 1]} #{+$3}, #{$1}"
-
-  releaseHeader = (date, version, prevVersion) -> """
-    <div class="anchor" id="#{version}"></div>
-    <b class="header">
-      #{prevVersion and "<a href=\"https://github.com/jashkenas/coffeescript/compare/#{prevVersion}...#{version}\">#{version}</a>" or version}
-      <span class="timestamp"> &mdash; <time datetime="#{date}">#{formatDate date}</time></span>
-    </b>
-  """
+  releaseHeader = (date, version, prevVersion) ->
+    monthNames = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']
+
+    formatDate = (date) ->
+      date.replace /^(\d\d\d\d)-(\d\d)-(\d\d)$/, (match, $1, $2, $3) ->
+        "#{monthNames[$2 - 1]} #{+$3}, #{$1}"
 
+    """
+      <div class="anchor" id="#{version}"></div>
+      <h2 class="header">
+        #{prevVersion and "<a href=\"https://github.com/jashkenas/coffeescript/compare/#{prevVersion}...#{version}\">#{version}</a>" or version}
+        <span class="timestamp"> &mdash; <time datetime="#{date}">#{formatDate date}</time></span>
+      </h2>
+    """
+
+  codeFor = require "./documentation/v#{majorVersion}/code.coffee"
+
+  htmlFor = ->
+    marked = require 'marked'
+    markdownRenderer = new marked.Renderer()
+    markdownRenderer.heading = (text, level) ->
+      "<h#{level}>#{text}</h#{level}>" # Don’t let marked add an id
+    markdownRenderer.code = (code) ->
+      if code.indexOf('codeFor(') is 0 or code.indexOf('releaseHeader(') is 0
+        "<%= #{code} %>"
+      else
+        "<pre><code>#{code}</code></pre>" # Default
+
+    (file, bookmark) ->
+      md = fs.readFileSync "#{sectionsSourceFolder}/#{file}.md", 'utf-8'
+      md = md.replace /<%= releaseHeader %>/g, releaseHeader
+      md = md.replace /<%= majorVersion %>/g, majorVersion
+      md = md.replace /<%= fullVersion %>/g, CoffeeScript.VERSION
+      html = marked md, renderer: markdownRenderer
+      html = _.template(html)
+        codeFor: codeFor()
+        releaseHeader: releaseHeader
+
+  include = ->
+    (file) ->
+      file = "#{versionedSourceFolder}/#{file}" if file.indexOf('/') is -1
+      output = fs.readFileSync file, 'utf-8'
+      if /\.html$/.test(file)
+        render = _.template output
+        output = render
+          releaseHeader: releaseHeader
+          majorVersion: majorVersion
+          fullVersion: CoffeeScript.VERSION
+          htmlFor: htmlFor()
+          codeFor: codeFor()
+          include: include()
+      output
+
+  # Task
+  do renderIndex = ->
+    render = _.template fs.readFileSync(indexFile, 'utf-8')
+    output = render
+      include: include()
+    fs.writeFileSync "#{outputFolder}/index.html", output
+    log 'compiled', green, "#{indexFile} → #{outputFolder}/index.html"
+  try
+    fs.symlinkSync "v#{majorVersion}/index.html", 'docs/index.html'
+  catch exception
+
+  for target in [indexFile, versionedSourceFolder, examplesSourceFolder, sectionsSourceFolder]
+    fs.watch target, interval: 200, renderIndex
+  log 'watching...' , green
+
+
+task 'doc:test', 'watch and continually rebuild the browser-based tests', ->
+  # Constants
+  testFile = 'documentation/test.html'
+  testsSourceFolder = 'test'
+  outputFolder = "docs/v#{majorVersion}"
+
+  # Included in test.html
   testHelpers = fs.readFileSync('test/support/helpers.coffee', 'utf-8').replace /exports\./g, '@'
 
+  # Helpers
   testsInScriptBlocks = ->
     output = ''
-    excludedTestFiles = ['error_messages.coffee']
-    for filename in fs.readdirSync 'test'
-      continue if filename in excludedTestFiles
-
+    for filename in fs.readdirSync testsSourceFolder
       if filename.indexOf('.coffee') isnt -1
         type = 'coffeescript'
       else if filename.indexOf('.litcoffee') isnt -1
@@ -213,41 +239,16 @@ task 'doc:site', 'watch and continually rebuild the documentation for the websit
     output
 
   # Task
-  examplesSourceFolder = 'documentation/examples'
-  examplesOutputFolder = "docs/v#{majorVersion}/examples"
-  fs.mkdirSync examplesOutputFolder unless fs.existsSync examplesOutputFolder
-  do renderExamples = ->
-    execSync "bin/coffee -bc -o #{examplesOutputFolder} #{examplesSourceFolder}/*.coffee"
-
-  indexFile = 'documentation/index.html'
-  do renderIndex = ->
-    render = _.template fs.readFileSync(indexFile, 'utf-8')
-    output = render
-      css: css
-      logo: logo
-      codeFor: codeFor()
-      releaseHeader: releaseHeader
-      majorVersion: majorVersion
-      fullVersion: CoffeeScript.VERSION
-    fs.writeFileSync "docs/v#{majorVersion}/index.html", output
-    log 'compiled', green, "#{indexFile} → docs/v#{majorVersion}/index.html"
-
-  testFile = 'documentation/test.html'
   do renderTest = ->
     render = _.template fs.readFileSync(testFile, 'utf-8')
     output = render
       testHelpers: testHelpers
       tests: testsInScriptBlocks()
-      majorVersion: majorVersion
-    fs.writeFileSync "docs/v#{majorVersion}/test.html", output
-    log 'compiled', green, "#{testFile} → docs/v#{majorVersion}/test.html"
-
-  fs.watch examplesSourceFolder, interval: 200, ->
-    renderExamples()
-    renderIndex()
-  fs.watch indexFile, interval: 200, renderIndex
-  fs.watch testFile, interval: 200, renderTest
-  fs.watch 'test', interval: 200, renderTest
+    fs.writeFileSync "#{outputFolder}/test.html", output
+    log 'compiled', green, "#{testFile} → #{outputFolder}/test.html"
+
+  for target in [testFile, testsSourceFolder]
+    fs.watch target, interval: 200, renderTest
   log 'watching...' , green
 
 
diff --git a/docs/v1/.gitignore b/docs/v1/.gitignore
@@ -1 +0,0 @@
-examples/