fix($state): use $browser.baseHref() when generating urls with .href()

If an angular app is placed in a subdirectory and a <base href="..." /> tag is used, ui-router should use the configured value when generating urls through $state.href(). Thanks to @mfield for the testing help!
feat(uiSref): add support for transition options

Allows optionally specifying options to be passed to $state.go via
attribute ui-sref-opts.
Example should show how to use ui-sref-active instead of ng-class
Merge pull request #873 from lukaszb/sample-should-use-ui-sref-active

Example should show how to use ui-sref-active instead of ng-class
chore(README): don't try so hard to scare people
chore(ngdoc): More complete ngdoc site. Soon we will retire the Github API Reference page.
Merge pull request #880 from angular-ui/ngdoc

chore(ngdoc): More complete ngdoc site.
Updated API links to point to new ngDoc site
chore(grunt): Fix auto ngdoc publish grunt task
chore(ngdocs): Add Github and Guide links to API reference
chore(travis): test against all angular versions
chore(files.js): Remove double entry

- Closes #876
Merge pull request #813 from roryf/ui-sref-options

feat(uiSref): add support for transition options
Merge pull request #528 from tgecho/basehref

Prepend the baseHref to $state.href() generated urls if it exists.