This sentence seems to be line-wrapped weirdly.

(Also, we are (slowly) moving to just using `///` for doc comments, i.e.

```rust
/// Returns true if all the elements in vector
/// for which pred returns true precede those for which it returns false.
///
/// ...
fn is_partititioned(...)
```