diff --git a/src/java.base/share/man/java.md b/src/java.base/share/man/java.md index 514db80e3a20c..ad4cb6fea9e3f 100644 --- a/src/java.base/share/man/java.md +++ b/src/java.base/share/man/java.md @@ -3816,9 +3816,10 @@ general form: be loaded on top of those in the ``. - On Windows, the above path delimiter `:` should be replaced with `;` -(The names "static" and "dynamic" are used for historical reasons. -The only significance is that the "static" archive is loaded first and -the "dynamic" archive is loaded second). +The names "static" and "dynamic" are used for historical reasons. The dynamic +archive, while still useful, supports fewer optimizations than +available for the static CDS archive. If the full set of CDS/AOT +optimizations are desired, consider using the AOT cache described below. The JVM can use up to two archives. To use only a single ``, you can omit the `` portion: