From 01e1b832d722a9ee4322714da739d79e24ac8d07 Mon Sep 17 00:00:00 2001
From: Scott Main <smain@google.com>
Date: Mon, 2 Jul 2012 20:05:54 -0700
Subject: docs: add largeHeap attribute to app manifest doc external issue
 33967

Change-Id: I69e5d3da78098842c4710708f4d389637dd0fe6b
---
 docs/html/guide/topics/manifest/application-element.jd | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/html/guide/topics/manifest/application-element.jd b/docs/html/guide/topics/manifest/application-element.jd
index df6f61a54e06..8a91ec8e82fd 100644
--- a/docs/html/guide/topics/manifest/application-element.jd
+++ b/docs/html/guide/topics/manifest/application-element.jd
@@ -14,6 +14,7 @@ parent.link=manifest-intro.html
              android:<a href="#hwaccel">hardwareAccelerated</a>=["true" | "false"]
              android:<a href="#icon">icon</a>="<i>drawable resource</i>"
              android:<a href="#killrst">killAfterRestore</a>=["true" | "false"]
+             android:<a href="#largeHeap">largeHeap</a>=["true" | "false"]
              android:<a href="#label">label</a>="<i>string resource</i>"
              android:<a href="#logo">logo</a>="<i>drawable resource</i>"
              android:<a href="#space">manageSpaceActivity</a>="<i>string</i>"
@@ -161,6 +162,19 @@ has finished processing its data during a full-system restore, it will be
 terminated.
 </p></dd>
 
+<dt><a name="largeHeap"></a>{@code android:largeHeap}</dt>
+<dd>Whether your application's processes should be created with a large Dalvik heap. This applies to
+all processes created for the application. It only applies to the first application loaded into a
+process; if you're using a shared user ID to allow multiple applications to use a process, they all
+must use this option consistently or they will have unpredictable results.
+<p>Most apps should not need this and should instead focus on reducing their overall memory usage for
+improved performance. Enabling this also does not guarantee a fixed increase in available memory,
+because some devices are constrained by their total available memory.</p>
+<p>To query the available memory size at runtime, use the methods {@link
+  android.app.ActivityManager#getMemoryClass()} or {@link
+  android.app.ActivityManager#getLargeMemoryClass()}.</p>
+</dd>
+
 <dt><a name="label"></a>{@code android:label}</dt>
 <dd>A user-readable label for the application as a whole, and a default 
 label for each of the application's components.  See the individual 
-- 
cgit v1.2.3-59-g8ed1b