more doc improvements

Author: invpt

library/alloc/src/vec/mod.rs

@@ -1023,11 +1023,11 @@ impl<T, A: Allocator> Vec<T, A> {
 
     /// Shrinks the capacity of the vector as much as possible.
     ///
-    /// The behavior of this method depends on the allocator being used. If the allocator supports
-    /// in-place shrinking, some or all of the excess capacity may be returned to the allocator.
-    /// If not, this method may cause the vector's data to be copied to a new allocation, although
-    /// no guarantees are given that this new allocation is actually smaller. See
-    /// [`Allocator::shrink`] for more details.
+    /// The behavior of this method depends on the allocator, which may either shrink the vector
+    /// in-place or reallocate. The resulting vector might still have some excess capacity, just as
+    /// is the case for [`with_capacity`]. See [`Allocator::shrink`] for more details.
+    ///
+    /// [`with_capacity`]: Vec::with_capacity
     ///
     /// # Examples
     ///