Update heap profiling docs.
Explain that "kill -10" is being removed as a heap-dump mechanism, and
describe the new "am dumpheap" command.
Change-Id: I83ac6cb5a7624d006001cc5404689bfe88b44fdd
diff --git a/docs/heap-profiling.html b/docs/heap-profiling.html
index 3570fdb..ca0c2bc 100644
--- a/docs/heap-profiling.html
+++ b/docs/heap-profiling.html
@@ -165,12 +165,27 @@
</p>
-<h3>Android 2.2 ("Froyo")</h3>
+<h3>Android 2.2 ("Froyo"), Android 2.x ("Gingerbread")</h3>
<p>
DDMS heap dump requests are now streamed directly out of the VM, removing
the external storage requirement.
</p>
+<h3>Android 2.x ("Honeycomb")</h3>
+<p>
+The <code>kill -10</code> (<code>SIGUSR1</code>) method of generating heap
+dumps has been removed, in favor of a much more useful shell command:
+</p>
+<blockquote><pre>am dumpheap <pid> <output-file-name></pre></blockquote>
+<p>
+Unlike the <code>SIGUSR1</code> approach, this does not require a rooted
+phone. It's only necessary for the application to be debuggable (by setting
+<code>android:debuggable="true"</code> in the <code><application></code>
+element of the app manifest). The output file is opened by "am", which
+means you can write the data to a file on <code>/sdcard</code> without
+needing the <code>WRITE_EXTERNAL_STORAGE</code> permission.
+</p>
+
<h2>Examining the data</h2>
<p>
The data file format was augmented slightly from the common hprof format,