From d8b5bd1cdd21afc9ccd9c666ac172e5e8df0d8a0 Mon Sep 17 00:00:00 2001
From: Andy McFadden <fadden@android.com>
Date: Thu, 15 Jul 2010 10:30:23 -0700
Subject: [PATCH] Describe dalvik.vm.extra-opts.

Goes with bug 2838629.

Change-Id: I754af767bf8173a674d84428a3ce11cd337b19ae
---
 docs/embedded-vm-control.html | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/embedded-vm-control.html b/docs/embedded-vm-control.html
index e3797f33f..ec2b69462 100644
--- a/docs/embedded-vm-control.html
+++ b/docs/embedded-vm-control.html
@@ -16,6 +16,7 @@
     <li><a href="#dp">Deadlock Prediction</a>
     <li><a href="#stackdump">Stack Dumps</a>
     <li><a href="#dexcheck">DEX File Checksums</a>
+    <li><a href="#general">General Flags</a>
 </ul>
 
 <h2><a name="introduction">Introduction (read this first!)</a></h2>
@@ -288,6 +289,22 @@ problems it may be useful to add the property to
 to check for corruption in a large set of files.
 
 
+<h2><a name="general">General Flags</a></h2>
+
+<p>In the "Honeycomb" release, a general mechanism for passing flags to
+the VM was introduced:
+
+<pre>adb shell setprop dalvik.vm.extra-opts "flag1 flag2 ... flagN"</pre>
+
+<p>The flags are separated by spaces.  You can specify as many as you want
+so long as they all fit within the system property value length limit
+(currently 92 characters).
+
+<p>The extra-opts flags will be added at the end of the command line,
+which means they will override earlier settings.  This can be used, for
+example, to experiment with different values for <code>-Xmx</code> even
+though the Android framework is setting it explicitly.
+
 <address>Copyright &copy; 2008 The Android Open Source Project</address>
 
 </body></html>
-- 
2.11.0