Docs (theming): Added more info about which swatches are used by default.

Author: jaspermdegroot

docs/api/themes.html

@@ -43,7 +43,13 @@ <h2>ThemeRoller</h2>
 
 		<h2>jQuery Mobile default theming</h2>
 
-		<p>If no theme swatch letter is set at all, the framework uses the <strong>a</strong> swatch for headers and footers and, for best contrast, the <strong>c</strong> swatch for the content of a page. All items in this containers inherit the swatch from its parents. One exception is the listdivider in listviews. This always defaults to the <strong>b</strong> (blue in the default theme). Also there is an swatch named "active" (bright blue in the default theme) which is used to indicate an active selected item. For more information about that, read <strong>Global "Active" state</strong> on this page.</p>
+		<p>If no theme swatch letter is set at all, the framework uses the "a" swatch (black in the default theme) for headers and footers and the "c" swatch (light gray in the default theme) for the page content to maximize contrast between the both.</p>
+        
+        <p>All items in containers inherit the swatch from their parent. Exceptions to this rule are the listdivider in listviews, the header of nested list pages, and the button of split button lists. Those default to "b" (blue in the default theme). Count bubbles default to "c" (silver in the default theme).
+        
+        <p>Note that there is also a swatch named "active" (bright blue in the default theme) which is used to indicate an active selected item. See the <strong>Global "Active" state</strong> further down this page for further information on the <strong>active</strong> swatch.</p>
+        
+        <p>The page loading dialog and error message don't inherit a swatch theme. The loading dialog defaults to swatch "a" (black in the default theme) and the error message to swatch "e" (yellow in the default theme). You can configure those defaults globally. See <a href="globalconfig.html">configuring defaults</a>.
 
 		<h2>Themes &amp; swatches</h2>
 
@@ -67,7 +73,7 @@ <h3>Bars</h3>
 			<div class="ui-bar ui-bar-e">Bar E - <a href="#" data-role="none" class="ui-link">Link</a></div>
 		</div><!-- end swatch-bars -->
 
-		<p>By default, the framework assigns the "a" swatch to all headers and footers, because these are typically given high visual priority in an application. To set the color of a bar to a different swatch color, simply add the <code> data-theme</code> attribute to your header or footer and specify an alternate swatch letter ('b' or 'd', for example) and the specified theme swatch color will be applied. Learn more about <a href="../toolbars/bars-themes.html">toolbar theming</a>.</p>
+		<p>By default, the framework assigns the "a" swatch to all headers and footers, because these are typically given high visual priority in an application. To set the color of a bar to a different swatch color, simply add the <code> data-theme</code> attribute to your header or footer and specify an alternate swatch letter ("b" or "d", for example) and the specified theme swatch color will be applied. Learn more about <a href="../toolbars/bars-themes.html">toolbar theming</a>.</p>
 
 
 
@@ -297,4 +303,4 @@ <h3>More in this section</h3>
 </div><!-- /page -->
 
 </body>
-</html>
+</html>