Add comments around runtime options "-Xgc:[no]generational_cc" processing.
These comments serve as a reminder that these options should be
accepted by the runtime as long as they are passed by
app_process/zygote.
Test: mmma art
Bug: 72446017
Bug: 120794191
Bug: 123754583
Change-Id: Ieede0536befbd9cad77c0ab9da7f553717678916
diff --git a/cmdline/cmdline_types.h b/cmdline/cmdline_types.h
index 478ecdf..1f63d7d 100644
--- a/cmdline/cmdline_types.h
+++ b/cmdline/cmdline_types.h
@@ -457,8 +457,18 @@
} else if (gc_option == "nopresweepingverify") {
xgc.verify_pre_sweeping_heap_ = false;
} else if (gc_option == "generational_cc") {
+ // Note: Option "-Xgc:generational_cc" can be passed directly by
+ // app_process/zygote (see `android::AndroidRuntime::startVm`). If this
+ // option is ever deprecated, it should still be accepted (but ignored)
+ // for compatibility reasons (this should not prevent the runtime from
+ // starting up).
xgc.generational_cc = true;
} else if (gc_option == "nogenerational_cc") {
+ // Note: Option "-Xgc:nogenerational_cc" can be passed directly by
+ // app_process/zygote (see `android::AndroidRuntime::startVm`). If this
+ // option is ever deprecated, it should still be accepted (but ignored)
+ // for compatibility reasons (this should not prevent the runtime from
+ // starting up).
xgc.generational_cc = false;
} else if (gc_option == "postverify") {
xgc.verify_post_gc_heap_ = true;