diff --git a/README.md b/README.md
index 4312229..96fd7ab 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,7 @@ $ npm install -g local-web-server
 Usage
 -----
 ```
-ws [--directory|-d <directory>] [--port|-p <port>] [--log-format|-f dev|default|short|tiny]
+ws [--directory|-d <directory>] [--port|-p <port>] [--log-format|-f dev|default|short|tiny] [--compress|-c]
 ```
 
 From the folder you wish to serve, run:
@@ -47,6 +47,11 @@ Use a built-in or custom [Connect logger format](http://www.senchalabs.org/conne
 $ ws --log-format short
 ```
 
+To add compression, reducing bandwidth, increasing page load time (by 10-15% on my Macbook Air)
+```sh
+$ ws --compress
+```
+
 Use with Logstalgia
 -------------------
 The "default" log-format is compatible with [logstalgia](http://code.google.com/p/logstalgia/).
diff --git a/ws.js b/ws.js
index a688bb8..d9cf629 100755
--- a/ws.js
+++ b/ws.js
@@ -23,6 +23,7 @@ var argv = new Thing()
     .define({ name: "log-format", alias: "f", type: "string" })
     .define({ name: "help", alias: "h", type: "boolean" })
     .define({ name: "directory", alias: "d", type: "string", value: process.cwd() })
+    .define({ name: "compress", alias: "c", type: "boolean" })
     .on("error", function(err){
         halt(err.message);
     })
@@ -71,6 +72,9 @@ if (argv.help){
 
     var app = connect();
 
+    /*
+    log using --log-format (if supplied), else output statics
+    */
     if(argv["log-format"]){
         app.use(connect.logger(argv["log-format"]));
     } else {
@@ -80,9 +84,20 @@ if (argv.help){
         });
     }
 
+    /**
+    --compress enables compression
+    */
+    if (argv.compress) app.use(connect.compress());
+
+    /**
+    static file server including directory browsing support
+    */
     app.use(connect.static(argv.directory))
         .use(connect.directory(argv.directory, { icons: true }));
 
+    /**
+    launch server
+    */
     var server = http.createServer(app)
         .on("error", handleServerError)
         .listen(argv.port);
@@ -96,6 +111,9 @@ if (argv.help){
         console.error("serving %u{%s} at %u{%s}", argv.directory, "http://localhost:" + argv.port);
     }
 
+    /**
+    in stats mode, monitor connections and bytes transferred
+    */
     if (!argv["log-format"]){
         console.hide();
         console.log("%u{Requests}   %u{Data}        %u{Connections}");