Merge branch 'master' of github.com:koajs/koa

docs/api/index.md

@@ -27,8 +27,8 @@ app.listen(3000);
 ## Cascading
 
   Koa middleware cascading in a more traditional way as you may be use to with similar tools -
-  this was previsouly not impossible, but difficult to make user friendly due to node's callbacks,
-  however with generators we can achieve "true" middlware. Contrasting Connect's implementation which
+  this was previously very difficult to make user friendly due to node's callbacks.
+  However with generators we can achieve "true" middlware. Contrasting Connect's implementation which
   simply passes control through series of functions until one returns, Koa yields "downstream", then
   control flows back "upstream".
 
@@ -84,9 +84,9 @@ app.listen(3000);
 
 ## app.listen(...)
 
-  A Koa application is not a 1-to-1 representation of an HTTP server,
-  as one or more Koa applications may be mounted together to form larger
-  applications, with a single HTTP server.
+  A Koa application is not a 1-to-1 representation of a HTTP server.
+  One or more Koa applications may be mounted together to form larger
+  applications with a single HTTP server.
 
   Create and return an HTTP server, passing the given arguments to
   `Server#listen()`. These arguments are documented on [nodejs.org](http://nodejs.org/api/http.html#http_server_listen_port_hostname_backlog_callback). The following is a useless Koa application bound to port `3000`:
@@ -106,7 +106,7 @@ var app = koa();
 http.createServer(app.callback()).listen(3000);
 ```
 
-  This means you can spin up the same application as both HTTP and HTTPS,
+  This means you can spin up the same application as both HTTP and HTTPS
   or on multiple addresses:
 
 ```js

docs/api/request.md

@@ -1,4 +1,3 @@
-
 # Request
 
   A Koa `Request` object is an abstraction on top of node's vanilla request object,
@@ -124,7 +123,7 @@ this.body = yield db.find('something');
 
 ### req.secure
 
-  Shorthand for `this.protocol == "https"` to check if a requset was
+  Shorthand for `this.protocol == "https"` to check if a request was
   issued via TLS.
 
 ### req.ip

docs/api/response.md

@@ -1,4 +1,3 @@
-
 # Response
 
   A Koa `Response` object is an abstraction on top of node's vanilla response object,
@@ -203,8 +202,8 @@ this.redirect('/login');
 this.redirect('http://google.com');
 ```
 
-  To alter the default status of `302` or the response
-  body simply assign before and re-assign after this call:
+  To alter the default status of `302`, simply assign the status
+  before or after this call. To alter the body, assign it after this call:
 
 ```js
 this.status = 301;

lib/context.js

@@ -75,6 +75,7 @@ module.exports = {
    */
 
   error: function(msg, status){
+    console.warn('ctx.error is deprecated, use ctx.throw');
     this.throw(msg, status);
   },