\n#{code}\n"
+ "#{code}The golden rule of CoffeeScript is: “It’s just JavaScript”. 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.
The CoffeeScript compiler goes to great lengths to generate output JavaScript that runs in every JavaScript runtime, but there are exceptions. Use generator functions, for…from, or tagged template literals only if you know that your target runtimes can support them. If you use modules, you will need to use an additional tool to resolve them.
Latest Version: 1.12.1
--npm install -g coffee-script -+
++npm install -g coffee-script
The CoffeeScript compiler is itself written in CoffeeScript, using the Jison parser generator. The command-line version of coffee is available as a Node.js utility. The core compiler however, does not depend on Node, and can be run in any JavaScript environment, or in the browser (see “Try CoffeeScript”, above).
To install, first make sure you have a working copy of the latest stable version of Node.js. You can then install CoffeeScript globally with npm:
--npm install -g coffee-script -
When you need CoffeeScript as a dependency, install it locally:
--npm install --save coffee-script -
If you’d prefer to install the latest master version of CoffeeScript, you can clone the CoffeeScript source repository from GitHub, or download the source directly. To install the latest master CoffeeScript compiler with npm:
--npm install -g jashkenas/coffeescript -
Or, if you want to install to /usr/local, and don’t want to use npm to manage it, open the coffee-script directory and run:
-sudo bin/cake install -+
++npm install -g coffee-script
When you need CoffeeScript as a dependency, install it locally:
+++npm install --save coffee-script
If you’d prefer to install the latest master version of CoffeeScript, you can clone the CoffeeScript source repository from GitHub, or download the source directly. To install the latest master CoffeeScript compiler with npm:
+++npm install -g jashkenas/coffeescript
Or, if you want to install to /usr/local, and don’t want to use npm to manage it, open the coffee-script directory and run:
++sudo bin/cake install
-n, --nodesBlock
+Block
Assign
Value IdentifierLiteral: square
Code
@@ -890,8 +884,7 @@ sudo bin/cake install
Block
Op *
Value IdentifierLiteral: x
- Value IdentifierLiteral: x
-
+ Value IdentifierLiteral: x
yield return can no longer mistakenly be used as an expression.yield now mirrors return in that it can be used stand-alone as well as with expressions. Where you previously wrote yield undefined, you may now write simply yield. However, this means also inheriting the same syntax limitations that return has, so these examples no longer compile:
doubles = -> +-doubles = -> yield for i in [1..3] i * 2 six = -> yield - 2 * 3
The JavaScript output is a bit nicer, with unnecessary parentheses and spaces, double indentation and double semicolons around yield no longer present.
doubles = ->
+ ```
+ doubles = ->
yield for i in [1..3]
i * 2
six = ->
yield
- 2 * 3
+ 2 * 3
+ ```
* The JavaScript output is a bit nicer, with unnecessary parentheses and spaces, double indentation and double semicolons around `yield` no longer present.
* `&&=`, `||=`, `and=` and `or=` no longer accidentally allow a space before the equals sign.
diff --git a/documentation/sections/installation.md b/documentation/sections/installation.md
index cba6ad8c..e44852f4 100644
--- a/documentation/sections/installation.md
+++ b/documentation/sections/installation.md
@@ -4,24 +4,24 @@ The CoffeeScript compiler is itself [written in CoffeeScript](v<%= majorVersion
To install, first make sure you have a working copy of the latest stable version of [Node.js](http://nodejs.org/). You can then install CoffeeScript globally with [npm](http://npmjs.org):
-```
+> ```
npm install -g coffee-script
```
When you need CoffeeScript as a dependency, install it locally:
-```
+> ```
npm install --save coffee-script
```
If you’d prefer to install the latest **master** version of CoffeeScript, you can clone the CoffeeScript [source repository](http://github.com/jashkenas/coffeescript) from GitHub, or download [the source](http://github.com/jashkenas/coffeescript/tarball/master) directly. To install the latest master CoffeeScript compiler with npm:
-```
+> ```
npm install -g jashkenas/coffeescript
```
Or, if you want to install to `/usr/local`, and don’t want to use npm to manage it, open the `coffee-script` directory and run:
-```
+> ```
sudo bin/cake install
```
diff --git a/documentation/sections/introduction.md b/documentation/sections/introduction.md
index f4e08db8..0f460cf2 100644
--- a/documentation/sections/introduction.md
+++ b/documentation/sections/introduction.md
@@ -6,6 +6,6 @@ The CoffeeScript compiler goes to great lengths to generate output JavaScript th
**Latest Version:** [<%= fullVersion %>](http://github.com/jashkenas/coffeescript/tarball/<%= fullVersion %>)
-```
+> ```
npm install -g coffee-script
```
diff --git a/documentation/sections/usage.md b/documentation/sections/usage.md
index 80f6913f..ab513667 100644
--- a/documentation/sections/usage.md
+++ b/documentation/sections/usage.md
@@ -125,9 +125,10 @@ Once installed, you should have access to the `coffee` command, which can execut
Block
+```
+Block
Assign
Value IdentifierLiteral: square
Code
@@ -135,8 +136,8 @@ Once installed, you should have access to the `coffee` command, which can execut
Block
Op *
Value IdentifierLiteral: x
- Value IdentifierLiteral: x
-
+ Value IdentifierLiteral: x
+```