Merge pull request #2417 from gabehollombe/doc_for_switch_with_no_control_expression

Documentation for switch statements with no control expression

Author: jashkenas

documentation/coffee/constructor_destructuring.coffee

@@ -0,0 +1,4 @@
+class Person
+  constructor: (options) -> 
+    {@name, @age, @height} = options
+

documentation/coffee/switch_with_no_expression.coffee

@@ -0,0 +1,8 @@
+score = 76
+grade = switch
+  when score < 60 then 'F'
+  when score < 70 then 'D'
+  when score < 80 then 'C'
+  when score < 90 then 'B'
+  else 'A'
+# grade == 'C'

documentation/index.html.erb

@@ -812,6 +812,11 @@ Expressions
       Destructuring assignment can even be combined with splats.
     </p>
     <%= code_for('patterns_and_splats', 'contents.join("")') %>
+    <p>
+      Destructuring assignment is also useful when combined with class constructors 
+      to assign propeties to your instance from an options object passed to the constructor.
+    </p>
+    <%= code_for('constructor_destructuring', 'contents.join("")') %>
 
     <p>
       <span id="fat-arrow" class="bookmark"></span>
@@ -869,6 +874,11 @@ Expressions
     </p>
     <%= code_for('switch') %>
 
+    <p>
+      Switch statements can also be used without a control expression, turning them in to a cleaner alternative to if/else chains.
+    </p>
+    <%= code_for('switch_with_no_expression') %>
+
     <p>
       <span id="try" class="bookmark"></span>
       <b class="header">Try/Catch/Finally</b>

documentation/js/constructor_destructuring.js

@@ -1786,6 +1786,37 @@ <h2>
 tag = "<impossible>";
 
 _ref = tag.split(""), open = _ref[0], contents = 3 <= _ref.length ? __slice.call(_ref, 1, _i = _ref.length - 1) : (_i = 1, []), close = _ref[_i++];
+;alert(contents.join(""));'>run: contents.join("")</div><br class='clear' /></div>
+    <p>
+      Destructuring assignment is also useful when combined with class constructors 
+      to assign propeties to your instance from an options object passed to the constructor.
+    </p>
+    <div class='code'><pre class="idle">class Person
+  constructor: (options) -&gt; 
+    {@name, @age, @height} = options
+
+</pre><pre class="idle"><span class="Storage">var</span> Person;
+
+Person <span class="Keyword">=</span> (<span class="Storage">function</span>() {
+
+  <span class="Storage">function</span> <span class="FunctionName">Person</span>(<span class="FunctionArgument">options</span>) {
+    <span class="Variable">this</span>.<span class="LibraryConstant">name</span> <span class="Keyword">=</span> options.<span class="LibraryConstant">name</span>, <span class="Variable">this</span>.age <span class="Keyword">=</span> options.age, <span class="Variable">this</span>.<span class="LibraryConstant">height</span> <span class="Keyword">=</span> options.<span class="LibraryConstant">height</span>;
+  }
+
+  <span class="Keyword">return</span> Person;
+
+})();
+</pre><script>window.example29 = "class Person\n  constructor: (options) -> \n    {@name, @age, @height} = options\n\nalert contents.join(\"\")"</script><div class='minibutton load' onclick='javascript: loadConsole(example29);'>load</div><div class='minibutton ok' onclick='javascript: var Person;
+
+Person = (function() {
+
+  function Person(options) {
+    this.name = options.name, this.age = options.age, this.height = options.height;
+  }
+
+  return Person;
+
+})();
 ;alert(contents.join(""));'>run: contents.join("")</div><br class='clear' /></div>
 
     <p>