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