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.
This documentation style is outdated, we now recommend using `///` even for multi-line comments. As long as you're modifying this, it would be nice to update it.