std::vec: correct .sort()'s doc-string and add some
examples/clarification to others.
std::vec: clarify & examplify more docs.
auto merge of #11127 : huonw/rust/vec-docs, r=alexcrichton