From c6cb8a78d03cda44a49a990b4d4153560bee7420 Mon Sep 17 00:00:00 2001
From: Scott Main <smain@google.com>
Date: Fri, 9 Apr 2010 15:52:18 -0700
Subject: docs: revisions to the new resources doc based on editorial feedback
 plus some fixes to resource references and other misc revisions

Change-Id: I7b498858d9d0ecfd8cf9bad48c08c93047d597b8
---
 docs/html/guide/topics/resources/available-resources.jd | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

(limited to 'docs/html/guide/topics/resources/available-resources.jd')

diff --git a/docs/html/guide/topics/resources/available-resources.jd b/docs/html/guide/topics/resources/available-resources.jd
index 19babee..09c55a5 100644
--- a/docs/html/guide/topics/resources/available-resources.jd
+++ b/docs/html/guide/topics/resources/available-resources.jd
@@ -18,6 +18,23 @@ of application resource that you can provide in your resources directory ({@code
 
 <p>Here's a brief summary of each resource type:</p>
 
+<div class="sidebox-wrapper">
+<div class="sidebox">
+<h2>{@code R.id} Is Not a Resource</h2>
+
+<p>You will often use an {@code R.id} integer to handle {@link android.view.View} objects in
+your UI. Although the {@code id} is a subclass of the {@code R} class, it is not considered a
+"resource" because it is not a reference to an externalized application resource. The {@code id}
+is simply a unique identifier that allows you to handle elements in your UI by instantiating
+objects with {@link android.app.Activity#findViewById(int) findViewById()}.</p>
+
+<p>For information about using {@code R.id} with your UI, see <a
+href="{@docRoot}guide/topics/ui/declaring-layout.html#attributes">Declaring Layout</a>.</p>
+
+</div>
+</div>
+
+
 <dl>
   <dt><a href="{@docRoot}guide/topics/resources/animation-resource.html">Animation Resources</a></dt>
     <dd>Define pre-determined animations.<br/>
-- 
cgit v1.1