Improve documentation of rounding functions
auto merge of #16056 : Sawyer47/rust/round-doc, r=alexcrichton

Important note: I documented current behaviour even though it may not be correct (see issue #15826). `round()` function for rationals does different rounding than `round()` from `Float` trait.