FromIterator probably shouldn't say "rarely called explicitly" when it's in the prelude

[scottmcm]

The documentation for FromIterator https://doc.rust-lang.org/nightly/std/iter/trait.FromIterator.html says

FromIterator::from_iter() is rarely called explicitly, and is instead used through Iterator::collect() method. See Iterator::collect()’s documentation for more examples.

However, the trait is now in the rust_2021 prelude https://doc.rust-lang.org/nightly/core/prelude/rust_2021/index.html explicitly to allow it to be called more often.

This documentation should thus likely be updated to -- while still pointing at collect -- mention why one may wish to call it explicitly. Perhaps something like VecDeque::from_iter(0..100) would be a nice example.

One might also re-use some text from the RFC that added it to the prelude, https://rust-lang.github.io/rfcs/3114-prelude-2021.html#fromiterator

[henrifrancois]

Can I take care of this?

[scottmcm]

@henrifrancois Absolutely!

You can use @rustbot claim to get the issue assigned to you.

[henrifrancois]

@rustbot claim

[JKAnderson409]

Hi @henrifrancois! I'd like to claim this issue if you're interested in releasing it.

[henrifrancois]

@rustbot unclaim. All yours @JKAnderson409

[JKAnderson409]

Thanks! @rustbot claim

[JKAnderson409]

Closed by #94587