Update resources documentation with new qualifiers.

Change-Id: I4a3e0d3ece64d8a177157e469c39dbb282094373

1 files changed, 80 insertions, 40 deletions

diff --git a/docs/html/guide/topics/resources/providing-resources.jd b/docs/html/guide/topics/resources/providing-resources.jd
index 59f2e73..a996ccc 100644
--- a/docs/html/guide/topics/resources/providing-resources.jd
+++ b/docs/html/guide/topics/resources/providing-resources.jd
@@ -333,6 +333,86 @@ your application for other languages.</p>
 indicates the current locale.</p>
       </td>
     </tr>
+    <tr id="SmallestScreenWidthQualifier">
+      <td>Smallest screen width</td>
+      <td>Examples:<br/>
+        <code>sw320dp</code><br/>
+        <code>sw600dp</code><br/>
+        <code>sw720dp</code><br/>
+        etc.
+      </td>
+      <td>
+        <p>Specifies a minimum "smallest screen width," in "dp" units, at which the resource
+          should be used.  This configuration value represents the base screen size
+          of the device, regardless of the orientation of the display.  It is based
+          on the smallest width the application will have in which to perform its
+          UI layout (in dp units) regardless of the orientation of the screen.  The
+          value here takes into account screen decorations so if the device has some
+          persistent UI elements on the left or right edge of the display it must
+          present a value here that is smaller than the real screen size, accounting
+          for these UI elements reducing the application's available space.</p>
+        <p>Some values you may use here for common screen sizes:</p>
+        <ul>
+          <li>240x320 ldpi (QVGA phone): 320
+          <li>320x480 mdpi (phone): 320
+          <li>480x800 hdpi (high density phone): 320
+          <li>480x800 mdpi (tablet/phone): 480
+          <li>600x1024 mdpi (7" tablet): 600
+          <li>720x1280 mdpi (10" tablet): 720
+        </ul>
+        <p><em>Added in API Level 13.</em></p>
+        <p>Also see the {@link android.content.res.Configuration#smallestScreenWidthDp}
+          configuration field, which holds the current smallest screen width.</p>
+      </td>
+    </tr>
+    <tr id="ScreenWidthQualifier">
+      <td>Screen width</td>
+      <td>Examples:<br/>
+        <code>w720dp</code><br/>
+        <code>w1024dp</code><br/>
+        etc.
+      </td>
+      <td>
+        <p>Specifies a minimum screen width, in "dp" units, at which the resource
+          should be used.  This configuration value will change when the orientation
+          changes between landscape and portrait to match the current actual width.
+          When multiple screen width configurations are available, the closest to
+          the current screen width will be used.  The
+          value here takes into account screen decorations so if the device has some
+          persistent UI elements on the left or right edge of the display it must
+          present a value here that is smaller than the real screen size, accounting
+          for these UI elements reducing the application's available space.</p>
+        <p><em>Added in API Level 13.</em></p>
+        <p>Also see the {@link android.content.res.Configuration#screenWidthDp}
+          configuration field, which holds the current screen width.</p>
+      </td>
+    </tr>
+    <tr id="ScreenHeightQualifier">
+      <td>Screen height</td>
+      <td>Examples:<br/>
+        <code>h720dp</code><br/>
+        <code>h1024dp</code><br/>
+        etc.
+      </td>
+      <td>
+        <p>Specifies a minimum screen height, in "dp" units, at which the resource
+          should be used.  This configuration value will change when the orientation
+          changes between landscape and portrait to match the current actual height.
+          When multiple screen height configurations are available, the closest to
+          the current screen height will be used.  The
+          value here takes into account screen decorations so if the device has some
+          persistent UI elements on the left or right edge of the display it must
+          present a value here that is smaller than the real screen size, accounting
+          for these UI elements reducing the application's available space.  Screen
+          decorations that are not fixed (such as a phone status bar that can be
+          hidden when full screen) are <em>not</em> accounted for here, nor are
+          window decorations like title bar, so applications must be prepared to
+          deal with a somewhat smaller space than they specify.
+        <p><em>Added in API Level 13.</em></p>
+        <p>Also see the {@link android.content.res.Configuration#screenHeightDp}
+          configuration field, which holds the current screen width.</p>
+      </td>
+    </tr>
     <tr id="ScreenSizeQualifier">
       <td>Screen size</td>
       <td>
@@ -392,46 +472,6 @@ is not related to the screen orientation.</p>
 which indicates whether the screen is long.</p>
       </td>
     </tr>
-    <tr id="ScreenWidthQualifier">
-      <td>Screen width</td>
-      <td>Examples:<br/>
-        <code>w720dp</code><br/>
-        <code>w1024dp</code><br/>
-        etc.
-      </td>
-      <td>
-        <p>Specifies a minimum screen width, in "dp" units, at which the resource
-          should be used.  This configuration value will change when the orientation
-          changes between landscape and portrait to match the current actual width.
-          When multiple screen width configurations are available, the closest to
-          the current screen width will be used.  The value specified here is
-          approximate; screen decorations like a status bar or system bar may cause
-          the actual space available in your UI to be slightly smaller.
-        <p><em>Added in API Level 13.</em></p>
-        <p>Also see the {@link android.content.res.Configuration#screenWidthDp}
-          configuration field, which holds the current screen width.</p>
-      </td>
-    </tr>
-    <tr id="ScreenHeightQualifier">
-      <td>Screen height</td>
-      <td>Examples:<br/>
-        <code>h720dp</code><br/>
-        <code>h1024dp</code><br/>
-        etc.
-      </td>
-      <td>
-        <p>Specifies a minimum screen height, in "dp" units, at which the resource
-          should be used.  This configuration value will change when the orientation
-          changes between landscape and portrait to match the current actual height.
-          When multiple screen height configurations are available, the closest to
-          the current screen height will be used.  The value specified here is
-          approximate; screen decorations like a status bar or system bar may cause
-          the actual space available in your UI to be slightly smaller.
-        <p><em>Added in API Level 13.</em></p>
-        <p>Also see the {@link android.content.res.Configuration#screenHeightDp}
-          configuration field, which holds the current screen width.</p>
-      </td>
-    </tr>
     <tr id="OrientationQualifier">
       <td>Screen orientation</td>
       <td>