Mercurial > hg > gc-bench

changeset 12:958908a0e252

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Formatting and test descriptions.
author shade
date Mon, 28 Nov 2016 21:20:25 +0100
parents 4794db251a34
children 53719afbd785
files src/main/java/org/openjdk/gcbench/GCBench.java
diffstat 1 files changed, 13 insertions(+), 8 deletions(-) [+]
line wrap: on
line diff
--- a/src/main/java/org/openjdk/gcbench/GCBench.java	Mon Nov 28 21:07:24 2016 +0100
+++ b/src/main/java/org/openjdk/gcbench/GCBench.java	Mon Nov 28 21:20:25 2016 +0100
@@ -148,7 +148,8 @@
 
         // alloc family
         {
-            String groupDescr = "Allocates the objects in almost completely empty heap as fast as it can. ";
+            String groupDescr = "Allocates the objects in almost completely empty heap as fast as it can. " +
+                    "This tests what allocation pressure can the collector withstand without doing anything else. ";
 
             tests.add(new DimensionalTest(baseOpts, org.openjdk.gcbench.alloc.plain.Objects.class,
                     "alloc.peak.object", groupDescr + "Allocates plain Java Objects.",
@@ -172,7 +173,9 @@
         }
 
         {
-            String groupDescr = "Allocates the objects in almost completely empty heap, with rate limiting. ";
+            String groupDescr = "Allocates the objects in almost completely empty heap, with rate limiting. " +
+                    "If the collector needs some headroom to do cleanup, rate limited tests would show how much " +
+                    "headroom is needed. ";
 
             tests.add(new DimensionalTest(baseOpts, org.openjdk.gcbench.alloc.ratelimited.Objects.class,
                     "alloc.rated.object", groupDescr + "Allocates plain Java Objects.",
@@ -195,7 +198,8 @@
         }
 
         {
-            String groupDesc = "Allocates the objects in heap, when there are retained object in heap. ";
+            String groupDesc = "Allocates the objects in heap, when heap is not empty. This tests how well the collector " +
+                    "can withstand the allocation pressure when there is other potential work to do.";
 
             tests.add(new DimensionalTest(baseOpts, org.openjdk.gcbench.mark.ArrayLists.class,
                     "mark.arraylist", groupDesc + "Retains ArrayList of given size.",
@@ -230,7 +234,8 @@
         }
 
         {
-            String groupDescr = "Stresses the application root set. ";
+            String groupDescr = "Stresses the application root set. Beefs up the particular part of root set, " +
+                    "and then runs peak allocation tests to see if it affects garbage collection.";
 
             tests.add(new DimensionalTest(baseOpts, org.openjdk.gcbench.roots.StringTableRoots.class,
                     "roots.strings", groupDescr + "Allocates and retains a number of interned Strings.",
@@ -258,19 +263,19 @@
     }
 
     public void run() throws RunnerException {
-        pw.println("Available tests:");
+        pw.println("  Available tests: ");
         for (Test test : tests) {
-            pw.printf(" %-20s %20s%n", test.label(), test.description());
+            pw.printf("    %-20s %n", test.label());
         }
         pw.println();
 
         Pattern pattern = Pattern.compile(testFilter);
         List<Test> runTests = new ArrayList<>();
 
-        pw.println("Matching tests:");
+        pw.println("  Matching tests:");
         for (Test test : tests) {
             if (pattern.matcher(test.label()).find()) {
-                pw.printf(" %-20s %20s%n", test.label(), test.description());
+                pw.printf("    %-20s%n", test.label());
                 runTests.add(test);
             }
         }