create urlInterface and RouteUrl classes. deprecate ModUrl. Maintain BC by having RouteUrl extend ModUrl.
change typehints for Hooks to UrlInterface
change SearchResultEntity typehints to UrlInterface
add ModUrl deprecation docs
minor fixes
correct copy/paste error
Merge pull request #1947 from craigh/ModUrl-update

upgrade ModUrl usage for Route compatibility