added test and little docs

index.js

@@ -436,7 +436,9 @@ Router.prototype.process_params = function process_params(layer, called, req, re
 }
 
 /**
- * Remove all paths from the current stack
+ * Removes all paths from the current stack
+ *
+ * Removing routes could be useful when you need to add/remove routes on runtime.
  *
  * @public
  */

test/router.js

@@ -35,6 +35,21 @@ describe('Router', function () {
     router({}, {}, done)
   })
 
+  describe('.removeAllRoutes()', function () {
+    it('should remove all routes from the stack', function (done) {
+      var router = new Router()
+
+      for (var i = 0; i < 10; i++) {
+        router.get('/thing' + i, helloWorld)
+      }
+
+      router.removeAllRoutes()
+
+      assert.equal(router.stack.length, 0)
+      done()
+    })
+  })
+
   describe('.all(path, fn)', function () {
     it('should be chainable', function () {
       var router = new Router()