Replace usage of `get_ref`
Add general doccomments
Merge commit 'jdeseno/remove-deprecated' into update
Merge remote-tracking branch 'tomaka/add-docs' into update
Update dependencies to unbreak the build
auto merge of #732 : alexcrichton/cargo/update, r=alexcrichton

Also merge some other PRs while I'm at it