Vec::capacity documentation is ambiguous

[akonradi]

Location

Standard library documentation for Vec::capacity (https://doc.rust-lang.org/std/vec/struct.Vec.html#method.capacity)

Summary

It's not clear whether the returned capacity is the total capacity or remaining capacity of the vector. The text and example don't seem to signal either way.

[the8472]

Vec's struct-level documentation provides context: https://doc.rust-lang.org/std/vec/struct.Vec.html#capacity-and-reallocation