Add note about HashMap::capacity's bounds

Fixes #24591

src/libstd/collections/hash/map.rs

@@ -601,6 +601,9 @@ pub fn with_capacity_and_hash_state(capacity: usize, hash_state: S)
 
     /// Returns the number of elements the map can hold without reallocating.
     ///
+    /// This number is a lower bound; the `HashMap<K, V>` might be able to hold
+    /// more, but is guaranteed to be able to hold at least this many.
+    ///
     /// # Examples
     ///
     /// ```