Rustdoc should show "where" in a new line

[mitsuhiko]

It becomes very hard to read certain signatures at the moment. A good example is HashMap::get:

fn get<Sized? Q>(&self, k: &Q) -> Option<&V> where Q: Hash<S> + Eq + BorrowFrom<K>

This would be a lot easier to read (assuming ?Sized lands) like this:

fn get(&self, k: &Q) -> Option<&V>
  where Q: ?Sized + Hash<S> + Eq + BorrowFrom<K>

Reasoning being that right now the important part (return value) is lost somewhere in the middle whereas the trait bounds (which very often are not as important) are on the easier to read, end of the line.

[huonw]

+1

@wycats, @aturon and I were all in favour of this (and some other rustdoc tweaks for making complicated signatures more readable, which I don't recall) when we discussed it in passing at the work week.

[dirk]

Can this be closed as of 1e9c7c5?

[alexcrichton]

Thanks @dirk!