The documentation of `Vec` contradicts itself regarding `with_capacity`

[Kixunil]

Location

https://doc.rust-lang.org/std/vec/struct.Vec.html

Summary

In section Guarantees the documentation says:

vec![x; n], vec![a, b, c, d], and Vec::with_capacity(n), will all produce a Vec with exactly the requested capacity.

However in Vec::with_capacity(n) it says:

This method is allowed to allocate for more elements than capacity.

And

If it is imporant to know the exact allocated capacity of a Vec, always use the capacity method after construction.

These clearly contradict each-other. I guess it's better for performance to not guarantee capacity but maybe it'd break someones code to change it since it was already "documented". :(

[ehuss]

I believe this is being worked on in #99790. Can you take a look at that PR and comment over there if it still seems unclear?

[Kixunil]

Heh, was trying to find an issue but didn't think of looking at PRs. Will keep open until that merges.