8010506: Typos and errors in descriptions of vm options in globals.hpp

Wed, 09 Oct 2013 11:18:53 -0700

author
tamao
date
Wed, 09 Oct 2013 11:18:53 -0700
changeset 5861
b4d8a3d4db73
parent 5860
69944b868a32
child 5862
82af7d7a0128

8010506: Typos and errors in descriptions of vm options in globals.hpp
Summary: Fix typos and errors in descriptions of vm options in globals.hpp
Reviewed-by: jmasa, jwilhelm

src/share/vm/runtime/globals.hpp file | annotate | diff | comparison | revisions
     1.1 --- a/src/share/vm/runtime/globals.hpp	Tue Oct 08 17:35:51 2013 +0200
     1.2 +++ b/src/share/vm/runtime/globals.hpp	Wed Oct 09 11:18:53 2013 -0700
     1.3 @@ -440,21 +440,21 @@
     1.4  #define RUNTIME_FLAGS(develop, develop_pd, product, product_pd, diagnostic, experimental, notproduct, manageable, product_rw, lp64_product) \
     1.5                                                                              \
     1.6    lp64_product(bool, UseCompressedOops, false,                              \
     1.7 -            "Use 32-bit object references in 64-bit VM  "                   \
     1.8 -            "lp64_product means flag is always constant in 32 bit VM")      \
     1.9 +          "Use 32-bit object references in 64-bit VM. "                     \
    1.10 +          "lp64_product means flag is always constant in 32 bit VM")        \
    1.11                                                                              \
    1.12    lp64_product(bool, UseCompressedClassPointers, false,                     \
    1.13 -            "Use 32-bit class pointers in 64-bit VM  "                      \
    1.14 -            "lp64_product means flag is always constant in 32 bit VM")      \
    1.15 +          "Use 32-bit class pointers in 64-bit VM. "                        \
    1.16 +          "lp64_product means flag is always constant in 32 bit VM")        \
    1.17                                                                              \
    1.18    notproduct(bool, CheckCompressedOops, true,                               \
    1.19 -            "generate checks in encoding/decoding code in debug VM")        \
    1.20 +          "Generate checks in encoding/decoding code in debug VM")          \
    1.21                                                                              \
    1.22    product_pd(uintx, HeapBaseMinAddress,                                     \
    1.23 -            "OS specific low limit for heap base address")                  \
    1.24 +          "OS specific low limit for heap base address")                    \
    1.25                                                                              \
    1.26    diagnostic(bool, PrintCompressedOopsMode, false,                          \
    1.27 -            "Print compressed oops base address and encoding mode")         \
    1.28 +          "Print compressed oops base address and encoding mode")           \
    1.29                                                                              \
    1.30    lp64_product(intx, ObjectAlignmentInBytes, 8,                             \
    1.31            "Default object alignment in bytes, 8 is minimum")                \
    1.32 @@ -476,7 +476,7 @@
    1.33            "Use lwsync instruction if true, else use slower sync")           \
    1.34                                                                              \
    1.35    develop(bool, CleanChunkPoolAsync, falseInEmbedded,                       \
    1.36 -          "Whether to clean the chunk pool asynchronously")                 \
    1.37 +          "Clean the chunk pool asynchronously")                            \
    1.38                                                                              \
    1.39    /* Temporary: See 6948537 */                                              \
    1.40    experimental(bool, UseMemSetInBOT, true,                                  \
    1.41 @@ -486,10 +486,12 @@
    1.42            "Enable normal processing of flags relating to field diagnostics")\
    1.43                                                                              \
    1.44    experimental(bool, UnlockExperimentalVMOptions, false,                    \
    1.45 -          "Enable normal processing of flags relating to experimental features")\
    1.46 +          "Enable normal processing of flags relating to experimental "     \
    1.47 +          "features")                                                       \
    1.48                                                                              \
    1.49    product(bool, JavaMonitorsInStackTrace, true,                             \
    1.50 -          "Print info. about Java monitor locks when the stacks are dumped")\
    1.51 +          "Print information about Java monitor locks when the stacks are"  \
    1.52 +          "dumped")                                                         \
    1.53                                                                              \
    1.54    product_pd(bool, UseLargePages,                                           \
    1.55            "Use large page memory")                                          \
    1.56 @@ -501,7 +503,7 @@
    1.57            "Fail large pages individual allocation")                         \
    1.58                                                                              \
    1.59    develop(bool, TracePageSizes, false,                                      \
    1.60 -          "Trace page size selection and usage.")                           \
    1.61 +          "Trace page size selection and usage")                            \
    1.62                                                                              \
    1.63    product(bool, UseNUMA, false,                                             \
    1.64            "Use NUMA if available")                                          \
    1.65 @@ -516,12 +518,12 @@
    1.66            "Force NUMA optimizations on single-node/UMA systems")            \
    1.67                                                                              \
    1.68    product(uintx, NUMAChunkResizeWeight, 20,                                 \
    1.69 -          "Percentage (0-100) used to weigh the current sample when "      \
    1.70 +          "Percentage (0-100) used to weigh the current sample when "       \
    1.71            "computing exponentially decaying average for "                   \
    1.72            "AdaptiveNUMAChunkSizing")                                        \
    1.73                                                                              \
    1.74    product(uintx, NUMASpaceResizeRate, 1*G,                                  \
    1.75 -          "Do not reallocate more that this amount per collection")         \
    1.76 +          "Do not reallocate more than this amount per collection")         \
    1.77                                                                              \
    1.78    product(bool, UseAdaptiveNUMAChunkSizing, true,                           \
    1.79            "Enable adaptive chunk sizing for NUMA")                          \
    1.80 @@ -538,17 +540,17 @@
    1.81    product(intx, UseSSE, 99,                                                 \
    1.82            "Highest supported SSE instructions set on x86/x64")              \
    1.83                                                                              \
    1.84 -  product(bool, UseAES, false,                                               \
    1.85 +  product(bool, UseAES, false,                                              \
    1.86            "Control whether AES instructions can be used on x86/x64")        \
    1.87                                                                              \
    1.88    product(uintx, LargePageSizeInBytes, 0,                                   \
    1.89 -          "Large page size (0 to let VM choose the page size")              \
    1.90 +          "Large page size (0 to let VM choose the page size)")             \
    1.91                                                                              \
    1.92    product(uintx, LargePageHeapSizeThreshold, 128*M,                         \
    1.93 -          "Use large pages if max heap is at least this big")               \
    1.94 +          "Use large pages if maximum heap is at least this big")           \
    1.95                                                                              \
    1.96    product(bool, ForceTimeHighResolution, false,                             \
    1.97 -          "Using high time resolution(For Win32 only)")                     \
    1.98 +          "Using high time resolution (for Win32 only)")                    \
    1.99                                                                              \
   1.100    develop(bool, TraceItables, false,                                        \
   1.101            "Trace initialization and use of itables")                        \
   1.102 @@ -564,10 +566,10 @@
   1.103                                                                              \
   1.104    develop(bool, TraceLongCompiles, false,                                   \
   1.105            "Print out every time compilation is longer than "                \
   1.106 -          "a given threashold")                                             \
   1.107 +          "a given threshold")                                              \
   1.108                                                                              \
   1.109    develop(bool, SafepointALot, false,                                       \
   1.110 -          "Generates a lot of safepoints. Works with "                      \
   1.111 +          "Generate a lot of safepoints. This works with "                  \
   1.112            "GuaranteedSafepointInterval")                                    \
   1.113                                                                              \
   1.114    product_pd(bool, BackgroundCompilation,                                   \
   1.115 @@ -575,13 +577,13 @@
   1.116            "compilation")                                                    \
   1.117                                                                              \
   1.118    product(bool, PrintVMQWaitTime, false,                                    \
   1.119 -          "Prints out the waiting time in VM operation queue")              \
   1.120 +          "Print out the waiting time in VM operation queue")               \
   1.121                                                                              \
   1.122    develop(bool, NoYieldsInMicrolock, false,                                 \
   1.123            "Disable yields in microlock")                                    \
   1.124                                                                              \
   1.125    develop(bool, TraceOopMapGeneration, false,                               \
   1.126 -          "Shows oopmap generation")                                        \
   1.127 +          "Show OopMapGeneration")                                          \
   1.128                                                                              \
   1.129    product(bool, MethodFlushing, true,                                       \
   1.130            "Reclamation of zombie and not-entrant methods")                  \
   1.131 @@ -590,10 +592,11 @@
   1.132            "Verify stack of each thread when it is entering a runtime call") \
   1.133                                                                              \
   1.134    diagnostic(bool, ForceUnreachable, false,                                 \
   1.135 -          "Make all non code cache addresses to be unreachable with forcing use of 64bit literal fixups") \
   1.136 +          "Make all non code cache addresses to be unreachable by "         \
   1.137 +          "forcing use of 64bit literal fixups")                            \
   1.138                                                                              \
   1.139    notproduct(bool, StressDerivedPointers, false,                            \
   1.140 -          "Force scavenge when a derived pointers is detected on stack "    \
   1.141 +          "Force scavenge when a derived pointer is detected on stack "     \
   1.142            "after rtm call")                                                 \
   1.143                                                                              \
   1.144    develop(bool, TraceDerivedPointers, false,                                \
   1.145 @@ -612,86 +615,86 @@
   1.146            "Use Inline Caches for virtual calls ")                           \
   1.147                                                                              \
   1.148    develop(bool, InlineArrayCopy, true,                                      \
   1.149 -          "inline arraycopy native that is known to be part of "            \
   1.150 +          "Inline arraycopy native that is known to be part of "            \
   1.151            "base library DLL")                                               \
   1.152                                                                              \
   1.153    develop(bool, InlineObjectHash, true,                                     \
   1.154 -          "inline Object::hashCode() native that is known to be part "      \
   1.155 +          "Inline Object::hashCode() native that is known to be part "      \
   1.156            "of base library DLL")                                            \
   1.157                                                                              \
   1.158    develop(bool, InlineNatives, true,                                        \
   1.159 -          "inline natives that are known to be part of base library DLL")   \
   1.160 +          "Inline natives that are known to be part of base library DLL")   \
   1.161                                                                              \
   1.162    develop(bool, InlineMathNatives, true,                                    \
   1.163 -          "inline SinD, CosD, etc.")                                        \
   1.164 +          "Inline SinD, CosD, etc.")                                        \
   1.165                                                                              \
   1.166    develop(bool, InlineClassNatives, true,                                   \
   1.167 -          "inline Class.isInstance, etc")                                   \
   1.168 +          "Inline Class.isInstance, etc")                                   \
   1.169                                                                              \
   1.170    develop(bool, InlineThreadNatives, true,                                  \
   1.171 -          "inline Thread.currentThread, etc")                               \
   1.172 +          "Inline Thread.currentThread, etc")                               \
   1.173                                                                              \
   1.174    develop(bool, InlineUnsafeOps, true,                                      \
   1.175 -          "inline memory ops (native methods) from sun.misc.Unsafe")        \
   1.176 +          "Inline memory ops (native methods) from sun.misc.Unsafe")        \
   1.177                                                                              \
   1.178    product(bool, CriticalJNINatives, true,                                   \
   1.179 -          "check for critical JNI entry points")                            \
   1.180 +          "Check for critical JNI entry points")                            \
   1.181                                                                              \
   1.182    notproduct(bool, StressCriticalJNINatives, false,                         \
   1.183 -            "Exercise register saving code in critical natives")            \
   1.184 +          "Exercise register saving code in critical natives")              \
   1.185                                                                              \
   1.186    product(bool, UseSSE42Intrinsics, false,                                  \
   1.187            "SSE4.2 versions of intrinsics")                                  \
   1.188                                                                              \
   1.189    product(bool, UseAESIntrinsics, false,                                    \
   1.190 -          "use intrinsics for AES versions of crypto")                      \
   1.191 +          "Use intrinsics for AES versions of crypto")                      \
   1.192                                                                              \
   1.193    product(bool, UseCRC32Intrinsics, false,                                  \
   1.194            "use intrinsics for java.util.zip.CRC32")                         \
   1.195                                                                              \
   1.196    develop(bool, TraceCallFixup, false,                                      \
   1.197 -          "traces all call fixups")                                         \
   1.198 +          "Trace all call fixups")                                          \
   1.199                                                                              \
   1.200    develop(bool, DeoptimizeALot, false,                                      \
   1.201 -          "deoptimize at every exit from the runtime system")               \
   1.202 +          "Deoptimize at every exit from the runtime system")               \
   1.203                                                                              \
   1.204    notproduct(ccstrlist, DeoptimizeOnlyAt, "",                               \
   1.205 -          "a comma separated list of bcis to deoptimize at")                \
   1.206 +          "A comma separated list of bcis to deoptimize at")                \
   1.207                                                                              \
   1.208    product(bool, DeoptimizeRandom, false,                                    \
   1.209 -          "deoptimize random frames on random exit from the runtime system")\
   1.210 +          "Deoptimize random frames on random exit from the runtime system")\
   1.211                                                                              \
   1.212    notproduct(bool, ZombieALot, false,                                       \
   1.213 -          "creates zombies (non-entrant) at exit from the runt. system")    \
   1.214 +          "Create zombies (non-entrant) at exit from the runtime system")   \
   1.215                                                                              \
   1.216    product(bool, UnlinkSymbolsALot, false,                                   \
   1.217 -          "unlink unreferenced symbols from the symbol table at safepoints")\
   1.218 +          "Unlink unreferenced symbols from the symbol table at safepoints")\
   1.219                                                                              \
   1.220    notproduct(bool, WalkStackALot, false,                                    \
   1.221 -          "trace stack (no print) at every exit from the runtime system")   \
   1.222 +          "Trace stack (no print) at every exit from the runtime system")   \
   1.223                                                                              \
   1.224    product(bool, Debugging, false,                                           \
   1.225 -          "set when executing debug methods in debug.ccp "                  \
   1.226 +          "Set when executing debug methods in debug.cpp "                  \
   1.227            "(to prevent triggering assertions)")                             \
   1.228                                                                              \
   1.229    notproduct(bool, StrictSafepointChecks, trueInDebug,                      \
   1.230            "Enable strict checks that safepoints cannot happen for threads " \
   1.231 -          "that used No_Safepoint_Verifier")                                \
   1.232 +          "that use No_Safepoint_Verifier")                                 \
   1.233                                                                              \
   1.234    notproduct(bool, VerifyLastFrame, false,                                  \
   1.235            "Verify oops on last frame on entry to VM")                       \
   1.236                                                                              \
   1.237    develop(bool, TraceHandleAllocation, false,                               \
   1.238 -          "Prints out warnings when suspicious many handles are allocated") \
   1.239 +          "Print out warnings when suspiciously many handles are allocated")\
   1.240                                                                              \
   1.241    product(bool, UseCompilerSafepoints, true,                                \
   1.242            "Stop at safepoints in compiled code")                            \
   1.243                                                                              \
   1.244    product(bool, FailOverToOldVerifier, true,                                \
   1.245 -          "fail over to old verifier when split verifier fails")            \
   1.246 +          "Fail over to old verifier when split verifier fails")            \
   1.247                                                                              \
   1.248    develop(bool, ShowSafepointMsgs, false,                                   \
   1.249 -          "Show msg. about safepoint synch.")                               \
   1.250 +          "Show message about safepoint synchronization")                   \
   1.251                                                                              \
   1.252    product(bool, SafepointTimeout, false,                                    \
   1.253            "Time out and warn or fail after SafepointTimeoutDelay "          \
   1.254 @@ -715,19 +718,19 @@
   1.255            "Trace external suspend wait failures")                           \
   1.256                                                                              \
   1.257    product(bool, MaxFDLimit, true,                                           \
   1.258 -          "Bump the number of file descriptors to max in solaris.")         \
   1.259 +          "Bump the number of file descriptors to maximum in Solaris")      \
   1.260                                                                              \
   1.261    diagnostic(bool, LogEvents, true,                                         \
   1.262 -             "Enable the various ring buffer event logs")                   \
   1.263 +          "Enable the various ring buffer event logs")                      \
   1.264                                                                              \
   1.265    diagnostic(uintx, LogEventsBufferEntries, 10,                             \
   1.266 -             "Enable the various ring buffer event logs")                   \
   1.267 +          "Number of ring buffer event logs")                               \
   1.268                                                                              \
   1.269    product(bool, BytecodeVerificationRemote, true,                           \
   1.270 -          "Enables the Java bytecode verifier for remote classes")          \
   1.271 +          "Enable the Java bytecode verifier for remote classes")           \
   1.272                                                                              \
   1.273    product(bool, BytecodeVerificationLocal, false,                           \
   1.274 -          "Enables the Java bytecode verifier for local classes")           \
   1.275 +          "Enable the Java bytecode verifier for local classes")            \
   1.276                                                                              \
   1.277    develop(bool, ForceFloatExceptions, trueInDebug,                          \
   1.278            "Force exceptions on FP stack under/overflow")                    \
   1.279 @@ -739,7 +742,7 @@
   1.280            "Trace java language assertions")                                 \
   1.281                                                                              \
   1.282    notproduct(bool, CheckAssertionStatusDirectives, false,                   \
   1.283 -          "temporary - see javaClasses.cpp")                                \
   1.284 +          "Temporary - see javaClasses.cpp")                                \
   1.285                                                                              \
   1.286    notproduct(bool, PrintMallocFree, false,                                  \
   1.287            "Trace calls to C heap malloc/free allocation")                   \
   1.288 @@ -758,16 +761,16 @@
   1.289            "entering the VM")                                                \
   1.290                                                                              \
   1.291    notproduct(bool, CheckOopishValues, false,                                \
   1.292 -          "Warn if value contains oop ( requires ZapDeadLocals)")           \
   1.293 +          "Warn if value contains oop (requires ZapDeadLocals)")            \
   1.294                                                                              \
   1.295    develop(bool, UseMallocOnly, false,                                       \
   1.296 -          "use only malloc/free for allocation (no resource area/arena)")   \
   1.297 +          "Use only malloc/free for allocation (no resource area/arena)")   \
   1.298                                                                              \
   1.299    develop(bool, PrintMalloc, false,                                         \
   1.300 -          "print all malloc/free calls")                                    \
   1.301 +          "Print all malloc/free calls")                                    \
   1.302                                                                              \
   1.303    develop(bool, PrintMallocStatistics, false,                               \
   1.304 -          "print malloc/free statistics")                                   \
   1.305 +          "Print malloc/free statistics")                                   \
   1.306                                                                              \
   1.307    develop(bool, ZapResourceArea, trueInDebug,                               \
   1.308            "Zap freed resource/arena space with 0xABABABAB")                 \
   1.309 @@ -779,7 +782,7 @@
   1.310            "Zap freed JNI handle space with 0xFEFEFEFE")                     \
   1.311                                                                              \
   1.312    notproduct(bool, ZapStackSegments, trueInDebug,                           \
   1.313 -             "Zap allocated/freed Stack segments with 0xFADFADED")          \
   1.314 +          "Zap allocated/freed stack segments with 0xFADFADED")             \
   1.315                                                                              \
   1.316    develop(bool, ZapUnusedHeapArea, trueInDebug,                             \
   1.317            "Zap unused heap space with 0xBAADBABE")                          \
   1.318 @@ -794,7 +797,7 @@
   1.319            "Zap filler objects with 0xDEAFBABE")                             \
   1.320                                                                              \
   1.321    develop(bool, PrintVMMessages, true,                                      \
   1.322 -          "Print vm messages on console")                                   \
   1.323 +          "Print VM messages on console")                                   \
   1.324                                                                              \
   1.325    product(bool, PrintGCApplicationConcurrentTime, false,                    \
   1.326            "Print the time the application has been running")                \
   1.327 @@ -803,21 +806,21 @@
   1.328            "Print the time the application has been stopped")                \
   1.329                                                                              \
   1.330    diagnostic(bool, VerboseVerification, false,                              \
   1.331 -             "Display detailed verification details")                       \
   1.332 +          "Display detailed verification details")                          \
   1.333                                                                              \
   1.334    notproduct(uintx, ErrorHandlerTest, 0,                                    \
   1.335 -          "If > 0, provokes an error after VM initialization; the value"    \
   1.336 -          "determines which error to provoke.  See test_error_handler()"    \
   1.337 +          "If > 0, provokes an error after VM initialization; the value "   \
   1.338 +          "determines which error to provoke. See test_error_handler() "    \
   1.339            "in debug.cpp.")                                                  \
   1.340                                                                              \
   1.341    develop(bool, Verbose, false,                                             \
   1.342 -          "Prints additional debugging information from other modes")       \
   1.343 +          "Print additional debugging information from other modes")        \
   1.344                                                                              \
   1.345    develop(bool, PrintMiscellaneous, false,                                  \
   1.346 -          "Prints uncategorized debugging information (requires +Verbose)") \
   1.347 +          "Print uncategorized debugging information (requires +Verbose)")  \
   1.348                                                                              \
   1.349    develop(bool, WizardMode, false,                                          \
   1.350 -          "Prints much more debugging information")                         \
   1.351 +          "Print much more debugging information")                          \
   1.352                                                                              \
   1.353    product(bool, ShowMessageBoxOnError, false,                               \
   1.354            "Keep process alive on VM fatal error")                           \
   1.355 @@ -829,7 +832,7 @@
   1.356            "Let VM fatal error propagate to the OS (ie. WER on Windows)")    \
   1.357                                                                              \
   1.358    product(bool, SuppressFatalErrorMessage, false,                           \
   1.359 -          "Do NO Fatal Error report [Avoid deadlock]")                      \
   1.360 +          "Report NO fatal error message (avoid deadlock)")                 \
   1.361                                                                              \
   1.362    product(ccstrlist, OnError, "",                                           \
   1.363            "Run user-defined commands on fatal error; see VMError.cpp "      \
   1.364 @@ -839,17 +842,17 @@
   1.365            "Run user-defined commands on first java.lang.OutOfMemoryError")  \
   1.366                                                                              \
   1.367    manageable(bool, HeapDumpBeforeFullGC, false,                             \
   1.368 -          "Dump heap to file before any major stop-world GC")               \
   1.369 +          "Dump heap to file before any major stop-the-world GC")           \
   1.370                                                                              \
   1.371    manageable(bool, HeapDumpAfterFullGC, false,                              \
   1.372 -          "Dump heap to file after any major stop-world GC")                \
   1.373 +          "Dump heap to file after any major stop-the-world GC")            \
   1.374                                                                              \
   1.375    manageable(bool, HeapDumpOnOutOfMemoryError, false,                       \
   1.376            "Dump heap to file when java.lang.OutOfMemoryError is thrown")    \
   1.377                                                                              \
   1.378    manageable(ccstr, HeapDumpPath, NULL,                                     \
   1.379 -          "When HeapDumpOnOutOfMemoryError is on, the path (filename or"    \
   1.380 -          "directory) of the dump file (defaults to java_pid<pid>.hprof"    \
   1.381 +          "When HeapDumpOnOutOfMemoryError is on, the path (filename or "   \
   1.382 +          "directory) of the dump file (defaults to java_pid<pid>.hprof "   \
   1.383            "in the working directory)")                                      \
   1.384                                                                              \
   1.385    develop(uintx, SegmentedHeapDumpThreshold, 2*G,                           \
   1.386 @@ -863,10 +866,10 @@
   1.387            "Execute breakpoint upon encountering VM warning")                \
   1.388                                                                              \
   1.389    develop(bool, TraceVMOperation, false,                                    \
   1.390 -          "Trace vm operations")                                            \
   1.391 +          "Trace VM operations")                                            \
   1.392                                                                              \
   1.393    develop(bool, UseFakeTimers, false,                                       \
   1.394 -          "Tells whether the VM should use system time or a fake timer")    \
   1.395 +          "Tell whether the VM should use system time or a fake timer")     \
   1.396                                                                              \
   1.397    product(ccstr, NativeMemoryTracking, "off",                               \
   1.398            "Native memory tracking options")                                 \
   1.399 @@ -876,7 +879,7 @@
   1.400                                                                              \
   1.401    diagnostic(bool, AutoShutdownNMT, true,                                   \
   1.402            "Automatically shutdown native memory tracking under stress "     \
   1.403 -          "situation. When set to false, native memory tracking tries to "  \
   1.404 +          "situations. When set to false, native memory tracking tries to " \
   1.405            "stay alive at the expense of JVM performance")                   \
   1.406                                                                              \
   1.407    diagnostic(bool, LogCompilation, false,                                   \
   1.408 @@ -886,12 +889,12 @@
   1.409            "Print compilations")                                             \
   1.410                                                                              \
   1.411    diagnostic(bool, TraceNMethodInstalls, false,                             \
   1.412 -             "Trace nmethod intallation")                                   \
   1.413 +          "Trace nmethod installation")                                     \
   1.414                                                                              \
   1.415    diagnostic(intx, ScavengeRootsInCode, 2,                                  \
   1.416 -             "0: do not allow scavengable oops in the code cache; "         \
   1.417 -             "1: allow scavenging from the code cache; "                    \
   1.418 -             "2: emit as many constants as the compiler can see")           \
   1.419 +          "0: do not allow scavengable oops in the code cache; "            \
   1.420 +          "1: allow scavenging from the code cache; "                       \
   1.421 +          "2: emit as many constants as the compiler can see")              \
   1.422                                                                              \
   1.423    product(bool, AlwaysRestoreFPU, false,                                    \
   1.424            "Restore the FPU control word after every JNI call (expensive)")  \
   1.425 @@ -912,7 +915,7 @@
   1.426            "Print assembly code (using external disassembler.so)")           \
   1.427                                                                              \
   1.428    diagnostic(ccstr, PrintAssemblyOptions, NULL,                             \
   1.429 -          "Options string passed to disassembler.so")                       \
   1.430 +          "Print options string passed to disassembler.so")                 \
   1.431                                                                              \
   1.432    diagnostic(bool, PrintNMethods, false,                                    \
   1.433            "Print assembly code for nmethods when generated")                \
   1.434 @@ -933,20 +936,21 @@
   1.435            "Print exception handler tables for all nmethods when generated") \
   1.436                                                                              \
   1.437    develop(bool, StressCompiledExceptionHandlers, false,                     \
   1.438 -         "Exercise compiled exception handlers")                            \
   1.439 +          "Exercise compiled exception handlers")                           \
   1.440                                                                              \
   1.441    develop(bool, InterceptOSException, false,                                \
   1.442 -          "Starts debugger when an implicit OS (e.g., NULL) "               \
   1.443 +          "Start debugger when an implicit OS (e.g. NULL) "                 \
   1.444            "exception happens")                                              \
   1.445                                                                              \
   1.446    product(bool, PrintCodeCache, false,                                      \
   1.447            "Print the code cache memory usage when exiting")                 \
   1.448                                                                              \
   1.449    develop(bool, PrintCodeCache2, false,                                     \
   1.450 -          "Print detailed usage info on the code cache when exiting")       \
   1.451 +          "Print detailed usage information on the code cache when exiting")\
   1.452                                                                              \
   1.453    product(bool, PrintCodeCacheOnCompilation, false,                         \
   1.454 -          "Print the code cache memory usage each time a method is compiled") \
   1.455 +          "Print the code cache memory usage each time a method is "        \
   1.456 +          "compiled")                                                       \
   1.457                                                                              \
   1.458    diagnostic(bool, PrintStubCode, false,                                    \
   1.459            "Print generated stub code")                                      \
   1.460 @@ -958,40 +962,40 @@
   1.461            "Omit backtraces for some 'hot' exceptions in optimized code")    \
   1.462                                                                              \
   1.463    product(bool, ProfilerPrintByteCodeStatistics, false,                     \
   1.464 -          "Prints byte code statictics when dumping profiler output")       \
   1.465 +          "Print bytecode statistics when dumping profiler output")         \
   1.466                                                                              \
   1.467    product(bool, ProfilerRecordPC, false,                                    \
   1.468 -          "Collects tick for each 16 byte interval of compiled code")       \
   1.469 +          "Collect ticks for each 16 byte interval of compiled code")       \
   1.470                                                                              \
   1.471    product(bool, ProfileVM, false,                                           \
   1.472 -          "Profiles ticks that fall within VM (either in the VM Thread "    \
   1.473 +          "Profile ticks that fall within VM (either in the VM Thread "     \
   1.474            "or VM code called through stubs)")                               \
   1.475                                                                              \
   1.476    product(bool, ProfileIntervals, false,                                    \
   1.477 -          "Prints profiles for each interval (see ProfileIntervalsTicks)")  \
   1.478 +          "Print profiles for each interval (see ProfileIntervalsTicks)")   \
   1.479                                                                              \
   1.480    notproduct(bool, ProfilerCheckIntervals, false,                           \
   1.481 -          "Collect and print info on spacing of profiler ticks")            \
   1.482 +          "Collect and print information on spacing of profiler ticks")     \
   1.483                                                                              \
   1.484    develop(bool, PrintJVMWarnings, false,                                    \
   1.485 -          "Prints warnings for unimplemented JVM functions")                \
   1.486 +          "Print warnings for unimplemented JVM functions")                 \
   1.487                                                                              \
   1.488    product(bool, PrintWarnings, true,                                        \
   1.489 -          "Prints JVM warnings to output stream")                           \
   1.490 +          "Print JVM warnings to output stream")                            \
   1.491                                                                              \
   1.492    notproduct(uintx, WarnOnStalledSpinLock, 0,                               \
   1.493 -          "Prints warnings for stalled SpinLocks")                          \
   1.494 +          "Print warnings for stalled SpinLocks")                           \
   1.495                                                                              \
   1.496    product(bool, RegisterFinalizersAtInit, true,                             \
   1.497            "Register finalizable objects at end of Object.<init> or "        \
   1.498            "after allocation")                                               \
   1.499                                                                              \
   1.500    develop(bool, RegisterReferences, true,                                   \
   1.501 -          "Tells whether the VM should register soft/weak/final/phantom "   \
   1.502 +          "Tell whether the VM should register soft/weak/final/phantom "    \
   1.503            "references")                                                     \
   1.504                                                                              \
   1.505    develop(bool, IgnoreRewrites, false,                                      \
   1.506 -          "Supress rewrites of bytecodes in the oopmap generator. "         \
   1.507 +          "Suppress rewrites of bytecodes in the oopmap generator. "        \
   1.508            "This is unsafe!")                                                \
   1.509                                                                              \
   1.510    develop(bool, PrintCodeCacheExtension, false,                             \
   1.511 @@ -1001,8 +1005,7 @@
   1.512            "Enable the security JVM functions")                              \
   1.513                                                                              \
   1.514    develop(bool, ProtectionDomainVerification, true,                         \
   1.515 -          "Verifies protection domain before resolution in system "         \
   1.516 -          "dictionary")                                                     \
   1.517 +          "Verify protection domain before resolution in system dictionary")\
   1.518                                                                              \
   1.519    product(bool, ClassUnloading, true,                                       \
   1.520            "Do unloading of classes")                                        \
   1.521 @@ -1015,14 +1018,14 @@
   1.522            "Write memory usage profiling to log file")                       \
   1.523                                                                              \
   1.524    notproduct(bool, PrintSystemDictionaryAtExit, false,                      \
   1.525 -          "Prints the system dictionary at exit")                           \
   1.526 +          "Print the system dictionary at exit")                            \
   1.527                                                                              \
   1.528    experimental(intx, PredictedLoadedClassCount, 0,                          \
   1.529 -          "Experimental: Tune loaded class cache starting size.")           \
   1.530 +          "Experimental: Tune loaded class cache starting size")            \
   1.531                                                                              \
   1.532    diagnostic(bool, UnsyncloadClass, false,                                  \
   1.533            "Unstable: VM calls loadClass unsynchronized. Custom "            \
   1.534 -          "class loader  must call VM synchronized for findClass "          \
   1.535 +          "class loader must call VM synchronized for findClass "           \
   1.536            "and defineClass.")                                               \
   1.537                                                                              \
   1.538    product(bool, AlwaysLockClassLoader, false,                               \
   1.539 @@ -1038,22 +1041,22 @@
   1.540            "Call loadClassInternal() rather than loadClass()")               \
   1.541                                                                              \
   1.542    product_pd(bool, DontYieldALot,                                           \
   1.543 -          "Throw away obvious excess yield calls (for SOLARIS only)")       \
   1.544 +          "Throw away obvious excess yield calls (for Solaris only)")       \
   1.545                                                                              \
   1.546    product_pd(bool, ConvertSleepToYield,                                     \
   1.547 -          "Converts sleep(0) to thread yield "                              \
   1.548 -          "(may be off for SOLARIS to improve GUI)")                        \
   1.549 +          "Convert sleep(0) to thread yield "                               \
   1.550 +          "(may be off for Solaris to improve GUI)")                        \
   1.551                                                                              \
   1.552    product(bool, ConvertYieldToSleep, false,                                 \
   1.553 -          "Converts yield to a sleep of MinSleepInterval to simulate Win32 "\
   1.554 -          "behavior (SOLARIS only)")                                        \
   1.555 +          "Convert yield to a sleep of MinSleepInterval to simulate Win32 " \
   1.556 +          "behavior (Solaris only)")                                        \
   1.557                                                                              \
   1.558    product(bool, UseBoundThreads, true,                                      \
   1.559 -          "Bind user level threads to kernel threads (for SOLARIS only)")   \
   1.560 +          "Bind user level threads to kernel threads (for Solaris only)")   \
   1.561                                                                              \
   1.562    develop(bool, UseDetachedThreads, true,                                   \
   1.563            "Use detached threads that are recycled upon termination "        \
   1.564 -          "(for SOLARIS only)")                                             \
   1.565 +          "(for Solaris only)")                                             \
   1.566                                                                              \
   1.567    product(bool, UseLWPSynchronization, true,                                \
   1.568            "Use LWP-based instead of libthread-based synchronization "       \
   1.569 @@ -1063,41 +1066,43 @@
   1.570            "(Unstable) Various monitor synchronization tunables")            \
   1.571                                                                              \
   1.572    product(intx, EmitSync, 0,                                                \
   1.573 -          "(Unsafe,Unstable) "                                              \
   1.574 -          " Controls emission of inline sync fast-path code")               \
   1.575 +          "(Unsafe, Unstable) "                                             \
   1.576 +          "Control emission of inline sync fast-path code")                 \
   1.577                                                                              \
   1.578    product(intx, MonitorBound, 0, "Bound Monitor population")                \
   1.579                                                                              \
   1.580    product(bool, MonitorInUseLists, false, "Track Monitors for Deflation")   \
   1.581                                                                              \
   1.582 -  product(intx, SyncFlags, 0, "(Unsafe,Unstable) Experimental Sync flags" ) \
   1.583 -                                                                            \
   1.584 -  product(intx, SyncVerbose, 0, "(Unstable)" )                              \
   1.585 -                                                                            \
   1.586 -  product(intx, ClearFPUAtPark, 0, "(Unsafe,Unstable)" )                    \
   1.587 +  product(intx, SyncFlags, 0, "(Unsafe, Unstable) Experimental Sync flags") \
   1.588 +                                                                            \
   1.589 +  product(intx, SyncVerbose, 0, "(Unstable)")                               \
   1.590 +                                                                            \
   1.591 +  product(intx, ClearFPUAtPark, 0, "(Unsafe, Unstable)")                    \
   1.592                                                                              \
   1.593    product(intx, hashCode, 5,                                                \
   1.594 -         "(Unstable) select hashCode generation algorithm" )                \
   1.595 +          "(Unstable) select hashCode generation algorithm")                \
   1.596                                                                              \
   1.597    product(intx, WorkAroundNPTLTimedWaitHang, 1,                             \
   1.598 -         "(Unstable, Linux-specific)"                                       \
   1.599 -         " avoid NPTL-FUTEX hang pthread_cond_timedwait" )                  \
   1.600 +          "(Unstable, Linux-specific) "                                     \
   1.601 +          "avoid NPTL-FUTEX hang pthread_cond_timedwait")                   \
   1.602                                                                              \
   1.603    product(bool, FilterSpuriousWakeups, true,                                \
   1.604            "Prevent spurious or premature wakeups from object.wait "         \
   1.605            "(Solaris only)")                                                 \
   1.606                                                                              \
   1.607 -  product(intx, NativeMonitorTimeout, -1, "(Unstable)" )                    \
   1.608 -  product(intx, NativeMonitorFlags, 0, "(Unstable)" )                       \
   1.609 -  product(intx, NativeMonitorSpinLimit, 20, "(Unstable)" )                  \
   1.610 +  product(intx, NativeMonitorTimeout, -1, "(Unstable)")                     \
   1.611 +                                                                            \
   1.612 +  product(intx, NativeMonitorFlags, 0, "(Unstable)")                        \
   1.613 +                                                                            \
   1.614 +  product(intx, NativeMonitorSpinLimit, 20, "(Unstable)")                   \
   1.615                                                                              \
   1.616    develop(bool, UsePthreads, false,                                         \
   1.617            "Use pthread-based instead of libthread-based synchronization "   \
   1.618            "(SPARC only)")                                                   \
   1.619                                                                              \
   1.620    product(bool, AdjustConcurrency, false,                                   \
   1.621 -          "call thr_setconcurrency at thread create time to avoid "         \
   1.622 -          "LWP starvation on MP systems (For Solaris Only)")                \
   1.623 +          "Call thr_setconcurrency at thread creation time to avoid "       \
   1.624 +          "LWP starvation on MP systems (for Solaris Only)")                \
   1.625                                                                              \
   1.626    product(bool, ReduceSignalUsage, false,                                   \
   1.627            "Reduce the use of OS signals in Java and/or the VM")             \
   1.628 @@ -1106,13 +1111,14 @@
   1.629            "Share vtable stubs (smaller code but worse branch prediction")   \
   1.630                                                                              \
   1.631    develop(bool, LoadLineNumberTables, true,                                 \
   1.632 -          "Tells whether the class file parser loads line number tables")   \
   1.633 +          "Tell whether the class file parser loads line number tables")    \
   1.634                                                                              \
   1.635    develop(bool, LoadLocalVariableTables, true,                              \
   1.636 -          "Tells whether the class file parser loads local variable tables")\
   1.637 +          "Tell whether the class file parser loads local variable tables") \
   1.638                                                                              \
   1.639    develop(bool, LoadLocalVariableTypeTables, true,                          \
   1.640 -          "Tells whether the class file parser loads local variable type tables")\
   1.641 +          "Tell whether the class file parser loads local variable type"    \
   1.642 +          "tables")                                                         \
   1.643                                                                              \
   1.644    product(bool, AllowUserSignalHandlers, false,                             \
   1.645            "Do not complain if the application installs signal handlers "    \
   1.646 @@ -1143,10 +1149,12 @@
   1.647                                                                              \
   1.648    product(bool, EagerXrunInit, false,                                       \
   1.649            "Eagerly initialize -Xrun libraries; allows startup profiling, "  \
   1.650 -          " but not all -Xrun libraries may support the state of the VM at this time") \
   1.651 +          "but not all -Xrun libraries may support the state of the VM "    \
   1.652 +          "at this time")                                                   \
   1.653                                                                              \
   1.654    product(bool, PreserveAllAnnotations, false,                              \
   1.655 -          "Preserve RuntimeInvisibleAnnotations as well as RuntimeVisibleAnnotations") \
   1.656 +          "Preserve RuntimeInvisibleAnnotations as well "                   \
   1.657 +          "as RuntimeVisibleAnnotations")                                   \
   1.658                                                                              \
   1.659    develop(uintx, PreallocatedOutOfMemoryErrorCount, 4,                      \
   1.660            "Number of OutOfMemoryErrors preallocated with backtrace")        \
   1.661 @@ -1221,7 +1229,7 @@
   1.662            "Trace level for JVMTI RedefineClasses")                          \
   1.663                                                                              \
   1.664    develop(bool, StressMethodComparator, false,                              \
   1.665 -          "run the MethodComparator on all loaded methods")                 \
   1.666 +          "Run the MethodComparator on all loaded methods")                 \
   1.667                                                                              \
   1.668    /* change to false by default sometime after Mustang */                   \
   1.669    product(bool, VerifyMergedCPBytecodes, true,                              \
   1.670 @@ -1255,7 +1263,7 @@
   1.671            "Trace dependencies")                                             \
   1.672                                                                              \
   1.673    develop(bool, VerifyDependencies, trueInDebug,                            \
   1.674 -         "Exercise and verify the compilation dependency mechanism")        \
   1.675 +          "Exercise and verify the compilation dependency mechanism")       \
   1.676                                                                              \
   1.677    develop(bool, TraceNewOopMapGeneration, false,                            \
   1.678            "Trace OopMapGeneration")                                         \
   1.679 @@ -1273,7 +1281,7 @@
   1.680            "Trace monitor matching failures during OopMapGeneration")        \
   1.681                                                                              \
   1.682    develop(bool, TraceOopMapRewrites, false,                                 \
   1.683 -          "Trace rewritting of method oops during oop map generation")      \
   1.684 +          "Trace rewriting of method oops during oop map generation")       \
   1.685                                                                              \
   1.686    develop(bool, TraceSafepoint, false,                                      \
   1.687            "Trace safepoint operations")                                     \
   1.688 @@ -1291,10 +1299,10 @@
   1.689            "Trace setup time")                                               \
   1.690                                                                              \
   1.691    develop(bool, TraceProtectionDomainVerification, false,                   \
   1.692 -          "Trace protection domain verifcation")                            \
   1.693 +          "Trace protection domain verification")                           \
   1.694                                                                              \
   1.695    develop(bool, TraceClearedExceptions, false,                              \
   1.696 -          "Prints when an exception is forcibly cleared")                   \
   1.697 +          "Print when an exception is forcibly cleared")                    \
   1.698                                                                              \
   1.699    product(bool, TraceClassResolution, false,                                \
   1.700            "Trace all constant pool resolutions (for debugging)")            \
   1.701 @@ -1308,7 +1316,7 @@
   1.702    /* gc */                                                                  \
   1.703                                                                              \
   1.704    product(bool, UseSerialGC, false,                                         \
   1.705 -          "Use the serial garbage collector")                               \
   1.706 +          "Use the Serial garbage collector")                               \
   1.707                                                                              \
   1.708    product(bool, UseG1GC, false,                                             \
   1.709            "Use the Garbage-First garbage collector")                        \
   1.710 @@ -1327,16 +1335,16 @@
   1.711            "The collection count for the first maximum compaction")          \
   1.712                                                                              \
   1.713    product(bool, UseMaximumCompactionOnSystemGC, true,                       \
   1.714 -          "In the Parallel Old garbage collector maximum compaction for "   \
   1.715 -          "a system GC")                                                    \
   1.716 +          "Use maximum compaction in the Parallel Old garbage collector "   \
   1.717 +          "for a system GC")                                                \
   1.718                                                                              \
   1.719    product(uintx, ParallelOldDeadWoodLimiterMean, 50,                        \
   1.720 -          "The mean used by the par compact dead wood"                      \
   1.721 -          "limiter (a number between 0-100).")                              \
   1.722 +          "The mean used by the parallel compact dead wood "                \
   1.723 +          "limiter (a number between 0-100)")                               \
   1.724                                                                              \
   1.725    product(uintx, ParallelOldDeadWoodLimiterStdDev, 80,                      \
   1.726 -          "The standard deviation used by the par compact dead wood"        \
   1.727 -          "limiter (a number between 0-100).")                              \
   1.728 +          "The standard deviation used by the parallel compact dead wood "  \
   1.729 +          "limiter (a number between 0-100)")                               \
   1.730                                                                              \
   1.731    product(uintx, ParallelGCThreads, 0,                                      \
   1.732            "Number of parallel threads parallel gc will use")                \
   1.733 @@ -1346,7 +1354,7 @@
   1.734            "parallel gc will use")                                           \
   1.735                                                                              \
   1.736    diagnostic(bool, ForceDynamicNumberOfGCThreads, false,                    \
   1.737 -          "Force dynamic selection of the number of"                        \
   1.738 +          "Force dynamic selection of the number of "                       \
   1.739            "parallel threads parallel gc will use to aid debugging")         \
   1.740                                                                              \
   1.741    product(uintx, HeapSizePerGCThread, ScaleForWordSize(64*M),               \
   1.742 @@ -1357,7 +1365,7 @@
   1.743            "Trace the dynamic GC thread usage")                              \
   1.744                                                                              \
   1.745    develop(bool, ParallelOldGCSplitALot, false,                              \
   1.746 -          "Provoke splitting (copying data from a young gen space to"       \
   1.747 +          "Provoke splitting (copying data from a young gen space to "      \
   1.748            "multiple destination spaces)")                                   \
   1.749                                                                              \
   1.750    develop(uintx, ParallelOldGCSplitInterval, 3,                             \
   1.751 @@ -1367,19 +1375,19 @@
   1.752            "Number of threads concurrent gc will use")                       \
   1.753                                                                              \
   1.754    product(uintx, YoungPLABSize, 4096,                                       \
   1.755 -          "Size of young gen promotion labs (in HeapWords)")                \
   1.756 +          "Size of young gen promotion LAB's (in HeapWords)")               \
   1.757                                                                              \
   1.758    product(uintx, OldPLABSize, 1024,                                         \
   1.759 -          "Size of old gen promotion labs (in HeapWords)")                  \
   1.760 +          "Size of old gen promotion LAB's (in HeapWords)")                 \
   1.761                                                                              \
   1.762    product(uintx, GCTaskTimeStampEntries, 200,                               \
   1.763            "Number of time stamp entries per gc worker thread")              \
   1.764                                                                              \
   1.765    product(bool, AlwaysTenure, false,                                        \
   1.766 -          "Always tenure objects in eden. (ParallelGC only)")               \
   1.767 +          "Always tenure objects in eden (ParallelGC only)")                \
   1.768                                                                              \
   1.769    product(bool, NeverTenure, false,                                         \
   1.770 -          "Never tenure objects in eden, May tenure on overflow "           \
   1.771 +          "Never tenure objects in eden, may tenure on overflow "           \
   1.772            "(ParallelGC only)")                                              \
   1.773                                                                              \
   1.774    product(bool, ScavengeBeforeFullGC, true,                                 \
   1.775 @@ -1387,14 +1395,14 @@
   1.776            "used with UseParallelGC")                                        \
   1.777                                                                              \
   1.778    develop(bool, ScavengeWithObjectsInToSpace, false,                        \
   1.779 -          "Allow scavenges to occur when to_space contains objects.")       \
   1.780 +          "Allow scavenges to occur when to-space contains objects")        \
   1.781                                                                              \
   1.782    product(bool, UseConcMarkSweepGC, false,                                  \
   1.783            "Use Concurrent Mark-Sweep GC in the old generation")             \
   1.784                                                                              \
   1.785    product(bool, ExplicitGCInvokesConcurrent, false,                         \
   1.786 -          "A System.gc() request invokes a concurrent collection;"          \
   1.787 -          " (effective only when UseConcMarkSweepGC)")                      \
   1.788 +          "A System.gc() request invokes a concurrent collection; "         \
   1.789 +          "(effective only when UseConcMarkSweepGC)")                       \
   1.790                                                                              \
   1.791    product(bool, ExplicitGCInvokesConcurrentAndUnloadsClasses, false,        \
   1.792            "A System.gc() request invokes a concurrent collection and "      \
   1.793 @@ -1402,19 +1410,19 @@
   1.794            "(effective only when UseConcMarkSweepGC)")                       \
   1.795                                                                              \
   1.796    product(bool, GCLockerInvokesConcurrent, false,                           \
   1.797 -          "The exit of a JNI CS necessitating a scavenge also"              \
   1.798 -          " kicks off a bkgrd concurrent collection")                       \
   1.799 +          "The exit of a JNI critical section necessitating a scavenge, "   \
   1.800 +          "also kicks off a background concurrent collection")              \
   1.801                                                                              \
   1.802    product(uintx, GCLockerEdenExpansionPercent, 5,                           \
   1.803 -          "How much the GC can expand the eden by while the GC locker  "    \
   1.804 +          "How much the GC can expand the eden by while the GC locker "     \
   1.805            "is active (as a percentage)")                                    \
   1.806                                                                              \
   1.807    diagnostic(intx, GCLockerRetryAllocationCount, 2,                         \
   1.808 -          "Number of times to retry allocations when"                       \
   1.809 -          " blocked by the GC locker")                                      \
   1.810 +          "Number of times to retry allocations when "                      \
   1.811 +          "blocked by the GC locker")                                       \
   1.812                                                                              \
   1.813    develop(bool, UseCMSAdaptiveFreeLists, true,                              \
   1.814 -          "Use Adaptive Free Lists in the CMS generation")                  \
   1.815 +          "Use adaptive free lists in the CMS generation")                  \
   1.816                                                                              \
   1.817    develop(bool, UseAsyncConcMarkSweepGC, true,                              \
   1.818            "Use Asynchronous Concurrent Mark-Sweep GC in the old generation")\
   1.819 @@ -1429,44 +1437,46 @@
   1.820            "Use passing of collection from background to foreground")        \
   1.821                                                                              \
   1.822    product(bool, UseParNewGC, false,                                         \
   1.823 -          "Use parallel threads in the new generation.")                    \
   1.824 +          "Use parallel threads in the new generation")                     \
   1.825                                                                              \
   1.826    product(bool, ParallelGCVerbose, false,                                   \
   1.827 -          "Verbose output for parallel GC.")                                \
   1.828 +          "Verbose output for parallel gc")                                 \
   1.829                                                                              \
   1.830    product(uintx, ParallelGCBufferWastePct, 10,                              \
   1.831 -          "Wasted fraction of parallel allocation buffer.")                 \
   1.832 +          "Wasted fraction of parallel allocation buffer")                  \
   1.833                                                                              \
   1.834    diagnostic(bool, ParallelGCRetainPLAB, false,                             \
   1.835 -             "Retain parallel allocation buffers across scavenges; "        \
   1.836 -             " -- disabled because this currently conflicts with "          \
   1.837 -             " parallel card scanning under certain conditions ")           \
   1.838 +          "Retain parallel allocation buffers across scavenges; "           \
   1.839 +          "it is disabled because this currently conflicts with "           \
   1.840 +          "parallel card scanning under certain conditions.")               \
   1.841                                                                              \
   1.842    product(uintx, TargetPLABWastePct, 10,                                    \
   1.843            "Target wasted space in last buffer as percent of overall "       \
   1.844            "allocation")                                                     \
   1.845                                                                              \
   1.846    product(uintx, PLABWeight, 75,                                            \
   1.847 -          "Percentage (0-100) used to weight the current sample when"       \
   1.848 -          "computing exponentially decaying average for ResizePLAB.")       \
   1.849 +          "Percentage (0-100) used to weigh the current sample when "       \
   1.850 +          "computing exponentially decaying average for ResizePLAB")        \
   1.851                                                                              \
   1.852    product(bool, ResizePLAB, true,                                           \
   1.853 -          "Dynamically resize (survivor space) promotion labs")             \
   1.854 +          "Dynamically resize (survivor space) promotion LAB's")            \
   1.855                                                                              \
   1.856    product(bool, PrintPLAB, false,                                           \
   1.857 -          "Print (survivor space) promotion labs sizing decisions")         \
   1.858 +          "Print (survivor space) promotion LAB's sizing decisions")        \
   1.859                                                                              \
   1.860    product(intx, ParGCArrayScanChunk, 50,                                    \
   1.861 -          "Scan a subset and push remainder, if array is bigger than this") \
   1.862 +          "Scan a subset of object array and push remainder, if array is "  \
   1.863 +          "bigger than this")                                               \
   1.864                                                                              \
   1.865    product(bool, ParGCUseLocalOverflow, false,                               \
   1.866            "Instead of a global overflow list, use local overflow stacks")   \
   1.867                                                                              \
   1.868    product(bool, ParGCTrimOverflow, true,                                    \
   1.869 -          "Eagerly trim the local overflow lists (when ParGCUseLocalOverflow") \
   1.870 +          "Eagerly trim the local overflow lists "                          \
   1.871 +          "(when ParGCUseLocalOverflow)")                                   \
   1.872                                                                              \
   1.873    notproduct(bool, ParGCWorkQueueOverflowALot, false,                       \
   1.874 -          "Whether we should simulate work queue overflow in ParNew")       \
   1.875 +          "Simulate work queue overflow in ParNew")                         \
   1.876                                                                              \
   1.877    notproduct(uintx, ParGCWorkQueueOverflowInterval, 1000,                   \
   1.878            "An `interval' counter that determines how frequently "           \
   1.879 @@ -1484,43 +1494,46 @@
   1.880            "during card table scanning")                                     \
   1.881                                                                              \
   1.882    product(uintx, CMSParPromoteBlocksToClaim, 16,                            \
   1.883 -          "Number of blocks to attempt to claim when refilling CMS LAB for "\
   1.884 -          "parallel GC.")                                                   \
   1.885 +          "Number of blocks to attempt to claim when refilling CMS LAB's "  \
   1.886 +          "for parallel GC")                                                \
   1.887                                                                              \
   1.888    product(uintx, OldPLABWeight, 50,                                         \
   1.889 -          "Percentage (0-100) used to weight the current sample when"       \
   1.890 -          "computing exponentially decaying average for resizing CMSParPromoteBlocksToClaim.") \
   1.891 +          "Percentage (0-100) used to weight the current sample when "      \
   1.892 +          "computing exponentially decaying average for resizing "          \
   1.893 +          "CMSParPromoteBlocksToClaim")                                     \
   1.894                                                                              \
   1.895    product(bool, ResizeOldPLAB, true,                                        \
   1.896 -          "Dynamically resize (old gen) promotion labs")                    \
   1.897 +          "Dynamically resize (old gen) promotion LAB's")                   \
   1.898                                                                              \
   1.899    product(bool, PrintOldPLAB, false,                                        \
   1.900 -          "Print (old gen) promotion labs sizing decisions")                \
   1.901 +          "Print (old gen) promotion LAB's sizing decisions")               \
   1.902                                                                              \
   1.903    product(uintx, CMSOldPLABMin, 16,                                         \
   1.904 -          "Min size of CMS gen promotion lab caches per worker per blksize")\
   1.905 +          "Minimum size of CMS gen promotion LAB caches per worker "        \
   1.906 +          "per block size")                                                 \
   1.907                                                                              \
   1.908    product(uintx, CMSOldPLABMax, 1024,                                       \
   1.909 -          "Max size of CMS gen promotion lab caches per worker per blksize")\
   1.910 +          "Maximum size of CMS gen promotion LAB caches per worker "        \
   1.911 +          "per block size")                                                 \
   1.912                                                                              \
   1.913    product(uintx, CMSOldPLABNumRefills, 4,                                   \
   1.914 -          "Nominal number of refills of CMS gen promotion lab cache"        \
   1.915 -          " per worker per block size")                                     \
   1.916 +          "Nominal number of refills of CMS gen promotion LAB cache "       \
   1.917 +          "per worker per block size")                                      \
   1.918                                                                              \
   1.919    product(bool, CMSOldPLABResizeQuicker, false,                             \
   1.920 -          "Whether to react on-the-fly during a scavenge to a sudden"       \
   1.921 -          " change in block demand rate")                                   \
   1.922 +          "React on-the-fly during a scavenge to a sudden "                 \
   1.923 +          "change in block demand rate")                                    \
   1.924                                                                              \
   1.925    product(uintx, CMSOldPLABToleranceFactor, 4,                              \
   1.926 -          "The tolerance of the phase-change detector for on-the-fly"       \
   1.927 -          " PLAB resizing during a scavenge")                               \
   1.928 +          "The tolerance of the phase-change detector for on-the-fly "      \
   1.929 +          "PLAB resizing during a scavenge")                                \
   1.930                                                                              \
   1.931    product(uintx, CMSOldPLABReactivityFactor, 2,                             \
   1.932 -          "The gain in the feedback loop for on-the-fly PLAB resizing"      \
   1.933 -          " during a scavenge")                                             \
   1.934 +          "The gain in the feedback loop for on-the-fly PLAB resizing "     \
   1.935 +          "during a scavenge")                                              \
   1.936                                                                              \
   1.937    product(bool, AlwaysPreTouch, false,                                      \
   1.938 -          "It forces all freshly committed pages to be pre-touched.")       \
   1.939 +          "Force all freshly committed pages to be pre-touched")            \
   1.940                                                                              \
   1.941    product_pd(uintx, CMSYoungGenPerWorker,                                   \
   1.942            "The maximum size of young gen chosen by default per GC worker "  \
   1.943 @@ -1530,64 +1543,67 @@
   1.944            "Whether CMS GC should operate in \"incremental\" mode")          \
   1.945                                                                              \
   1.946    product(uintx, CMSIncrementalDutyCycle, 10,                               \
   1.947 -          "CMS incremental mode duty cycle (a percentage, 0-100).  If"      \
   1.948 -          "CMSIncrementalPacing is enabled, then this is just the initial"  \
   1.949 -          "value")                                                          \
   1.950 +          "Percentage (0-100) of CMS incremental mode duty cycle. If "      \
   1.951 +          "CMSIncrementalPacing is enabled, then this is just the initial " \
   1.952 +          "value.")                                                         \
   1.953                                                                              \
   1.954    product(bool, CMSIncrementalPacing, true,                                 \
   1.955            "Whether the CMS incremental mode duty cycle should be "          \
   1.956            "automatically adjusted")                                         \
   1.957                                                                              \
   1.958    product(uintx, CMSIncrementalDutyCycleMin, 0,                             \
   1.959 -          "Lower bound on the duty cycle when CMSIncrementalPacing is "     \
   1.960 -          "enabled (a percentage, 0-100)")                                  \
   1.961 +          "Minimum percentage (0-100) of the CMS incremental duty cycle "   \
   1.962 +          "used when CMSIncrementalPacing is enabled")                      \
   1.963                                                                              \
   1.964    product(uintx, CMSIncrementalSafetyFactor, 10,                            \
   1.965            "Percentage (0-100) used to add conservatism when computing the " \
   1.966            "duty cycle")                                                     \
   1.967                                                                              \
   1.968    product(uintx, CMSIncrementalOffset, 0,                                   \
   1.969 -          "Percentage (0-100) by which the CMS incremental mode duty cycle" \
   1.970 -          " is shifted to the right within the period between young GCs")   \
   1.971 +          "Percentage (0-100) by which the CMS incremental mode duty cycle "\
   1.972 +          "is shifted to the right within the period between young GCs")    \
   1.973                                                                              \
   1.974    product(uintx, CMSExpAvgFactor, 50,                                       \
   1.975 -          "Percentage (0-100) used to weight the current sample when"       \
   1.976 -          "computing exponential averages for CMS statistics.")             \
   1.977 +          "Percentage (0-100) used to weigh the current sample when "       \
   1.978 +          "computing exponential averages for CMS statistics")              \
   1.979                                                                              \
   1.980    product(uintx, CMS_FLSWeight, 75,                                         \
   1.981 -          "Percentage (0-100) used to weight the current sample when"       \
   1.982 -          "computing exponentially decating averages for CMS FLS statistics.") \
   1.983 +          "Percentage (0-100) used to weigh the current sample when "       \
   1.984 +          "computing exponentially decaying averages for CMS FLS "          \
   1.985 +          "statistics")                                                     \
   1.986                                                                              \
   1.987    product(uintx, CMS_FLSPadding, 1,                                         \
   1.988 -          "The multiple of deviation from mean to use for buffering"        \
   1.989 -          "against volatility in free list demand.")                        \
   1.990 +          "The multiple of deviation from mean to use for buffering "       \
   1.991 +          "against volatility in free list demand")                         \
   1.992                                                                              \
   1.993    product(uintx, FLSCoalescePolicy, 2,                                      \
   1.994 -          "CMS: Aggression level for coalescing, increasing from 0 to 4")   \
   1.995 +          "CMS: aggressiveness level for coalescing, increasing "           \
   1.996 +          "from 0 to 4")                                                    \
   1.997                                                                              \
   1.998    product(bool, FLSAlwaysCoalesceLarge, false,                              \
   1.999 -          "CMS: Larger free blocks are always available for coalescing")    \
  1.1000 +          "CMS: larger free blocks are always available for coalescing")    \
  1.1001                                                                              \
  1.1002    product(double, FLSLargestBlockCoalesceProximity, 0.99,                   \
  1.1003 -          "CMS: the smaller the percentage the greater the coalition force")\
  1.1004 +          "CMS: the smaller the percentage the greater the coalescing "     \
  1.1005 +          "force")                                                          \
  1.1006                                                                              \
  1.1007    product(double, CMSSmallCoalSurplusPercent, 1.05,                         \
  1.1008 -          "CMS: the factor by which to inflate estimated demand of small"   \
  1.1009 -          " block sizes to prevent coalescing with an adjoining block")     \
  1.1010 +          "CMS: the factor by which to inflate estimated demand of small "  \
  1.1011 +          "block sizes to prevent coalescing with an adjoining block")      \
  1.1012                                                                              \
  1.1013    product(double, CMSLargeCoalSurplusPercent, 0.95,                         \
  1.1014 -          "CMS: the factor by which to inflate estimated demand of large"   \
  1.1015 -          " block sizes to prevent coalescing with an adjoining block")     \
  1.1016 +          "CMS: the factor by which to inflate estimated demand of large "  \
  1.1017 +          "block sizes to prevent coalescing with an adjoining block")      \
  1.1018                                                                              \
  1.1019    product(double, CMSSmallSplitSurplusPercent, 1.10,                        \
  1.1020 -          "CMS: the factor by which to inflate estimated demand of small"   \
  1.1021 -          " block sizes to prevent splitting to supply demand for smaller"  \
  1.1022 -          " blocks")                                                        \
  1.1023 +          "CMS: the factor by which to inflate estimated demand of small "  \
  1.1024 +          "block sizes to prevent splitting to supply demand for smaller "  \
  1.1025 +          "blocks")                                                         \
  1.1026                                                                              \
  1.1027    product(double, CMSLargeSplitSurplusPercent, 1.00,                        \
  1.1028 -          "CMS: the factor by which to inflate estimated demand of large"   \
  1.1029 -          " block sizes to prevent splitting to supply demand for smaller"  \
  1.1030 -          " blocks")                                                        \
  1.1031 +          "CMS: the factor by which to inflate estimated demand of large "  \
  1.1032 +          "block sizes to prevent splitting to supply demand for smaller "  \
  1.1033 +          "blocks")                                                         \
  1.1034                                                                              \
  1.1035    product(bool, CMSExtrapolateSweep, false,                                 \
  1.1036            "CMS: cushion for block demand during sweep")                     \
  1.1037 @@ -1599,11 +1615,11 @@
  1.1038                                                                              \
  1.1039    product(uintx, CMS_SweepPadding, 1,                                       \
  1.1040            "The multiple of deviation from mean to use for buffering "       \
  1.1041 -          "against volatility in inter-sweep duration.")                    \
  1.1042 +          "against volatility in inter-sweep duration")                     \
  1.1043                                                                              \
  1.1044    product(uintx, CMS_SweepTimerThresholdMillis, 10,                         \
  1.1045            "Skip block flux-rate sampling for an epoch unless inter-sweep "  \
  1.1046 -          "duration exceeds this threhold in milliseconds")                 \
  1.1047 +          "duration exceeds this threshold in milliseconds")                \
  1.1048                                                                              \
  1.1049    develop(bool, CMSTraceIncrementalMode, false,                             \
  1.1050            "Trace CMS incremental mode")                                     \
  1.1051 @@ -1618,14 +1634,15 @@
  1.1052            "Whether class unloading enabled when using CMS GC")              \
  1.1053                                                                              \
  1.1054    product(uintx, CMSClassUnloadingMaxInterval, 0,                           \
  1.1055 -          "When CMS class unloading is enabled, the maximum CMS cycle count"\
  1.1056 -          " for which classes may not be unloaded")                         \
  1.1057 +          "When CMS class unloading is enabled, the maximum CMS cycle "     \
  1.1058 +          "count for which classes may not be unloaded")                    \
  1.1059                                                                              \
  1.1060    product(bool, CMSCompactWhenClearAllSoftRefs, true,                       \
  1.1061 -          "Compact when asked to collect CMS gen with clear_all_soft_refs") \
  1.1062 +          "Compact when asked to collect CMS gen with "                     \
  1.1063 +          "clear_all_soft_refs()")                                          \
  1.1064                                                                              \
  1.1065    product(bool, UseCMSCompactAtFullCollection, true,                        \
  1.1066 -          "Use mark sweep compact at full collections")                     \
  1.1067 +          "Use Mark-Sweep-Compact algorithm at full collections")           \
  1.1068                                                                              \
  1.1069    product(uintx, CMSFullGCsBeforeCompaction, 0,                             \
  1.1070            "Number of CMS full collection done before compaction if > 0")    \
  1.1071 @@ -1647,38 +1664,37 @@
  1.1072            "Warn in case of excessive CMS looping")                          \
  1.1073                                                                              \
  1.1074    develop(bool, CMSOverflowEarlyRestoration, false,                         \
  1.1075 -          "Whether preserved marks should be restored early")               \
  1.1076 +          "Restore preserved marks early")                                  \
  1.1077                                                                              \
  1.1078    product(uintx, MarkStackSize, NOT_LP64(32*K) LP64_ONLY(4*M),              \
  1.1079            "Size of marking stack")                                          \
  1.1080                                                                              \
  1.1081    product(uintx, MarkStackSizeMax, NOT_LP64(4*M) LP64_ONLY(512*M),          \
  1.1082 -          "Max size of marking stack")                                      \
  1.1083 +          "Maximum size of marking stack")                                  \
  1.1084                                                                              \
  1.1085    notproduct(bool, CMSMarkStackOverflowALot, false,                         \
  1.1086 -          "Whether we should simulate frequent marking stack / work queue"  \
  1.1087 -          " overflow")                                                      \
  1.1088 +          "Simulate frequent marking stack / work queue overflow")          \
  1.1089                                                                              \
  1.1090    notproduct(uintx, CMSMarkStackOverflowInterval, 1000,                     \
  1.1091 -          "An `interval' counter that determines how frequently"            \
  1.1092 -          " we simulate overflow; a smaller number increases frequency")    \
  1.1093 +          "An \"interval\" counter that determines how frequently "         \
  1.1094 +          "to simulate overflow; a smaller number increases frequency")     \
  1.1095                                                                              \
  1.1096    product(uintx, CMSMaxAbortablePrecleanLoops, 0,                           \
  1.1097 -          "(Temporary, subject to experimentation)"                         \
  1.1098 +          "(Temporary, subject to experimentation) "                        \
  1.1099            "Maximum number of abortable preclean iterations, if > 0")        \
  1.1100                                                                              \
  1.1101    product(intx, CMSMaxAbortablePrecleanTime, 5000,                          \
  1.1102 -          "(Temporary, subject to experimentation)"                         \
  1.1103 -          "Maximum time in abortable preclean in ms")                       \
  1.1104 +          "(Temporary, subject to experimentation) "                        \
  1.1105 +          "Maximum time in abortable preclean (in milliseconds)")           \
  1.1106                                                                              \
  1.1107    product(uintx, CMSAbortablePrecleanMinWorkPerIteration, 100,              \
  1.1108 -          "(Temporary, subject to experimentation)"                         \
  1.1109 +          "(Temporary, subject to experimentation) "                        \
  1.1110            "Nominal minimum work per abortable preclean iteration")          \
  1.1111                                                                              \
  1.1112    manageable(intx, CMSAbortablePrecleanWaitMillis, 100,                     \
  1.1113 -          "(Temporary, subject to experimentation)"                         \
  1.1114 -          " Time that we sleep between iterations when not given"           \
  1.1115 -          " enough work per iteration")                                     \
  1.1116 +          "(Temporary, subject to experimentation) "                        \
  1.1117 +          "Time that we sleep between iterations when not given "           \
  1.1118 +          "enough work per iteration")                                      \
  1.1119                                                                              \
  1.1120    product(uintx, CMSRescanMultiple, 32,                                     \
  1.1121            "Size (in cards) of CMS parallel rescan task")                    \
  1.1122 @@ -1696,23 +1712,24 @@
  1.1123            "Whether parallel remark enabled (only if ParNewGC)")             \
  1.1124                                                                              \
  1.1125    product(bool, CMSParallelSurvivorRemarkEnabled, true,                     \
  1.1126 -          "Whether parallel remark of survivor space"                       \
  1.1127 -          " enabled (effective only if CMSParallelRemarkEnabled)")          \
  1.1128 +          "Whether parallel remark of survivor space "                      \
  1.1129 +          "enabled (effective only if CMSParallelRemarkEnabled)")           \
  1.1130                                                                              \
  1.1131    product(bool, CMSPLABRecordAlways, true,                                  \
  1.1132 -          "Whether to always record survivor space PLAB bdries"             \
  1.1133 -          " (effective only if CMSParallelSurvivorRemarkEnabled)")          \
  1.1134 +          "Always record survivor space PLAB boundaries (effective only "   \
  1.1135 +          "if CMSParallelSurvivorRemarkEnabled)")                           \
  1.1136                                                                              \
  1.1137    product(bool, CMSEdenChunksRecordAlways, true,                            \
  1.1138 -          "Whether to always record eden chunks used for "                  \
  1.1139 -          "the parallel initial mark or remark of eden" )                   \
  1.1140 +          "Always record eden chunks used for the parallel initial mark "   \
  1.1141 +          "or remark of eden")                                              \
  1.1142                                                                              \
  1.1143    product(bool, CMSPrintEdenSurvivorChunks, false,                          \
  1.1144            "Print the eden and the survivor chunks used for the parallel "   \
  1.1145            "initial mark or remark of the eden/survivor spaces")             \
  1.1146                                                                              \
  1.1147    product(bool, CMSConcurrentMTEnabled, true,                               \
  1.1148 -          "Whether multi-threaded concurrent work enabled (if ParNewGC)")   \
  1.1149 +          "Whether multi-threaded concurrent work enabled "                 \
  1.1150 +          "(effective only if ParNewGC)")                                   \
  1.1151                                                                              \
  1.1152    product(bool, CMSPrecleaningEnabled, true,                                \
  1.1153            "Whether concurrent precleaning enabled")                         \
  1.1154 @@ -1721,12 +1738,12 @@
  1.1155            "Maximum number of precleaning iteration passes")                 \
  1.1156                                                                              \
  1.1157    product(uintx, CMSPrecleanNumerator, 2,                                   \
  1.1158 -          "CMSPrecleanNumerator:CMSPrecleanDenominator yields convergence"  \
  1.1159 -          " ratio")                                                         \
  1.1160 +          "CMSPrecleanNumerator:CMSPrecleanDenominator yields convergence " \
  1.1161 +          "ratio")                                                          \
  1.1162                                                                              \
  1.1163    product(uintx, CMSPrecleanDenominator, 3,                                 \
  1.1164 -          "CMSPrecleanNumerator:CMSPrecleanDenominator yields convergence"  \
  1.1165 -          " ratio")                                                         \
  1.1166 +          "CMSPrecleanNumerator:CMSPrecleanDenominator yields convergence " \
  1.1167 +          "ratio")                                                          \
  1.1168                                                                              \
  1.1169    product(bool, CMSPrecleanRefLists1, true,                                 \
  1.1170            "Preclean ref lists during (initial) preclean phase")             \
  1.1171 @@ -1741,7 +1758,7 @@
  1.1172            "Preclean survivors during abortable preclean phase")             \
  1.1173                                                                              \
  1.1174    product(uintx, CMSPrecleanThreshold, 1000,                                \
  1.1175 -          "Don't re-iterate if #dirty cards less than this")                \
  1.1176 +          "Do not iterate again if number of dirty cards is less than this")\
  1.1177                                                                              \
  1.1178    product(bool, CMSCleanOnEnter, true,                                      \
  1.1179            "Clean-on-enter optimization for reducing number of dirty cards") \
  1.1180 @@ -1750,14 +1767,16 @@
  1.1181            "Choose variant (1,2) of verification following remark")          \
  1.1182                                                                              \
  1.1183    product(uintx, CMSScheduleRemarkEdenSizeThreshold, 2*M,                   \
  1.1184 -          "If Eden used is below this value, don't try to schedule remark") \
  1.1185 +          "If Eden size is below this, do not try to schedule remark")      \
  1.1186                                                                              \
  1.1187    product(uintx, CMSScheduleRemarkEdenPenetration, 50,                      \
  1.1188 -          "The Eden occupancy % at which to try and schedule remark pause") \
  1.1189 +          "The Eden occupancy percentage (0-100) at which "                 \
  1.1190 +          "to try and schedule remark pause")                               \
  1.1191                                                                              \
  1.1192    product(uintx, CMSScheduleRemarkSamplingRatio, 5,                         \
  1.1193 -          "Start sampling Eden top at least before yg occupancy reaches"    \
  1.1194 -          " 1/<ratio> of the size at which we plan to schedule remark")     \
  1.1195 +          "Start sampling eden top at least before young gen "              \
  1.1196 +          "occupancy reaches 1/<ratio> of the size at which "               \
  1.1197 +          "we plan to schedule remark")                                     \
  1.1198                                                                              \
  1.1199    product(uintx, CMSSamplingGrain, 16*K,                                    \
  1.1200            "The minimum distance between eden samples for CMS (see above)")  \
  1.1201 @@ -1779,27 +1798,27 @@
  1.1202            "should start a collection cycle")                                \
  1.1203                                                                              \
  1.1204    product(bool, CMSYield, true,                                             \
  1.1205 -          "Yield between steps of concurrent mark & sweep")                 \
  1.1206 +          "Yield between steps of CMS")                                     \
  1.1207                                                                              \
  1.1208    product(uintx, CMSBitMapYieldQuantum, 10*M,                               \
  1.1209 -          "Bitmap operations should process at most this many bits"         \
  1.1210 +          "Bitmap operations should process at most this many bits "        \
  1.1211            "between yields")                                                 \
  1.1212                                                                              \
  1.1213    product(bool, CMSDumpAtPromotionFailure, false,                           \
  1.1214            "Dump useful information about the state of the CMS old "         \
  1.1215 -          " generation upon a promotion failure.")                          \
  1.1216 +          "generation upon a promotion failure")                            \
  1.1217                                                                              \
  1.1218    product(bool, CMSPrintChunksInDump, false,                                \
  1.1219            "In a dump enabled by CMSDumpAtPromotionFailure, include "        \
  1.1220 -          " more detailed information about the free chunks.")              \
  1.1221 +          "more detailed information about the free chunks")                \
  1.1222                                                                              \
  1.1223    product(bool, CMSPrintObjectsInDump, false,                               \
  1.1224            "In a dump enabled by CMSDumpAtPromotionFailure, include "        \
  1.1225 -          " more detailed information about the allocated objects.")        \
  1.1226 +          "more detailed information about the allocated objects")          \
  1.1227                                                                              \
  1.1228    diagnostic(bool, FLSVerifyAllHeapReferences, false,                       \
  1.1229 -          "Verify that all refs across the FLS boundary "                   \
  1.1230 -          " are to valid objects")                                          \
  1.1231 +          "Verify that all references across the FLS boundary "             \
  1.1232 +          "are to valid objects")                                           \
  1.1233                                                                              \
  1.1234    diagnostic(bool, FLSVerifyLists, false,                                   \
  1.1235            "Do lots of (expensive) FreeListSpace verification")              \
  1.1236 @@ -1811,17 +1830,18 @@
  1.1237            "Do lots of (expensive) FLS dictionary verification")             \
  1.1238                                                                              \
  1.1239    develop(bool, VerifyBlockOffsetArray, false,                              \
  1.1240 -          "Do (expensive!) block offset array verification")                \
  1.1241 +          "Do (expensive) block offset array verification")                 \
  1.1242                                                                              \
  1.1243    diagnostic(bool, BlockOffsetArrayUseUnallocatedBlock, false,              \
  1.1244 -          "Maintain _unallocated_block in BlockOffsetArray"                 \
  1.1245 -          " (currently applicable only to CMS collector)")                  \
  1.1246 +          "Maintain _unallocated_block in BlockOffsetArray "                \
  1.1247 +          "(currently applicable only to CMS collector)")                   \
  1.1248                                                                              \
  1.1249    develop(bool, TraceCMSState, false,                                       \
  1.1250            "Trace the state of the CMS collection")                          \
  1.1251                                                                              \
  1.1252    product(intx, RefDiscoveryPolicy, 0,                                      \
  1.1253 -          "Whether reference-based(0) or referent-based(1)")                \
  1.1254 +          "Select type of reference discovery policy: "                     \
  1.1255 +          "reference-based(0) or referent-based(1)")                        \
  1.1256                                                                              \
  1.1257    product(bool, ParallelRefProcEnabled, false,                              \
  1.1258            "Enable parallel reference processing whenever possible")         \
  1.1259 @@ -1849,7 +1869,7 @@
  1.1260            "denotes 'do constant GC cycles'.")                               \
  1.1261                                                                              \
  1.1262    product(bool, UseCMSInitiatingOccupancyOnly, false,                       \
  1.1263 -          "Only use occupancy as a crierion for starting a CMS collection") \
  1.1264 +          "Only use occupancy as a criterion for starting a CMS collection")\
  1.1265                                                                              \
  1.1266    product(uintx, CMSIsTooFullPercentage, 98,                                \
  1.1267            "An absolute ceiling above which CMS will always consider the "   \
  1.1268 @@ -1861,7 +1881,7 @@
  1.1269                                                                              \
  1.1270    notproduct(bool, CMSVerifyReturnedBytes, false,                           \
  1.1271            "Check that all the garbage collected was returned to the "       \
  1.1272 -          "free lists.")                                                    \
  1.1273 +          "free lists")                                                     \
  1.1274                                                                              \
  1.1275    notproduct(bool, ScavengeALot, false,                                     \
  1.1276            "Force scavenge at every Nth exit from the runtime system "       \
  1.1277 @@ -1876,16 +1896,16 @@
  1.1278                                                                              \
  1.1279    product(bool, PrintPromotionFailure, false,                               \
  1.1280            "Print additional diagnostic information following "              \
  1.1281 -          " promotion failure")                                             \
  1.1282 +          "promotion failure")                                              \
  1.1283                                                                              \
  1.1284    notproduct(bool, PromotionFailureALot, false,                             \
  1.1285            "Use promotion failure handling on every youngest generation "    \
  1.1286            "collection")                                                     \
  1.1287                                                                              \
  1.1288    develop(uintx, PromotionFailureALotCount, 1000,                           \
  1.1289 -          "Number of promotion failures occurring at ParGCAllocBuffer"      \
  1.1290 +          "Number of promotion failures occurring at ParGCAllocBuffer "     \
  1.1291            "refill attempts (ParNew) or promotion attempts "                 \
  1.1292 -          "(other young collectors) ")                                      \
  1.1293 +          "(other young collectors)")                                       \
  1.1294                                                                              \
  1.1295    develop(uintx, PromotionFailureALotInterval, 5,                           \
  1.1296            "Total collections between promotion failures alot")              \
  1.1297 @@ -1904,7 +1924,7 @@
  1.1298            "Ratio of hard spins to calls to yield")                          \
  1.1299                                                                              \
  1.1300    develop(uintx, ObjArrayMarkingStride, 512,                                \
  1.1301 -          "Number of ObjArray elements to push onto the marking stack"      \
  1.1302 +          "Number of object array elements to push onto the marking stack " \
  1.1303            "before pushing a continuation entry")                            \
  1.1304                                                                              \
  1.1305    develop(bool, MetadataAllocationFailALot, false,                          \
  1.1306 @@ -1912,7 +1932,7 @@
  1.1307            "MetadataAllocationFailALotInterval")                             \
  1.1308                                                                              \
  1.1309    develop(uintx, MetadataAllocationFailALotInterval, 1000,                  \
  1.1310 -          "metadata allocation failure alot interval")                      \
  1.1311 +          "Metadata allocation failure a lot interval")                     \
  1.1312                                                                              \
  1.1313    develop(bool, MetaDataDeallocateALot, false,                              \
  1.1314            "Deallocation bunches of metadata at intervals controlled by "    \
  1.1315 @@ -1931,7 +1951,7 @@
  1.1316            "Trace virtual space metadata allocations")                       \
  1.1317                                                                              \
  1.1318    notproduct(bool, ExecuteInternalVMTests, false,                           \
  1.1319 -          "Enable execution of internal VM tests.")                         \
  1.1320 +          "Enable execution of internal VM tests")                          \
  1.1321                                                                              \
  1.1322    notproduct(bool, VerboseInternalVMTests, false,                           \
  1.1323            "Turn on logging for internal VM tests.")                         \
  1.1324 @@ -1939,7 +1959,7 @@
  1.1325    product_pd(bool, UseTLAB, "Use thread-local object allocation")           \
  1.1326                                                                              \
  1.1327    product_pd(bool, ResizeTLAB,                                              \
  1.1328 -          "Dynamically resize tlab size for threads")                       \
  1.1329 +          "Dynamically resize TLAB size for threads")                       \
  1.1330                                                                              \
  1.1331    product(bool, ZeroTLAB, false,                                            \
  1.1332            "Zero out the newly created TLAB")                                \
  1.1333 @@ -1951,7 +1971,8 @@
  1.1334            "Print various TLAB related information")                         \
  1.1335                                                                              \
  1.1336    product(bool, TLABStats, true,                                            \
  1.1337 -          "Print various TLAB related information")                         \
  1.1338 +          "Provide more detailed and expensive TLAB statistics "            \
  1.1339 +          "(with PrintTLAB)")                                               \
  1.1340                                                                              \
  1.1341    EMBEDDED_ONLY(product(bool, LowMemoryProtection, true,                    \
  1.1342            "Enable LowMemoryProtection"))                                    \
  1.1343 @@ -1985,14 +2006,14 @@
  1.1344            "Fraction (1/n) of real memory used for initial heap size")       \
  1.1345                                                                              \
  1.1346    develop(uintx, MaxVirtMemFraction, 2,                                     \
  1.1347 -          "Maximum fraction (1/n) of virtual memory used for ergonomically" \
  1.1348 +          "Maximum fraction (1/n) of virtual memory used for ergonomically "\
  1.1349            "determining maximum heap size")                                  \
  1.1350                                                                              \
  1.1351    product(bool, UseAutoGCSelectPolicy, false,                               \
  1.1352            "Use automatic collection selection policy")                      \
  1.1353                                                                              \
  1.1354    product(uintx, AutoGCSelectPauseMillis, 5000,                             \
  1.1355 -          "Automatic GC selection pause threshhold in ms")                  \
  1.1356 +          "Automatic GC selection pause threshold in milliseconds")         \
  1.1357                                                                              \
  1.1358    product(bool, UseAdaptiveSizePolicy, true,                                \
  1.1359            "Use adaptive generation sizing policies")                        \
  1.1360 @@ -2007,7 +2028,7 @@
  1.1361            "Use adaptive young-old sizing policies at major collections")    \
  1.1362                                                                              \
  1.1363    product(bool, UseAdaptiveSizePolicyWithSystemGC, false,                   \
  1.1364 -          "Use statistics from System.GC for adaptive size policy")         \
  1.1365 +          "Include statistics from System.gc() for adaptive size policy")   \
  1.1366                                                                              \
  1.1367    product(bool, UseAdaptiveGCBoundary, false,                               \
  1.1368            "Allow young-old boundary to move")                               \
  1.1369 @@ -2019,16 +2040,16 @@
  1.1370            "Resize the virtual spaces of the young or old generations")      \
  1.1371                                                                              \
  1.1372    product(uintx, AdaptiveSizeThroughPutPolicy, 0,                           \
  1.1373 -          "Policy for changeing generation size for throughput goals")      \
  1.1374 +          "Policy for changing generation size for throughput goals")       \
  1.1375                                                                              \
  1.1376    product(uintx, AdaptiveSizePausePolicy, 0,                                \
  1.1377            "Policy for changing generation size for pause goals")            \
  1.1378                                                                              \
  1.1379    develop(bool, PSAdjustTenuredGenForMinorPause, false,                     \
  1.1380 -          "Adjust tenured generation to achive a minor pause goal")         \
  1.1381 +          "Adjust tenured generation to achieve a minor pause goal")        \
  1.1382                                                                              \
  1.1383    develop(bool, PSAdjustYoungGenForMajorPause, false,                       \
  1.1384 -          "Adjust young generation to achive a major pause goal")           \
  1.1385 +          "Adjust young generation to achieve a major pause goal")          \
  1.1386                                                                              \
  1.1387    product(uintx, AdaptiveSizePolicyInitializingSteps, 20,                   \
  1.1388            "Number of steps where heuristics is used before data is used")   \
  1.1389 @@ -2083,14 +2104,15 @@
  1.1390            "Decay factor to TenuredGenerationSizeIncrement")                 \
  1.1391                                                                              \
  1.1392    product(uintx, MaxGCPauseMillis, max_uintx,                               \
  1.1393 -          "Adaptive size policy maximum GC pause time goal in msec, "       \
  1.1394 -          "or (G1 Only) the max. GC time per MMU time slice")               \
  1.1395 +          "Adaptive size policy maximum GC pause time goal in millisecond, "\
  1.1396 +          "or (G1 Only) the maximum GC time per MMU time slice")            \
  1.1397                                                                              \
  1.1398    product(uintx, GCPauseIntervalMillis, 0,                                  \
  1.1399            "Time slice for MMU specification")                               \
  1.1400                                                                              \
  1.1401    product(uintx, MaxGCMinorPauseMillis, max_uintx,                          \
  1.1402 -          "Adaptive size policy maximum GC minor pause time goal in msec")  \
  1.1403 +          "Adaptive size policy maximum GC minor pause time goal "          \
  1.1404 +          "in millisecond")                                                 \
  1.1405                                                                              \
  1.1406    product(uintx, GCTimeRatio, 99,                                           \
  1.1407            "Adaptive size policy application time to GC time ratio")         \
  1.1408 @@ -2118,8 +2140,8 @@
  1.1409            "before an OutOfMemory error is thrown")                          \
  1.1410                                                                              \
  1.1411    product(uintx, GCTimeLimit, 98,                                           \
  1.1412 -          "Limit of proportion of time spent in GC before an OutOfMemory"   \
  1.1413 -          "error is thrown (used with GCHeapFreeLimit)")                    \
  1.1414 +          "Limit of the proportion of time spent in GC before "             \
  1.1415 +          "an OutOfMemoryError is thrown (used with GCHeapFreeLimit)")      \
  1.1416                                                                              \
  1.1417    product(uintx, GCHeapFreeLimit, 2,                                        \
  1.1418            "Minimum percentage of free space after a full GC before an "     \
  1.1419 @@ -2141,7 +2163,7 @@
  1.1420            "How many fields ahead to prefetch in oop scan (<= 0 means off)") \
  1.1421                                                                              \
  1.1422    diagnostic(bool, VerifySilently, false,                                   \
  1.1423 -          "Don't print print the verification progress")                    \
  1.1424 +          "Do not print the verification progress")                         \
  1.1425                                                                              \
  1.1426    diagnostic(bool, VerifyDuringStartup, false,                              \
  1.1427            "Verify memory system before executing any Java code "            \
  1.1428 @@ -2164,7 +2186,7 @@
  1.1429                                                                              \
  1.1430    diagnostic(bool, DeferInitialCardMark, false,                             \
  1.1431            "When +ReduceInitialCardMarks, explicitly defer any that "        \
  1.1432 -           "may arise from new_pre_store_barrier")                          \
  1.1433 +          "may arise from new_pre_store_barrier")                           \
  1.1434                                                                              \
  1.1435    diagnostic(bool, VerifyRememberedSets, false,                             \
  1.1436            "Verify GC remembered sets")                                      \
  1.1437 @@ -2173,10 +2195,10 @@
  1.1438            "Verify GC object start array if verify before/after")            \
  1.1439                                                                              \
  1.1440    product(bool, DisableExplicitGC, false,                                   \
  1.1441 -          "Tells whether calling System.gc() does a full GC")               \
  1.1442 +          "Ignore calls to System.gc()")                                    \
  1.1443                                                                              \
  1.1444    notproduct(bool, CheckMemoryInitialization, false,                        \
  1.1445 -          "Checks memory initialization")                                   \
  1.1446 +          "Check memory initialization")                                    \
  1.1447                                                                              \
  1.1448    product(bool, CollectGen0First, false,                                    \
  1.1449            "Collect youngest generation before each full GC")                \
  1.1450 @@ -2197,44 +2219,45 @@
  1.1451            "Stride through processors when distributing processes")          \
  1.1452                                                                              \
  1.1453    product(uintx, CMSCoordinatorYieldSleepCount, 10,                         \
  1.1454 -          "number of times the coordinator GC thread will sleep while "     \
  1.1455 +          "Number of times the coordinator GC thread will sleep while "     \
  1.1456            "yielding before giving up and resuming GC")                      \
  1.1457                                                                              \
  1.1458    product(uintx, CMSYieldSleepCount, 0,                                     \
  1.1459 -          "number of times a GC thread (minus the coordinator) "            \
  1.1460 +          "Number of times a GC thread (minus the coordinator) "            \
  1.1461            "will sleep while yielding before giving up and resuming GC")     \
  1.1462                                                                              \
  1.1463    /* gc tracing */                                                          \
  1.1464    manageable(bool, PrintGC, false,                                          \
  1.1465 -          "Print message at garbage collect")                               \
  1.1466 +          "Print message at garbage collection")                            \
  1.1467                                                                              \
  1.1468    manageable(bool, PrintGCDetails, false,                                   \
  1.1469 -          "Print more details at garbage collect")                          \
  1.1470 +          "Print more details at garbage collection")                       \
  1.1471                                                                              \
  1.1472    manageable(bool, PrintGCDateStamps, false,                                \
  1.1473 -          "Print date stamps at garbage collect")                           \
  1.1474 +          "Print date stamps at garbage collection")                        \
  1.1475                                                                              \
  1.1476    manageable(bool, PrintGCTimeStamps, false,                                \
  1.1477 -          "Print timestamps at garbage collect")                            \
  1.1478 +          "Print timestamps at garbage collection")                         \
  1.1479                                                                              \
  1.1480    product(bool, PrintGCTaskTimeStamps, false,                               \
  1.1481            "Print timestamps for individual gc worker thread tasks")         \
  1.1482                                                                              \
  1.1483    develop(intx, ConcGCYieldTimeout, 0,                                      \
  1.1484 -          "If non-zero, assert that GC threads yield within this # of ms.") \
  1.1485 +          "If non-zero, assert that GC threads yield within this "          \
  1.1486 +          "number of milliseconds")                                         \
  1.1487                                                                              \
  1.1488    notproduct(bool, TraceMarkSweep, false,                                   \
  1.1489            "Trace mark sweep")                                               \
  1.1490                                                                              \
  1.1491    product(bool, PrintReferenceGC, false,                                    \
  1.1492            "Print times spent handling reference objects during GC "         \
  1.1493 -          " (enabled only when PrintGCDetails)")                            \
  1.1494 +          "(enabled only when PrintGCDetails)")                             \
  1.1495                                                                              \
  1.1496    develop(bool, TraceReferenceGC, false,                                    \
  1.1497            "Trace handling of soft/weak/final/phantom references")           \
  1.1498                                                                              \
  1.1499    develop(bool, TraceFinalizerRegistration, false,                          \
  1.1500 -         "Trace registration of final references")                          \
  1.1501 +          "Trace registration of final references")                         \
  1.1502                                                                              \
  1.1503    notproduct(bool, TraceScavenge, false,                                    \
  1.1504            "Trace scavenge")                                                 \
  1.1505 @@ -2271,7 +2294,7 @@
  1.1506            "Print heap layout before and after each GC")                     \
  1.1507                                                                              \
  1.1508    product_rw(bool, PrintHeapAtGCExtended, false,                            \
  1.1509 -          "Prints extended information about the layout of the heap "       \
  1.1510 +          "Print extended information about the layout of the heap "        \
  1.1511            "when -XX:+PrintHeapAtGC is set")                                 \
  1.1512                                                                              \
  1.1513    product(bool, PrintHeapAtSIGBREAK, true,                                  \
  1.1514 @@ -2308,45 +2331,45 @@
  1.1515            "Trace actions of the GC task threads")                           \
  1.1516                                                                              \
  1.1517    product(bool, PrintParallelOldGCPhaseTimes, false,                        \
  1.1518 -          "Print the time taken by each parallel old gc phase."             \
  1.1519 -          "PrintGCDetails must also be enabled.")                           \
  1.1520 +          "Print the time taken by each phase in ParallelOldGC "            \
  1.1521 +          "(PrintGCDetails must also be enabled)")                          \
  1.1522                                                                              \
  1.1523    develop(bool, TraceParallelOldGCMarkingPhase, false,                      \
  1.1524 -          "Trace parallel old gc marking phase")                            \
  1.1525 +          "Trace marking phase in ParallelOldGC")                           \
  1.1526                                                                              \
  1.1527    develop(bool, TraceParallelOldGCSummaryPhase, false,                      \
  1.1528 -          "Trace parallel old gc summary phase")                            \
  1.1529 +          "Trace summary phase in ParallelOldGC")                           \
  1.1530                                                                              \
  1.1531    develop(bool, TraceParallelOldGCCompactionPhase, false,                   \
  1.1532 -          "Trace parallel old gc compaction phase")                         \
  1.1533 +          "Trace compaction phase in ParallelOldGC")                        \
  1.1534                                                                              \
  1.1535    develop(bool, TraceParallelOldGCDensePrefix, false,                       \
  1.1536 -          "Trace parallel old gc dense prefix computation")                 \
  1.1537 +          "Trace dense prefix computation for ParallelOldGC")               \
  1.1538                                                                              \
  1.1539    develop(bool, IgnoreLibthreadGPFault, false,                              \
  1.1540            "Suppress workaround for libthread GP fault")                     \
  1.1541                                                                              \
  1.1542    product(bool, PrintJNIGCStalls, false,                                    \
  1.1543 -          "Print diagnostic message when GC is stalled"                     \
  1.1544 +          "Print diagnostic message when GC is stalled "                    \
  1.1545            "by JNI critical section")                                        \
  1.1546                                                                              \
  1.1547    experimental(double, ObjectCountCutOffPercent, 0.5,                       \
  1.1548            "The percentage of the used heap that the instances of a class "  \
  1.1549 -          "must occupy for the class to generate a trace event.")           \
  1.1550 +          "must occupy for the class to generate a trace event")            \
  1.1551                                                                              \
  1.1552    /* GC log rotation setting */                                             \
  1.1553                                                                              \
  1.1554    product(bool, UseGCLogFileRotation, false,                                \
  1.1555 -          "Prevent large gclog file for long running app. "                 \
  1.1556 -          "Requires -Xloggc:<filename>")                                    \
  1.1557 +          "Rotate gclog files (for long running applications). It requires "\
  1.1558 +          "-Xloggc:<filename>")                                             \
  1.1559                                                                              \
  1.1560    product(uintx, NumberOfGCLogFiles, 0,                                     \
  1.1561 -          "Number of gclog files in rotation, "                             \
  1.1562 -          "Default: 0, no rotation")                                        \
  1.1563 +          "Number of gclog files in rotation "                              \
  1.1564 +          "(default: 0, no rotation)")                                      \
  1.1565                                                                              \
  1.1566    product(uintx, GCLogFileSize, 0,                                          \
  1.1567 -          "GC log file size, Default: 0 bytes, no rotation "                \
  1.1568 -          "Only valid with UseGCLogFileRotation")                           \
  1.1569 +          "GC log file size (default: 0 bytes, no rotation). "              \
  1.1570 +          "It requires UseGCLogFileRotation")                               \
  1.1571                                                                              \
  1.1572    /* JVMTI heap profiling */                                                \
  1.1573                                                                              \
  1.1574 @@ -2423,40 +2446,40 @@
  1.1575            "Generate range checks for array accesses")                       \
  1.1576                                                                              \
  1.1577    develop_pd(bool, ImplicitNullChecks,                                      \
  1.1578 -          "generate code for implicit null checks")                         \
  1.1579 +          "Generate code for implicit null checks")                         \
  1.1580                                                                              \
  1.1581    product(bool, PrintSafepointStatistics, false,                            \
  1.1582 -          "print statistics about safepoint synchronization")               \
  1.1583 +          "Print statistics about safepoint synchronization")               \
  1.1584                                                                              \
  1.1585    product(intx, PrintSafepointStatisticsCount, 300,                         \
  1.1586 -          "total number of safepoint statistics collected "                 \
  1.1587 +          "Total number of safepoint statistics collected "                 \
  1.1588            "before printing them out")                                       \
  1.1589                                                                              \
  1.1590    product(intx, PrintSafepointStatisticsTimeout,  -1,                       \
  1.1591 -          "print safepoint statistics only when safepoint takes"            \
  1.1592 -          " more than PrintSafepointSatisticsTimeout in millis")            \
  1.1593 +          "Print safepoint statistics only when safepoint takes "           \
  1.1594 +          "more than PrintSafepointSatisticsTimeout in millis")             \
  1.1595                                                                              \
  1.1596    product(bool, TraceSafepointCleanupTime, false,                           \
  1.1597 -          "print the break down of clean up tasks performed during"         \
  1.1598 -          " safepoint")                                                     \
  1.1599 +          "Print the break down of clean up tasks performed during "        \
  1.1600 +          "safepoint")                                                      \
  1.1601                                                                              \
  1.1602    product(bool, Inline, true,                                               \
  1.1603 -          "enable inlining")                                                \
  1.1604 +          "Enable inlining")                                                \
  1.1605                                                                              \
  1.1606    product(bool, ClipInlining, true,                                         \
  1.1607 -          "clip inlining if aggregate method exceeds DesiredMethodLimit")   \
  1.1608 +          "Clip inlining if aggregate method exceeds DesiredMethodLimit")   \
  1.1609                                                                              \
  1.1610    develop(bool, UseCHA, true,                                               \
  1.1611 -          "enable CHA")                                                     \
  1.1612 +          "Enable CHA")                                                     \
  1.1613                                                                              \
  1.1614    product(bool, UseTypeProfile, true,                                       \
  1.1615            "Check interpreter profile for historically monomorphic calls")   \
  1.1616                                                                              \
  1.1617    notproduct(bool, TimeCompiler, false,                                     \
  1.1618 -          "time the compiler")                                              \
  1.1619 +          "Time the compiler")                                              \
  1.1620                                                                              \
  1.1621    diagnostic(bool, PrintInlining, false,                                    \
  1.1622 -          "prints inlining optimizations")                                  \
  1.1623 +          "Print inlining optimizations")                                   \
  1.1624                                                                              \
  1.1625    product(bool, UsePopCountInstruction, false,                              \
  1.1626            "Use population count instruction")                               \
  1.1627 @@ -2468,57 +2491,59 @@
  1.1628            "Print when methods are replaced do to recompilation")            \
  1.1629                                                                              \
  1.1630    develop(bool, PrintMethodFlushing, false,                                 \
  1.1631 -          "print the nmethods being flushed")                               \
  1.1632 +          "Print the nmethods being flushed")                               \
  1.1633                                                                              \
  1.1634    develop(bool, UseRelocIndex, false,                                       \
  1.1635 -         "use an index to speed random access to relocations")              \
  1.1636 +          "Use an index to speed random access to relocations")             \
  1.1637                                                                              \
  1.1638    develop(bool, StressCodeBuffers, false,                                   \
  1.1639 -         "Exercise code buffer expansion and other rare state changes")     \
  1.1640 +          "Exercise code buffer expansion and other rare state changes")    \
  1.1641                                                                              \
  1.1642    diagnostic(bool, DebugNonSafepoints, trueInDebug,                         \
  1.1643 -         "Generate extra debugging info for non-safepoints in nmethods")    \
  1.1644 +          "Generate extra debugging information for non-safepoints in "     \
  1.1645 +          "nmethods")                                                       \
  1.1646                                                                              \
  1.1647    product(bool, PrintVMOptions, false,                                      \
  1.1648 -         "Print flags that appeared on the command line")                   \
  1.1649 +          "Print flags that appeared on the command line")                  \
  1.1650                                                                              \
  1.1651    product(bool, IgnoreUnrecognizedVMOptions, false,                         \
  1.1652 -         "Ignore unrecognized VM options")                                  \
  1.1653 +          "Ignore unrecognized VM options")                                 \
  1.1654                                                                              \
  1.1655    product(bool, PrintCommandLineFlags, false,                               \
  1.1656 -         "Print flags specified on command line or set by ergonomics")      \
  1.1657 +          "Print flags specified on command line or set by ergonomics")     \
  1.1658                                                                              \
  1.1659    product(bool, PrintFlagsInitial, false,                                   \
  1.1660 -         "Print all VM flags before argument processing and exit VM")       \
  1.1661 +          "Print all VM flags before argument processing and exit VM")      \
  1.1662                                                                              \
  1.1663    product(bool, PrintFlagsFinal, false,                                     \
  1.1664 -         "Print all VM flags after argument and ergonomic processing")      \
  1.1665 +          "Print all VM flags after argument and ergonomic processing")     \
  1.1666                                                                              \
  1.1667    notproduct(bool, PrintFlagsWithComments, false,                           \
  1.1668 -         "Print all VM flags with default values and descriptions and exit")\
  1.1669 +          "Print all VM flags with default values and descriptions and "    \
  1.1670 +          "exit")                                                           \
  1.1671                                                                              \
  1.1672    diagnostic(bool, SerializeVMOutput, true,                                 \
  1.1673 -         "Use a mutex to serialize output to tty and LogFile")              \
  1.1674 +          "Use a mutex to serialize output to tty and LogFile")             \
  1.1675                                                                              \
  1.1676    diagnostic(bool, DisplayVMOutput, true,                                   \
  1.1677 -         "Display all VM output on the tty, independently of LogVMOutput")  \
  1.1678 +          "Display all VM output on the tty, independently of LogVMOutput") \
  1.1679                                                                              \
  1.1680    diagnostic(bool, LogVMOutput, false,                                      \
  1.1681 -         "Save VM output to LogFile")                                       \
  1.1682 +          "Save VM output to LogFile")                                      \
  1.1683                                                                              \
  1.1684    diagnostic(ccstr, LogFile, NULL,                                          \
  1.1685 -         "If LogVMOutput or LogCompilation is on, save VM output to "       \
  1.1686 -         "this file [default: ./hotspot_pid%p.log] (%p replaced with pid)") \
  1.1687 +          "If LogVMOutput or LogCompilation is on, save VM output to "      \
  1.1688 +          "this file [default: ./hotspot_pid%p.log] (%p replaced with pid)")\
  1.1689                                                                              \
  1.1690    product(ccstr, ErrorFile, NULL,                                           \
  1.1691 -         "If an error occurs, save the error data to this file "            \
  1.1692 -         "[default: ./hs_err_pid%p.log] (%p replaced with pid)")            \
  1.1693 +          "If an error occurs, save the error data to this file "           \
  1.1694 +          "[default: ./hs_err_pid%p.log] (%p replaced with pid)")           \
  1.1695                                                                              \
  1.1696    product(bool, DisplayVMOutputToStderr, false,                             \
  1.1697 -         "If DisplayVMOutput is true, display all VM output to stderr")     \
  1.1698 +          "If DisplayVMOutput is true, display all VM output to stderr")    \
  1.1699                                                                              \
  1.1700    product(bool, DisplayVMOutputToStdout, false,                             \
  1.1701 -         "If DisplayVMOutput is true, display all VM output to stdout")     \
  1.1702 +          "If DisplayVMOutput is true, display all VM output to stdout")    \
  1.1703                                                                              \
  1.1704    product(bool, UseHeavyMonitors, false,                                    \
  1.1705            "use heavyweight instead of lightweight Java monitors")           \
  1.1706 @@ -2542,7 +2567,7 @@
  1.1707                                                                              \
  1.1708    notproduct(ccstr, AbortVMOnExceptionMessage, NULL,                        \
  1.1709            "Call fatal if the exception pointed by AbortVMOnException "      \
  1.1710 -          "has this message.")                                              \
  1.1711 +          "has this message")                                               \
  1.1712                                                                              \
  1.1713    develop(bool, DebugVtables, false,                                        \
  1.1714            "add debugging code to vtable dispatch")                          \
  1.1715 @@ -2609,29 +2634,29 @@
  1.1716                                                                              \
  1.1717    /* statistics */                                                          \
  1.1718    develop(bool, CountCompiledCalls, false,                                  \
  1.1719 -          "counts method invocations")                                      \
  1.1720 +          "Count method invocations")                                       \
  1.1721                                                                              \
  1.1722    notproduct(bool, CountRuntimeCalls, false,                                \
  1.1723 -          "counts VM runtime calls")                                        \
  1.1724 +          "Count VM runtime calls")                                         \
  1.1725                                                                              \
  1.1726    develop(bool, CountJNICalls, false,                                       \
  1.1727 -          "counts jni method invocations")                                  \
  1.1728 +          "Count jni method invocations")                                   \
  1.1729                                                                              \
  1.1730    notproduct(bool, CountJVMCalls, false,                                    \
  1.1731 -          "counts jvm method invocations")                                  \
  1.1732 +          "Count jvm method invocations")                                   \
  1.1733                                                                              \
  1.1734    notproduct(bool, CountRemovableExceptions, false,                         \
  1.1735 -          "count exceptions that could be replaced by branches due to "     \
  1.1736 +          "Count exceptions that could be replaced by branches due to "     \
  1.1737            "inlining")                                                       \
  1.1738                                                                              \
  1.1739    notproduct(bool, ICMissHistogram, false,                                  \
  1.1740 -          "produce histogram of IC misses")                                 \
  1.1741 +          "Produce histogram of IC misses")                                 \
  1.1742                                                                              \
  1.1743    notproduct(bool, PrintClassStatistics, false,                             \
  1.1744 -          "prints class statistics at end of run")                          \
  1.1745 +          "Print class statistics at end of run")                           \
  1.1746                                                                              \
  1.1747    notproduct(bool, PrintMethodStatistics, false,                            \
  1.1748 -          "prints method statistics at end of run")                         \
  1.1749 +          "Print method statistics at end of run")                          \
  1.1750                                                                              \
  1.1751    /* interpreter */                                                         \
  1.1752    develop(bool, ClearInterpreterLocals, false,                              \
  1.1753 @@ -2645,7 +2670,7 @@
  1.1754            "Rewrite frequently used bytecode pairs into a single bytecode")  \
  1.1755                                                                              \
  1.1756    diagnostic(bool, PrintInterpreter, false,                                 \
  1.1757 -          "Prints the generated interpreter code")                          \
  1.1758 +          "Print the generated interpreter code")                           \
  1.1759                                                                              \
  1.1760    product(bool, UseInterpreter, true,                                       \
  1.1761            "Use interpreter for non-compiled methods")                       \
  1.1762 @@ -2663,8 +2688,8 @@
  1.1763            "Use fast method entry code for accessor methods")                \
  1.1764                                                                              \
  1.1765    product_pd(bool, UseOnStackReplacement,                                   \
  1.1766 -           "Use on stack replacement, calls runtime if invoc. counter "     \
  1.1767 -           "overflows in loop")                                             \
  1.1768 +          "Use on stack replacement, calls runtime if invoc. counter "      \
  1.1769 +          "overflows in loop")                                              \
  1.1770                                                                              \
  1.1771    notproduct(bool, TraceOnStackReplacement, false,                          \
  1.1772            "Trace on stack replacement")                                     \
  1.1773 @@ -2712,10 +2737,10 @@
  1.1774            "Trace frequency based inlining")                                 \
  1.1775                                                                              \
  1.1776    develop_pd(bool, InlineIntrinsics,                                        \
  1.1777 -           "Inline intrinsics that can be statically resolved")             \
  1.1778 +          "Inline intrinsics that can be statically resolved")              \
  1.1779                                                                              \
  1.1780    product_pd(bool, ProfileInterpreter,                                      \
  1.1781 -           "Profile at the bytecode level during interpretation")           \
  1.1782 +          "Profile at the bytecode level during interpretation")            \
  1.1783                                                                              \
  1.1784    develop_pd(bool, ProfileTraps,                                            \
  1.1785            "Profile deoptimization traps at the bytecode level")             \
  1.1786 @@ -2725,7 +2750,7 @@
  1.1787            "CompileThreshold) before using the method's profile")            \
  1.1788                                                                              \
  1.1789    develop(bool, PrintMethodData, false,                                     \
  1.1790 -           "Print the results of +ProfileInterpreter at end of run")        \
  1.1791 +          "Print the results of +ProfileInterpreter at end of run")         \
  1.1792                                                                              \
  1.1793    develop(bool, VerifyDataPointer, trueInDebug,                             \
  1.1794            "Verify the method data pointer during interpreter profiling")    \
  1.1795 @@ -2740,7 +2765,7 @@
  1.1796                                                                              \
  1.1797    /* compilation */                                                         \
  1.1798    product(bool, UseCompiler, true,                                          \
  1.1799 -          "use compilation")                                                \
  1.1800 +          "Use Just-In-Time compilation")                                   \
  1.1801                                                                              \
  1.1802    develop(bool, TraceCompilationPolicy, false,                              \
  1.1803            "Trace compilation policy")                                       \
  1.1804 @@ -2749,20 +2774,21 @@
  1.1805            "Time the compilation policy")                                    \
  1.1806                                                                              \
  1.1807    product(bool, UseCounterDecay, true,                                      \
  1.1808 -           "adjust recompilation counters")                                 \
  1.1809 +          "Adjust recompilation counters")                                  \
  1.1810                                                                              \
  1.1811    develop(intx, CounterHalfLifeTime,    30,                                 \
  1.1812 -          "half-life time of invocation counters (in secs)")                \
  1.1813 +          "Half-life time of invocation counters (in seconds)")             \
  1.1814                                                                              \
  1.1815    develop(intx, CounterDecayMinIntervalLength,   500,                       \
  1.1816 -          "Min. ms. between invocation of CounterDecay")                    \
  1.1817 +          "The minimum interval (in milliseconds) between invocation of "   \
  1.1818 +          "CounterDecay")                                                   \
  1.1819                                                                              \
  1.1820    product(bool, AlwaysCompileLoopMethods, false,                            \
  1.1821 -          "when using recompilation, never interpret methods "              \
  1.1822 +          "When using recompilation, never interpret methods "              \
  1.1823            "containing loops")                                               \
  1.1824                                                                              \
  1.1825    product(bool, DontCompileHugeMethods, true,                               \
  1.1826 -          "don't compile methods > HugeMethodLimit")                        \
  1.1827 +          "Do not compile methods > HugeMethodLimit")                       \
  1.1828                                                                              \
  1.1829    /* Bytecode escape analysis estimation. */                                \
  1.1830    product(bool, EstimateArgEscape, true,                                    \
  1.1831 @@ -2772,10 +2798,10 @@
  1.1832            "How much tracing to do of bytecode escape analysis estimates")   \
  1.1833                                                                              \
  1.1834    product(intx, MaxBCEAEstimateLevel, 5,                                    \
  1.1835 -          "Maximum number of nested calls that are analyzed by BC EA.")     \
  1.1836 +          "Maximum number of nested calls that are analyzed by BC EA")      \
  1.1837                                                                              \
  1.1838    product(intx, MaxBCEAEstimateSize, 150,                                   \
  1.1839 -          "Maximum bytecode size of a method to be analyzed by BC EA.")     \
  1.1840 +          "Maximum bytecode size of a method to be analyzed by BC EA")      \
  1.1841                                                                              \
  1.1842    product(intx,  AllocatePrefetchStyle, 1,                                  \
  1.1843            "0 = no prefetch, "                                               \
  1.1844 @@ -2790,7 +2816,8 @@
  1.1845            "Number of lines to prefetch ahead of array allocation pointer")  \
  1.1846                                                                              \
  1.1847    product(intx,  AllocateInstancePrefetchLines, 1,                          \
  1.1848 -          "Number of lines to prefetch ahead of instance allocation pointer") \
  1.1849 +          "Number of lines to prefetch ahead of instance allocation "       \
  1.1850 +          "pointer")                                                        \
  1.1851                                                                              \
  1.1852    product(intx,  AllocatePrefetchStepSize, 16,                              \
  1.1853            "Step size in bytes of sequential prefetch instructions")         \
  1.1854 @@ -2810,8 +2837,8 @@
  1.1855            "(0 means off)")                                                  \
  1.1856                                                                              \
  1.1857    product(intx, MaxJavaStackTraceDepth, 1024,                               \
  1.1858 -          "Max. no. of lines in the stack trace for Java exceptions "       \
  1.1859 -          "(0 means all)")                                                  \
  1.1860 +          "The maximum number of lines in the stack trace for Java "        \
  1.1861 +          "exceptions (0 means all)")                                       \
  1.1862                                                                              \
  1.1863    NOT_EMBEDDED(diagnostic(intx, GuaranteedSafepointInterval, 1000,          \
  1.1864            "Guarantee a safepoint (at least) every so many milliseconds "    \
  1.1865 @@ -2831,10 +2858,10 @@
  1.1866            "Compilers wake up every n seconds to possibly sweep nmethods")   \
  1.1867                                                                              \
  1.1868    notproduct(bool, LogSweeper, false,                                       \
  1.1869 -            "Keep a ring buffer of sweeper activity")                       \
  1.1870 +          "Keep a ring buffer of sweeper activity")                         \
  1.1871                                                                              \
  1.1872    notproduct(intx, SweeperLogEntries, 1024,                                 \
  1.1873 -            "Number of records in the ring buffer of sweeper activity")     \
  1.1874 +          "Number of records in the ring buffer of sweeper activity")       \
  1.1875                                                                              \
  1.1876    notproduct(intx, MemProfilingInterval, 500,                               \
  1.1877            "Time between each invocation of the MemProfiler")                \
  1.1878 @@ -2877,34 +2904,35 @@
  1.1879            "less than this")                                                 \
  1.1880                                                                              \
  1.1881    product(intx, MaxInlineSize, 35,                                          \
  1.1882 -          "maximum bytecode size of a method to be inlined")                \
  1.1883 +          "The maximum bytecode size of a method to be inlined")            \
  1.1884                                                                              \
  1.1885    product_pd(intx, FreqInlineSize,                                          \
  1.1886 -          "maximum bytecode size of a frequent method to be inlined")       \
  1.1887 +          "The maximum bytecode size of a frequent method to be inlined")   \
  1.1888                                                                              \
  1.1889    product(intx, MaxTrivialSize, 6,                                          \
  1.1890 -          "maximum bytecode size of a trivial method to be inlined")        \
  1.1891 +          "The maximum bytecode size of a trivial method to be inlined")    \
  1.1892                                                                              \
  1.1893    product(intx, MinInliningThreshold, 250,                                  \
  1.1894 -          "min. invocation count a method needs to have to be inlined")     \
  1.1895 +          "The minimum invocation count a method needs to have to be "      \
  1.1896 +          "inlined")                                                        \
  1.1897                                                                              \
  1.1898    develop(intx, MethodHistogramCutoff, 100,                                 \
  1.1899 -          "cutoff value for method invoc. histogram (+CountCalls)")         \
  1.1900 +          "The cutoff value for method invocation histogram (+CountCalls)") \
  1.1901                                                                              \
  1.1902    develop(intx, ProfilerNumberOfInterpretedMethods, 25,                     \
  1.1903 -          "# of interpreted methods to show in profile")                    \
  1.1904 +          "Number of interpreted methods to show in profile")               \
  1.1905                                                                              \
  1.1906    develop(intx, ProfilerNumberOfCompiledMethods, 25,                        \
  1.1907 -          "# of compiled methods to show in profile")                       \
  1.1908 +          "Number of compiled methods to show in profile")                  \
  1.1909                                                                              \
  1.1910    develop(intx, ProfilerNumberOfStubMethods, 25,                            \
  1.1911 -          "# of stub methods to show in profile")                           \
  1.1912 +          "Number of stub methods to show in profile")                      \
  1.1913                                                                              \
  1.1914    develop(intx, ProfilerNumberOfRuntimeStubNodes, 25,                       \
  1.1915 -          "# of runtime stub nodes to show in profile")                     \
  1.1916 +          "Number of runtime stub nodes to show in profile")                \
  1.1917                                                                              \
  1.1918    product(intx, ProfileIntervalsTicks, 100,                                 \
  1.1919 -          "# of ticks between printing of interval profile "                \
  1.1920 +          "Number of ticks between printing of interval profile "           \
  1.1921            "(+ProfileIntervals)")                                            \
  1.1922                                                                              \
  1.1923    notproduct(intx, ScavengeALotInterval,     1,                             \
  1.1924 @@ -2925,7 +2953,7 @@
  1.1925                                                                              \
  1.1926    develop(intx, MinSleepInterval,     1,                                    \
  1.1927            "Minimum sleep() interval (milliseconds) when "                   \
  1.1928 -          "ConvertSleepToYield is off (used for SOLARIS)")                  \
  1.1929 +          "ConvertSleepToYield is off (used for Solaris)")                  \
  1.1930                                                                              \
  1.1931    develop(intx, ProfilerPCTickThreshold,    15,                             \
  1.1932            "Number of ticks in a PC buckets to be a hotspot")                \
  1.1933 @@ -2940,22 +2968,22 @@
  1.1934            "Mark nmethods non-entrant at registration")                      \
  1.1935                                                                              \
  1.1936    diagnostic(intx, MallocVerifyInterval,     0,                             \
  1.1937 -          "if non-zero, verify C heap after every N calls to "              \
  1.1938 +          "If non-zero, verify C heap after every N calls to "              \
  1.1939            "malloc/realloc/free")                                            \
  1.1940                                                                              \
  1.1941    diagnostic(intx, MallocVerifyStart,     0,                                \
  1.1942 -          "if non-zero, start verifying C heap after Nth call to "          \
  1.1943 +          "If non-zero, start verifying C heap after Nth call to "          \
  1.1944            "malloc/realloc/free")                                            \
  1.1945                                                                              \
  1.1946    diagnostic(uintx, MallocMaxTestWords,     0,                              \
  1.1947 -          "if non-zero, max # of Words that malloc/realloc can allocate "   \
  1.1948 -          "(for testing only)")                                             \
  1.1949 +          "If non-zero, maximum number of words that malloc/realloc can "   \
  1.1950 +          "allocate (for testing only)")                                    \
  1.1951                                                                              \
  1.1952    product(intx, TypeProfileWidth,     2,                                    \
  1.1953 -          "number of receiver types to record in call/cast profile")        \
  1.1954 +          "Number of receiver types to record in call/cast profile")        \
  1.1955                                                                              \
  1.1956    develop(intx, BciProfileWidth,      2,                                    \
  1.1957 -          "number of return bci's to record in ret profile")                \
  1.1958 +          "Number of return bci's to record in ret profile")                \
  1.1959                                                                              \
  1.1960    product(intx, PerMethodRecompilationCutoff, 400,                          \
  1.1961            "After recompiling N times, stay in the interpreter (-1=>'Inf')") \
  1.1962 @@ -3022,7 +3050,7 @@
  1.1963            "Percentage of Eden that can be wasted")                          \
  1.1964                                                                              \
  1.1965    product(uintx, TLABRefillWasteFraction,    64,                            \
  1.1966 -          "Max TLAB waste at a refill (internal fragmentation)")            \
  1.1967 +          "Maximum TLAB waste at a refill (internal fragmentation)")        \
  1.1968                                                                              \
  1.1969    product(uintx, TLABWasteIncrement,    4,                                  \
  1.1970            "Increment allowed waste at slow allocation")                     \
  1.1971 @@ -3031,7 +3059,7 @@
  1.1972            "Ratio of eden/survivor space size")                              \
  1.1973                                                                              \
  1.1974    product(uintx, NewRatio, 2,                                               \
  1.1975 -          "Ratio of new/old generation sizes")                              \
  1.1976 +          "Ratio of old/new generation sizes")                              \
  1.1977                                                                              \
  1.1978    product_pd(uintx, NewSizeThreadIncrease,                                  \
  1.1979            "Additional size added to desired new generation size per "       \
  1.1980 @@ -3048,28 +3076,30 @@
  1.1981            "class pointers are used")                                        \
  1.1982                                                                              \
  1.1983    product(uintx, MinHeapFreeRatio,    40,                                   \
  1.1984 -          "Min percentage of heap free after GC to avoid expansion")        \
  1.1985 +          "The minimum percentage of heap free after GC to avoid expansion")\
  1.1986                                                                              \
  1.1987    product(uintx, MaxHeapFreeRatio,    70,                                   \
  1.1988 -          "Max percentage of heap free after GC to avoid shrinking")        \
  1.1989 +          "The maximum percentage of heap free after GC to avoid shrinking")\
  1.1990                                                                              \
  1.1991    product(intx, SoftRefLRUPolicyMSPerMB, 1000,                              \
  1.1992            "Number of milliseconds per MB of free space in the heap")        \
  1.1993                                                                              \
  1.1994    product(uintx, MinHeapDeltaBytes, ScaleForWordSize(128*K),                \
  1.1995 -          "Min change in heap space due to GC (in bytes)")                  \
  1.1996 +          "The minimum change in heap space due to GC (in bytes)")          \
  1.1997                                                                              \
  1.1998    product(uintx, MinMetaspaceExpansion, ScaleForWordSize(256*K),            \
  1.1999 -          "Min expansion of Metaspace (in bytes)")                          \
  1.2000 +          "The minimum expansion of Metaspace (in bytes)")                  \
  1.2001                                                                              \
  1.2002    product(uintx, MinMetaspaceFreeRatio,    40,                              \
  1.2003 -          "Min percentage of Metaspace free after GC to avoid expansion")   \
  1.2004 +          "The minimum percentage of Metaspace free after GC to avoid "     \
  1.2005 +          "expansion")                                                      \
  1.2006                                                                              \
  1.2007    product(uintx, MaxMetaspaceFreeRatio,    70,                              \
  1.2008 -          "Max percentage of Metaspace free after GC to avoid shrinking")   \
  1.2009 +          "The maximum percentage of Metaspace free after GC to avoid "     \
  1.2010 +          "shrinking")                                                      \
  1.2011                                                                              \
  1.2012    product(uintx, MaxMetaspaceExpansion, ScaleForWordSize(4*M),              \
  1.2013 -          "Max expansion of Metaspace without full GC (in bytes)")          \
  1.2014 +          "The maximum expansion of Metaspace without full GC (in bytes)")  \
  1.2015                                                                              \
  1.2016    product(uintx, QueuedAllocationWarningCount, 0,                           \
  1.2017            "Number of times an allocation that queues behind a GC "          \
  1.2018 @@ -3091,13 +3121,14 @@
  1.2019            "Desired percentage of survivor space used after scavenge")       \
  1.2020                                                                              \
  1.2021    product(uintx, MarkSweepDeadRatio,     5,                                 \
  1.2022 -          "Percentage (0-100) of the old gen allowed as dead wood."         \
  1.2023 -          "Serial mark sweep treats this as both the min and max value."    \
  1.2024 -          "CMS uses this value only if it falls back to mark sweep."        \
  1.2025 -          "Par compact uses a variable scale based on the density of the"   \
  1.2026 -          "generation and treats this as the max value when the heap is"    \
  1.2027 -          "either completely full or completely empty.  Par compact also"   \
  1.2028 -          "has a smaller default value; see arguments.cpp.")                \
  1.2029 +          "Percentage (0-100) of the old gen allowed as dead wood. "        \
  1.2030 +          "Serial mark sweep treats this as both the minimum and maximum "  \
  1.2031 +          "value. "                                                         \
  1.2032 +          "CMS uses this value only if it falls back to mark sweep. "       \
  1.2033 +          "Par compact uses a variable scale based on the density of the "  \
  1.2034 +          "generation and treats this as the maximum value when the heap "  \
  1.2035 +          "is either completely full or completely empty.  Par compact "    \
  1.2036 +          "also has a smaller default value; see arguments.cpp.")           \
  1.2037                                                                              \
  1.2038    product(uintx, MarkSweepAlwaysCompactCount,     4,                        \
  1.2039            "How often should we fully compact the heap (ignoring the dead "  \
  1.2040 @@ -3116,27 +3147,27 @@
  1.2041            "Census for CMS' FreeListSpace")                                  \
  1.2042                                                                              \
  1.2043    develop(uintx, GCExpandToAllocateDelayMillis, 0,                          \
  1.2044 -          "Delay in ms between expansion and allocation")                   \
  1.2045 +          "Delay between expansion and allocation (in milliseconds)")       \
  1.2046                                                                              \
  1.2047    develop(uintx, GCWorkerDelayMillis, 0,                                    \
  1.2048 -          "Delay in ms in scheduling GC workers")                           \
  1.2049 +          "Delay in scheduling GC workers (in milliseconds)")               \
  1.2050                                                                              \
  1.2051    product(intx, DeferThrSuspendLoopCount,     4000,                         \
  1.2052            "(Unstable) Number of times to iterate in safepoint loop "        \
  1.2053 -          " before blocking VM threads ")                                   \
  1.2054 +          "before blocking VM threads ")                                    \
  1.2055                                                                              \
  1.2056    product(intx, DeferPollingPageLoopCount,     -1,                          \
  1.2057            "(Unsafe,Unstable) Number of iterations in safepoint loop "       \
  1.2058            "before changing safepoint polling page to RO ")                  \
  1.2059                                                                              \
  1.2060 -  product(intx, SafepointSpinBeforeYield, 2000,  "(Unstable)")              \
  1.2061 +  product(intx, SafepointSpinBeforeYield, 2000, "(Unstable)")               \
  1.2062                                                                              \
  1.2063    product(bool, PSChunkLargeArrays, true,                                   \
  1.2064 -          "true: process large arrays in chunks")                           \
  1.2065 +          "Process large arrays in chunks")                                 \
  1.2066                                                                              \
  1.2067    product(uintx, GCDrainStackTargetSize, 64,                                \
  1.2068 -          "how many entries we'll try to leave on the stack during "        \
  1.2069 -          "parallel GC")                                                    \
  1.2070 +          "Number of entries we will try to leave on the stack "            \
  1.2071 +          "during parallel gc")                                             \
  1.2072                                                                              \
  1.2073    /* stack parameters */                                                    \
  1.2074    product_pd(intx, StackYellowPages,                                        \
  1.2075 @@ -3146,8 +3177,8 @@
  1.2076            "Number of red zone (unrecoverable overflows) pages")             \
  1.2077                                                                              \
  1.2078    product_pd(intx, StackShadowPages,                                        \
  1.2079 -          "Number of shadow zone (for overflow checking) pages"             \
  1.2080 -          " this should exceed the depth of the VM and native call stack")  \
  1.2081 +          "Number of shadow zone (for overflow checking) pages "            \
  1.2082 +          "this should exceed the depth of the VM and native call stack")   \
  1.2083                                                                              \
  1.2084    product_pd(intx, ThreadStackSize,                                         \
  1.2085            "Thread Stack Size (in Kbytes)")                                  \
  1.2086 @@ -3187,22 +3218,22 @@
  1.2087            "Reserved code cache size (in bytes) - maximum code cache size")  \
  1.2088                                                                              \
  1.2089    product(uintx, CodeCacheMinimumFreeSpace, 500*K,                          \
  1.2090 -          "When less than X space left, we stop compiling.")                \
  1.2091 +          "When less than X space left, we stop compiling")                 \
  1.2092                                                                              \
  1.2093    product_pd(uintx, CodeCacheExpansionSize,                                 \
  1.2094            "Code cache expansion size (in bytes)")                           \
  1.2095                                                                              \
  1.2096    develop_pd(uintx, CodeCacheMinBlockLength,                                \
  1.2097 -          "Minimum number of segments in a code cache block.")              \
  1.2098 +          "Minimum number of segments in a code cache block")               \
  1.2099                                                                              \
  1.2100    notproduct(bool, ExitOnFullCodeCache, false,                              \
  1.2101 -          "Exit the VM if we fill the code cache.")                         \
  1.2102 +          "Exit the VM if we fill the code cache")                          \
  1.2103                                                                              \
  1.2104    product(bool, UseCodeCacheFlushing, true,                                 \
  1.2105            "Attempt to clean the code cache before shutting off compiler")   \
  1.2106                                                                              \
  1.2107    product(intx,  MinCodeCacheFlushingInterval, 30,                          \
  1.2108 -          "Min number of seconds between code cache cleaning sessions")     \
  1.2109 +          "Minimum number of seconds between code cache cleaning sessions") \
  1.2110                                                                              \
  1.2111    product(uintx,  CodeCacheFlushingMinimumFreeSpace, 1500*K,                \
  1.2112            "When less than X space left, start code cache cleaning")         \
  1.2113 @@ -3216,31 +3247,31 @@
  1.2114            "switch")                                                         \
  1.2115                                                                              \
  1.2116    develop(intx, StopInterpreterAt, 0,                                       \
  1.2117 -          "Stops interpreter execution at specified bytecode number")       \
  1.2118 +          "Stop interpreter execution at specified bytecode number")        \
  1.2119                                                                              \
  1.2120    develop(intx, TraceBytecodesAt, 0,                                        \
  1.2121 -          "Traces bytecodes starting with specified bytecode number")       \
  1.2122 +          "Trace bytecodes starting with specified bytecode number")        \
  1.2123                                                                              \
  1.2124    /* compiler interface */                                                  \
  1.2125    develop(intx, CIStart, 0,                                                 \
  1.2126 -          "the id of the first compilation to permit")                      \
  1.2127 +          "The id of the first compilation to permit")                      \
  1.2128                                                                              \
  1.2129    develop(intx, CIStop,    -1,                                              \
  1.2130 -          "the id of the last compilation to permit")                       \
  1.2131 +          "The id of the last compilation to permit")                       \
  1.2132                                                                              \
  1.2133    develop(intx, CIStartOSR,     0,                                          \
  1.2134 -          "the id of the first osr compilation to permit "                  \
  1.2135 +          "The id of the first osr compilation to permit "                  \
  1.2136            "(CICountOSR must be on)")                                        \
  1.2137                                                                              \
  1.2138    develop(intx, CIStopOSR,    -1,                                           \
  1.2139 -          "the id of the last osr compilation to permit "                   \
  1.2140 +          "The id of the last osr compilation to permit "                   \
  1.2141            "(CICountOSR must be on)")                                        \
  1.2142                                                                              \
  1.2143    develop(intx, CIBreakAtOSR,    -1,                                        \
  1.2144 -          "id of osr compilation to break at")                              \
  1.2145 +          "The id of osr compilation to break at")                          \
  1.2146                                                                              \
  1.2147    develop(intx, CIBreakAt,    -1,                                           \
  1.2148 -          "id of compilation to break at")                                  \
  1.2149 +          "The id of compilation to break at")                              \
  1.2150                                                                              \
  1.2151    product(ccstrlist, CompileOnly, "",                                       \
  1.2152            "List of methods (pkg/class.name) to restrict compilation to")    \
  1.2153 @@ -3259,11 +3290,11 @@
  1.2154            "[default: ./replay_pid%p.log] (%p replaced with pid)")           \
  1.2155                                                                              \
  1.2156    develop(intx, ReplaySuppressInitializers, 2,                              \
  1.2157 -          "Controls handling of class initialization during replay"         \
  1.2158 -          "0 - don't do anything special"                                   \
  1.2159 -          "1 - treat all class initializers as empty"                       \
  1.2160 -          "2 - treat class initializers for application classes as empty"   \
  1.2161 -          "3 - allow all class initializers to run during bootstrap but"    \
  1.2162 +          "Control handling of class initialization during replay: "        \
  1.2163 +          "0 - don't do anything special; "                                 \
  1.2164 +          "1 - treat all class initializers as empty; "                     \
  1.2165 +          "2 - treat class initializers for application classes as empty; " \
  1.2166 +          "3 - allow all class initializers to run during bootstrap but "   \
  1.2167            "    pretend they are empty after starting replay")               \
  1.2168                                                                              \
  1.2169    develop(bool, ReplayIgnoreInitErrors, false,                              \
  1.2170 @@ -3292,14 +3323,15 @@
  1.2171            "0 : Normal.                                                     "\
  1.2172            "    VM chooses priorities that are appropriate for normal       "\
  1.2173            "    applications. On Solaris NORM_PRIORITY and above are mapped "\
  1.2174 -          "    to normal native priority. Java priorities below NORM_PRIORITY"\
  1.2175 -          "    map to lower native priority values. On Windows applications"\
  1.2176 -          "    are allowed to use higher native priorities. However, with  "\
  1.2177 -          "    ThreadPriorityPolicy=0, VM will not use the highest possible"\
  1.2178 -          "    native priority, THREAD_PRIORITY_TIME_CRITICAL, as it may   "\
  1.2179 -          "    interfere with system threads. On Linux thread priorities   "\
  1.2180 -          "    are ignored because the OS does not support static priority "\
  1.2181 -          "    in SCHED_OTHER scheduling class which is the only choice for"\
  1.2182 +          "    to normal native priority. Java priorities below "           \
  1.2183 +          "    NORM_PRIORITY map to lower native priority values. On       "\
  1.2184 +          "    Windows applications are allowed to use higher native       "\
  1.2185 +          "    priorities. However, with ThreadPriorityPolicy=0, VM will   "\
  1.2186 +          "    not use the highest possible native priority,               "\
  1.2187 +          "    THREAD_PRIORITY_TIME_CRITICAL, as it may interfere with     "\
  1.2188 +          "    system threads. On Linux thread priorities are ignored      "\
  1.2189 +          "    because the OS does not support static priority in          "\
  1.2190 +          "    SCHED_OTHER scheduling class which is the only choice for   "\
  1.2191            "    non-root, non-realtime applications.                        "\
  1.2192            "1 : Aggressive.                                                 "\
  1.2193            "    Java thread priorities map over to the entire range of      "\
  1.2194 @@ -3330,16 +3362,35 @@
  1.2195    product(bool, VMThreadHintNoPreempt, false,                               \
  1.2196            "(Solaris only) Give VM thread an extra quanta")                  \
  1.2197                                                                              \
  1.2198 -  product(intx, JavaPriority1_To_OSPriority, -1, "Map Java priorities to OS priorities") \
  1.2199 -  product(intx, JavaPriority2_To_OSPriority, -1, "Map Java priorities to OS priorities") \
  1.2200 -  product(intx, JavaPriority3_To_OSPriority, -1, "Map Java priorities to OS priorities") \
  1.2201 -  product(intx, JavaPriority4_To_OSPriority, -1, "Map Java priorities to OS priorities") \
  1.2202 -  product(intx, JavaPriority5_To_OSPriority, -1, "Map Java priorities to OS priorities") \
  1.2203 -  product(intx, JavaPriority6_To_OSPriority, -1, "Map Java priorities to OS priorities") \
  1.2204 -  product(intx, JavaPriority7_To_OSPriority, -1, "Map Java priorities to OS priorities") \
  1.2205 -  product(intx, JavaPriority8_To_OSPriority, -1, "Map Java priorities to OS priorities") \
  1.2206 -  product(intx, JavaPriority9_To_OSPriority, -1, "Map Java priorities to OS priorities") \
  1.2207 -  product(intx, JavaPriority10_To_OSPriority,-1, "Map Java priorities to OS priorities") \
  1.2208 +  product(intx, JavaPriority1_To_OSPriority, -1,                            \
  1.2209 +          "Map Java priorities to OS priorities")                           \
  1.2210 +                                                                            \
  1.2211 +  product(intx, JavaPriority2_To_OSPriority, -1,                            \
  1.2212 +          "Map Java priorities to OS priorities")                           \
  1.2213 +                                                                            \
  1.2214 +  product(intx, JavaPriority3_To_OSPriority, -1,                            \
  1.2215 +          "Map Java priorities to OS priorities")                           \
  1.2216 +                                                                            \
  1.2217 +  product(intx, JavaPriority4_To_OSPriority, -1,                            \
  1.2218 +          "Map Java priorities to OS priorities")                           \
  1.2219 +                                                                            \
  1.2220 +  product(intx, JavaPriority5_To_OSPriority, -1,                            \
  1.2221 +          "Map Java priorities to OS priorities")                           \
  1.2222 +                                                                            \
  1.2223 +  product(intx, JavaPriority6_To_OSPriority, -1,                            \
  1.2224 +          "Map Java priorities to OS priorities")                           \
  1.2225 +                                                                            \
  1.2226 +  product(intx, JavaPriority7_To_OSPriority, -1,                            \
  1.2227 +          "Map Java priorities to OS priorities")                           \
  1.2228 +                                                                            \
  1.2229 +  product(intx, JavaPriority8_To_OSPriority, -1,                            \
  1.2230 +          "Map Java priorities to OS priorities")                           \
  1.2231 +                                                                            \
  1.2232 +  product(intx, JavaPriority9_To_OSPriority, -1,                            \
  1.2233 +          "Map Java priorities to OS priorities")                           \
  1.2234 +                                                                            \
  1.2235 +  product(intx, JavaPriority10_To_OSPriority,-1,                            \
  1.2236 +          "Map Java priorities to OS priorities")                           \
  1.2237                                                                              \
  1.2238    experimental(bool, UseCriticalJavaThreadPriority, false,                  \
  1.2239            "Java thread priority 10 maps to critical scheduling priority")   \
  1.2240 @@ -3370,37 +3421,38 @@
  1.2241            "Used with +TraceLongCompiles")                                   \
  1.2242                                                                              \
  1.2243    product(intx, StarvationMonitorInterval,    200,                          \
  1.2244 -          "Pause between each check in ms")                                 \
  1.2245 +          "Pause between each check (in milliseconds)")                     \
  1.2246                                                                              \
  1.2247    /* recompilation */                                                       \
  1.2248    product_pd(intx, CompileThreshold,                                        \
  1.2249            "number of interpreted method invocations before (re-)compiling") \
  1.2250                                                                              \
  1.2251    product_pd(intx, BackEdgeThreshold,                                       \
  1.2252 -          "Interpreter Back edge threshold at which an OSR compilation is invoked")\
  1.2253 +          "Interpreter Back edge threshold at which an OSR compilation is " \
  1.2254 +          "invoked")                                                        \
  1.2255                                                                              \
  1.2256    product(intx, Tier0InvokeNotifyFreqLog, 7,                                \
  1.2257 -          "Interpreter (tier 0) invocation notification frequency.")        \
  1.2258 +          "Interpreter (tier 0) invocation notification frequency")         \
  1.2259                                                                              \
  1.2260    product(intx, Tier2InvokeNotifyFreqLog, 11,                               \
  1.2261 -          "C1 without MDO (tier 2) invocation notification frequency.")     \
  1.2262 +          "C1 without MDO (tier 2) invocation notification frequency")      \
  1.2263                                                                              \
  1.2264    product(intx, Tier3InvokeNotifyFreqLog, 10,                               \
  1.2265            "C1 with MDO profiling (tier 3) invocation notification "         \
  1.2266 -          "frequency.")                                                     \
  1.2267 +          "frequency")                                                      \
  1.2268                                                                              \
  1.2269    product(intx, Tier23InlineeNotifyFreqLog, 20,                             \
  1.2270            "Inlinee invocation (tiers 2 and 3) notification frequency")      \
  1.2271                                                                              \
  1.2272    product(intx, Tier0BackedgeNotifyFreqLog, 10,                             \
  1.2273 -          "Interpreter (tier 0) invocation notification frequency.")        \
  1.2274 +          "Interpreter (tier 0) invocation notification frequency")         \
  1.2275                                                                              \
  1.2276    product(intx, Tier2BackedgeNotifyFreqLog, 14,                             \
  1.2277 -          "C1 without MDO (tier 2) invocation notification frequency.")     \
  1.2278 +          "C1 without MDO (tier 2) invocation notification frequency")      \
  1.2279                                                                              \
  1.2280    product(intx, Tier3BackedgeNotifyFreqLog, 13,                             \
  1.2281            "C1 with MDO profiling (tier 3) invocation notification "         \
  1.2282 -          "frequency.")                                                     \
  1.2283 +          "frequency")                                                      \
  1.2284                                                                              \
  1.2285    product(intx, Tier2CompileThreshold, 0,                                   \
  1.2286            "threshold at which tier 2 compilation is invoked")               \
  1.2287 @@ -3417,7 +3469,7 @@
  1.2288                                                                              \
  1.2289    product(intx, Tier3CompileThreshold, 2000,                                \
  1.2290            "Threshold at which tier 3 compilation is invoked (invocation "   \
  1.2291 -          "minimum must be satisfied.")                                     \
  1.2292 +          "minimum must be satisfied")                                      \
  1.2293                                                                              \
  1.2294    product(intx, Tier3BackEdgeThreshold,  60000,                             \
  1.2295            "Back edge threshold at which tier 3 OSR compilation is invoked") \
  1.2296 @@ -3431,7 +3483,7 @@
  1.2297                                                                              \
  1.2298    product(intx, Tier4CompileThreshold, 15000,                               \
  1.2299            "Threshold at which tier 4 compilation is invoked (invocation "   \
  1.2300 -          "minimum must be satisfied.")                                     \
  1.2301 +          "minimum must be satisfied")                                      \
  1.2302                                                                              \
  1.2303    product(intx, Tier4BackEdgeThreshold, 40000,                              \
  1.2304            "Back edge threshold at which tier 4 OSR compilation is invoked") \
  1.2305 @@ -3460,12 +3512,12 @@
  1.2306            "Stop at given compilation level")                                \
  1.2307                                                                              \
  1.2308    product(intx, Tier0ProfilingStartPercentage, 200,                         \
  1.2309 -          "Start profiling in interpreter if the counters exceed tier 3"    \
  1.2310 +          "Start profiling in interpreter if the counters exceed tier 3 "   \
  1.2311            "thresholds by the specified percentage")                         \
  1.2312                                                                              \
  1.2313    product(uintx, IncreaseFirstTierCompileThresholdAt, 50,                   \
  1.2314 -          "Increase the compile threshold for C1 compilation if the code"   \
  1.2315 -          "cache is filled by the specified percentage.")                   \
  1.2316 +          "Increase the compile threshold for C1 compilation if the code "  \
  1.2317 +          "cache is filled by the specified percentage")                    \
  1.2318                                                                              \
  1.2319    product(intx, TieredRateUpdateMinTime, 1,                                 \
  1.2320            "Minimum rate sampling interval (in milliseconds)")               \
  1.2321 @@ -3480,24 +3532,26 @@
  1.2322            "Print tiered events notifications")                              \
  1.2323                                                                              \
  1.2324    product_pd(intx, OnStackReplacePercentage,                                \
  1.2325 -          "NON_TIERED number of method invocations/branches (expressed as %"\
  1.2326 -          "of CompileThreshold) before (re-)compiling OSR code")            \
  1.2327 +          "NON_TIERED number of method invocations/branches (expressed as " \
  1.2328 +          "% of CompileThreshold) before (re-)compiling OSR code")          \
  1.2329                                                                              \
  1.2330    product(intx, InterpreterProfilePercentage, 33,                           \
  1.2331 -          "NON_TIERED number of method invocations/branches (expressed as %"\
  1.2332 -          "of CompileThreshold) before profiling in the interpreter")       \
  1.2333 +          "NON_TIERED number of method invocations/branches (expressed as " \
  1.2334 +          "% of CompileThreshold) before profiling in the interpreter")     \
  1.2335                                                                              \
  1.2336    develop(intx, MaxRecompilationSearchLength,    10,                        \
  1.2337 -          "max. # frames to inspect searching for recompilee")              \
  1.2338 +          "The maximum number of frames to inspect when searching for "     \
  1.2339 +          "recompilee")                                                     \
  1.2340                                                                              \
  1.2341    develop(intx, MaxInterpretedSearchLength,     3,                          \
  1.2342 -          "max. # interp. frames to skip when searching for recompilee")    \
  1.2343 +          "The maximum number of interpreted frames to skip when searching "\
  1.2344 +          "for recompilee")                                                 \
  1.2345                                                                              \
  1.2346    develop(intx, DesiredMethodLimit,  8000,                                  \
  1.2347 -          "desired max. method size (in bytecodes) after inlining")         \
  1.2348 +          "The desired maximum method size (in bytecodes) after inlining")  \
  1.2349                                                                              \
  1.2350    develop(intx, HugeMethodLimit,  8000,                                     \
  1.2351 -          "don't compile methods larger than this if "                      \
  1.2352 +          "Don't compile methods larger than this if "                      \
  1.2353            "+DontCompileHugeMethods")                                        \
  1.2354                                                                              \
  1.2355    /* New JDK 1.4 reflection implementation */                               \
  1.2356 @@ -3519,7 +3573,7 @@
  1.2357            "in InvocationTargetException. See 6531596")                      \
  1.2358                                                                              \
  1.2359    develop(bool, VerifyLambdaBytecodes, false,                               \
  1.2360 -          "Force verification of jdk 8 lambda metafactory bytecodes.")      \
  1.2361 +          "Force verification of jdk 8 lambda metafactory bytecodes")       \
  1.2362                                                                              \
  1.2363    develop(intx, FastSuperclassLimit, 8,                                     \
  1.2364            "Depth of hardwired instanceof accelerator array")                \
  1.2365 @@ -3543,18 +3597,19 @@
  1.2366    /* flags for performance data collection */                               \
  1.2367                                                                              \
  1.2368    product(bool, UsePerfData, falseInEmbedded,                               \
  1.2369 -          "Flag to disable jvmstat instrumentation for performance testing" \
  1.2370 -          "and problem isolation purposes.")                                \
  1.2371 +          "Flag to disable jvmstat instrumentation for performance testing "\
  1.2372 +          "and problem isolation purposes")                                 \
  1.2373                                                                              \
  1.2374    product(bool, PerfDataSaveToFile, false,                                  \
  1.2375            "Save PerfData memory to hsperfdata_<pid> file on exit")          \
  1.2376                                                                              \
  1.2377    product(ccstr, PerfDataSaveFile, NULL,                                    \
  1.2378 -          "Save PerfData memory to the specified absolute pathname,"        \
  1.2379 -           "%p in the file name if present will be replaced by pid")        \
  1.2380 -                                                                            \
  1.2381 -  product(intx, PerfDataSamplingInterval, 50 /*ms*/,                        \
  1.2382 -          "Data sampling interval in milliseconds")                         \
  1.2383 +          "Save PerfData memory to the specified absolute pathname. "       \
  1.2384 +          "The string %p in the file name (if present) "                    \
  1.2385 +          "will be replaced by pid")                                        \
  1.2386 +                                                                            \
  1.2387 +  product(intx, PerfDataSamplingInterval, 50,                               \
  1.2388 +          "Data sampling interval (in milliseconds)")                       \
  1.2389                                                                              \
  1.2390    develop(bool, PerfTraceDataCreation, false,                               \
  1.2391            "Trace creation of Performance Data Entries")                     \
  1.2392 @@ -3579,7 +3634,7 @@
  1.2393            "Bypass Win32 file system criteria checks (Windows Only)")        \
  1.2394                                                                              \
  1.2395    product(intx, UnguardOnExecutionViolation, 0,                             \
  1.2396 -          "Unguard page and retry on no-execute fault (Win32 only)"         \
  1.2397 +          "Unguard page and retry on no-execute fault (Win32 only) "        \
  1.2398            "0=off, 1=conservative, 2=aggressive")                            \
  1.2399                                                                              \
  1.2400    /* Serviceability Support */                                              \
  1.2401 @@ -3588,7 +3643,7 @@
  1.2402            "Create JMX Management Server")                                   \
  1.2403                                                                              \
  1.2404    product(bool, DisableAttachMechanism, false,                              \
  1.2405 -         "Disable mechanism that allows tools to attach to this VM")        \
  1.2406 +          "Disable mechanism that allows tools to attach to this VM")       \
  1.2407                                                                              \
  1.2408    product(bool, StartAttachListener, false,                                 \
  1.2409            "Always start Attach Listener at VM startup")                     \
  1.2410 @@ -3611,9 +3666,9 @@
  1.2411            "Require shared spaces for metadata")                             \
  1.2412                                                                              \
  1.2413    product(bool, DumpSharedSpaces, false,                                    \
  1.2414 -           "Special mode: JVM reads a class list, loads classes, builds "   \
  1.2415 -            "shared spaces, and dumps the shared spaces to a file to be "   \
  1.2416 -            "used in future JVM runs.")                                     \
  1.2417 +          "Special mode: JVM reads a class list, loads classes, builds "    \
  1.2418 +          "shared spaces, and dumps the shared spaces to a file to be "     \
  1.2419 +          "used in future JVM runs")                                        \
  1.2420                                                                              \
  1.2421    product(bool, PrintSharedSpaces, false,                                   \
  1.2422            "Print usage of shared spaces")                                   \
  1.2423 @@ -3686,7 +3741,7 @@
  1.2424            "Relax the access control checks in the verifier")                \
  1.2425                                                                              \
  1.2426    diagnostic(bool, PrintDTraceDOF, false,                                   \
  1.2427 -             "Print the DTrace DOF passed to the system for JSDT probes")   \
  1.2428 +          "Print the DTrace DOF passed to the system for JSDT probes")      \
  1.2429                                                                              \
  1.2430    product(uintx, StringTableSize, defaultStringTableSize,                   \
  1.2431            "Number of buckets in the interned String table")                 \
  1.2432 @@ -3699,8 +3754,8 @@
  1.2433                                                                              \
  1.2434    product(bool, UseVMInterruptibleIO, false,                                \
  1.2435            "(Unstable, Solaris-specific) Thread interrupt before or with "   \
  1.2436 -          "EINTR for I/O operations results in OS_INTRPT. The default value"\
  1.2437 -          " of this flag is true for JDK 6 and earlier")                    \
  1.2438 +          "EINTR for I/O operations results in OS_INTRPT. The default "     \
  1.2439 +          "value of this flag is true for JDK 6 and earlier")               \
  1.2440                                                                              \
  1.2441    diagnostic(bool, WhiteBoxAPI, false,                                      \
  1.2442            "Enable internal testing APIs")                                   \
  1.2443 @@ -3721,6 +3776,7 @@
  1.2444                                                                              \
  1.2445    product(bool, EnableTracing, false,                                       \
  1.2446            "Enable event-based tracing")                                     \
  1.2447 +                                                                            \
  1.2448    product(bool, UseLockedTracing, false,                                    \
  1.2449            "Use locked-tracing when doing event-based tracing")
  1.2450  

mercurial