making --run the default option for consistency. If you want to save the file, use -c or --compile.

Cakefile

@@ -25,7 +25,7 @@ task 'install', 'install CoffeeScript into /usr/local (or --prefix)', (options)
 task 'build', 'build the CoffeeScript language from source', ->
   files: fs.readdirSync 'src'
   files: 'src/' + file for file in files when file.match(/\.coffee$/)
-  run ['-o', 'lib'].concat(files)
+  run ['-c', '-o', 'lib'].concat(files)
 
 
 task 'build:parser', 'rebuild the Jison parser (run build first)', ->

documentation/index.html.erb

@@ -163,33 +163,33 @@ alert reverse '!tpircseeffoC'</textarea>
 sudo bin/cake install</pre>
 
     <p>
-      This provides the <tt>coffee</tt> command, which can
-      be used to compile CoffeeScript <tt>.coffee</tt> files into JavaScript, as
-      well as debug them. The <tt>coffee</tt>
-      command also provides direct evaluation and an interactive REPL.
+      This provides the <tt>coffee</tt> command, which will execute CoffeeScripts
+      under Node.js by default, but is also used to compile CoffeeScript 
+      <tt>.coffee</tt> files into JavaScript, or to run an an interactive REPL.
       When compiling to JavaScript, <tt>coffee</tt> writes the output
       as <tt>.js</tt> files in the same directory by default, but output
       can be customized with the following options:
     </p>
 
     <table>
+      <tr>
+        <td><code>-c, --compile</code></td>
+        <td>
+          Compile a <tt>.coffee</tt> script into a <tt>.js</tt> JavaScript file
+          of the same name.
+        </td>
+      </tr>
       <tr>
         <td width="25%"><code>-i, --interactive</code></td>
         <td>
           Launch an interactive CoffeeScript session to try short snippets.
         </td>
       </tr>
-      <tr>
-        <td><code>-r, --run</code></td>
-        <td>
-          Compile and execute a given CoffeeScript without saving the intermediate
-          JavaScript.
-        </td>
-      </tr>
       <tr>
         <td><code>-o, --output [DIR]</code></td>
         <td>
           Write out all compiled JavaScript files into the specified directory.
+          Use in conjunction with <tt>--compile</tt> or <tt>--watch</tt>.
         </td>
       </tr>
       <tr>
@@ -267,7 +267,7 @@ Expressions
     </p>
 
     <pre>
