docs: misc changes for new manifest attributes,

including fix for bug 7443821
bug 7442263

Change-Id: I20b712bf2b0379c70ff28682025d6f30817a6c36

1 files changed, 14 insertions, 6 deletions

diff --git a/docs/html/guide/topics/resources/providing-resources.jd b/docs/html/guide/topics/resources/providing-resources.jd
index 749e458..b311b7f 100644
--- a/docs/html/guide/topics/resources/providing-resources.jd
+++ b/docs/html/guide/topics/resources/providing-resources.jd
@@ -331,14 +331,13 @@ indicates the current locale.</p>
     </tr>
     <tr id="LayoutDirectionQualifier">
       <td>Layout Direction</td>
-      <td>Examples:<br/>
-        <code>ldrtl</code><br/>
+      <td><code>ldrtl</code><br/>
         <code>ldltr</code><br/>
       </td>
       <td><p>The layout direction of your application. {@code ldrtl} means "layout-direction-right-to-left".
       {@code ldltr} means "layout-direction-left-to-right" and is the default implicit value.
       </p>
-      <p>This can apply to any resource like layouts or values or drawables.
+      <p>This can apply to any resource such as layouts, drawables, or values.
       </p>
       <p>For example, if you want to provide some specific layout for the Arabic language and some
       generic layout for any other "right-to-left" language (like Persian or Hebrew) then you would have:
@@ -346,12 +345,21 @@ indicates the current locale.</p>
 <pre class="classic no-pretty-print">
 res/
     layout/   <span style="color:black">
-        main.xml  </span>(This is the default layout)
+        main.xml  </span>(Default layout)
     layout-ar/  <span style="color:black">
-        main.xml  </span>(This is the specific layout for Arabic)
+        main.xml  </span>(Specific layout for Arabic)
     layout-ldrtl/  <span style="color:black">
-        main.xml  </span>(This applies to any "right-to-left" language, except for Arabic, because the ar language qualifier has a higher precedence.)
+        main.xml  </span>(Any "right-to-left" language, except
+                  for Arabic, because the "ar" language qualifier
+                  has a higher precedence.)
 </pre>
+        <p class="note"><strong>Note:</strong> To enable right-to-left layout features
+        for your app, you must set <a
+        href="{@docRoot}guide/topics/manifest/application-element.html#supportsrtl">{@code
+        supportsRtl}</a> to {@code "true"} and set <a
+        href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target"
+        >{@code targetSdkVersion}</a> to 17 or higher.</p>
+        <p><em>Added in API level 17.</em></p>
       </td>
     </tr>
     <tr id="SmallestScreenWidthQualifier">