Skip to content

Commit 12a5475

Browse files
committed
docs: update hw accel attribute's default behavior and fix link to l10n tutorial
Change-Id: I445a5ef7513749ab55537c16dac2ee00aee0859d
1 parent 0038ec1 commit 12a5475

File tree

2 files changed

+30
-28
lines changed

2 files changed

+30
-28
lines changed

docs/html/guide/topics/manifest/application-element.jd

Lines changed: 28 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -57,9 +57,9 @@ cannot be overridden by the components.</dd>
5757
<dt><a name="reparent"></a>{@code android:allowTaskReparenting}</dt>
5858
<dd>Whether or not activities that the application defines can move from
5959
the task that started them to the task they have an affinity for when that task
60-
is next brought to the front &mdash; "{@code true}" if they can move, and
61-
"{@code false}" if they must remain with the task where they started.
62-
The default value is "{@code false}".
60+
is next brought to the front &mdash; {@code "true"} if they can move, and
61+
{@code "false"} if they must remain with the task where they started.
62+
The default value is {@code "false"}.
6363

6464
<p>
6565
The
@@ -73,9 +73,9 @@ information.
7373
<dt><a name="agent"></a>{@code android:backupAgent}</dt>
7474
<dd>The name of the class that implement's the application's backup agent,
7575
a subclass of {@link android.app.backup.BackupAgent}. The attribute value should be
76-
a fully qualified class name (such as, "{@code com.example.project.MyBackupAgent}").
76+
a fully qualified class name (such as, {@code "com.example.project.MyBackupAgent"}).
7777
However, as a shorthand, if the first character of the name is a period
78-
(for example, "{@code .MyBackupAgent}"), it is appended to the
78+
(for example, {@code ".MyBackupAgent"}), it is appended to the
7979
package name specified in the
8080
<code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</a></code>
8181
element.
@@ -86,29 +86,29 @@ There is no default. The name must be specified.
8686

8787
<dt><a name="debug"></a>{@code android:debuggable}</dt>
8888
<dd>Whether or not the application can be debugged, even when running
89-
on a device in user mode &mdash; "{@code true}" if it can be, and "{@code false}"
90-
if not. The default value is "{@code false}".</dd>
89+
on a device in user mode &mdash; {@code "true"} if it can be, and {@code "false"}
90+
if not. The default value is {@code "false"}.</dd>
9191

9292
<dt><a name="desc"></a>{@code android:description}</dt>
9393
<dd>User-readable text about the application, longer and more descriptive than the application label. The value must be set as a reference to a string resource. Unlike the label, it cannot be a raw string. There is no default value.</dd>
9494

9595
<dt><a name="enabled"></a>{@code android:enabled}</dt>
9696
<dd>Whether or not the Android system can instantiate components of
97-
the application &mdash; "{@code true}" if it can, and "{@code false}"
98-
if not. If the value is "{@code true}", each component's
97+
the application &mdash; {@code "true"} if it can, and {@code "false"}
98+
if not. If the value is {@code "true"}, each component's
9999
{@code enabled} attribute determines whether that component is enabled
100-
or not. If the value is "{@code false}", it overrides the
100+
or not. If the value is {@code "false"}, it overrides the
101101
component-specific values; all components are disabled.
102102

103103
<p>
104-
The default value is "{@code true}".
104+
The default value is {@code "true"}.
105105
</p></dd>
106106

107107
<dt><a name="code"></a>{@code android:hasCode}</dt>
108-
<dd>Whether or not the application contains any code &mdash; "{@code true}"
109-
if it does, and "{@code false}" if not. When the value is "{@code false}",
108+
<dd>Whether or not the application contains any code &mdash; {@code "true"}
109+
if it does, and {@code "false"} if not. When the value is {@code "false"},
110110
the system does not try to load any application code when launching components.
111-
The default value is "{@code true}".
111+
The default value is {@code "true"}.
112112

113113
<p>
114114
An application would not have any code of its own only if it's using nothing
@@ -118,10 +118,14 @@ android.app.AliasActivity} class, a rare occurrence.</p>
118118

119119
<dt><a name="hwaccel"></a>{@code android:hardwareAccelerated}</dt>
120120
<dd>Whether or not hardware-accelerated rendering should be enabled for all
121-
Activities and Views in this application &mdash; "{@code true}" if it
122-
should be enabled, and "{@code false}" if not. The default value is "{@code false}".
123-
124-
<p>Starting from Android 3.0, a hardware-accelerated OpenGL renderer is
121+
activities and views in this application &mdash; {@code "true"} if it
122+
should be enabled, and {@code "false"} if not. The default value is {@code "true"} if you've set
123+
either <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code minSdkVersion}</a>
124+
or <a
125+
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code targetSdkVersion}</a>
126+
to {@code "14"} or higher; otherwise, it's {@code "false"}.
127+
128+
<p>Starting from Android 3.0 (API level 11), a hardware-accelerated OpenGL renderer is
125129
available to applications, to improve performance for many common 2D graphics
126130
operations. When the hardware-accelerated renderer is enabled, most operations
127131
in Canvas, Paint, Xfermode, ColorFilter, Shader, and Camera are accelerated.
@@ -132,6 +136,9 @@ the framework's OpenGL libraries. </p>
132136
<p>Note that not all of the OpenGL 2D operations are accelerated. If you enable
133137
the hardware-accelerated renderer, test your application to ensure that it can
134138
make use of the renderer without errors.</p>
139+
140+
<p>For more information, read the <a href="{@docRoot}guide/topics/graphics/hardware-accel.html"
141+
>Hardware Acceleration</a> guide.</p>
135142
</dd>
136143

137144
<dt><a name="icon"></a>{@code android:icon}</dt>
@@ -146,7 +153,7 @@ each of the application's components. See the individual
146153

147154
<p>
148155
This attribute must be set as a reference to a drawable resource containing
149-
the image (for example {@code "@drawable/icon"}). There is no default icon.
156+
the image (for example {@code "@drawable/icon"}). There is no default icon.
150157
</p></dd>
151158

152159
<dt><a name="killrst"></a>{@code android:killAfterRestore}</dt>
@@ -233,8 +240,8 @@ Permissions</a>.
233240

234241
<dt><a name="persistent"></a>{@code android:persistent}</dt>
235242
<dd>Whether or not the application should remain running at all times &mdash;
236-
"{@code true}" if it should, and "{@code false}" if not. The default value
237-
is "{@code false}". Applications should not normally set this flag;
243+
{@code "true"} if it should, and {@code "false"} if not. The default value
244+
is {@code "false"}. Applications should not normally set this flag;
238245
persistence mode is intended only for certain system applications.</dd>
239246

240247
<dt><a name="proc"></a>{@code android:process}</dt>

docs/html/guide/topics/resources/localization.jd

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,6 @@ defaults.</li>
4848

4949
<h2>See also</h2>
5050
<ol>
51-
<li><a
52-
href="{@docRoot}resources/tutorials/localization/index.html">Hello, L10N Tutorial</a></li>
5351
<li><a href="{@docRoot}guide/topics/resources/providing-resources.html">Providing Resources</a></li>
5452
<li><a href="{@docRoot}guide/topics/ui/declaring-layout.html">Layouts</a></li>
5553
<li><a href="{@docRoot}reference/android/app/Activity.html#ActivityLifecycle">Activity Lifecycle</a></li>
@@ -87,11 +85,8 @@ programmatically. This document does not cover how to localize your Java code.
8785
</li>
8886
</ul>
8987

90-
<p>The <a
91-
href="{@docRoot}resources/tutorials/localization/index.html">Hello, L10N
92-
</a> tutorial takes you through the steps of creating a simple localized
93-
application that uses locale-specific resources in the way described in this
94-
document. </p>
88+
<p>For a short guide to localizing strings in your app, see the training lesson, <a
89+
href="{@docRoot}training/basics/supporting-devices/languages.html">Supporting Different Languages</a>. </p>
9590

9691

9792
<h2 id="resource-switching">Overview: Resource-Switching in Android</h2>

0 commit comments

Comments
 (0)