4722265: (spec str) StringBuffer.ensureCapacity() should mention that capacity is mutable
Summary: add usage note to AbstractStringBuilder ensureCapacity()
Reviewed-by: mduigou, dholmes, chegar
--- a/jdk/src/share/classes/java/lang/AbstractStringBuilder.java Tue Sep 18 15:06:14 2012 -0700
+++ b/jdk/src/share/classes/java/lang/AbstractStringBuilder.java Wed Sep 19 08:52:21 2012 -0400
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2003, 2012, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2012, Oracle and/or its affiliates. All rights reserved.ob
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -96,6 +96,8 @@
* </ul>
* If the {@code minimumCapacity} argument is nonpositive, this
* method takes no action and simply returns.
+ * Note that subsequent operations on this object can reduce the
+ * actual capacity below that requested here.
*
* @param minimumCapacity the minimum desired capacity.
*/