route.clear() method and method descriptions docblocks

* Added route.clear() method for clearing current hash (including # itself)
* added some docblocks for existing methods also