Release 2.4.0 (#5182)

* cake doc:site:watch should also watch the changelog files

* Changelog for 2.4.0

* 2.4.0 output

Author: GeoffreyBooth

Cakefile

@@ -192,11 +192,12 @@ task 'build:watch:harmony', 'watch and continually rebuild the CoffeeScript comp
 
 buildDocs = (watch = no) ->
   # Constants
-  indexFile            = 'documentation/site/index.html'
-  siteSourceFolder     = "documentation/site"
-  sectionsSourceFolder = 'documentation/sections'
-  examplesSourceFolder = 'documentation/examples'
-  outputFolder         = "docs/v#{majorVersion}"
+  indexFile             = 'documentation/site/index.html'
+  siteSourceFolder      = "documentation/site"
+  sectionsSourceFolder  = 'documentation/sections'
+  changelogSourceFolder = 'documentation/sections/changelog'
+  examplesSourceFolder  = 'documentation/examples'
+  outputFolder          = "docs/v#{majorVersion}"
 
   # Helpers
   releaseHeader = (date, version, prevVersion) ->
@@ -279,7 +280,7 @@ buildDocs = (watch = no) ->
   catch exception
 
   if watch
-    for target in [indexFile, siteSourceFolder, examplesSourceFolder, sectionsSourceFolder]
+    for target in [indexFile, siteSourceFolder, examplesSourceFolder, sectionsSourceFolder, changelogSourceFolder]
       fs.watch target, interval: 200, renderIndex
     log 'watching...', green
 

docs/v2/browser-compiler-modern/coffeescript.js

@@ -1,5 +1,5 @@
 /**
- * CoffeeScript Compiler v2.3.2
+ * CoffeeScript Compiler v2.4.0
  * https://coffeescript.org
  *
  * Copyright 2011, Jeremy Ashkenas
@@ -18,7 +18,7 @@ var CoffeeScript = function() {
     "compiler"
   ],
   "author": "Jeremy Ashkenas",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "license": "MIT",
   "engines": {
     "node": ">=6"
@@ -66,7 +66,7 @@ var CoffeeScript = function() {
 ;
 })();require['./helpers'] = (function() {
   var exports = {}, module = {exports: exports};
-  // Generated by CoffeeScript 2.3.2
+  // Generated by CoffeeScript 2.4.0
 (function() {
   // This file contains the common helper functions that we'd like to share among
   // the **Lexer**, **Rewriter**, and the **Nodes**. Merge objects, flatten
@@ -420,7 +420,7 @@ var CoffeeScript = function() {
   return module.exports;
 })();require['./rewriter'] = (function() {
   var exports = {}, module = {exports: exports};
-  // Generated by CoffeeScript 2.3.2
+  // Generated by CoffeeScript 2.4.0
 (function() {
   // The CoffeeScript language has a good deal of optional syntax, implicit syntax,
   // and shorthand syntax. This can greatly complicate a grammar and bloat
@@ -1440,7 +1440,7 @@ var CoffeeScript = function() {
   return module.exports;
 })();require['./lexer'] = (function() {
   var exports = {}, module = {exports: exports};
-  // Generated by CoffeeScript 2.3.2
+  // Generated by CoffeeScript 2.4.0
 (function() {
   // The CoffeeScript Lexer. Uses a series of token-matching regexes to attempt
   // matches against the beginning of the source code. When a match is found,
@@ -4295,7 +4295,7 @@ if (typeof module !== 'undefined' && require.main === module) {
   return module.exports;
 })();require['./scope'] = (function() {
   var exports = {}, module = {exports: exports};
-  // Generated by CoffeeScript 2.3.2
+  // Generated by CoffeeScript 2.4.0
 (function() {
   // The **Scope** class regulates lexical scoping within CoffeeScript. As you
   // generate code, you create a tree of scopes in the same shape as the nested
@@ -4486,7 +4486,7 @@ if (typeof module !== 'undefined' && require.main === module) {
   return module.exports;
 })();require['./nodes'] = (function() {
   var exports = {}, module = {exports: exports};
-  // Generated by CoffeeScript 2.3.2
+  // Generated by CoffeeScript 2.4.0
 (function() {
   // `nodes.coffee` contains all of the node classes for the syntax tree. Most
   // nodes are created as the result of actions in the [grammar](grammar.html),
@@ -10394,7 +10394,7 @@ if (typeof module !== 'undefined' && require.main === module) {
   return module.exports;
 })();require['./sourcemap'] = (function() {
   var exports = {}, module = {exports: exports};
-  // Generated by CoffeeScript 2.3.2
+  // Generated by CoffeeScript 2.4.0
 (function() {
   // Source maps allow JavaScript runtimes to match running JavaScript back to
   // the original source code that corresponds to it. This can be minified
@@ -10609,7 +10609,7 @@ if (typeof module !== 'undefined' && require.main === module) {
   return module.exports;
 })();require['./coffeescript'] = (function() {
   var exports = {}, module = {exports: exports};
-  // Generated by CoffeeScript 2.3.2
+  // Generated by CoffeeScript 2.4.0
 (function() {
   // CoffeeScript can be used both on the server, as a command-line compiler based
   // on Node.js/V8, or to run CoffeeScript directly in the browser. This module
@@ -11062,7 +11062,7 @@ if (typeof module !== 'undefined' && require.main === module) {
   return module.exports;
 })();require['./browser'] = (function() {
   var exports = {}, module = {exports: exports};
-  // Generated by CoffeeScript 2.3.2
+  // Generated by CoffeeScript 2.4.0
 (function() {
   // This **Browser** compatibility layer extends core CoffeeScript functions
   // to make things work smoothly when compiling code directly in the browser.

docs/v2/browser-compiler/coffeescript.js

@@ -693,7 +693,7 @@
       <section id="introduction">
         <p><strong>CoffeeScript is a little language that compiles into JavaScript.</strong> Underneath that awkward Java-esque patina, JavaScript has always had a gorgeous heart. CoffeeScript is an attempt to expose the good parts of JavaScript in a simple way.</p>
 <p>The golden rule of CoffeeScript is: <em>“It’s just JavaScript.”</em> The code compiles one-to-one into the equivalent JS, and there is no interpretation at runtime. You can use any existing JavaScript library seamlessly from CoffeeScript (and vice-versa). The compiled output is readable, pretty-printed, and tends to run as fast or faster than the equivalent handwritten JavaScript.</p>
-<p><strong>Latest Version:</strong> <a href="https://github.com/jashkenas/coffeescript/tarball/2.3.2">2.3.2</a></p>
+<p><strong>Latest Version:</strong> <a href="https://github.com/jashkenas/coffeescript/tarball/2.4.0">2.4.0</a></p>
 <blockquote class="uneditable-code-block"><pre><code class="language-bash"><span class="comment"># Install locally for a project:</span>
 npm install --save-dev coffeescript
 
@@ -4408,6 +4408,7 @@ <h2>Modules</h2>
   </div>
 
 </aside>
+<div id="dynamic-import" class="bookmark"></div>
 <p><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#Dynamic_Imports">Dynamic import</a> is also supported, with mandatory parentheses:</p>
 <aside class="code-example container-fluid bg-ribbed-dark" data-example="dynamic_import">
   <div class="row">
@@ -4900,7 +4901,7 @@ <h2>Web Chat (IRC)</h2>
         </section>
         <section id="annotated-source">
           <h2>Annotated Source</h2>
-<p>You can browse the CoffeeScript 2.3.2 source in readable, annotated form <a href="annotated-source/">here</a>. You can also jump directly to a particular source file:</p>
+<p>You can browse the CoffeeScript 2.4.0 source in readable, annotated form <a href="annotated-source/">here</a>. You can also jump directly to a particular source file:</p>
 <ul>
 <li><a href="annotated-source/grammar.html">Grammar Rules — src/grammar</a></li>
 <li><a href="annotated-source/lexer.html">Lexing Tokens — src/lexer</a></li>
@@ -5578,6 +5579,17 @@ <h3>Argument parsing and shebang (<code>#!</code>) lines</h3>
       <section id="changelog">
         <h2>Changelog</h2>
 
+        <section id="2.4.0">
+          <h3><a href="https://github.com/jashkenas/coffeescript/compare/2.3.2...2.4.0">2.4.0</a>
+  <span class="timestamp"> &mdash; <time datetime="2019-03-29">2019-03-29</time></span>
+</h3><ul>
+<li>Dynamic <code>import()</code> expressions are now supported. The parentheses are always required, to distinguish from <code>import</code> statements. See <a href="#dynamic-import">Modules</a>. Note that as of this writing, the JavaScript feature itself is still Stage 3; if it changes before being fully standardized, it may change in CoffeeScript too. Using <code>import()</code> before its upstream <a href="https://github.com/tc39/proposal-dynamic-import">ECMAScript proposal</a> is finalized should be considered provisional, subject to breaking changes if the proposal changes or is rejected. We have also revised our <a href="#contributing">policy</a> on Stage 3 ECMAScript features, to support them when the features are <a href="https://caniuse.com/#feat=es6-module-dynamic-import">shipped</a> in significant runtimes such as major browsers or Node.js.</li>
+<li>There are now two browser versions of the CoffeeScript compiler: the traditional one that’s been published for years, and a new <a href="/browser-compiler-modern/coffeescript.js">ES module version</a> that can be used via <code>import</code>. If your browser supports it, it is in effect on this page. A reference to the ES module browser compiler is in the <code>package.json</code> <code>&quot;module&quot;</code> field.</li>
+<li>The Node API now exposes the previously private <code>registerCompiled</code> method, to allow plugins that use the <code>coffeescript</code> package to take advantage of CoffeeScript’s internal caching.</li>
+<li>Bugfixes for commas in strings in block arrays, a reference to <code>@</code> not being maintained in a <code>do</code> block in a class, and function default parameters should no longer be wrapped by extraneous parentheses.</li>
+</ul>
+
+        </section>
         <section id="2.3.2">
           <h3><a href="https://github.com/jashkenas/coffeescript/compare/2.3.1...2.3.2">2.3.2</a>
   <span class="timestamp"> &mdash; <time datetime="2018-09-19">2018-09-19</time></span>

docs/v2/index.html

@@ -0,0 +1,8 @@
+```
+releaseHeader('2019-03-29', '2.4.0', '2.3.2')
+```
+
+*   Dynamic `import()` expressions are now supported. The parentheses are always required, to distinguish from `import` statements. See [Modules](#dynamic-import). Note that as of this writing, the JavaScript feature itself is still Stage 3; if it changes before being fully standardized, it may change in CoffeeScript too. Using `import()` before its upstream [ECMAScript proposal](https://github.com/tc39/proposal-dynamic-import) is finalized should be considered provisional, subject to breaking changes if the proposal changes or is rejected. We have also revised our [policy](#contributing) on Stage 3 ECMAScript features, to support them when the features are [shipped](https://caniuse.com/#feat=es6-module-dynamic-import) in significant runtimes such as major browsers or Node.js.
+*   There are now two browser versions of the CoffeeScript compiler: the traditional one that’s been published for years, and a new [ES module version](/browser-compiler-modern/coffeescript.js) that can be used via `import`. If your browser supports it, it is in effect on this page. A reference to the ES module browser compiler is in the `package.json` `"module"` field.
+*   The Node API now exposes the previously private `registerCompiled` method, to allow plugins that use the `coffeescript` package to take advantage of CoffeeScript’s internal caching.
+*   Bugfixes for commas in strings in block arrays, a reference to `@` not being maintained in a `do` block in a class, and function default parameters should no longer be wrapped by extraneous parentheses.

documentation/sections/changelog/2.4.0.md

@@ -6,6 +6,8 @@ ES2015 modules are supported in CoffeeScript, with very similar `import` and `ex
 codeFor('modules')
 ```
 
+<div id="dynamic-import" class="bookmark"></div>
+
 [Dynamic import](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#Dynamic_Imports) is also supported, with mandatory parentheses:
 
 ```

documentation/sections/modules.md

@@ -207,6 +207,9 @@
       </section>
       <section id="changelog">
         <%= htmlFor('changelog') %>
+        <section id="2.4.0">
+          <%= htmlFor('changelog/2.4.0') %>
+        </section>
         <section id="2.3.2">
           <%= htmlFor('changelog/2.3.2') %>
         </section>