Add zsh completion for publish command
auto merge of #906 : eerden/cargo/zsh-completion, r=alexcrichton
Be sure to include OUT_DIR for doc tests
Update the FAQ and some documentation styles

Closes rust-lang/crates.io#21
Closes rust-lang/crates.io#29
Closes #882
auto merge of #897 : alexcrichton/cargo/issue-879, r=brson

Closes #879
auto merge of #901 : alexcrichton/cargo/update-faq, r=brson

Closes rust-lang/crates.io#21
Closes rust-lang/crates.io#29
Closes #882
Merge remote-tracking branch 'upstream/master'