-coffee path/to/script.coffee
+coffee -c path/to/script.coffee
 coffee --interactive
 coffee --watch --lint experimental.coffee
 coffee --print app/scripts/*.coffee > concatenation.js</pre>

index.html

@@ -260,33 +260,33 @@ cubed_list = (function() {
 sudo bin/cake install</pre>
 
     <p>
-      This provides the <tt>coffee</tt> command, which can
-      be used to compile CoffeeScript <tt>.coffee</tt> files into JavaScript, as
-      well as debug them. The <tt>coffee</tt>
-      command also provides direct evaluation and an interactive REPL.
+      This provides the <tt>coffee</tt> command, which will execute CoffeeScripts
+      under Node.js by default, but is also used to compile CoffeeScript 
+      <tt>.coffee</tt> files into JavaScript, or to run an an interactive REPL.
       When compiling to JavaScript, <tt>coffee</tt> writes the output
       as <tt>.js</tt> files in the same directory by default, but output
       can be customized with the following options:
     </p>
 
     <table>
+      <tr>
+        <td><code>-c, --compile</code></td>
+        <td>
+          Compile a <tt>.coffee</tt> script into a <tt>.js</tt> JavaScript file
+          of the same name.
+        </td>
+      </tr>
       <tr>
         <td width="25%"><code>-i, --interactive</code></td>
         <td>
           Launch an interactive CoffeeScript session to try short snippets.
         </td>
       </tr>
-      <tr>
-        <td><code>-r, --run</code></td>
-        <td>
-          Compile and execute a given CoffeeScript without saving the intermediate
-          JavaScript.
-        </td>
-      </tr>
       <tr>
         <td><code>-o, --output [DIR]</code></td>
         <td>
           Write out all compiled JavaScript files into the specified directory.
+          Use in conjunction with <tt>--compile</tt> or <tt>--watch</tt>.
         </td>
       </tr>
       <tr>
@@ -364,7 +364,7 @@ Expressions
     </p>
 
     <pre>
-coffee path/to/script.coffee
+coffee -c path/to/script.coffee
 coffee --interactive
 coffee --watch --lint experimental.coffee
 coffee --print app/scripts/*.coffee > concatenation.js</pre>

lib/command_line.js

@@ -5,7 +5,7 @@
   optparse = require('optparse');
   CoffeeScript = require('coffee-script');
   BANNER = "coffee compiles CoffeeScript source files into JavaScript.\n\nUsage:\n  coffee path/to/script.coffee";
-  SWITCHES = [['-i', '--interactive', 'run an interactive CoffeeScript REPL'], ['-r', '--run', 'compile and run a CoffeeScript'], ['-o', '--output [DIR]', 'set the directory for compiled JavaScript'], ['-w', '--watch', 'watch scripts for changes, and recompile'], ['-p', '--print', 'print the compiled JavaScript to stdout'], ['-l', '--lint', 'pipe the compiled JavaScript through JSLint'], ['-s', '--stdio', 'listen for and compile scripts over stdio'], ['-e', '--eval', 'compile a string from the command line'], ['--no-wrap', 'compile without the top-level function wrapper'], ['-t', '--tokens', 'print the tokens that the lexer produces'], ['-n', '--nodes', 'print the parse tree that Jison produces'], ['-v', '--version', 'display CoffeeScript version'], ['-h', '--help', 'display this help message']];
+  SWITCHES = [['-c', '--compile', 'compile to JavaScript and save as .js files'], ['-i', '--interactive', 'run an interactive CoffeeScript REPL'], ['-o', '--output [DIR]', 'set the directory for compiled JavaScript'], ['-w', '--watch', 'watch scripts for changes, and recompile'], ['-p', '--print', 'print the compiled JavaScript to stdout'], ['-l', '--lint', 'pipe the compiled JavaScript through JSLint'], ['-s', '--stdio', 'listen for and compile scripts over stdio'], ['-e', '--eval', 'compile a string from the command line'], ['--no-wrap', 'compile without the top-level function wrapper'], ['-t', '--tokens', 'print the tokens that the lexer produces'], ['-n', '--nodes', 'print the parse tree that Jison produces'], ['-v', '--version', 'display CoffeeScript version'], ['-h', '--help', 'display this help message']];
   options = {};
   sources = [];
   option_parser = null;
@@ -87,14 +87,14 @@
         return puts(CoffeeScript.nodes(code).toString());
       } else {
         js = CoffeeScript.compile(code, compile_options());
-        if (o.run) {
-          return eval(js);
+        if (o.compile) {
+          return write_js(source, js);
         } else if (o.lint) {
           return lint(js);
         } else if (o.print || o.eval) {
           return print(js);
         } else {
-          return write_js(source, js);
+          return eval(js);
         }
       }
     } catch (err) {

src/command_line.coffee

@@ -11,8 +11,8 @@ BANNER: '''
         '''
 
 SWITCHES: [
+  ['-c', '--compile',       'compile to JavaScript and save as .js files']
   ['-i', '--interactive',   'run an interactive CoffeeScript REPL']
-  ['-r', '--run',           'compile and run a CoffeeScript']
   ['-o', '--output [DIR]',  'set the directory for compiled JavaScript']
   ['-w', '--watch',         'watch scripts for changes, and recompile']
   ['-p', '--print',         'print the compiled JavaScript to stdout']
@@ -77,10 +77,10 @@ compile_script: (source, code) ->
     else if o.nodes             then puts CoffeeScript.nodes(code).toString()
     else
       js: CoffeeScript.compile code, compile_options()
-      if      o.run             then eval js
+      if      o.compile         then write_js source, js
       else if o.lint            then lint js
       else if o.print or o.eval then print js
-      else                           write_js source, js
+      else                           eval js
   catch err
     if o.watch                  then puts err.message else throw err