Cleanup and stability for core::slice

This implements some of the recommendations from https://github.com/rust-lang/meeting-minutes/blob/master/Meeting-API-review-2014-08-06.md.

Explanation in commits.
Documentation is a bit nicer if you replace the doc comment as well, so people skimming the function list don't see two identical docstrings.