Misleading doc about Vec::into_boxed_slice

[ark0f]

Location

Vec::into_boxed_slice
impl From<Vec<T>> for Box<[T]>

Summary

impl From<Vec<T>> for Box<[T]> says:

If v has excess capacity, its items will be moved into a newly-allocated buffer with exactly the right capacity.

When Vec::into_boxed_slice does not:

Note that this will drop any excess capacity.

Despite the fact that impl From<Vec<T>> for Box<[T]> uses Vec::into_boxed_slice inside

[saethlin]

I'm confused, what do you think the difference is? Those mean the same thing to me.

[asquared31415]

Those do mean the same thing, because "dropping excess capacity" is reallocating, which means moving to a new allocation. However this probably could be clarified/made consistent anyway. I don't see why these shouldn't be identical docs.

[HintringerFabian]

@rustbot claim