--- a/src/java.base/share/classes/java/lang/System.java Wed Jun 05 15:19:13 2019 +0200
+++ b/src/java.base/share/classes/java/lang/System.java Wed Jun 05 10:21:02 2019 -0400
@@ -1782,14 +1782,17 @@
}
/**
- * Runs the garbage collector.
- *
- * Calling the {@code gc} method suggests that the Java Virtual
- * Machine expend effort toward recycling unused objects in order to
- * make the memory they currently occupy available for quick reuse.
- * When control returns from the method call, the Java Virtual
- * Machine has made a best effort to reclaim space from all discarded
- * objects.
+ * Runs the garbage collector in the Java Virtual Machine.
+ * <p>
+ * Calling the {@code gc} method suggests that the Java Virtual Machine
+ * expend effort toward recycling unused objects in order to
+ * make the memory they currently occupy available for reuse
+ * by the Java Virtual Machine.
+ * When control returns from the method call, the Java Virtual Machine
+ * has made a best effort to reclaim space from all unused objects.
+ * There is no guarantee that this effort will recycle any particular
+ * number of unused objects, reclaim any particular amount of space, or
+ * complete at any particular time, if at all, before the method returns or ever.
* <p>
* The call {@code System.gc()} is effectively equivalent to the
* call: